Le Crieur est un outil en ligne de commande qui nécessite peu de dépendances (c-a-d de briques logicielles complexes)

Les pré-requis pour pouvoir utiliser le Crieur sont les suivants :

  1. Savoir créer des articles et corpus dans Stylo avec des métadonnées spécifiques ;
  2. Installer uv qui est un gestionnaire de paquets Python ne polluant pas votre ordinateur - vous trouverez des indications pour l'installer ici](https://docs.astral.sh/uv/getting-started/installation/) ;
  3. Disposer d'un terminal pour saisir des lignes de commande (et ne pas en avoir peur).

La première étape va être de créer des articles et des corpus Stylo. Ces derniers correspondent aux catégories (ou numéros dans le cadre de revues). Les articles doivent être créés avec les méta-données suivantes :

  • Date de publication
  • Titre et résumé
  • Mots-clés (optionnels)
  • Auteur·ices
  • Numéro de revue (correspondant au corpus)

Vous devez ensuite vous rendre sur votre page de Corpus dans Stylo et récupérer les identifiants de ceux-ci (par exemple 691dd81c6ddf3e0028foobar et 691dde946ddf3e002bazquux) accessibles grâce au bouton dédié.

Ouvrez un terminal, créez un dossier dédié à votre site et mettez vous dedans :

mkdir mon-site
cd mon-site

Tapez la commande suivante (bien sûr en remplaçant les identifiants avec les vôtres !) :

uv run --python 3.13 --with crieur crieur stylo 691dd81c6ddf3e0028foobar 691dde946ddf3e002bazquux

Cela va télécharger vos corpus.

Puis générez le site à partir du même dossier :

uv run --python 3.13 --with crieur crieur generate serve

Vous devriez avoir ceci qui s'affiche :

Generated meta-feed with 10 items.
Serving HTML book from `./public` to http://127.0.0.1:8000
Serving HTTP on :: port 8000 (http://[::]:8000/) ...

Vous pouvez alors aller sur http://127.0.0.1:8000 et vous devriez voir votre site apparaître.

Pour reprendre la main sur votre terminal, vous pouvez taper simultanément ctrl+c.

À partir de là, il est possible d'adapter la génération de votre site avec des options, par exemple vous pouvez relancer la commande avec une option de titre :

uv run --python 3.13 --with crieur crieur generate --title "Mon Site" serve

Ce qui devrait changer le titre de vos pages.

Vous remarquerez aussi que le générateur a créé un dossier public/ dans votre dossier (en plus d'autres artefacts comme une archive par corpus et un dossier sources/ mais c'est moins important). Ce dossier public/ contient l'intégralité de votre site que vous pouvez déposer chez un hébergeur web afin de rendre vos productions accessibles à toutes et tous.

Autre précision, lorsque vous éditez vos sources dans Stylo il vous faudra télécharger à nouveau vos sources avec la commande précédemment tapée en spécifiant l'option --force afin d'être certain·e d'avoir la toute dernière version de vos articles :

uv run --python 3.13 --with crieur crieur stylo 691dd81c6ddf3e0028foobar 691dde946ddf3e002bazquux --force

Et voilà ! Vous pouvez maintenant passer à la configuration avancée, par exemple pour adapter le thème de votre site.