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

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 टेम्पलेट प्रोसेसिंग के माध्यम से वही एंकर मार्कअप इंजेक्ट करता है। दोनों फ़ॉर्मेट समान परिणाम देते हैं।

अधिक जानें 🔗