हल्के मार्कअप भाषाओं की तुलना करें और इसके विपरीत [बंद]


90

कृपया सबसे लोकप्रिय हल्के मार्कअप भाषाओं की पहचान करें और उनकी ताकत और कमजोरियों की तुलना करें। ये भाषाएं तकनीकी गद्य के लिए सामान्य प्रयोजन के मार्कअप होनी चाहिए, जैसे कि प्रलेखन के लिए (उदाहरण के लिए, हैम की गिनती नहीं होती है)।

इसे भी देखें: मार्कडाउन बनाम रिस्ट्रक्चरटैक्स


जवाबों:


115

मुझे तीन मुख्य भाषाओं का पता है जो आमतौर पर अधिक से अधिक प्रोग्रामिंग और तकनीकी समुदाय में उपयोग की जाती हैं: टेक्सटाइल, मार्कडाउन और रीस्ट्रक्टेक्टेड टेक्स्ट। इन तीनों को कुछ घंटों में या "पंखों वाला" पास के धोखा पत्र के साथ सीखा जा सकता है।

कपड़ा

  • Redmine और रूबी समुदाय द्वारा उपयोग किया जाता है
  • वर्तमान में स्टैक ओवरफ्लो पर 113 प्रश्न टैग किए गए हैं
  • HTML के समान, लेकिन कम से कम पठनीय स्रोत
  • तीनों भाषाओं की सबसे सरल नेस्टेड सूची
  • गैर-प्रोग्रामर या HTML-अज्ञानी के लिए समझ में नहीं आता है
  • जटिल लघु दस्तावेजों के लिए आदर्श (लिंक, नेस्टेड सूचियों, कोड, कस्टम HTML के साथ); उदाहरण के लिए: लघु प्रलेखन, कैसे-करें, ब्लॉग या सीएमएस सामग्री
  • सिंटेक्स संदर्भ

Markdown

  • लगता है एक घर भाषा "समुदाय" लेकिन नहीं है ...
  • स्टैक ओवरफ्लो * पर टैग किए गए 1274 प्रश्न
  • ईमेल परंपराओं के समान स्रोत कोड पठनीयता पर जोर देता है
  • सीधा HTML एम्बेडिंग (आप केवल टैग टाइप करें)
  • HTML एम्बेड करने के अलावा टेबल बनाने का कोई तरीका नहीं
  • आप इसे पहले से ही जानते हैं यदि आप स्टैक ओवरफ्लो जानते हैं
  • जानने के लिए आसान अगर आप पहले से ही reStructuredText जानते हैं
  • प्रारूप के लिए स्वचालित ईमेल पता obfuscation <address@example.com> (कोण कोष्ठक के साथ)
  • सिंटेक्स संदर्भ

reStructuredText (AKA ReST)

  • अजगर समुदाय में लोकप्रिय है
  • स्टैक ओवरफ्लो पर 285 प्रश्न टैग किए गए
  • यदि आप मुझसे पूछते हैं तो व्हाट्सएप और संरेखण के बारे में थोड़ा दृढ़ता से
  • सूचियाँ (विशेषकर नेस्टेड सूचियाँ) और अनुच्छेद हमेशा झगड़े में लगते हैं
  • गैर-प्रोग्रामर द्वारा पठनीय
  • केवल प्रारूप जो सामग्री की तालिका बना सकता है (पायथन संदर्भ कार्यान्वयन में विस्तार के माध्यम से)
  • सीधे पीडीएफ और एक्सएमएल जैसे अन्य प्रारूपों में कनवर्ट करता है
  • गद्य के बहुत सारे दस्तावेज़ों के लिए आदर्श (उदाहरण के लिए उपयोगकर्ता पुस्तिका के लिए डॉकबुक का विकल्प)
  • सिंटेक्स संदर्भ

4
ReST के उपयोगकर्ताओं के लिए, sphinx.pocoo.org संदर्भ दस्तावेज के बड़े पेड़ संरचित संग्रहों के लिए एक बहुत अच्छा उपकरण है।
बेंडिन

