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…
J’ai payé mon obole annuelle à app.net… ce réseau fort bien fait, élégant, peut être perçu comme un équivalent de Twitter qui aurait échoué mais sa destination initiale était autre, orientée vers la communication entre développeurs.
Ici, pas de vente de vos données, un espace plus large, la possibilité de récupérer à tout instant son contenu en l’exportant, de détruire son compte en quelques clics…
Bref, un endroit idéal pour écrire avec moins de bruit…
IFTTT assure depuis des années ma présence sur ce réseau en informant quelques lecteurs de la disponibilité de mes billets.
En conversation privée, 2048 signes sont disponibles, de quoi pouvoir échanger bien des infos. Et même une amorce de coloration syntaxique est disponible pour les éléments glissés dans un message.
Alors, oui, cela ne fait pas l’actualité. Si vous voulez touchez du monde, Facebook ou Twitter vous seront plus utiles.
App.net est comme un salon de thé où les habitués passent une tête, échangent. Et il est clair que les utilisateurs visibles sont de moins en moins nombreux !
Du coup, je me demande si, paradoxalement, ce n’est pas le moment d’y revenir tranquillement tant c’est calme. Car, de fait, ce sont bien des conversations et, surtout, beaucoup de discussions en tête à tête, de salons privés, voir de la diffusion de contenus…
Bien entendu, il y a quelques bot qui ne font que prendre les 128 caractères de Twitter pour les balancer sur app.net… Mais ici, il est facile de bloquer ou même de muter (pas buter…!) des emmerdeurs…
Le plus étonnant est que certains développeurs continuent à préparer de nouvelles versions de leurs produits pour iOS 9. Si hAppy est toujours en ordre de marche, c’est l’excellent Riposte qui est en bêta. Et, cette fois-ci, sous iPad.
Pour mémoire, Redécouvrir APN et ses 256 caractères
Alors, totalement mort ?
Étonnamment, mais sous toutes réserves (!), non. Enfin pas encore. Surtout si d’aucuns contribuent, même modestement, au bon fonctionnement de ce réseau.
Autant j’ai essayé nombre de solutions (une bonne dizaine), autant je garde le lien avec app.net. J’en avais parlé ici il y a un an…
Bref, ne venez pas, il n’y a rien à vendre !
Bon, c’est n’est plus au stade des projets, c’est bien dans la dernière version de MultiMarkdown, c’est déjà utilisable dans la version bêta 3 de MultiMarkdown Composer
Et l’on peut espérer que cela sera dans tous les bons outils, de Drafts 4 à Editorial en passant par iA Writer ou Byword prochainement. Bref, dans tous les produits de traitement de texte supportant MultiMarkdown.
Pour résumer, il fallait jusqu’à présent réaliser des ancres comme <a name="ancre">Titre</a> précédé ou non, d’une indication de niveau de type ##. Puis lister quelque part en amont, dans une liste par exemple, un rappel de toutes ces ancres, de la manière suivante… [Titre](#ancre).
Un peu compliqué mais souple, permettant d’organiser d’éventuels sommaires thématiques, voir de ne pas suivre l’ordre des niveaux.
Avec la prochaine version de MultiMarkdown, vous écrirez vos niveaux # Titre 1, ## Titre 2 sans vous soucier d’ajouter une ancre…

Et, à l’emplacement choisi par vous dans votre texte, juste cette instruction {{TOC}}…!
Attention, cela prend en compte tous les niveaux de votre texte et il est indispensable que les niveaux soient continus, que vous ne passiez pas du niveau 1 au niveau 3 sans ajouter un niveau 2…!
Bon, ces deux dispositifs fonctionnent mais, comme d’habitude, ces derniers ajouts de MultiMarkdown sont à vérifier avec vos outils de productions quotidien… qui, comme d’habitude, suivront lentement. Ou pas…!
À suivre…