Hugo | Example Hugo site with Toph theme

AsciiDoc एडमोनिशन समर्थन

Sun, 05 Jul 2026 00:00:00 +0000

AsciiDoc विशिष्ट सामग्री की ओर ध्यान आकर्षित करने के लिए पांच अंतर्निहित एडमोनिशन प्रकार प्रदान करता है। Toph प्रत्येक प्रकार को रंग-कोडित बाईं सीमा, हल्के रंग की पृष्ठभूमि और आइकन के साथ एक परिष्कृत कॉलआउट कार्ड के रूप में स्टाइल करता है।

एडमोनिशन प्रकार

AsciiDoc पांच एडमोनिशन प्रकार परिभाषित करता है, प्रत्येक अलग उद्देश्य के लिए।

Note	मुख्य पाठ का समर्थन करने वाली अतिरिक्त जानकारी या पूरक संदर्भ प्रदान करने के लिए नोट्स का उपयोग करें।

Tip	पाठक की सहायता करने वाली सर्वोत्तम प्रथाओं, शॉर्टकट या सिफारिशों को साझा करने के लिए टिप्स का उपयोग करें।

Warning

संभावित समस्याओं या नुकसानों के बारे में पाठक को सचेत करने के लिए चेतावनियों का उपयोग करें जिनके बारे में उन्हें पता होना चाहिए।

Caution

उन कार्यों को चिह्नित करने के लिए सावधानियों का उपयोग करें जो लापरवाही से किए जाने पर नुकसान, डेटा हानि या अनपेक्षित परिणाम पैदा कर सकते हैं।

Important

महत्वपूर्ण जानकारी को उजागर करने के लिए इम्पॉर्टेंट एडमोनिशन का उपयोग करें जिसे पाठक को नजरअंदाज नहीं करना चाहिए।

ब्लॉक एडमोनिशन

एडमोनिशन AsciiDoc के ब्लॉक सिंटैक्स का उपयोग करके कई पैराग्राफ तक भी फैल सकते हैं। यह तब उपयोगी होता है जब संदेश को एक वाक्य से अधिक की आवश्यकता हो।

Note	ब्लॉक एडमोनिशन चार बराबर चिह्नों के साथ डिलिमिटर सिंटैक्स का उपयोग करते हैं। इनमें कई पैराग्राफ, सूचियां और अन्य AsciiDoc तत्व हो सकते हैं। यह उसी एडमोनिशन ब्लॉक के अंदर दूसरा पैराग्राफ है।

Tip	दस्तावेज़ लिखते समय, विचार करें कि कौन सा एडमोनिशन प्रकार आपके संदेश के लिए सबसे उपयुक्त है। पूरक संदर्भ के लिए NOTE व्यावहारिक सलाह के लिए TIP संभावित नुकसानों के लिए WARNING नुकसान या डेटा हानि के जोखिम के लिए CAUTION महत्वपूर्ण जानकारी के लिए IMPORTANT

Warning

एडमोनिशन का उपयोग सीमित मात्रा में किया जाना चाहिए। अत्यधिक उपयोग उनके प्रभाव को कम करता है और सामग्री को स्कैन करना कठिन बनाता है।

सिंटैक्स

AsciiDoc में एडमोनिशन लिखने के दो तरीके हैं।

इनलाइन सिंटैक्स

सबसे सरल रूप एडमोनिशन लेबल को पैराग्राफ की शुरुआत में रखता है:

NOTE: यह एक इनलाइन नोट एडमोनिशन है।

TIP: यह एक इनलाइन टिप एडमोनिशन है।

ब्लॉक सिंटैक्स

बहु-पैराग्राफ एडमोनिशन के लिए, ब्लॉक डिलिमिटर का उपयोग करें:

[NOTE]
====
एडमोनिशन का पहला पैराग्राफ।

एडमोनिशन का दूसरा पैराग्राफ।
====

अधिक जानें

Toph में AsciiDoc के साथ ब्लॉगिंग

Mon, 23 Mar 2026 00:00:00 +0000

Toph, AsciiDoc को एक प्रथम श्रेणी की सामग्री फ़ॉर्मेट के रूप में मानता है। Markdown के साथ काम करने वाली हर चीज़ AsciiDoc के साथ भी काम करती है — टैक्सोनॉमी बैज, पोस्ट मेटाडेटा, कवर इमेज, हेडिंग एंकर और नेविगेशन।

AsciiDoc क्यों?

AsciiDoc ऐसी सुविधाएं प्रदान करता है जो Markdown नहीं देता:

:toc: दस्तावेज़ विशेषता के साथ नेटिव टेबल ऑफ़ कंटेंट्स
एडमोनिशन ब्लॉक (NOTE, TIP, WARNING, IMPORTANT, CAUTION)
पेजों में सामग्री को पुनः उपयोग करने के लिए इनक्लूड डायरेक्टिव
जटिल तालिकाओं और नेस्टेड सूचियों के लिए बिल्ट-इन सपोर्ट

यदि आप पहले से ही AsciiDoc में लिखने में सहज हैं, तो Toph बिना किसी समझौते के आपकी ज़रूरतों को पूरा करेगा।

एक AsciiDoc पोस्ट बनाना

अपनी ब्लॉग डायरेक्टरी में .adoc एक्सटेंशन वाली फ़ाइल बनाएं:

