Création de fichiers

Vous pouvez créer des fichiers directement sur GitHub dans n’importe quel dépôt auquel vous avez accès en écriture.

Lors de la création d’un fichier sur GitHub, tenez compte des points suivants :

  • Si vous essayez de créer un fichier dans un dépôt auquel vous n’avez pas accès, nous dupliquons le projet dans votre compte personnel et vous aidons à envoyer une demande de tirage (pull request) au dépôt d’origine une fois votre modification commitée.
  • Les noms de fichiers créés par le biais de l’interface web ne peuvent contenir que des caractères alphanumériques et des traits d’union (-). Pour utiliser d’autres caractères, créez et commitez les fichiers localement, puis poussez-les vers le dépôt sur GitHub.

Avertissement : N’appliquez jamais git add, commit ni push sur des informations sensibles pour un dépôt distant. Les informations sensibles peuvent être, sans s’y limiter :

Pour plus d’informations, consultez « Suppression de données sensibles dans un dépôt ».

  1. Dans GitHub.com, accédez à la page principale du dépôt.

  2. Dans votre dépôt, accédez au dossier dans lequel vous souhaitez créer un fichier.

  3. Au-dessus de la liste de fichiers, sélectionnez le menu déroulant Ajouter un fichier , puis cliquez sur Créer un fichier.

    Vous pouvez également cliquer sur dans l’arborescence de fichiers à gauche.

    Capture d’écran de la page principale du référentiel. Au-dessus de la liste des fichiers, un bouton, intitulé « Ajouter un fichier », est indiqué en orange foncé. Dans l’arborescence de fichiers du dépôt, un bouton, avec l’icône du signe plus, est également encadré en orange foncé.

  4. Dans le champ du nom de fichier, tapez le nom et l’extension du fichier. Pour créer des sous-répertoires, tapez le séparateur de répertoire /.

  5. Dans la zone de texte de contenu du fichier, tapez le contenu du fichier.

  6. Pour passer en revue le nouveau contenu, au-dessus du contenu du fichier, cliquez sur Aperçu.

Capture d’écran d’un fichier en mode d’édition. Au-dessus de la zone de texte permettant de modifier le contenu du fichier, un onglet intitulé « Aperçu » est indiqué en orange foncé.

  1. Cliquez sur Valider les modifications...

  2. Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Création d’une validation avec plusieurs auteurs ».

  3. Si vous avez plusieurs adresses e-mail associées à votre compte sur GitHub.com, cliquez sur le menu déroulant d’adresses e-mail et sélectionnez l’adresse e-mail à utiliser comme adresse e-mail de l’auteur Git. Seules les adresses e-mail vérifiées apparaissent dans ce menu déroulant. Si vous avez activé la confidentialité de l’adresse e-mail, <username>@users.noreply.github.com est l’adresse e-mail par défaut de l’auteur de commit. Pour plus d’informations, consultez « Définition de votre adresse e-mail de commit ».

    Capture d’écran d’une demande de tirage GitHub montrant un menu déroulant avec des options permettant de choisir l’adresse e-mail de l’auteur du commit. octocat@github.com est sélectionné.

  4. Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « Création d’une demande de tirage ».

    Capture d’écran d’une demande de tirage GitHub montrant une case d’option permettant de commiter directement dans la branche main ou de créer une branche. Une nouvelle branche est sélectionnée.

  5. Cliquez sur Valider les modifications ou Proposer des modifications.