Le Crieur vous permet de prendre totalement la main sur le thème de votre site. Cela nécessite d’avoir des compétences minimales en HTML et CSS.

Le Crieur a été pensé pour permettre un degré élevé de personnalisation graphique et organisationnelle de votre site, sans nécessiter de ressources économiques et de compétences techniques trop importantes. Cela est particulièrement important pour les revues qui ont leur propre identité, leurs besoins particuliers, et pour lesquelles l’uniformisation nécessaire pour la diffusion sur les plateformes est souvent source de frustration, comme nous l'expliquons ici.

Il est possible d'adapter l'enveloppe de votre site pour utiliser la charte graphique et le thème qui vous convient, ainsi que de potentiels plugins supplémentaires.

Pour cela, il faut modifier les options dans le fichier de configuration .toml de votre site, avant de le construire via la commande build.

Il y a deux options importantes :

  • statics-path qui permet d'ajouter un chemin vers des CSS, JS, images, etc de votre thème
  • templates-path qui permet de surcharger les templates utilisés sur ceux par défaut du Crieur

Vous devez retirer les # au début des lignes correspondantes de votre fichier de configuration et créer au même niveau que votre fichier .toml (ou ailleurs sur l'ordinateur, auquel cas il faut adapter les chemins dans le fichier .toml) les dossiers statics/ et templates correspondants (que vous pouvez renommer), en y plaçant les fichiers de templates et de statics personnalisés pour votre site.

Les templates utilisés sont consultables sur le dépôt du Crieur et utilisent le langage de template Jinja. Toutes les pages utilisent le même fichier commun appelé base.html comme modèle pour leur structure.

Vous pouvez par exemple télécharger ce fichier base.html et adapter le nom des références aux fichiers CSS que vous avez définis dans statics/ pour totalement changer l'apparence du site - par exemple un fichier custom.css, que vous pouvez appeler pour votre site en spécifiant, dans dans le bloc de code {% block imported_css %} dans le template base.html :

<link rel="stylesheet"
        href="{{ base_url }}statics/custom.css" />

Les possibilités de personnalisation sont aussi infinies que votre imagination !

Templates distants

Il est possible d’héberger votre thème sur un dépôt GitLab partagé et de récupérer dynamiquement ces fichiers lors de la génération du site avec le Crieur, au travers de la commande crieur template. Par exemple :

uv run --with crieur crieur templates --source-path blogs/blog-purple

Ici les templates vont être récupérés et déposés localement dans un dossier templates-git, il s’agira ensuite de pointer vers ces fichiers lors de la génération dans votre fichier .toml :

templates-path = "templates-git/blogs/blog-purple/templates" 
statics-path = "templates-git/blogs/blog-purple/statics"

Il est également possible de spécifier explicitement l’URL d’un autre dépôt, lors de la récupération des templates :

uv run --with crieur crieur templates --repo-url https://gitlab.huma-num.fr/vous/vos-templates/ --source-path chemin/vers-vos-templates

Ces options vous permettent de travailler avec des templates pré-conçus par d'autres ou de partager les vôtres à la communauté du Crieur 🤗.