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.