Générer la Documentation avec Des Fichiers Markdown à l'aide de Docsify - Tech-Tutoriel

Breaking

Post Top Ad

Générer la Documentation avec Des Fichiers Markdown à l'aide de Docsify

Si vous créez un plug-in gratuit, un framework ou un script open-source, vous aurez besoin de documentation. Il est crucial de documenter votre travail, à la fois pour votre santé mentale et pour aider les autres qui veulent apprendre votre ressource impressionnante.


Cependant, la création de documentation en ligne peut être très pénible. Heureusement, Docsify le rend plus facile en fournissant un générateur de documentation gratuit fonctionnant sur Markdown.

Ce n'est pas un générateur de site statique typique et il ne nécessite pas de pages HTML / CSS statiques. Au lieu de cela, il charge dynamiquement les fichiers Markdown et les affiche en tant que pages Web. Génial!


Voir Aussi: Comment Installer Des Outils Kali Linux Dans Son PC Windows

Consultez la page d'accueil de Docsify pour un aperçu de la mise en page, ainsi que d'autres détails de configuration.

Cela nécessite de créer vous-même le fichier index.html, qui peut ensuite être téléchargé sur des pages GitHub ou hébergé sur votre propre serveur. De là, vous venez d'écrire des fichiers Markdown pour chaque page et les utiliser comme vos documents principaux.

L'ensemble du processus est décrit en détail dans le guide de démarrage rapide, c'est probablement le meilleur endroit pour commencer. Tout cela peut se faire via npm, il est donc utile de connaître votre invite de commande ou tout au moins être prêt à apprendre.

Il est possible de créer vous-même un fichier HTML brut et de simplement copier / coller le modèle à partir du guide d'installation de Docsify. Mais, je recommande de le faire dynamiquement, car cela permet d'économiser beaucoup de temps.

Au fur et à mesure que vous apprenez le système Docsify, vous pouvez ajouter des fonctionnalités en utilisant Markdown ou HTML brut. Ces fonctionnalités comprennent une barre de navigation personnalisée et même votre propre page de couverture avec le logo de votre projet.

Docsify est même livré avec des thèmes gratuits si vous voulez travailler avec des mises en page pré-conçues. Ou, vous pouvez parcourir leur galerie de présentation pour voir quels projets utilisent Docsify pour leur documentation.


Voir Aussi: Comment Utiliser Google Comme Un Serveur Proxy En Deux Façons Différentes

Toutes les informations de configuration de base et les téléchargements de fichiers peuvent être trouvés sur GitHub.

Vous pouvez également voir une démo en direct sur la page de documentation principale de Docsify qui, bien sûr, fonctionne sur Docsify. Donc, si vous aimez cette mise en page Web, vous pouvez utiliser ce même modèle et l'exécuter à travers Docsify, 100% gratuit et open-source.