hideout-lastation.com
Paradis Pour Les Concepteurs Et Les Développeurs


Générer de 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!

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 au moins d'apprendre.

Il est possible de créer un fichier HTML brut vous-même et de simplement copier / coller le modèle à partir du guide d'installation de Docsify. Mais, je recommande de le faire dynamiquement, car cela fait gagner du temps - et n'est-ce pas vraiment le but?

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 un tas de 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.

Toutes les informations de configuration de base et les téléchargements de fichiers peuvent être trouvés sur GitHub, alors dirigez-vous là-bas si vous voulez donner un coup de feu.

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.

Cette application réveil vous forcer à rester éveillé

Cette application réveil vous forcer à rester éveillé

Faire la sieste du réveil est quelque chose que tout le monde fait car il vous permet d'attraper un peu plus de sommeil. Cependant, les snoozers chroniques ont tendance à rendre le but du réveil obsolète.Si vous, comme moi, avez besoin d'un réveil qui vous réveille de manière créative et qui est en quelque sorte «heavy duty» dans sa fonction, alors vous voudrez peut-être vérifier une application de réveil appelé I Can not Wake Up . À première v

(Conseils techniques et de conception)

Créer des spins et des chargeurs mono-élément avec CSSPIN

Créer des spins et des chargeurs mono-élément avec CSSPIN

Vous pouvez créer des choses incroyables avec CSS3, des champs de saisie personnalisés aux listes déroulantes et même des graphiques vectoriels . Ces techniques dépassent rapidement JavaScript, ce qui permet aux développeurs de créer de meilleures expériences utilisateurs.L'une des choses les plus délicates à construire est une animation spinner de chargement, mais l'animation CSS moderne rend même cela assez simple.Pour gagne

(Conseils techniques et de conception)