Une petite contribution à la documentation de Zola

blogzola

Parfois après une longue recherche pour mettre en place une configuration ou corriger un bug, on se dit qu'il faut garder une note sur ce que l'on a fait.

Un truc que j'adore avec les projets libres ou open source c'est qu'il est parfois plus rapide de faire une pull request sur la documentation officielle du projet que de se garder des notes. C'est aussi bien plus efficace et en plus tout le monde peut en bénéficier.

Avec Zola, j'ai butté sur la configuration de la taxonomie. En effet quand on fait cette configuration, on a tendance à mettre la directive pour déclarer la taxonomie en fin de fichier. Si on fait cette erreur la directive ne se retrouve pas dans la section principale du fichier de configuration, mais dans la section extra. Le résultat est que Zola ne construit plus les pages et crache un beau message d'erreur.

Bref, en cinq minutes, j'ai fait cette pull request sur le projet Zola histoire d'éviter cette erreur aux autres utilisateurs. Elle a été "merged" très rapidement et fait partie maintenant de la documentation.