Comment télécharger des fichiers depuis GitHub

Si vous avez déjà utilisé GitHub auparavant, vous savez qu'il n'est pas immédiatement clair comment télécharger des fichiers à partir de la plate-forme. C'est l'une des plates-formes les plus compliquées, car elle n'est pas directement destinée au partage direct de fichiers, mais plutôt au développement. Certes, l'une des grandes choses à propos de GitHub est que tous les référentiels publics sont open source, et les gens sont encouragés à contribuer - il existe des référentiels privés, mais ceux-ci sont généralement utilisés à des fins de développement au sein d'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 à partir de projets (ou de projets entiers) à partir de GitHub, nous allons vous montrer comment. Commençons.

Télécharger un fichier depuis GitHub

La plupart des référentiels 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 open source. Cela dit, à moins que le propriétaire de la base de code ne coche une case contraire, sa base de code peut être téléchargée sur votre ordinateur, emballée dans un fichier .zip.

1. Donc, si vous accédez à une base de code publique - telle que ce calculateur de pourboires que j'ai construit - vous remarquerez que dans le coin supérieur droit se trouve un bouton vert qui dit Cloner ou télécharger, clécher sur le bouton.
2. Ensuite, dans la liste déroulante, sélectionnez Télécharger ZIP. Tous les fichiers commenceront à se télécharger sur votre ordinateur, généralement dans votre dossier Téléchargements.
3. Ensuite, ouvrez votre dossier Téléchargements sur votre ordinateur et recherchez le fichier ZIP. Vous voudrez faire un clic droit dessus et choisir l'option qui dit Extraire tout…, Décompressez, ou Décompresser, puis sélectionnez un dossier dans lequel vous souhaitez que les fichiers se terminent.
4. Enfin, accédez au dossier sélectionné et vous y trouverez tous ces fichiers Github que nous avons téléchargés !

C'est une base de code assez petite, avec seulement quelques fichiers dedans. 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.

Téléchargement de fichiers GitHub à l'aide de commandes

Alternativement, vous pouvez facilement cloner un fichier ou un référentiel à l'aide de quelques commandes simples sur GitHub. Pour que cela fonctionne, vous devez installer les outils Git. Nous allons installer le même calculateur de pourboire à partir de la ligne de commande dans cette démo.

1. Copiez l'URL à partir de votre barre d'adresse ou du même menu à partir duquel vous avez téléchargé le fichier zip.
2. Ouvrez Git Bash, tapez "Téléchargements de CD" et appuyez sur Entrer. Cela vous mènera au dossier Téléchargements dans la fenêtre de commande, vous pouvez également saisir l'emplacement du fichier dans lequel vous souhaitez enregistrer le fichier.
3. Maintenant, tapez "git clone //github.com/bdward16/tip-calculator.git" et frapper Entrer.
4. En utilisant cette méthode, les fichiers sont automatiquement décompressés lors du téléchargement.

Il existe une meilleure façon de télécharger des fichiers

Bien que la manière que nous avons décrite soit simple et directe, elle est la plus optimale pour simplement afficher les fichiers de code, pas pour expérimenter. Si vous envisagez de télécharger des fichiers GitHub pour expérimenter, le meilleur moyen serait de « forker » le projet. Un fork est simplement votre propre copie d'un référentiel.

Le fork d'un référentiel présente un certain nombre d'avantages. Il vous donne votre propre copie sur votre compte GitHub qui vous permet d'expérimenter librement les modifications sans affecter le projet d'origine. Par exemple, vous pourriez trouver un bogue dans mon calculateur de pourboires ou vouloir ajouter vos propres fonctionnalités. Ainsi, vous pouvez « forker » mon calculateur de pourboires, en créant une copie sur votre compte GitHub. Ici, vous pouvez modifier le code et l'expérimenter sans affecter le projet d'origine, car ce serait votre copie ou « fork ».

Le plus souvent, les forks sont utilisés pour proposer des modifications au projet de quelqu'un d'autre, comme corriger un bogue ou ajouter une fonctionnalité comme nous l'avons mentionné.

Alors, comment forkez-vous un dépôt public ? C'est en fait assez facile. Avant de commencer, vous devez créer un compte GitHub gratuit, car vous aurez besoin d'un endroit pour stocker votre fourchette. Vous pouvez vous rendre sur www.github.com et le faire dès maintenant.

Une fois votre compte créé, vous pouvez créer un référentiel public sur votre compte.

1. Par exemple, vous pouvez vous diriger vers le référentiel public pour le cours de formation 30 jours de JavaScript de Wes Bos, et dans le coin supérieur droit, vous verrez un bouton qui dit Fourchette. Cliquez sur le bouton.
2. Cela peut prendre quelques secondes à quelques minutes, mais GitHub va ensuite cloner ou « forker » ce projet sur votre propre compte GitHub. Une fois cela fait, il vous montrera immédiatement le projet sous votre nom d'utilisateur GitHub.
3. 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.

Maintenant, vous pouvez modifier et expérimenter le code à votre guise, et cela n'affectera pas 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 quelque chose appelé « Pull Request », où ce changement peut être discuté. Si le propriétaire du projet d'origine aime le changement - et qu'il fonctionne correctement - il peut être fusionné dans la base de code d'origine en tant que code de production.

Fermeture

Comme vous pouvez le voir, le téléchargement de fichiers et de projets entiers depuis GitHub est en fait assez simple. En quelques minutes seulement, vous pouvez télécharger un projet entier 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 de votre fork pour voir ce qui affecte quoi, et puis éventuellement, vous pourrez même créer votre première pull request ! Bon codage !