Confronta e contrapponi i linguaggi di markup leggeri [chiuso]

Identifica i linguaggi di markup leggeri più popolari e confronta i loro punti di forza e di debolezza. Questi linguaggi dovrebbero essere markup di uso generale per la prosa tecnica, come per la documentazione (ad esempio, Haml non conta).

Vedi anche: Markdown versus ReStructuredText

Conosco tre linguaggi principali usati comunemente nella più ampia comunità di programmazione e tecnologia: Textile, Markdown e reStructuredText. Tutti e tre possono essere appresi in un paio d'ore o "alati" con il cheat sheet nelle vicinanze.

Tessile

• Utilizzato da Redmine e dalla comunità Ruby
• 113 domande attualmente contrassegnate su Stack Overflow
• La sorgente più simile all'HTML, ma meno leggibile
• Elenchi annidati più semplici di tutte e tre le lingue
• Non comprensibile ai non programmatori o agli ignoranti di HTML
• Ideale per documenti brevi complessi (con collegamenti, elenchi annidati, codice, HTML personalizzato); ad esempio: breve documentazione, how-to, blog o contenuto CMS
• Riferimento alla sintassi

Markdown

• Non sembra avere una "comunità" di lingua madre ma ...
• 1274 domande taggate su Stack Overflow *
• Enfatizza la leggibilità del codice sorgente, simile alle tradizioni della posta elettronica
• Incorporamento HTML semplice (devi solo digitare i tag)
• Non c'è modo di creare tabelle oltre a incorporare HTML
• Lo sai già se conosci Stack Overflow
• Facile da imparare se conosci già reStructuredText
• Offuscamento automatico dell'indirizzo e-mail per il formato <indirizzo@esempio.com> (con parentesi angolari)
• Riferimento alla sintassi

reStructuredText (AKA ReST)

• Popolare nella comunità Python
• 285 domande taggate su Stack Overflow
• Un po 'perspicace sugli spazi bianchi e l'allineamento se me lo chiedi
• Le liste (specialmente le liste annidate) ei paragrafi sembrano sempre entrare in conflitto
• Leggibile da non programmatori
• Unico formato che può creare un sommario (tramite un'estensione nell'implementazione di riferimento di Python)
• Converte direttamente in altri formati come PDF e XML
• Ideale per documenti di grandi dimensioni con molta prosa (ad es. Un'alternativa a docbook per un manuale utente)
• Riferimento alla sintassi

Potresti anche considerare asciidoc

• markup relativamente leggibile
• semplice utilizzo da riga di comando
• alcuni potrebbero percepirlo come relativamente "schizzinoso" (vs. flessibile) rispetto alla sintassi
• docbook e (x) output html

La pagina di Wikipedia sui linguaggi di markup leggeri ha un buon confronto tra le varie opzioni, oltre a mostrare la sintassi per usi comuni (titoli, grassetto, corsivo, ecc.)

Sto tentando di coprire tutti i vari linguaggi di markup leggeri qui:

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

Come puoi vedere, è iniziato con "come posso creare un blog sicuro", ovvero uno che genera HTML statico, e mi sono ritrovato intrappolato in linguaggi di markup, sistemi di modelli, ecc.

Aggiornare

Mi sono concentrato solo su LWML con implementazioni Python e sono qui:

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

Finora ho provato markdown e ReST, e quest'ultimo mi piace di più per qualsiasi cosa tranne gli snippet HTML incorporati in altre pagine. Tabelle, riferimenti incrociati, collegamenti indiretti, ecc ...

per la documentazione? che ne dici di ossigeno ?
L'ho usato per alcuni dei progetti c / c ++ che ho bisogno di documentare. Anche tu puoi "abusarne" proprio come l'autore di doxygen usa per la documentazione di doxygen