Ajout de pages wiki
-
Sur GitHub, accédez à la page principale du référentiel.
-
Sous le nom de votre référentiel, cliquez sur Wiki.
-
Dans le coin supérieur droit de la page, cliquez sur Nouvelle page.
-
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.
-
Utilisez l’éditeur de texte pour ajouter le contenu de votre page.
-
Dans le champ « Modifier le message », entrez un message de validation décrivant le nouveau fichier que vous ajoutez.
-
Pour commiter les changements apportés au wiki, cliquez sur, Enregistrer la page.
Modification des pages wiki
-
Sur GitHub, accédez à la page principale du référentiel.
-
Sous le nom de votre référentiel, cliquez sur Wiki.
-
À 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.
-
Utilisez l’éditeur de texte pour modifier le contenu de la page.
-
Dans le champ « Modifier le message », entrez un message de validation décrivant le nouveau fichier que vous ajoutez.
-
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 Server, 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.