6
जब मैं Emacs में हार्ड-रैप चीजें लपेटता हूं तो मुझे reStructuredText में सूचियों और पैराग्राफ के साथ कोई समस्या नहीं है। वास्तव में, वे ठीक उसी तरह काम करते हैं जैसे मैं उनसे उम्मीद करता हूं कि :-)
मार्टिन जिसलर

1
मार्कडाउन के एक्सटेंशन हैं जो एएससीआईआई में तालिकाओं की रचना करने की अनुमति देते हैं।
याकूब नारबस्की

1
ReST के पास उत्कृष्ट उपकरण समर्थन भी है: जैसे कि ब्राउज़र आधारित notex.ch एक अच्छा उपकरण है, जिसके साथ ReST (sphinx.pocoo.org बैकएंड पर आधारित) सीखें और उपयोग करें।
hsk81

31

तुम भी asciidoc पर विचार कर सकते हैं

  • अपेक्षाकृत पठनीय मार्कअप
  • सीधी कमांड लाइन का उपयोग
  • कुछ लोग इसे सिंटैक्स के संबंध में अपेक्षाकृत 'पिकी' (बनाम लचीला) के रूप में देख सकते हैं
  • docbook और (x) html आउटपुट

2
दुर्भाग्य से asciidoc में कई पैराग्राफ के साथ सूची आइटम के लिए एक भयानक वाक्यविन्यास है: आपको उन्हें केवल एक प्लस-साइन (हां, एक "+") वाली एकल पंक्ति के साथ अलग करना होगा।
मार्टिन गिस्लर

4
@ मॉर्टिन: क्या बहु-पैराग्राफ सूची आइटम वास्तव में महत्वपूर्ण हैं? यदि आपको एक से अधिक पैराग्राफ की आवश्यकता है, तो हेडिंग / सेक्शन किसी सूची से अधिक उपयुक्त नहीं होंगे?
स्टीव एस

AsciiDoc का सबसे बड़ा लाभ यह है कि यह बहुत अधिक सुविधाओं का समर्थन करता है। यह किताबें बना सकता है, टिप सेक्शन हो सकता है, कई आउटपुट हो सकते हैं ... powerman.name/doc/asciidoc
Wernight

21

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


5

मैं यहाँ सभी विभिन्न हल्के मार्कअप भाषाओं को कवर करने का प्रयास कर रहा हूँ:

http://www.subspacefield.org/~travis/static_blog_generators.html

जैसा कि आप देख सकते हैं, यह "मैं एक सुरक्षित ब्लॉग कैसे बना सकता हूं" के साथ शुरू हुआ - यानी वह जो स्थैतिक एचटीएमएल उत्पन्न करता है, और मैंने खुद को मार्कअप भाषाओं, टेम्प्लेटिंग सिस्टम, आदि में पाया।

अपडेट करें

मैंने अजगर के कार्यान्वयन के साथ केवल LWML पर refocused, और वे यहाँ हैं:

http://www.subspacefield.org/~travis/python_lightweight_markup_languages.html

अब तक मैंने मार्कडाउन और रेस्ट की कोशिश की है, और मुझे बाद के कुछ के लिए बेहतर पसंद है, लेकिन एचटीएमएल स्निपेट अन्य पृष्ठों में एम्बेडेड हैं। टेबल्स, क्रॉस रिफ, अप्रत्यक्ष लिंक, आदि ...


4

प्रलेखन के लिए? doxygen के बारे में कैसे ?
मैंने इसे कुछ c / c ++ प्रोजेक्ट के लिए उपयोग किया है जिन्हें मुझे दस्तावेज करने की आवश्यकता है। यहां तक ​​कि आप इसे 'दुर्व्यवहार' कर सकते हैं, जैसे कि doxygen लेखक डॉक्यूमेंटेशन डॉक्यूमेंटेशन के लिए उपयोग करता है

हमारी साइट का प्रयोग करके, आप स्वीकार करते हैं कि आपने हमारी Cookie Policy और निजता नीति को पढ़ और समझा लिया है।
Licensed under cc by-sa 3.0 with attribution required.