Si vous avez déjà utilisé Github auparavant, vous savez que le téléchargement de fichiers depuis la plate-forme n’est pas immédiatement clair. C'est l'une des plates-formes les plus compliquées, car elle n'est pas directement destinée au partage de fichiers direct, mais au développement. Certes, l’un des gros avantages de Github est que tous les référentiels publics sont open source et que les utilisateurs sont encouragés à contribuer. Il existe des référentiels privés, mais ils sont généralement utilisés à des fins de développement dans les entreprises qui ne veulent pas que leur code soit vu. par le public. Github, cependant, gère toujours le téléchargement de fichiers différemment des autres endroits.
Donc, si vous ne savez pas exactement comment télécharger des fichiers de projets (ou de projets entiers) à partir de Github, nous allons vous montrer comment. Commençons.
Télécharger un fichier
La plupart des dépôts publics peuvent être téléchargés gratuitement, sans même un compte utilisateur. En effet, les référentiels publics sont considérés comme des bases de code ouvertes. Cela dit, à moins que le propriétaire de la base de code ne coche une case, sa base de code peut être téléchargée sur votre ordinateur, dans un fichier .zip.
Ainsi, si vous accédez à une base de code publique - telle que la calculatrice de conseil que j'ai construite -, vous remarquerez que dans le coin supérieur droit se trouve un bouton vert indiquant Cloner ou Télécharger . Cliquez sur le bouton, puis dans le menu déroulant, sélectionnez Download ZIP . Tous les fichiers commenceront à se télécharger sur votre ordinateur, généralement dans votre dossier Téléchargements.
Ensuite, ouvrez votre dossier Téléchargements sur votre ordinateur et recherchez le fichier ZIP. Vous aurez envie de cliquer dessus avec le bouton droit de la souris et de choisir l'option «Décompresser» ou «Décompresser», puis de sélectionner un dossier dans lequel vous voulez que les fichiers se retrouvent.
Enfin, accédez au dossier sélectionné et vous y trouverez tous les fichiers Github que nous avons téléchargés!
C'est une base de code assez petite, ne contenant que quelques fichiers. Si vous accédez au référentiel JavaScript 30 de Wes Bos sur Github, vous remarquerez que - puisqu'il s'agit d'un référentiel public - il peut être téléchargé de la même manière.
Il existe un meilleur moyen de “télécharger” des fichiers
Bien que la méthode décrite soit simple et directe, elle est tout à fait optimale pour afficher simplement les fichiers de code, sans expérimenter. Si vous envisagez de télécharger des fichiers Github pour expérimenter, le meilleur moyen serait de «bifurquer» le projet. Un fork est simplement votre propre copie d'un référentiel.
La création d'un référentiel présente de nombreux avantages. Il vous donne votre propre copie sur votre compte Github qui vous permet d'expérimenter librement des modifications sans affecter le projet d'origine. Par exemple, vous pouvez trouver un bug dans ma calculatrice de pourboires ou vouloir ajouter vos propres fonctionnalités. Vous pouvez donc «brancher» ma calculatrice de pourboires en créant une copie sur votre compte Github. Ici, vous pouvez modifier le code et le tester sans affecter le projet d'origine, car il s'agirait de votre copie ou de votre "fork". La plupart du temps, les forks sont utilisés pour proposer des modifications au projet de quelqu'un d'autre, comme la correction d'un bogue ou l'ajout de une fonctionnalité comme nous l'avons mentionné.
Alors, comment pouvez-vous créer un référentiel public? C'est en fait assez facile. Avant de commencer, vous devez créer un compte Github gratuit, car vous aurez besoin d'un emplacement pour stocker votre fourche. Vous pouvez vous rendre sur www.github.com et le faire maintenant.
Une fois votre compte créé, vous pouvez créer un référentiel public avec votre compte. Par exemple, vous pouvez vous rendre dans le référentiel public du cours de formation 30 jours de JavaScript de Wes Bos. Dans le coin supérieur droit, vous verrez un bouton indiquant Fork. Cliquez sur le bouton.
Cela peut prendre quelques secondes à quelques minutes, mais Github clonera ou "transférera" ce projet sur votre propre compte GitHub. Une fois cela fait, il vous montrera immédiatement le projet sous votre nom d'utilisateur Github. Pour vérifier, vous pouvez cliquer sur l'icône de votre profil dans la barre de navigation en haut à droite, puis sélectionner l'option qui dit Vos référentiels . Dans votre liste de référentiels, vous devriez voir la base de code du cours JavaScript 30.
Désormais, vous pouvez modifier et expérimenter le code à votre guise, sans que cela n'affecte les fichiers de projet d'origine du propriétaire d'origine. Si vous modifiez du code, corrigez un bogue ou ajoutez une nouvelle fonctionnalité, vous pouvez créer un élément appelé «demande d'extraction» permettant de discuter de cette modification. Si le propriétaire du projet d'origine aime la modification (et qu'elle fonctionne correctement), elle peut être fusionnée dans la base de code d'origine en tant que code de production.
Fermeture
Comme vous pouvez le constater, le téléchargement de fichiers et de projets entiers depuis Github est en fait assez simple. En quelques minutes à peine, vous pouvez télécharger tout un projet sur votre ordinateur ou même le transférer sur votre propre compte Github. Il ne faut pas grand-chose pour jouer avec le code dans votre fork pour voir ce qui affecte quoi, et finalement, vous pourrez peut-être même créer votre première demande d'extraction! Bonne codage!