Création de gists

À propos des gists

Les gists fournissent un moyen simple de partager des extraits de code avec d’autres personnes. Chaque gist est un dépôt Git, ce qui signifie qu’il peut être dupliqué et cloné. Si vous êtes connecté à GitHub lorsque vous créez un gist, il est associé à votre compte et vous le verrez dans votre liste de gists lorsque vous accéderez à votre page d’accueil gist.

Les gists peuvent être publics ou secrets. Les gists publics s’affichent dans Découvrir, où les utilisateurs peuvent parcourir de nouveaux gists au fur et à mesure qu’ils sont créés. Ils peuvent également faire l’objet d’une recherche. Vous pouvez donc les utiliser si vous souhaitez que d’autres personnes trouvent et voient votre travail.

Les gists secrets ne s’affichent pas dans Découvrir et ne peuvent pas faire l’objet d’une recherche, sauf si vous êtes connecté et que vous êtes l’auteur du gist secret. Les gists secrets ne sont pas privés. Si vous envoyez l'URL d'un gist secret à un ami, il pourra le voir. Toutefois, si quelqu’un que vous ne connaissez pas découvre l’URL de votre gist, il sera également en mesure de le voir. Si vous avez besoin de garder votre code à l’écart des yeux indiscrets, vous souhaiterez peut-être créer un dépôt privé à la place.

Après avoir créé un gist, vous ne pouvez pas le convertir de public à secret. Toutefois, un gist secret peut être rendu public en modifiant le gist et en mettant à jour la visibilité sur public.

Vous recevez une notification quand :

• Vous êtes l’auteur d’un gist.
• Quelqu’un vous mentionne dans un gist.
• Vous vous abonnez à un gist, en cliquant sur S’abonner en haut de n’importe quel gist.

Vous pouvez épingler des gists à votre profil afin que d’autres personnes puissent les voir facilement. Pour plus d’informations, consultez « Épinglage d’éléments à votre profil ».

Vous pouvez découvrir des gists publics que d’autres personnes ont créés en accédant à la page d’accueil gist et en cliquant sur Tous les gists. Vous accéderez alors à une page de tous les gists triés et affichés d’après leur date de création ou de mise à jour. Vous pouvez également rechercher des gists par langue avec Recherche Gist.

Les gists étant des dépôts Git, vous pouvez afficher leur historique de commit complet, avec les différences. Vous pouvez également dupliquer ou cloner des gists. Pour plus d’informations, consultez « Duplication et clonage des gists ».

Vous pouvez télécharger un fichier ZIP d’un gist en cliquant sur le bouton Télécharger le fichier ZIP en haut du gist. Vous pouvez incorporer un gist dans n’importe quel champ de texte qui prend en charge JavaScript, tel qu’un billet de blog. Pour obtenir le code incorporé, cliquez sur l’icône du Presse-papiers en regard de l’URL incorporée d’un gist. Pour incorporer un fichier de gist spécifique, ajoutez l’URL Incorporée avec ?file=FILENAME.

Les gists prennent en charge le mappage des fichiers GeoJSON. Ces cartes sont affichées dans des gists incorporés, ce qui vous permet de partager et d’incorporer facilement des cartes. Pour plus d’informations, consultez « Travailler avec des fichiers non basés sur du code ».

Création d’un gist

Suivez la procédure ci-dessous pour créer un gist.

1. Connectez-vous à GitHub.

2. Accédez à votre page d’accueil gist.

3. Si vous le souhaitez, dans le champ « Description gist », tapez une description pour votre gist.

4. Dans le champ « Nom de fichier incluant l’extension », tapez un nom de fichier pour votre gist, y compris l’extension de fichier.

5. Dans le champ Contenu du fichier, tapez le texte de votre gist.

6. Si vous le souhaitez, pour créer un gist public, cliquez sur , puis cliquez sur Créer un gist public.

   

7. Cliquez sur Créer un gist secret ou Créer un gist public.