En pratique : du TOC prochainement dans MultiMarkdown…
Profitons du mode Split offert à l’occasion de la sortie de OSX El Capitan pour faire le tour d’une balise épatante arrivée avec la dernière version de MultiMarkdown (la 4.7.x), la balise TOC.
Cette derniere permet de créer le sommaire d’un document MultiMarkdown en une seconde…! Nul besoin de rechercher les entrées, le plan du fichier est immédiatement affiché à l’emplacement souhaité dans votre texte, toute modification de la structure de votre arborescence immédiatement reportée… Magique…!
Pour cela, je place côté MultiMarkdown Composer (4,99 €) (ici le bêta 3.x qui devrait être déclinée en une version de base et une version pro) et l’excellent Marked2 (9,99 €).
Juste le plaisir de découvrir que ces deux applications peuvent se partager un écran. Mais déjà un doute, MultiMarkdown Composer annonce en bas d’écran 42 mots et nul n’est besoin d’être grand clerc pour constater que Marked2 en affiche nettement plus, 1253 pour être précis.
En cause, les balises transclude propres à MultiMarkdown et qui permettent dans un fichier maître de lister une série de fichier liés avec, ou non, des portions de texte entre chaque lien dans ce même document maitre.
Pour imager l’usage de ces fichiers liés, nommons les fragments. Ces fichiers autonomes peuvent être de n’importe quel volume en terme de contenu et donc modifiables individuellement, vu qu’ils sont autonomes…! Seul le document maître rythme leur ordre.
Note : Cette capacité à enchaîner une série de feuillets est un peu ce que propose Ulysses (44,99 €).
Bref, pas la peine de vous faire un dessin, vous voilà avec un outil pratique pour rassembler une série de fichiers .md ou .txt issus de n’importe quel traitement de texte Markdown. Il suffit de les insérer dans ce fichier maître en employant la balise mon_fichier.txt, ce qui est pas trop compliqué à mémoriser.
**Rassembler en un seul fichier
MultiMarkdown Composer dispose d’une commande — File Transclusion — qui permet, à partir de ce fichier Maître, de rassembler en seul fichier, tous les documents (le fichier maître et tous les feuillets) en un seul fichier.
MultiMarkdown Composer génère sans efforts un fichier unique que je nomme dans cet exemple flux. Pour les plus attentifs, le nombre des mots du fichier texte n’est pas égal à celui l’aperçu dans Marked2. En cause, les mots contenus dans l’intitulé des URL dans le fichier texte, CQFD.
Comme le fichier est balisé en avec des niveaux #, il est facile de les lire tant dans MultiMarkdown Composer que sur Marked2.
Et c’est ici, Mesdames et Messieurs, que MultiMarkdown sort sa botte secrète…!
**et TOC…!
La version 4.7 de MultiMarkdown propose une nouvelle balise. Dans le fichier complet, dans ce flux, il suffit, à l’endroit propice d’ajouter TOC.
Comme vous pouvez le comprendre, c’est une balise fort intéressante. Seul point à prendre en compte, la continuité de l’arborescence. Pas question de passer d’un niveau ## à un ####.
Et pas de minis sommaires spécialisés au sein d’un même ouvrage. Si vous souhaitez en créer, il faudra recourir aux ancres. Pour mémoire, rappel du balisage des ancres : Titre précédé ou non, d’une indication de niveau de type ##. Et, en amont, dans une liste par exemple, le rappel de toutes les ancres souhaitées [Titre](#ancre).
Note de fin : je ne montre cette nouvelle balise que sous la v3 bêta de MultiMarkdown Composer, Brett Terpstra (le developpeur de Marked2) confirme que ce sera bien dans la prochaine mise à jour de sa chouette usine à rendus.
Bon, reste ensuite à attendre que cette version 4.7.1 de MultiMarkdown se diffuse chez les développeurs de traitements de texte Markdown et soit intégrée. Patience.
On vous le signalera de toute manière…!
– MultiMarkdown Composer (4,99 €) (version 2 actuelle et donc n’intégrant pas encore la gestion de sommaire avec la balise TOC)
– Marked2 (9,99 €)
