tobogganSe connecter

Gists

Un gist est un extrait : quelques fichiers et une description, à part de tes dépôts. Chacun est un dépôt Git à lui : son historique, ce sont ses révisions, et tu peux le cloner, y pousser et le forker.

En faire un

Sous Gists dans la barre, Nouveau gist : une description, puis chaque fichier, un nom et son texte (un fichier sans nom s’appelle gistfile1.txt). Ajouter un fichier donne une rangée de plus ; vide le nom et le texte d’une rangée pour retirer ce fichier. En ligne de commande :

tob gist create notes.md wax.sh -d "Notes de fartage"
echo 'bonjour' | tob gist create -f bonjour.txt

Secret ou public

Un gist est secret à moins que tu choisisses public. Un gist secret n’est listé nulle part — ni sur ta page, ni dans la liste publique — mais quiconque a son lien peut le lire et le cloner : partage le lien comme tu partagerais le texte lui-même. Un gist secret peut devenir public ; un gist public ne redevient pas secret, puisqu’il a déjà été listé et cloné.

Le modifier, et son historique

Modifier sur la page de ton gist : chaque enregistrement est une révision, et Ses révisions les liste, chacune lisible telle qu’elle était. Si le gist a changé pendant que tu le modifiais, l’enregistrement est refusé et ton texte gardé. Par Git :

tob gist clone <id>      # ou git clone https://<hôte>/gists/<id>.git

Toi seul pousses dans ton gist, au plus 10 Mio à la fois ; sa branche, main, ne peut pas être supprimée. Un gist montre ses fichiers du premier niveau ; un dossier poussé dedans est gardé mais pas montré.

Étoiles, forks et commentaires

Toute personne connectée peut étoiler un gist (tes étoiles sont sous /gists/starred), le commenter et le forker : le fork est un gist à toi, son historique celui de l’original, aussi secret ou public qu’il l’était.