Porównaj i porównaj lekkie języki znaczników [zamknięte]

Proszę zidentyfikować najpopularniejsze lekkie języki znaczników i porównać ich mocne i słabe strony. Te języki powinny być znacznikami ogólnego przeznaczenia w prozie technicznej, takiej jak dokumentacja (na przykład Haml się nie liczy).

Zobacz także: Markdown a ReStructuredText

Znam trzy główne języki używane powszechnie w większej społeczności programistycznej i technicznej: Textile, Markdown i reStructuredText. Wszystkich trzech można się nauczyć w ciągu kilku godzin lub "uskrzydlonych" z pobliską ściągawką.

Włókienniczy

• Używany przez Redmine i społeczność Ruby
• 113 pytań aktualnie oznaczonych na Stack Overflow
• Najbardziej podobne do HTML, ale najmniej czytelne źródło
• Najłatwiejsze zagnieżdżone listy wszystkich trzech języków
• Niezrozumiałe dla nie-programistów lub nie znających języka HTML
• Idealny do złożonych, krótkich dokumentów (z linkami, zagnieżdżonymi listami, kodem, niestandardowym HTML); na przykład: krótka dokumentacja, poradniki, zawartość bloga lub CMS
• Odniesienie do składni

Obniżka cen

• Wygląda na to, że nie ma „społeczności” w języku ojczystym, ale ...
• 1274 pytania otagowane na przepełnieniu stosu *
• Podkreśla czytelność kodu źródłowego, podobnie jak w przypadku tradycyjnych wiadomości e-mail
• Proste osadzanie HTML (wystarczy wpisać tagi)
• Nie ma możliwości tworzenia tabel poza osadzeniem HTML
• Wiesz to już, jeśli znasz przepełnienie stosu
• Łatwy do nauczenia, jeśli znasz już reStructuredText
• Automatyczne zaciemnianie adresu e-mail dla formatu <adres@example.com> (z nawiasami ostrymi)
• Odniesienie do składni

reStructuredText (AKA ReST)

• Popularne w społeczności Pythona
• 285 pytań otagowanych na Stack Overflow
• Trochę wytrwałe w kwestii białych znaków i wyrównania, jeśli o mnie chodzi
• Listy (szczególnie listy zagnieżdżone) i akapity zawsze wydają się być w walce
• Czytelne dla nie programistów
• Jedyny format, który może zbudować spis treści (poprzez rozszerzenie w implementacji referencyjnej Pythona)
• Bezpośrednio konwertuje do innych formatów, takich jak PDF i XML
• Idealny do dużych dokumentów z dużą ilością prozy (np. Alternatywa dla docbooka dla instrukcji obsługi)
• Odniesienie do składni

Możesz również rozważyć asciidoc

• stosunkowo czytelne znaczniki
• proste użycie wiersza poleceń
• niektórzy mogą postrzegać ją jako stosunkowo „wybredną” (w porównaniu z elastyczną) pod względem składni
• docbook i (x) wyjście html

Strona Wikipedii dotycząca lekkich języków znaczników zawiera dobre porównanie różnych opcji, a także pokazuje składnię dla typowych zastosowań (nagłówki, pogrubienie, kursywa itp.)

Próbuję tutaj omówić wszystkie różne lekkie języki znaczników:

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

Jak widać, zaczęło się od „jak mogę stworzyć bezpieczny blog” - tj. Takiego, który generuje statyczny HTML, i znalazłem się w pułapce języków znaczników, systemów szablonów itp.

Aktualizacja

Skupiłem się tylko na LWML z implementacjami Pythona, a one są tutaj:

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

Do tej pory wypróbowałem Markdown i ReST, i to drugie podoba mi się bardziej z wyjątkiem fragmentów HTML osadzonych na innych stronach. Tabele, odsyłacze, linki pośrednie itp.

do dokumentacji? co powiesz na doxygen ?
Użyłem go do niektórych projektów c / c ++, które muszę udokumentować. Nawet ty możesz go „nadużywać”, tak jak autor doxygen używa do dokumentacji doxygen