Comment publier une page Github

Les pages Github permettent aux développeurs d’héberger gratuitement un site Web statique de leur projet. C’est l’une des installations clés de Github qui a rendu la maintenance de projets open source gratuits plus économique, en particulier pour les développeurs indépendants..

Bootstrap et Normalize.css sont quelques pages populaires de Github. Pour en créer un, il vous suffit de créer une nouvelle branche de votre référentiel de projet et de l'appeler. gh-pages. Publier la branche sur Github.

Une fois qu'il est en place, le site est accessible via l'URL qui est définie par rapport à votre nom d'utilisateur Github, ainsi que le nom du référentiel.. nom d'utilisateur .github.io / nom du référentiel.

Vous pouvez configurer un domaine personnalisé pour votre page Github. Nous avons montré comment faire dans notre précédent tutoriel.

Pages Github simplifiées

Créer une page Github est facile et rapide. Mais, il y a une petite mise en garde.

Prenez l’un des dépôts de démonstration de notre compte Github, le calendrier de l’avent, par exemple. Nous avons deux branches - maîtriser et gh-pages qui partagent exactement les mêmes branches de code.

Nous devons nous assurer que les codes en gh-pages sont toujours synchronisés avec le maîtriser branche.

Heureusement, Github a récemment simplifié les choses en supprimant les gh-pages exigence de branche. Nous pouvons maintenant nourrir le site directement à travers le maîtriser branche.

Pour ce faire, accédez à l’un de vos paramètres de référentiel Github. Faites défiler jusqu'à la section Pages Github et sélectionnez le branche maîtresse menu de la sélection.

Vous êtes tous ensemble et pouvez supprimer en toute sécurité le gh-pages branche du référentiel.

Serving Documentation

Certains projets tels que Bootstrap, Foundation ou Skeleton nécessitent une page de documentation. Et leurs développeurs servent aussi généralement ces pages de documentation à travers le gh-pages document.

Le référentiel a donc maintenant deux branches avec un ensemble de codes et d’objets complètement différents; l'un est le source principale, tandis que l'autre documentations hôte et aussi des extraits de code. Dans cette situation, vous pouvez souvent rencontrer des conflits de changement lors du basculement entre ces deux branches..

Avec cette nouvelle modification de Github, les développeurs peuvent désormais servir les pages de documentation via un nom de dossier. / docs / dans le maîtriser branche. Ensuite, allez sur les pages Github et sélectionnez l'option suivante, branche principale / dossier docs.

Maintenant, la maintenance du code source et de la documentation est devenue plus complexe.