Dans cette présentation, je vous guiderai à travers toutes les étapes nécessaires pour créer et héberger des documentations riches en fonctionnalités et localisées (et même des sites web) en utilisant MkDocs + Github Pages.
MkDocs est un projet célèbre alimenté par Python et utilisé pour créer de la documentation pour de nombreux projets. Il est basé sur du Markdown et supporte les extensions Markdown, les thèmes personnalisés et les plugins pour étendre ses capacités de rendu.
Mais il ne supportait pas la construction de documentations en plusieurs langues et c’était une fonctionnalité souhaitée depuis 2014…
Après avoir construit des documentations à l’aide de MkDocs, j’ai décidé de l’utiliser pour passer mon site web et mon blog de WordPress à un générateur de pages statiques. J’ai donc relevé le défi de contribuer au support de la localisation au projet MkDocs car j’en avais besoin et que cela pouvait bénéficier à la communauté.
Après 2 mois de travail, 175 commentaires et 85 commits sur 55 fichiers, je suis heureux que mon PR ait été fusionné et fasse partie de la version 1.2 de MkDocs.
J’ai beaucoup appris en cours de route et je voulais partager mon expérience et une marche à suivre complète pour que vous soyez prêts et heureux d’utiliser ces nouvelles fonctionnalités de MkDocs !