Comme vous l'avez probablement vu dans des articles précédents, ici à MakeUseOf nous sommes fans de Markdown. En apprenant ce format simple et intuitif, vous êtes en mesure de créer facilement de beaux résultats. Des fichiers PDF aux pages Web, votre humble fichier texte devient un document sophistiqué.

Mais Markdown n'est pas le seul jeu en ville. Il existe un certain nombre d'autres langages de balisage dit légers, similaires à Markdown, mais avec des jeux de fonctionnalités différents. L'un d'entre eux est Asciidoc. Si vous aimez Markdown mais recherchez un peu plus sous le capot, cela vaut la peine d'être examiné. Voici quelques raisons.

Qu'est-ce qu'un “Langage de balisage” En tous cas?

UNE langage de balisage est un ensemble de codes qui, lorsqu'ils sont appliqués à du texte brut, vous permettent d'ajouter une ou plusieurs des propriétés suivantes (parmi d'autres):

• Définir le texte
• Structurer le texte
• Décrivez la mise en page du texte
• Décorer le texte

Un langage de balisage que vous rencontrez chaque jour (sauf si vous êtes un ermite) est le langage de balisage hypertexte, ou HTML. Les sites Web et les applications qui vous apportent des nouvelles et vous montrent votre courrier électronique sont construits, au moins en partie, avec le balisage HTML. Apprenez le HTML et le CSS avec ces tutoriels étape par étape. Apprenez le HTML et le CSS avec ces tutoriels étape par étape. et JavaScript? Si vous pensez avoir le don d'apprendre à créer des sites Web à partir de rien, voici quelques excellents tutoriels étape par étape qui valent le coup d'être essayés. . HTML utilise Mots clés comme mécanisme de balisage du contenu en texte brut. Par exemple, considérons l'extrait de code HTML suivant:

 
Introduction au HTML
 
Voici un paragraphe en HTML… nous savons que c'est un paragraphe parce que les \ tags environnants le définissent comme un.
 

Ici le

balise spécifie que tout le texte à suivre, jusqu'à sa fermeture

Mais notez également les balises… celles-ci servent souvent à définir la mise en page d'une page Web, telle que la marge qu'il reste sur le côté de l'écran..

Et le les balises vont décorer le mot “paragraphe” en gras, tandis que le

les balises peuvent à la fois tracer le titre (en l’espaçant du texte environnant) et définir une police plus grande.

Le problème avec certains langages de balisage (HTML parmi eux) est que la frappe manuelle de ces balises est une opération très fastidieuse. Et avec d'autres langages comme XML Qu'est-ce qu'un fichier XML et comment pouvez-vous l'ouvrir et l'utiliser? Qu'est-ce qu'un fichier XML et comment pouvez-vous l'ouvrir et l'utiliser? Vous avez peut-être vu le terme "XML". Vous avez peut-être même accidentellement ouvert un fichier XML. Qu'est-ce que XML et comment l'utilisez-vous? , les balises et leurs attributs constituent une plus grande partie du contenu global que le texte lui-même! Jetez un coup d'œil à l'extrait de code DocBook suivant, un dialecte XML utilisé pour créer de nombreuses publications techniques:

Tout le texte en violet représente les balises que vous devez taper vous-même. Le premier paragraphe ne commence pas avant le bas de cette image. Et si cela n’est pas correctement réalisé conformément au standard DocBook, vous ne pourrez pas le convertir en un joli document PDF qui constitue généralement l’objectif final..

Entrez le langage de balisage léger

Si vous souhaitez tirer parti des langages de marquage, par exemple en publiant une page HTML sur le Web ou en convertissant un fichier DocBook au format PDF afin qu'il puisse être imprimé, vous devez procéder de l'une des deux manières suivantes. D'une part, vous pouvez investir du temps en apprenant ces langues de fond en comble, en les écrivant à la main, puis en effectuant une triple vérification de votre travail. Ou vous pourriez investir de l'argent dans un outil qui gère la complexité de ceux-ci pour vous.

Heureusement, certains développeurs entreprenants ont proposé une troisième option. Ils ont créé de nouveaux langages de balisage contenant beaucoup (dans certains cas, la plupart des fonctionnalités) des équivalents plus lourds, mais en simplifiant grandement la syntaxe. Celles-ci “poids léger” les langues incluent le familier Markdown Qu'est-ce que Markdown? 4 raisons pour lesquelles vous devriez apprendre maintenant Qu'est-ce que Markdown? 4 raisons pour lesquelles vous devriez apprendre maintenant Fatigué des éditeurs HTML et WYSIWYG? Alors Markdown est la solution pour vous, peu importe qui vous êtes. ainsi que Asciidoc, le format Org-Mode de Emac et la syntaxe Mediawiki.

Les langages de balisage légers ont une syntaxe simple

Une caractéristique de ces langues est que leur “Mots clés” (tels qu'ils sont) devraient être intuitifs. Jetons un coup d'oeil à l'extrait précédent, cette fois écrit en Asciidoc:

Introduction à Asciidoc -------------------- Où sont les balises * paragraph *? On n'en a pas besoin… Asciidoc est assez malin pour se rendre compte qu'il s'agit d'un paragraphe!

Beaucoup plus lisible, non? En partant du haut, nous pouvons identifier le titre tel qu'il est “souligné” avec des tirets. Si vous écrivez à la main, vous pouvez le faire en soulignant le titre de la page dans votre cahier. Il n'y a pas non plus de balises de paragraphe - Asciidoc considère que tout ce qui se trouve entre deux lignes vides ne comporte pas d'autre balisage. “plaine” texte du paragraphe. Enfin, les astérisques autour du mot “paragraphe” indiquez en gras. Levez la main si vous avez fait cela dans un message texte pour dire exactement la même chose.

Chacun a un ou plusieurs processeurs correspondants

le “poids lourd” les langages de balisage ont généralement une application dédiée pour les interpréter pour vous. Sur le Web, c’est votre navigateur ainsi que le serveur Web qui convertira le code en pages Web flashy. Tout ce que vous devez savoir sur les systèmes de gestion de contenu Tout ce que vous devez savoir sur les systèmes de gestion de contenu Pour un internaute moyen, voir du contenu est facile. Vous ouvrez un lien et la page apparaît. Mais que se passe-t-il dans les coulisses? Voici comment vos CMS préférés s’occupent des affaires. . Pour les documents XML, cela peut ressembler à quelque chose comme Microsoft Word, qui lit et écrit au format DOCX. Comment ouvrir les fichiers DOCX Microsoft Word 2007 Comment ouvrir les fichiers DOCX Microsoft Word 2007 Avez-vous déjà reçu l'un de ces fichiers avec l'extension .docx et je me demandais quoi faire avec ça? Il ne peut pas être visualisé dans les anciennes versions de Word, alors comment pouvez-vous ouvrir un fichier .docx… (qui est un autre dialecte XML). Pour que vous n'ayez jamais à interagir directement avec la source de ces documents, seules les jolies façades que vos applications vous montrent.

Pendant ce temps, les documents écrits dans des langages légers sont lisibles par l'homme sous forme de source (un autre locataire), mais seuls les vrais nerds peuvent penser qu'ils sont beaux. Pour obtenir de jolis résultats, vous devez utiliser un processeur. Ce sont des applications qui vont parcourir votre balisage ligne par ligne et le convertir en quelque chose de plus beau. Les mêmes projets qui développent le langage lui-même produiront généralement un utilitaire qui va avec. Le projet Markdown propose un script Perl du même nom et le programme associé d'Asciidoc est écrit en Python. En outre, d'autres utilitaires de conversion incluront la prise en charge de certaines de ces langues. L’un d’entre eux est l’excellent Pandoc Comment convertir facilement des formats de document sous Linux? Comment convertir facilement des formats de document sous Linux? Le passage à Linux peut entraîner des problèmes de compatibilité des fichiers. Par exemple, les documents ne se ressemblent pas dans LibreOffice et dans Word. Ce n'est qu'une des raisons pour lesquelles vous avez besoin de pandoc. , qui utilisera Markdown ainsi que des annotations légères Text reStructured, Mediawiki et Org-Mode et les convertira en PDF, DOCX, ODT, etc..

Le résultat est que les langages de balisage légers vous permettent de travailler en texte brut, le format de données le plus portable de la planète, tout en produisant une belle apparence au final. Maintenant que vous êtes convaincu de ses mérites, quelle langue choisir? Markdown est sans aucun doute le plus populaire, et a ses avantages (plus sur ceux-ci plus tard). Mais Asciidoc en particulier est une alternative valable. Dans la section suivante, nous explorerons quelques raisons pour lesquelles.

Comparaison entre Markdown et Asciidoc

Le format Asciidoc a été créé dans le but d’apporter une simplicité légère à DocBook, l’un des formats les plus courants en écriture longue (surtout technique). L’une de ses caractéristiques est qu’il s’agit d’une traduction personnalisée, ce qui signifie que pour chaque élément de DocBook, il existe une représentation correspondante dans Asciidoc. Ci-dessous, nous examinerons certains avantages et inconvénients d’Asciidoc par rapport à Markdown..

Asciidoc couvre un sur-ensemble d'éléments d'écriture

Le but initial de Markdown était de constituer un format simple pour les rédacteurs Web. En tant que tels, les éléments d’écriture qu’il supporte (du moins l’implémentation d’origine, voir ci-dessous) sont centrés sur l’automatisation des aspects les plus fastidieux de l’écriture HTML (listes par exemple, qui nécessitent la

ou
balises en plus de
• étiquettes pour chaque article).

  

  Asciidoc les contient également, mais offre également des éléments DocBook plus avancés tels que des avertissements (par exemple. “Remarque:” ou “Info:” blocs de légende) et des dispositions de table complexes. Ça ne veut pas dire toi avoir besoin de les utiliser tout le temps, mais ils seront là et disponibles si vous en avez besoin.

  Asciidoc est un format unifié

  Lorsque la popularité de Markdown a commencé à décoller, certains de ses utilisateurs ont commencé à rencontrer certaines des lacunes discutées ci-dessus. Ainsi, ces utilisateurs ont commencé à développer leurs propres extensions pour résoudre ces problèmes, telles que la possibilité d’ajouter des tableaux ou des notes de bas de page. Bientôt, il y avait beaucoup “les saveurs” de Markdown, y compris (entre autres):

  • La saveur utilisée par Github pour la “Lisez moi” fichiers de projets qu'il a hébergés.
  • Un “élargi” saveur née d'un port PHP de Markdown d'origine avec des fonctionnalités supplémentaires liées à HTML.
  • Une saveur appelée “MultiMarkdown” qui implémentait de nombreuses fonctionnalités d'écriture plus longue, y compris les citations, les définitions et les références croisées.

  Le résultat est que votre document peut nécessiter des éléments qui ne sont pas tous couverts par une seule variante. En revanche, Asciidoc ne souffre pas de la même fragmentation que Markdown fait actuellement.

  Asciidoc cible une variété de styles de publication

  Markdown est idéal pour obtenir rapidement un article de blog de la tête et sur la page. En sortie d'usine, il n'est pas conçu pour structurer des œuvres plus longues, comme un livre. Asciidoc est conçu pour cela, et un exemple en est sa “comprendre” les fonctions. Ces instructions vous permettent d'inclure tout le contenu d'un fichier dans un autre:

  include :: somefile.adoc

  Cela n’est pas sans rappeler la manière dont les documents maîtres fonctionnent dans les traitements de texte. Cela vous permet, par exemple, de rédiger chaque chapitre en tant que fichier séparé, puis “comprendre” tous dans un fichier représentant le livre. Quand vous traitez cela “dossier de livre,” la sortie sera comme si tous les chapitres avaient été écrits directement dans ce document.

  Markdown est suffisant pour la plupart des utilisateurs

  Markdown couvre toutes les bases pour une plus grande partie des utilisateurs. Pour ceux qui cherchent simplement à bloguer ou à saisir des notes au format texte brut, Markdown prend en charge tous les éléments dont ils auront besoin. Les références croisées ne signifient pas grand-chose pour un utilisateur qui souhaite simplement créer un mémo ou une page Web simple. Vous pouvez même utiliser Markdown pour des travaux plus longs avec des mises en page simples, telles que le roman Who Needs Scrivener? 5 Nouvelles applications d'écriture pour Linux Qui a besoin de Scrivener? 5 Nouvelles applications d'écriture pour Linux Scrivener n'est pas disponible pour Linux. Comment allez-vous donc savoir où vont ces personnages, ce qu'ils ont fait et comment ils terminent leur parcours? Eh bien, l’un de ces outils devrait aider. et combinez-les vous-même à la fin.

  Markdown est mieux pris en charge

  Étant donné que Markdown répond aux besoins d’un plus grand nombre d’utilisateurs, il est mieux pris en charge sur les points suivants:

  • Les éditeurs WYSIWYG (définis par ceux qui fournissent au moins un aperçu en direct) ont bien plus de chances de prendre en charge Markdown..
  • Les services en ligne, tels que le Github susmentionné, sont plus susceptibles d’accepter Markdown directement ou par l’utilisation d’addons 6 Editors de Markdown qui jouent bien avec Google Drive 6 Editeurs de Markdown qui jouent bien avec Google Drive Markdown est le format d’édition de texte du futur. Il est plus simple, plus élégant et plus facile à utiliser que HTML sans sacrifier beaucoup de puissance ou de flexibilité. .
  • Bien que les systèmes de publication, tels que les générateurs de sites statiques, 7 raisons de dissocier votre CMS et d'envisager un générateur de site statique 7 raisons de délimiter votre CMS et d'envisager un générateur de site statique Pendant de nombreuses années, la publication d'un site Web a été difficile pour de nombreux utilisateurs. Les CMS comme WordPress ont changé cela, mais ils peuvent toujours être déroutants. Une autre alternative est un générateur de site statique. prend souvent en charge Asciidoc avec des plugins, qu’ils supportent Markdown hors de la boîte est presque une donnée.

  Êtes-vous prêt à essayer Asciidoc?

  Bien que Markdown soit un choix de facto parmi les langages de balisage légers, Asciidoc contient tous les mêmes éléments, puis certains. Les extras d’Asciidoc nécessitent un certain temps d’apprentissage pour vous préparer au mieux à des projets d’écriture plus vastes et plus complexes..

  Qu'est-ce que tu penses? Êtes-vous satisfait de la simplicité de Markdown? Ou créer votre propre flux de publication multi-canaux avec Asciidoc est-il alléchant? Peut-être que vous détestez le texte brut et que c'est Word tout le chemin pour vous? Faites-nous savoir dans les commentaires ci-dessous!