Fichiers et Transclusion avec MultiMarkdown

Si l’option {{TOC}} permet remarquablement de créer un sommaire en une seule instruction MultiMarkdown et à l’emplacement souhaité — lire Construire un sommaire avec MultiMarkdown 4.7.1 — cela pose un seul problème quand on utilise de multiples fichiers liés et un fichier maître. En effet…

Tant que vous utilisez un seul document

Aucun souci, c’est un fichier unique et la balise {{TOC}} est à placer là où vous la souhaitez.

Si vous assemblez plusieurs documents

Là, ça se complique car il ne faut pas, sous peine de le retrouver en erreur dans Marked ⚑ (9,99 €), que cette balise {{TOC}} apparaisse…

• dans l’un des fichiers de travail liés

• dans le fichier maître qui lie tous ces fichiers de travail…!

Ah, là je sens poindre votre inquiétude…!!

Le balise {{TOC}} ne peut apparaitre que dans le fichier final, celui qui agrège tant le fichier maître que ses fichiers liés, la fameux fichier créé par l’instruction File/Transclude To New File…!

Cette instruction consiste à agréger tous les fichiers de travail en un unique fichier avec tous les éléments confondus et donc à retomber sur le cas précédent, un seul document… et je peux donc copier /coller ce que j’ai écrit précédemment : “Aucun souci, c’est un fichier unique et la balise {{TOC}} est à placer là où vous la souhaitez”.

Au fait, comment lier les fichiers…?

Dans un document maître en utilisant la même balise {{ }} avec le nom du fichier et son suffixe {{fichier.txt}} ou {{fichier.md}}. Chaque fichier fonctionne comme un feuillet qui est ordonné dans ce fichier maître…

À partir du moment où vous utiliser la fonction Transclusion qui va agréger vos fichiers sources, il n’y a plus de relation, pensez-y et corrigez en amont (ou corrigez au final dans ce fichier unique qui regroupera tout dont la balise {{TOC}}).

À suivre…

• Marked2 ⚑ (9,99 €)
• MultiMarkdown Composer ⚑ (4,99 €) version 2.x