Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

À propos des wikis

Vous pouvez héberger la documentation de votre dépôt dans un wiki, afin que d’autres personnes puissent utiliser et contribuer à votre projet.

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 ».

Chaque dépôt sur GitHub.com comporte une section d’hébergement de la documentation, appelée wiki. Vous pouvez utiliser le wiki de votre dépôt afin de partager du contenu détaillé sur votre projet, par exemple pour décrire son utilisation, sa conception ou ses principes de base. Un fichier README décrit rapidement votre projet, alors qu’un wiki vous permet de fournir de la documentation supplémentaire. Pour plus d’informations, consultez « À propos des fichiers README ».

Avec les wikis, vous pouvez écrire du contenu comme vous pouvez le faire partout ailleurs sur GitHub. Pour plus d’informations, consultez « Bien démarrer avec l’écriture et la mise en forme sur GitHub ». Nous utilisons notre bibliothèque de balises open source pour convertir différents formats en HTML. Vous pouvez donc choisir d’écrire en Markdown ou dans tout autre format pris en charge.

Vous pouvez utiliser Markdown pour ajouter des expressions mathématiques rendues, des diagrammes, des mappages et des modèles 3D à votre wiki. Pour plus d’informations sur la création d’expressions mathématiques rendues, consultez « Écriture d’expressions mathématiques ». Pour plus d’informations sur la création de diagrammes, de mappages et de modèles 3D, consultez « Création de diagrammes ».

Si vous créez un wiki dans un dépôt public, le wiki est accessible au public. Si vous créez un wiki dans un dépôt privé, seules les personnes ayant accès au dépôt peuvent consulter le wiki. Pour plus d’informations, consultez « Définition de la visibilité du dépôt ».

Vous pouvez modifier des wikis directement sur GitHub, ou vous pouvez modifier des fichiers wiki localement. Par défaut, seules les personnes disposant d’un accès en écriture à votre dépôt peuvent apporter des changements aux wikis. Toutefois, vous pouvez autoriser tout le monde sur GitHub.com à contribuer à un wiki dans un dépôt public. Pour plus d’informations, consultez « Changement des autorisations d’accès pour les wikis ».

Remarque : Les moteurs de recherche n’indexent pas le contenu des wikis. Pour que votre contenu soit indexé par les moteurs de recherche, vous pouvez utiliser GitHub Pages dans un dépôt public.

Pour aller plus loin