hugo new blog/my-post.adoc

फ़ाइल के शीर्ष पर YAML फ्रंट मैटर जोड़ें, उसके बाद AsciiDoc सामग्री:

---
title: "मेरी पोस्ट का शीर्षक"
date: 2026-01-15
draft: false
categories:
  - "tech"
tags:
  - "hugo"
  - "asciidoc"
author: "लेखक का नाम"
description: "पोस्ट का एक संक्षिप्त सारांश।"
---

आपकी AsciiDoc सामग्री यहां से शुरू होती है।

टेबल ऑफ़ कंटेंट्स

टेबल ऑफ़ कंटेंट्स सक्षम करने के लिए, फ्रंट मैटर के बाद :toc: विशेषता जोड़ें:

---
title: "मेरी पोस्ट का शीर्षक"
toc: true
---
:toc:

== पहला खंड

Toph का CSS, AsciiDoc द्वारा जनरेट किए गए टेबल ऑफ़ कंटेंट्स को Markdown के toc: true फ्रंट मैटर विकल्प के समान ही स्टाइल करता है। दोनों फ़ॉर्मेट एक ही विज़ुअल परिणाम देते हैं।

हेडिंग एंकर

सभी सेक्शन हेडिंग पर होवर करने पर क्लिक करने योग्य एंकर लिंक (🔗) दिखाई देते हैं। Markdown के लिए, यह एक रेंडर हुक द्वारा संभाला जाता है। AsciiDoc के लिए, Toph टेम्पलेट प्रोसेसिंग के माध्यम से वही एंकर मार्कअप इंजेक्ट करता है। दोनों फ़ॉर्मेट समान परिणाम देते हैं।

अधिक जानें

हैलो वर्ल्ड: Toph में ब्लॉगिंग की शुरुआत

Sun, 22 Mar 2026 00:00:00 +0000

हमें यह घोषणा करते हुए खुशी हो रही है कि Toph Hugo थीम अब ब्लॉगिंग को सपोर्ट करती है! Toph की शुरुआत एक हल्के बायोग्राफी और पोर्टफोलियो थीम के रूप में हुई थी, लेकिन यह एक सक्षम प्रकाशन प्लेटफ़ॉर्म में विकसित हो गई है। यहां नई सुविधाओं का एक संक्षिप्त दौरा है।

टैक्सोनॉमी समर्थन 🔗

पोस्ट को श्रेणियों और टैग के साथ व्यवस्थित किया जा सकता है। श्रेणियां व्यापक समूह हैं जो श्रेणी पृष्ठ पर मैगज़ीन-शैली के कार्ड के रूप में प्रदर्शित होती हैं। टैग अधिक विस्तृत होते हैं और टैग पृष्ठ पर एक विज़ुअल वर्ड क्लाउड के रूप में दिखाए जाते हैं।

इनका उपयोग करने के लिए, अपनी पोस्ट के फ्रंट मैटर में categories और tags जोड़ें:

categories: ["announcements"]
tags: ["toph", "blogging", "hugo"]

पोस्ट मेटाडेटा 🔗

हर ब्लॉग पोस्ट अपनी प्रकाशन तिथि, लेखक, पढ़ने का समय और शब्द संख्या स्वचालित रूप से दिखाती है। मेटाडेटा बार के नीचे श्रेणियां और टैग लिंक किए गए बैज के रूप में दिखाई देते हैं। यदि आपकी साइट में enableGitInfo: true है, तो प्रकाशन के बाद पोस्ट में संशोधन होने पर एक “अपडेटेड” तिथि दिखाई देती है।

ब्लॉग आर्काइव 🔗

ब्लॉग आर्काइव पोस्ट को वर्ष और महीने के अनुसार एक संक्षिप्त करने योग्य अकॉर्डियन लेआउट में समूहित करता है। सबसे हालिया वर्ष और महीना डिफ़ॉल्ट रूप से विस्तारित होते हैं, जिससे आर्काइव बढ़ने पर भी स्कैन करने योग्य बना रहता है।

होमपेज पर हाल की पोस्ट 🔗

पांच सबसे हाल की ब्लॉग पोस्ट स्वचालित रूप से होमपेज पर दिखाई देती हैं। नवीनतम पोस्ट को एक बड़े कार्ड में प्रदर्शित किया जाता है, जिसके नीचे अगली चार एक कॉम्पैक्ट ग्रिड में होती हैं। किसी कॉन्फ़िगरेशन की आवश्यकता नहीं है — यदि ब्लॉग पोस्ट मौजूद हैं, तो वे दिखाई देती हैं।

पोस्ट नेविगेशन 🔗

हर पोस्ट के नीचे, पिछला और अगला लिंक पाठकों को आर्काइव में वापस गए बिना पोस्ट के बीच जाने देते हैं।

शुरुआत करना 🔗

Hugo के बिल्ट-इन आर्कटाइप के साथ एक नई ब्लॉग पोस्ट बनाएं:

hugo new blog/my-first-post.md

यह सही फ्रंट मैटर फ़ील्ड के साथ एक नई पोस्ट तैयार करता है। जब आप प्रकाशित करने के लिए तैयार हों तो draft: false सेट करें, और अपनी साइट को फिर से बनाएं।

अधिक जानकारी के लिए, Toph थीम रिपॉजिटरी देखें।