Skip to main content

Ajout ou modification de pages wiki

Vous pouvez ajouter et modifier des pages wiki directement sur GitHub Enterprise Cloud, ou localement à l’aide de la ligne de commande.

Les wikis sont disponibles dans les dépôts publics avec GitHub Free et GitHub Free pour les organisations, et dans les dépôts publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server. Pour plus d’informations, consultez « Produits de GitHub ».

Ajout de pages wiki

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. Sous le nom de votre référentiel, cliquez sur Wiki. Lien du menu Wiki
  2. Dans le coin supérieur droit de la page, cliquez sur Nouvelle page. Bouton de nouvelle page wiki
  3. Si vous le souhaitez, pour écrire dans un autre format que le format Markdown, utilisez le menu déroulant Mode d’édition, puis cliquez sur un autre format. Sélection du langage de balises des pages wiki
  4. Utilisez l’éditeur de texte pour ajouter le contenu de votre page. Interface WYSIWYG du wiki
  5. Tapez un message de commit décrivant le nouveau fichier que vous ajoutez. Message de commit relatif au wiki
  6. Pour commiter les changements apportés au wiki, cliquez sur, Enregistrer la page.

Modification des pages wiki

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. Sous le nom de votre référentiel, cliquez sur Wiki. Lien du menu Wiki
  2. À l’aide de la barre latérale du wiki, accédez à la page à changer. Dans le coin supérieur droit de la page, cliquez sur Modifier. Bouton de modification de page wiki
  3. Utilisez l’éditeur de texte pour modifier le contenu de la page. Interface WYSIWYG du wiki
  4. Tapez un message de commit décrivant vos changements. Message de commit relatif au wiki
  5. Pour commiter les changements apportés au wiki, cliquez sur, Enregistrer la page.

Ajout ou modification de pages wiki localement

Les wikis font partie des dépôts Git. Vous pouvez donc leur apporter des changements localement, et les pousser vers votre dépôt à l’aide d’un workflow Git.

Clonage de wikis sur votre ordinateur

Le contenu de chaque wiki est clonable facilement sur votre ordinateur. Une fois que vous avez créé une page initiale sur GitHub Enterprise Cloud, vous pouvez cloner le référentiel sur votre ordinateur avec l’URL fournie :

$ git clone https://github.com/YOUR_USERNAME/YOUR_REPOSITORY.wiki.git
# Clones the wiki locally

Une fois que vous avez cloné le wiki, vous pouvez ajouter de nouveaux fichiers, modifier des fichiers existants et commiter vos changements. Vous et vos collaborateurs pouvez créer des branches quand vous travaillez sur des wikis. Toutefois, seuls les changements poussés vers la branche par défaut sont mis en production et accessibles à vos lecteurs.

À propos des noms de fichiers wiki

Le nom de fichier détermine le titre de votre page wiki, alors que l’extension de fichier détermine le mode d’affichage du contenu de votre page wiki.

Les wikis utilisent notre bibliothèque de balises open source pour convertir les balises. Ainsi, le convertisseur à utiliser est déterminé en fonction de l’extension d’un fichier. Par exemple, si vous nommez un fichier foo.md ou foo.markdown, le wiki utilise le convertisseur Markdown, alors qu’un fichier nommé foo.textile entraîne l’utilisation du convertisseur Textile.

N’utilisez pas les caractères suivants dans les titres de vos pages wiki : \ / : * ? " < > |. Les utilisateurs de certains systèmes d’exploitation ne peuvent pas utiliser les noms de fichiers contenant ces caractères. Veillez à écrire votre contenu à l’aide d’un langage de balises qui correspond à l’extension, sinon votre contenu ne s’affichera pas correctement.