मार्कडाउन/पैंडोक की पूरी साइट संकलन?

Question

Sphinx-doc के साथ, आप index.rst फ़ाइल के साथ, ReStructureText फ़ाइलों का एक समूह बना सकते हैं जिसमें सामग्री मैक्रो की एक तालिका शामिल है जो स्वत: शामिल फ़ाइलों से सामग्री की एक तालिका उत्पन्न करता है, और conf.py जो संकलन कॉन्फ़िगरेशन के रूप में कार्य करता है। इसके बाद आप बहुत ही एक पायथन-डॉक्टर-शैली साइट में संकलित कर सकते हैं, इंडेक्स, नेविगेशन टूल और एक खोज फ़ंक्शन के साथ पूरा कर सकते हैं।

क्या मार्कडाउन (अधिमानतः पैंडोक-स्टाइल मार्कडाउन) के लिए कोई तुलनात्मक टूल है?

Answer 1

कुछ स्थिर साइट जनरेटर कि Markdown के साथ काम:

• Jekyll बहुत लोकप्रिय है और यह भी GitHub pages के पीछे इंजन है।
• अजगर वेरिएंट: Hyde या Pelican
• nanoc (GitHub API documentation में इस्तेमाल f.ex.)
• Middlemanapp: शायद सबसे अच्छा एक?

मुझे लगता है कि उनमें से कोई भी pandoc का उपयोग (शायद क्योंकि यह हास्केल में लिखा है), लेकिन वे सभी एक उन्नत Markdown सिंटैक्स का उपयोग करें या pandoc उपयोग करने के लिए विन्यस्त किया जा सकता।

अन्य रोचक markdown से एक साइट उत्पन्न करने के लिए तरीके:

• Markdown- विकी कि आधारित फ़ाइल हैं: f.ex. Gollum, विकी-इंजन जिसका उपयोग गिटहब
• Telegram द्वारा किया जाता है: वाणिज्यिक;
  • Gitit: Pandoc विकी
  • Pandoc-Plugin forIkiwiki
  • Yst static site generator
  • Gouda - generates a site from a directory of markdown files
  डेविड पोलाक, आविष्कारक लिफ्ट-स्काला ढांचे

  इंजन कि Pandoc का उपयोग द्वारा लिखित

• Rippledoc - generates a navigable site from nested directories of markdown files

स्टेटिक साइट जेनरेटर

स्थिर साइट जनरेटर की एक अच्छा सिंहावलोकन की निश्चित सूची: http://staticsitegenerators.net/

Answer 2

Pandoc, जीएनयू make और sed आदेश, कुछ CSS के साथ छिड़का आप सभी की जरूरत हैं Markdown से शुरू होने वाली स्थिर वेबसाइट के निर्माण को पूरी तरह से स्वचालित करने के लिए।

पांडोक तीन कमांड लाइन विकल्प प्रदान करता है जो पेज के अंदर शीर्षकों के आधार पर पृष्ठों के बीच नेविगेशन और सामग्री की एक तालिका (टीओसी) के निर्माण के साथ नेविगेशन प्रदान कर सकते हैं। सीएसएस के साथ आप नेविगेशन और टीओसी देख सकते हैं और जिस तरीके से आप चाहते हैं उसका व्यवहार कर सकते हैं।

-B फ़ाइल, --include पहले शरीर = फ़ाइल

फ़ाइल की सामग्री, शब्दशः, दस्तावेज़ के मुख्य भाग की शुरुआत में शामिल करें (जैसे टैग के ठीक बाद के बाद, या \ begin { दस्तावेज़} कमांड लाटेक्स में)। इसका उपयोग HTML दस्तावेज़ों में नेविगेशन बार या बैनर शामिल करने के लिए किया जा सकता है। एकाधिक विकल्पों को शामिल करने के लिए इस विकल्प को बार-बार उपयोग किया जा सकता है। उन्हें निर्दिष्ट क्रम में शामिल किया जाएगा। मतलब - स्टैंडअलोन।

--toc, --table के- सामग्री

सामग्री की एक स्वत: उत्पन्न तालिका शामिल करें।

--toc गहराई = संख्या

सामग्री तालिका में शामिल करने के लिए खंड स्तर की संख्या निर्दिष्ट करें। डिफ़ॉल्ट 3 है (जिसका अर्थ है कि स्तर 1, 2, और 3 शीर्षलेख सामग्री में सूचीबद्ध होंगे)।

वास्तव में, my personal website is built this way। अधिक जानकारी के लिए अपने makefile देखें। यह सभी मुक्त-मुक्त ओपन-सोर्स GNU GPL version 3 के तहत लाइसेंस प्राप्त है।

Answer 3

यदि आप ठीक है पांडोक का उपयोग नहीं कर रहे हैं, तो mkdocs आपकी आवश्यकताओं के अनुरूप लग जाएगा।

यदि आप निश्चित रूप से पांडोक-स्वाद वाले मार्कडाउन का उपयोग करना चाहते हैं, तो आप pdsite देख सकते हैं। मैंने इसे अधिक इनपुट प्रारूपों (जैसे emacs org-mode) और पायथन निर्भरताओं के बिना mkdocs-style साइट पीढ़ी प्राप्त करने के लिए एक तरीका के रूप में लिखा - आप मार्कडाउन फ़ाइलों के फ़ोल्डर में पास हो जाते हैं और एक HTML साइट प्राप्त करते हैं (स्वचालित रूप से जेनरेट किए गए बहु सहित -वेल नेविगेशन लिंक)। यह सर्ज स्ट्रोबबैंट के दृष्टिकोण के समान है कि यह सिर्फ एक शेल स्क्रिप्ट है (हालांकि आपको tree स्थापित करने की आवश्यकता है)। दुर्भाग्यवश इसमें अभी तक कोई खोज फ़ंक्शन नहीं है, हालांकि इसे जोड़ने में बहुत मुश्किल नहीं होगी ...