Vergleichen und kontrastieren Sie die leichtgewichtigen Markup-Sprachen [geschlossen]

Bitte identifizieren Sie die beliebtesten Lightweight-Markup-Sprachen und vergleichen Sie ihre Stärken und Schwächen. Diese Sprachen sollten ein Allzweck-Markup für technische Prosa sein, beispielsweise für die Dokumentation (z. B. zählt Haml nicht).

Siehe auch: Markdown versus ReStructuredText

Ich kenne drei Hauptsprachen, die in der größeren Programmier- und Tech-Community häufig verwendet werden: Textile, Markdown und reStructuredText. Alle drei können in ein paar Stunden erlernt oder mit dem Spickzettel in der Nähe "geflügelt" werden.

Textil

• Wird von Redmine und der Ruby-Community verwendet
• 113 Fragen, die derzeit im Stapelüberlauf markiert sind
• Die HTML-ähnlichste, aber am wenigsten lesbare Quelle
• Einfachste verschachtelte Listen aller drei Sprachen
• Nicht verständlich für Nicht-Programmierer oder HTML-Unwissende
• Ideal für komplexe Kurzdokumente (mit Links, verschachtelten Listen, Code, benutzerdefiniertem HTML); Zum Beispiel: kurze Dokumentation, Anleitungen, Blog- oder CMS-Inhalte
• Syntaxreferenz

Abschlag

• Scheint keine "Community" in der Muttersprache zu haben, aber ...
• 1274 Fragen zum Thema Stapelüberlauf *
• Betont die Lesbarkeit des Quellcodes, ähnlich wie bei E-Mail-Traditionen
• Einfache HTML-Einbettung (Sie geben einfach die Tags ein)
• Außer dem Einbetten von HTML gibt es keine Möglichkeit, Tabellen zu erstellen
• Sie wissen es bereits, wenn Sie den Stapelüberlauf kennen
• Leicht zu erlernen, wenn Sie reStructuredText bereits kennen
• Automatische Verschleierung der E-Mail-Adresse für das Format <address@example.com> (mit spitzen Klammern)
• Syntaxreferenz

reStructuredText (AKA ReST)

• Beliebt in der Python-Community
• 285 Fragen zum Thema Stapelüberlauf
• Ein bisschen Ausdauer in Bezug auf Leerzeichen und Ausrichtung, wenn Sie mich fragen
• Listen (insbesondere verschachtelte Listen) und Absätze scheinen immer in Streit zu geraten
• Lesbar für Nicht-Programmierer
• Nur Format, das ein Inhaltsverzeichnis erstellen kann (über eine Erweiterung in der Python-Referenzimplementierung)
• Konvertiert direkt in andere Formate wie PDF und XML
• Ideal für große Dokumente mit viel Prosa (zB eine Alternative zu docbook für ein Benutzerhandbuch)
• Syntaxreferenz

Sie könnten auch Asciidoc in Betracht ziehen

• relativ lesbares Markup
• einfache Befehlszeilenverwendung
• Einige mögen es in Bezug auf die Syntax als relativ „wählerisch“ (vs. flexibel) empfinden
• docbook und (x) html Ausgabe

Die Wikipedia-Seite zu Lightweight-Markup-Sprachen bietet einen guten Vergleich zwischen den verschiedenen Optionen sowie eine Syntax für allgemeine Zwecke (Überschriften, Fettdruck, Kursivschrift usw.).

Ich versuche hier, alle verschiedenen Lightweight-Markup-Sprachen abzudecken:

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

Wie Sie sehen können, begann es mit "Wie kann ich ein sicheres Blog erstellen?" - dh einem Blog, das statisches HTML generiert, und ich befand mich in Markup-Sprachen, Template-Systemen usw. gefangen.

Aktualisieren

Ich habe mich nur auf LWMLs mit Python-Implementierungen konzentriert, und sie sind hier:

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

Bisher habe ich Markdown und ReST ausprobiert, und letzteres gefällt mir besser für alles andere als HTML-Schnipsel, die in andere Seiten eingebettet sind. Tabellen, Querverweise, indirekte Links usw.

zur Dokumentation? Wie wäre es mit Sauerstoff ?
Ich habe es für einige C / C ++ - Projekte verwendet, die ich dokumentieren muss. Sogar Sie können es "missbrauchen", wie es der Doxygen-Autor für die Doxygen-Dokumentation verwendet