Publicité

Comme vous l'avez probablement vu dans les articles précédents, ici à MakeUseOf nous sommes fans de Markdown What Is 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 réponse pour vous, peu importe qui vous êtes. Lire la suite . En apprenant ce format simple et intuitif, vous pouvez facilement créer des sorties attrayantes. Du 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 dits légers, similaires à Markdown, mais avec des ensembles de fonctionnalités différents. L'un d'eux est Asciidoc. Si vous aimez Markdown mais que vous cherchez un peu plus sous le capot, cela vaut la peine d'y réfléchir. Voici quelques raisons.

Qu'est-ce qu'un "langage de balisage" de toute façon?

Un langage de balisage est un ensemble de codes qui, lorsqu'il est appliqué à du texte en clair, vous permet d'ajouter une ou plusieurs des propriétés suivantes (parmi d'autres):

• Définir le texte
• Structurer le texte
• Décrivez la disposition du texte
• Décorer le texte

Un langage de balisage que vous rencontrez tous les jours (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 email sont construits, au moins en partie, avec le balisage HTML Apprendre HTML et CSS avec Ces tutoriels pas à pas Apprendre HTML et CSS avec ces tutoriels pas à pas Curieux de HTML, CSS et JavaScript? Si vous pensez que vous avez un talent pour apprendre à créer des sites Web à partir de zéro - voici quelques tutoriels étape par étape qui valent la peine d'être essayés. Lire la suite . HTML utilise les balises comme mécanisme pour baliser le contenu du texte brut. Par exemple, considérez l'extrait de code HTML suivant:

 Présentation du HTML 
Voici un paragraphe en HTML ... nous savons qu'il s'agit d'un paragraphe parce que les tags \ environnants le définissent comme un seul.

Ici le

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

tag, est un paragraphe. En ce sens, il définit le texte comme un paragraphe.

Mais notez aussi les tags ... ceux-ci servent souvent à définir la mise en page d'une page Web, comme la marge qu'il y a du côté de l'écran.

Et les étiquettes décoreront le mot "paragraphe" dans une police en gras, tandis que le

Les balises peuvent à la fois disposer 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 saisie manuelle de ces balises est une affaire très fastidieuse. Et avec d'autres langages comme XML Qu'est-ce qu'un fichier XML et quelles sont ses utilisations? [Dans le cas où vous vous demandiez] Qu'est-ce qu'un fichier XML et quelles sont ses utilisations? [Dans le cas où vous vous demandiez] En savoir plus, 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 DocBook suivant, un dialecte XML utilisé pour créer de nombreuses publications techniques:

Tout le texte en violet représente les tags que vous auriez besoin de taper par vous-même. Le premier paragraphe ne commence pas jusqu'au bas de cette image. Et si cela n'est pas fait correctement selon la norme DocBook, vous ne pourrez pas le convertir en un joli document PDF qui est généralement l'objectif final.

Entrez le langage de balisage léger

Si vous vouliez profiter des langages de balisage, par exemple en publiant une page HTML sur le web ou en convertissant un fichier DocBook en PDF pour qu'il puisse être imprimé, vous deviez faire l'une des deux choses suivantes. D'une part, vous pourriez investir du temps en apprenant ces langues à l'intérieur et à l'extérieur, en les écrivant à la main, puis en triplant votre travail. Ou vous pouvez 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 qui contenaient beaucoup (dans certains cas la plupart ou la totalité) des caractéristiques des contreparties les plus lourdes, mais qui simplifiaient grandement la syntaxe. Ces langages "légers" incluent le Markdown familier 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 réponse pour vous, peu importe qui vous êtes. Lire la suite ainsi que Asciidoc, le format Org-Mode d'Emac, et la syntaxe Mediawiki.

Les langages de balisage légers ont une syntaxe simple

Une caractéristique de ces langages est que leurs "tags" (tels qu'ils sont) devraient être intuitifs. Jetons un coup d'oeil à l'extrait précédent, cette fois écrit en Asciidoc:

 Introducing Asciidoc -------------------- Where are the *paragraph* tags? We dont need them... Asciidoc is smart enough to realize this is a paragraph! 

Beaucoup plus lisible, non? En commençant par le haut, nous pouvons identifier le titre car il est "souligné" avec des tirets. Vous pourriez le faire si vous étiez à la main, il suffit de dessiner un soulignement sous le titre de la page dans votre cahier. Il n'y a pas non plus de balises de paragraphe - Asciidoc considère n'importe quoi entre deux lignes vides qui n'ont pas d'autre balisage sur le texte de paragraphe «simple». Enfin, les astérisques autour du mot "paragraphe" indiquent le caractère gras. Levez la main si vous l'avez fait dans un message texte pour signifier exactement la même chose.

Chacun a un ou plusieurs processeurs correspondants

Les langages de balisage «lourds» ont généralement une application dédiée pour les interpréter pour vous. Sur le web, c'est votre navigateur et éventuellement le serveur web qui va transformer 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 est facile. Vous ouvrez un lien, et la page apparaît. Mais qu'est-ce qui se passe dans les coulisses? Voici comment vos CMS favoris s'occupent des affaires. Lire la suite . Pour les documents en XML, il pourrait être quelque chose comme Microsoft Word, qui lit et écrit son format DOCX Comment ouvrir les fichiers DOCX Microsoft Word 2007 Comment ouvrir les fichiers DOCX Microsoft Word 2007 Avez-vous déjà reçu un de ces fichiers avec l'extension .docx et demandé ce qu'il faut faire avec? Il ne peut pas être consulté dans les anciennes versions de Word, alors comment pouvez-vous ouvrir un fichier .docx ... Lire la suite (qui est un autre dialecte XML). Vous n'avez donc jamais à interagir directement avec la source de ces documents, seulement 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. Afin d'obtenir de jolis résultats, vous devez utiliser un processeur . Ce sont des applications qui vont parcourir votre ligne de balisage ligne par ligne et la convertir en quelque chose d'autre qui a l'air bien. Les mêmes projets qui développent la langue elle-même produiront typiquement une utilité pour l'accompagner. Le projet Markdown propose un script Perl du même nom et le programme compagnon d'Asciidoc est écrit en Python. En outre, d'autres utilitaires de conversion incluront un support pour certaines de ces langues. Un tel est l'excellent Pandoc Comment convertir facilement entre formats de documents sous Linux Comment convertir facilement entre formats de documents sous Linux Passer à Linux peut entraîner des problèmes de compatibilité des fichiers. Par exemple, les documents n'ont pas la même apparence dans LibreOffice que dans Word. C'est juste une des raisons pour lesquelles vous avez besoin de pandoc. Lire la suite, qui prendra Markdown ainsi que les balises légères reStructured Text, Mediawiki, et Org-Mode et les convertir en PDF, DOCX, ODT, et plus encore.

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 sur la planète, tout en produisant des sorties attrayantes à la fin. Maintenant que vous êtes convaincu de ses mérites, quelle langue devriez-vous choisir? Markdown est sans doute le plus populaire, et a ses avantages (plus sur ces derniers plus tard). Mais Asciidoc en particulier est une alternative digne. Dans la section suivante, nous allons explorer quelques raisons pour lesquelles.

En comparant Markdown et Asciidoc

Le format Asciidoc a été créé pour apporter de la légèreté à DocBook, l'un des formats les plus courants dans l'écriture longue (surtout technique). Une de ses prétentions à la célébrité est qu'il s'agit d'une traduction biunivoque, ce qui signifie que pour chaque élément de DocBook, il y a une représentation correspondante dans Asciidoc. Ci-dessous, nous allons jeter un oeil à certains des avantages et des inconvénients d'Asciidoc par rapport à Markdown.

Asciidoc couvre un surensemble d'éléments d'écriture

L'objectif de Markdown était dès le départ d'être un format simple pour les auteurs Web. En tant que tel, les éléments d'écriture qu'il supporte (au moins la mise en œuvre originale, voir ci-dessous) sont axés sur l'automatisation des aspects plus chronophages de l'écriture HTML (listes par exemple, qui nécessitent la

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

  

  Asciidoc les contient également, mais propose également des éléments DocBook plus avancés tels que des admonitions (par exemple "Note:" ou "Info:" blocs d'appel) et des mises en page complexes. Cela ne signifie pas que vous devez 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. Ces utilisateurs ont donc commencé à développer leurs propres extensions pour résoudre ces problèmes, comme la possibilité d'ajouter des tables ou des notes de pied / notes de fin. Bientôt, il y avait beaucoup de "saveurs" de Markdown, y compris (entre autres):

  • La saveur utilisée par Github pour les fichiers "Readme" des projets hébergés.
  • Une saveur "étendue" née d'un port PHP du Markdown original avec des fonctionnalités supplémentaires liées au HTML.
  • Une saveur appelée "MultiMarkdown" qui a implémenté de nombreuses fonctionnalités d'écriture de forme longue, y compris des citations, des définitions et des 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 saveur. 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 sortir rapidement un blog de votre tête et sur la page. Mais sorti de la boîte, il n'est pas construit pour structurer des œuvres plus longues, comme un livre. Asciidoc est conçu pour cela, et un exemple est ses fonctions "include". Ces instructions vous permettent d'inclure tout le contenu d'un fichier dans un autre:

   include::somefile.adoc 

  Ce n'est pas sans rappeler comment les documents maîtres fonctionnent dans les traitements de texte. Cela vous permet, par exemple, de rédiger chaque chapitre comme un fichier séparé, puis de les "inclure" dans un fichier représentant le livre. Lorsque vous traitez ce "fichier livre", la sortie sera comme si tous les chapitres étaient é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 tapez quelques notes dans un format de 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 veut simplement créer un simple mémo ou une page Web. Vous pouvez même utiliser Markdown pour des travaux plus longs avec des mises en page simples, comme un 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 - alors comment allez-vous savoir où vont ces personnages, ce qu'ils ont fait et comment ils terminent leur voyage? Eh bien, un de ces outils devrait aider. Lire la suite, et combinez-les vous-même à la fin.

  Markdown est mieux pris en charge

  Depuis Markdown répond aux besoins d'un plus grand segment d'utilisateurs, il est finalement mieux pris en charge en termes de ce qui suit:

  • Les éditeurs WYSIWYG (tels que définis par ceux qui fournissent au moins un aperçu en direct) sont beaucoup plus susceptibles de prendre en charge Markdown.
  • Les services en ligne, tels que le Github ci-dessus, sont plus susceptibles d'accepter Markdown directement ou par l'utilisation d'add-ons 6 Markdown éditeurs qui jouent Nice avec Google Drive 6 Markdown éditeurs qui jouent Nice avec Google Drive Markdown est le format d'édition de texte de l'avenir. C'est plus simple, plus élégant et plus facile à utiliser que le HTML sans sacrifier beaucoup de puissance ou de flexibilité. Lire la suite .
  • 7 raisons de faucher votre CMS et d'envisager un générateur de site statique 7 raisons de faucher votre CMS et 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 encore être déroutants. Une autre alternative est un générateur de site statique. Lire la suite souvent soutenir Asciidoc avec des plugins, qu'ils supportent Markdown hors de la boîte est presque un.

  Êtes-vous prêt à essayer Asciidoc?

  Alors que Markdown est un choix de fait parmi les langages de balisage légers, Asciidoc contient tous les mêmes éléments, et même certains. Les extras d'Asciidoc exigent un certain temps pour apprendre, en mai mieux vous préparer à des projets d'écriture plus grands et plus complexes.

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