TowSty

TowSty est le produit de la collaboration entre Josselin Morvan, Antoine Fauchié et Julien Dehut pour résoudre les problèmes posés par le site EcriSoi. Il s’agit de permettre au site d’accepter de nouveaux contenus tout en conservant les anciens. Pour un certain nombre de raisons qu’il a exposé dans son article sur Programming Historian (en cours de publication), Josselin Morvan a décidé de le développer en Julia.

L’idée est alors de s’appuyer sur Stylo pour la rédaction. Cet éditeur possède en effet une API GraphQL complète qui autorise des interactions fines avec les contenus rédigés. TowSty récupère alors le contenu de Stylo et le rend accessible sous différents formats. Il permet de produire un site qualifié d’hybride dont la mise à jour se fait en ligne, mais aussi un site statique dont il existe déjà de nombreux autres exemples.

L’écriture de TowSty veille à privilégier du code natif afin de ne pas être trop dépendant. En ce sens, une des exceptions est Lunr utilisée pour obtenir des fonctionnalités de recherche avancées.

Au cours de son développement, TowSty s’est affranchi d’EcriSoi pour permettre plus généralement la génération de site depuis Stylo. La logique par défaut est de construire un site depuis un Espace de travail unique dont les corpus deviennent des sections. Chaque page rattachée à un corpus appartient automatiquement à une des sections du site une fois celui-ci publié. Stylo permet donc de produire le contenu et la structure du site.

Il est également possible de paramétrer le routage des informations à travers un fichier spécifique et facultatif pour articuler finement les pages et les sections. TowSty gère aussi le cas de pages non rattachées à des corpus qui, si elles sont précisées avec une syntaxe spécifique, créent automatiquement des sections.

Le contenu structuré, dont l’entête YAML fait normalement partie intégrante, peut contenir des erreurs de syntaxe. TowSty en tient compte afin que le site soit toujours accessible.

Lien GitLab.

Vie du projet

Le site de la Chaire est produit intégralement avec TowSty. Mais ce n’est pas le seul.
EcriSoi, Passim et le carnet Saint-Gelais ont été progressivement déployés.