Git vos PCB en ligne

La dernière fois, je vous ai montré comment créer un référentiel Git local autour de votre projet PCB. Cela seul vous fournit des sauvegardes locales, vous aidant à ne jamais perdre les modifications que vous apportez à vos fichiers et à toujours être en mesure de revoir l'historique de votre projet au fur et à mesure de son développement.

Cependant, une partie encore plus importante de l'utilité de Git est la possibilité de télécharger nos créations sur l'un des différents services d'hébergement de référentiel Git en ligne, et de le maintenir à jour à tout moment avec une seule commande shell. J'aimerais vous montrer comment télécharger votre projet sur GitHub et GitLab, en particulier !

résumer

Tout d'abord, récapitulons ce qui se passe dans la création d'un référentiel. Voici une séquence de commandes auxquelles vous pouvez vous référer - ces commandes ont été expliquées dans le dernier article, elles sont donc là au cas où vous auriez besoin d'une feuille de triche.

# configuration de l'identité - celles-ci sont publiques et peuvent être fausses git config --global user.name "John Doe" git config --global user.email johndoe@example.com # initialisation d'un dépôt git init. branche git -M main # avant votre premier commit, vous ajoutez votre fichier .gitignore # ensuite, ajoutez des fichiers si nécessaire - utilisez 'git status' pour vous enregistrer git add board.kicad_pcb [...] git add LISEZMOI.md # ou, étant donné le bon .gitignore, vous pouvez simplement faire ceci : git add . # placez vos modifications ajoutées dans un commit git commet # un éditeur s'ouvrira pour écrire votre message de commit

Et si vous n'avez pas de projet PCB sous la main ? Voici un référentiel avec une carte Jolly Wrencher SAO que vous pouvez télécharger sous forme d'archive .zip via l'interface GitHub. C'est déjà un référentiel - si vous souhaitez tester ces commandes mais que vous n'avez pas encore de projet PCB à portée de main, vous pouvez librement pousser ce référentiel vers votre propre compte GitHub ou GitLab en tant qu'exercice de test ! Si vous souhaitez recommencer à zéro et pratiquer également la partie "création du référentiel", supprimez simplement le répertoire .git à la racine du projet.

Quelle est la différence?

GitHub et GitLab agissent tous deux comme interfaces pour votre référentiel. Ils fournissent également un endroit supplémentaire pour vider votre code - vous pouvez également simplement utiliser un lecteur flash ou un serveur avec un compte SSH. Mais l'hébergement vous donne une interface Web où d'autres personnes peuvent jeter un œil à votre code et à son README afin qu'elles sachent si votre code les intéresse, vous posent des questions, partagent leurs propres modifications de code avec vous, téléchargent tous les fichiers supplémentaires associés (comme gerbers) que vous avez peut-être téléchargés et faire une myriade d'autres choses utiles. Vous n'avez besoin d'utiliser aucune de ces fonctionnalités - vous pouvez toutes les désactiver, mais elles sont là dès qu'elles peuvent vous être utiles.

GitHub est la plate-forme la plus connue, et elle a été un pionnier à bien des égards. Une grande partie des actions de piratage logiciel et matériel à petite échelle se déroulent sur GitHub, et de nombreux référentiels auxquels vous pourriez être intéressé à contribuer seront également là. Il existe de nombreux didacticiels qui fonctionnent avec GitHub, et des outils amusants comme cette interface utilisateur GitHub en ligne de commande que nous avons couverte.

GitLab est une plate-forme moins connue mais non moins utile que vous pouvez utiliser pour votre code, vos PCB et vos documents, et elle présente des avantages importants par rapport à GitHub. Tout d'abord, le logiciel GitLab lui-même est entièrement open-source, vous pouvez donc l'auto-héberger, et beaucoup le font. Ce n'est pas le seul service auto-hébergé, mais c'est l'un des plus importants et des plus complets. Tout comme WordPress étant à la fois une suite logicielle et une plate-forme, vous n'avez pas à l'auto-héberger. Si vous voulez un endroit où héberger vos référentiels, vous pouvez aller sur gitlab.com et créer un compte, tout comme les gens le font avec GitHub.