Dans ce tutoriel, vous allez créer le référentiel que vous allez utiliser tout au long de cette série. Vous allez créer un petit projet logiciel appelé stargazers-log. À la fin du parcours, vous planifiez le travail, écrivez du code, passez en revue les modifications et déployez votre code sur un site web en direct.
stargazers-log est un site web simple qui suit et affiche les dépôts que vous avez ajoutés aux favoris. Il vous aide à créer un catalogue personnel d’outils et d’exemples de code dont vous vous souciez. Mettre des dépôts en favori vous permet également de retrouver des projets plus tard et de témoigner votre appréciation aux responsables de la maintenance.
Remarque
Au fil de cette série, si vous utilisez GitHub Enterprise Cloud avec résidence des données ou GitHub Enterprise Server, vous devrez remplacer les références et les liens vers GitHub.com par l’URL dédiée de votre entreprise.
Logiciels requis
- Un compte sur votre GitHub Enterprise Server instance.
Qu’est-ce qu’un référentiel ?
Un référentiel est l’endroit où vous conservez du code et des fichiers pour un projet logiciel sur GitHub. Il stocke vos fichiers, effectue le suivi de chaque modification en tant que validation et donne aux collaborateurs un emplacement partagé pour travailler. La plupart des projets logiciels , d’une seule page web à une grande application, vivent dans leur propre dépôt.
Création de votre référentiel
Suivez ces étapes pour créer le référentiel pour cette série.
-
Dans votre instance GitHub Enterprise Serverle coin supérieur droit de n’importe quelle page, sélectionnez , puis cliquez sur Nouveau référentiel.
-
Utilisez le menu déroulant Propriétaire pour sélectionner votre compte personnel pour posséder le référentiel.
-
Dans le champ Nom du référentiel , tapez
stargazers-log. -
Dans le champ Description, tapez une courte description, telle que « Une liste des dépôts que j’ai ajoutés à mes favoris. »
-
Utilisez le menu déroulant Choisir une visibilité pour sélectionner Public afin de pouvoir publier votre projet logiciel sur un site en direct plus loin dans cette série.
-
Sélectionnez Ajouter README. Cela donne à votre dépôt un fichier de démarrage et un emplacement pour décrire votre projet logiciel.
-
Vous n’avez pas besoin d’ajouter un
.gitignoreou un fichier de licence pour ce projet logiciel, laissez donc ces options inchangées. -
Cliquez sur Créer un dépôt.
Ajout d’une page web de démarrage
Votre projet logiciel s’agrandit en une petite page web. Ajoutez donc un index.html fichier pour contenir son contenu.
-
Sur la page principale de votre
stargazers-logréférentiel, au-dessus de la liste des fichiers, cliquez sur , puis cliquez sur Créer un nouveau fichier. -
Dans le champ du nom de fichier, tapez
index.html. -
Dans l’éditeur de fichiers, ajoutez le contenu de démarrage suivant.
HTML <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>Stargazers log</title> </head> <body> <h1>Stargazers log</h1> <p>A log of the repositories I've starred.</p> </body> </html><!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>Stargazers log</title> </head> <body> <h1>Stargazers log</h1> <p>A log of the repositories I've starred.</p> </body> </html> -
Cliquez sur Valider les changements.
-
Dans la boîte de dialogue qui s’ouvre, conservez l’option par défaut pour valider directement dans la
mainbranche, puis cliquez sur Valider les modifications.
Ce que vous avez accompli
| Tâche | Résultat |
|---|---|
| Création d’un référentiel | Vous avez créé stargazers-log pour stocker votre projet logiciel sur GitHub. |
| Ajout d’un fichier README | Vous avez donné à votre projet logiciel un endroit pour se décrire. |
| Ajout d’une page web | Vous avez créé index.html comme point de départ de votre site. |
Étapes suivantes
- Maintenant que votre projet logiciel a une maison, planifiez le travail que vous souhaitez faire. Passez à Planification de votre travail.