Comparer et contraster les langages de balisage léger

Question

Veuillez identifier les langages de balisage léger plus populaires et comparer leurs forces et leurs faiblesses. Ces langues doivent être polyvalent balisage technique prosateur, comme pour la documentation (par exemple, ne compte pas Haml).

Voir aussi : Markdown versus ReStructuredText

Answer 1

Je sais de trois langues principales utilisées couramment dans la grande région de la programmation et de la technologie de la communauté: Textile, Markdown, et reStructuredText. Tous les trois peuvent être appris en une heure ou deux "ailes" avec la feuille de triche à proximité.

Textile

• Utilisé par Redmine et la communauté Ruby
• 113 questions actuellement marqué sur un Débordement de Pile
• Le plus proche du HTML, mais moins lisible de la source
• La plus simple des listes imbriquées de tous les trois langues
• Pas compréhensibles pour les non-programmeurs ou le code HTML de ignorant la
• Idéal pour des complexes de documents courts (avec des liens, des listes imbriquées, code HTML personnalisé); par exemple: une courte documentation, tutoriels, blog ou de contenu CMS
• La syntaxe de référence

Markdown

• Ne semble pas avoir une langue à la maison de la "communauté", mais...
• 1274 questions tagged sur Stack Overflow*
• Met l'accent sur la lisibilité du code source, comme le courriel traditions
• Simple d'intégration HTML (vous tapez juste les balises)
• Pas moyen d'en faire des tables d'ailleurs intégration HTML
• Vous le savez déjà si vous connaissez Débordement de Pile
• Facile à apprendre si vous connaissez déjà reStructuredText
• E-mail automatique de la dissimulation de l'adresse est de la forme <address@example.com> (avec les crochets)
• La syntaxe de référence

reStructuredText (A. K. A. le Repos)

• Populaire dans la communauté Python
• 285 questions tagged sur un Débordement de Pile
• Un peu persnickety sur les espaces et l'alignement, si vous me demandez
• Les listes (en particulier les listes imbriquées) et les paragraphes semblent toujours obtenir dans les combats
• Lisible par les non-programmeurs
• Seul format qui peut créer une table des matières (via une extension dans le Python de référence de mise en œuvre)
• Directement convertit en d'autres formats comme le PDF et XML
• Idéal pour les documents de grande taille avec beaucoup de prose (par exemple, une alternative à docbook pour un manuel de l'utilisateur)
• La syntaxe de référence

Answer 2

Vous pouvez également envisager asciidoc

• balisage relativement lisible
• utilisation de ligne de commande simple
• certains pourraient le perçoivent comme relativement « pointilleux » (vs flexible) en ce qui concerne la syntaxe
• sortie html docbook et (x)

Answer 3

La page Wikipedia sur les langages de balisage léger a une bonne comparaison entre les diverses options, mais aussi affichage de syntaxe pour des utilisations courantes (titres, gras, italique, etc.)

Answer 4

Je suis tenter de couvrir tous les différents langages de balisage léger ici:

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

Comme vous pouvez le voir, il a commencé avec "comment puis-je faire un secure blog" - c'est à dire celle qui génère la page HTML statique, et je me suis retrouvé pris au piège dans des langages de balisage, la création de modèles de systèmes, etc.

Mise à jour

J'ai recentré uniquement sur LWMLs avec les implémentations de python, et theyre ici:

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

Jusqu'à présent, j'ai essayé de démarques et de Repos, et j'aime bien le dernier de mieux pour quoi que ce soit mais Des extraits de code HTML incorporé dans d'autres pages. Tables, croix de fer, des liens indirects, etc...

Answer 5

pour obtenir une documentation ? que diriez-vous de doxygen?
Je l’ai utilise pour certains des projets c / c++ que j’ai besoin de documentize. Même vous pouvez « abuser » tout comme doxygen auteur utilise pour obtenir la documentation doxygen