Hello World

De Mi caja de notas

Révision datée du 19 juin 2016 à 15:03 par Xtof (discussion | contributions) (Page créée avec « [Source](https://guides.github.com/activities/hello-world/ "Permalink to Hello World · GitHub Guides") # Hello World · GitHub Guides Le projet **Bonjour tout le monde*... »)
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)

[Source](https://guides.github.com/activities/hello-world/ "Permalink to Hello World · GitHub Guides")

  1. Hello World · GitHub Guides

Le projet **Bonjour tout le monde** est une tradition séculaire dans la programmation informatique. C'est un exercice simple qui vous permet de démarrer lors de l'apprentissage quelque chose de nouveau. Commençons avec GitHub!

    • Vous apprendrez à : **
  • Créer et utiliser un référentiel
  • Lancer et gérer une nouvelle branche
  • Apporter des modifications à un fichier et les pousser à GitHub sous forme de commits
  • Ouvrir et fusionner une demande de traction

The **Hello World** project is a time-honored tradition in computer programming. It is a simple exercise that gets you started when learning something new. Let's get started with GitHub!


    1. Qu'est-ce que GitHub ?

GitHub est une plate-forme d'hébergement de code pour le contrôle de version et la collaboration. Elle vous permet de travailler seul et avec d'autres sur des projets provenant de partout.

Ce tutoriel vous apprend l'essentiel de GitHub comme les _référentiels_, _branches_, _commits_ et _Pull Requests_. Vous allez créer votre propre référentiel Hello World et apprendre le workflow Pull Request de GitHub, un moyen populaire pour créer et faire examiner votre code.

        1. Aucune connaissance du code nécessaire

Pour compléter ce tutoriel, vous avez besoin d'un [compte GitHub.com][1] et d'un accès Internet. Vous n'avez pas besoin de savoir comment coder, utiliser la ligne de commande ou installer Git (le logiciel de contrôle de version sur lequel est construit GitHub).

> ** Truc : ** Ouvrez ce guide dans une fenêtre de navigateur (ou un onglet) de sorte que vous puissiez le voir pendant que vous effectuez les étapes dans le tutoriel.

    1. Etape 1. Création d'un référentiel

Un **repository** (référentiel ou dépôt) est habituellement utilisé pour organiser un seul projet. Les référentiels peuvent contenir des dossiers et des fichiers, des images, des vidéos, des feuilles de calcul et des ensembles de données - tout ce dont votre projet a besoin. Nous recommandons d'inclure un _README_, ou un fichier avec des informations sur votre projet. GitHub facilite l'ajout de ce fichier à chaque fois fois que vous créez votre nouveau référentiel. _Il offre également d'autres options communes comme un fichier de licence._

Votre référentiel `hello-world` peut être un endroit où vous stockez des idées, des ressources, ou même pour partager et discuter de choses avec les autres.

      1. Pour créer un nouveau référentiel

1. Dans le coin supérieur droit, à côté de votre avatar ou Identicône, cliquez et sélectionnez **New repository**. 2. Nommez votre référentiel `hello-world`. 3. Ecrivez une brève description. 4. Sélectionnez **Initialize this repository with a README **.

![new-repo-form][2]

Cliquez **Create repository**. ![:tada:][3]


    1. Étape 2. Créer une branche
    • Brancher** c'est la façon de travailler sur les différentes versions d'un référentiel à un moment donné.

Par défaut, votre référentiel a une branche nommée `master` qui est considérée comme la branche définitive. Nous utilisons des branches pour expérimenter et faire des modifications avant de les engager sur la branche `master`.

Lorsque vous créez une branche en dehors de la `branche master`, vous faites une copie, ou un instantané, de `master` tel qu'elle était à ce moment-là. Si quelqu'un d'autre a apporté des modifications à la branche `master` pendant que vous travaillez sur votre branche, vous pourriez extraire et ramener ces mises à jour.

Ce diagramme montre:

  • La branche `master`
  • Une nouvelle branche appelée `feature` (parce que nous faisons le travail de fond sur cette branche)
  • Le voyage que fait la branche `feature` avant qu'elle ne soit fusionnée dans `master`.

![une branche][4]

Avez-vous déjà enregistré différentes versions d'un fichier ? Quelque chose comme :

  • `histoire.txt`
  • `histoire-jean-edit.txt`
  • `histoire-jean-edit-revision.txt`

Les branches réalisent des objectifs similaires dans les dépôts GitHub.

Ici chez GitHub, nos développeurs, auteurs et concepteurs utilisent des branches pour garder trace des corrections de bugs et les travaux de fonctionnalités séparés de notre branche `master` (production). Lorsqu'un changement est prêt, ils fusionnent leur branche dans `master`.

      1. Pour créer une nouvelle branche

1. Accédez à votre nouveau repository `hello-world`. 2. Cliquez sur le menu déroulant en haut de la liste des fichiers qui dit **branch: master**. 3. Tapez un nom de branche, `readme-edits`, dans la nouvelle zone de texte de la branche. 4. Sélectionnez la boîte bleue **Create branch** et appuyez sur la touche "Entrée" de votre clavier.

![gif branche][5]

Maintenant, vous avez deux branches, `master` et` readme-edits`. Ce sont exactement les mêmes, mais pas pour longtemps ! Nous allons ensuite ajouter nos modifications à la nouvelle branche.

    1. Etape 3. Produire et commiter les modifications

Bravo ! Maintenant, vous êtes sur le point de vue code pour votre `branche readme-edits`, qui est une copie de `master`. Faisons quelques modifications.

Sur GitHub, les modifications sauvegardées sont appelées des _commits_. Chaque commit a un message associé, _commit message_, qui est une description expliquant pourquoi un changement particulier a été fait. Les messages commit capturent l'histoire de vos modifications afin que les autres contributeurs puissent comprendre ce que vous avez fait et pourquoi.

        1. Produire et "commiter" les modifications

1. Cliquez sur le fichier `README.md`. 2. Cliquez sur l'icône de crayon dans le coin supérieur droit de la vue du fichier à éditer. 3. Dans l'éditeur, écrivez quelques mots sur vous. 4. Rédigez un message de commit qui décrit vos modifications. 5. Cliquez sur le bouton **Commit changes**

![Commi][6]

Ces modifications seront apportées juste au fichier README sur votre branche `readme-edits`, par conséquent cette branche contient maintenant du contenu qui est différent de `master`.

    1. Étape 4. Ouvrez une Pull Request

Belles modifications ! Maintenant que vous avez des modifications dans une branche hors de `master`, vous pouvez ouvrir une _pull request_.

Les Pull Requests sont au cœur de la collaboration sur GitHub. Lorsque vous ouvrez une _Pull Request_, vous proposez vos modifications en demandant à ce quelqu'un examine et tire dans votre contribution et les fusionne dans leur branche. Les Pull Requests montrent les _diffs_, ou les différences, du contenu provenant des deux branches. Les changements, les ajouts et les soustractions sont indiquées en vert et rouge.

Dès que vous faites un commit, vous pouvez ouvrir une Pull Request et commencer une discussion, avant même que le code ne soit terminé.

En utilisant le [système de @mention][7] de GitHub dans message de Pull Request, vous pouvez demander des commentaires à des personnes ou des équipes spécifiques, celles-ci pouvant être dans le couloir à côté ou à 10 fuseaux horaires de là.

Vous pouvez même ouvrir des Pull Requests dans votre propre dépôt et les fusionner vous-même. C'est un excellent moyen d'apprendre le Flow GitHub avant de travailler sur des projets plus importants.

        1. Ouvrez une demande de traction pour les modifications apportées au README

_Cliquez sur l'image pour une plus grande version_

Lorsque vous avez terminé votre message, cliquez sur **Create pull request** !

  • * *

> ** Truc ** : Vous pouvez utiliser les [emoji][8] et [glisser-déposer des images et gifs][9] sur les commentaires et les Pull Requests.


    1. Etape 5. Fusionner votre Pull Request

Dans cette dernière étape, il est temps de rassembler et porter vos modifications - en fusionnant votre branche `readme-edits` dans la branche `master`.

1. Cliquez sur le bouton vert **Merge pull request** pour fusionner les modifications dans `master`. 2. Cliquez sur **Confirm merge**. 3. Allez-y et supprimez la branche, étant donné que ses changements ont été intégrés, avec le bouton **Delete branch** dans la boîte violette **.

![Fusion][10]![Supprimer][11]

      1. Célébrez!

En finissant ce tutoriel, vous avez appris à créer un projet et faire une pull request sur GitHub ! ![:tada:]![3][:octocat:][12]![:Zap:][13]

Voici ce que vous avez accompli dans ce tutoriel :

  • Création d'un référentiel open source
  • Démarrage et gestion d'une nouvelle branche
  • Modification d'un fichier et engagé ces modifications sur GitHub
  • Ouvert et fusionné une Pull Request

Jetez un oeil à votre profil GitHub et vous verrez vos nouveaux [carrés de contribution][14] !

Si vous voulez en savoir plus sur la puissance des Pull Request, nous vous recommandons de lire le [Guide GitHub Flow][15]. Vous pouvez également visiter [GitHub Explorer][16] et vous impliquer dans un projet Open Source ![:Octocat:][12]

  • * *

> ** Tip **: Découvrez nos autres [Guides] [17] et [chaîne YouTube] [18] pour plus de GitHub how-tos.

Last updated April 7, 2016

[1]: http://github.com [2]: https://guides.github.com/create-new-repo.png [3]: https://assets.github.com/images/icons/emoji/unicode/1f389.png ":tada:" [4]: https://guides.github.com/branching.png [5]: https://guides.github.com/readme-edits.gif [6]: https://guides.github.com/commit.png [7]: https://help.github.com/articles/about-writing-and-formatting-on-github/#text-formatting-toolbar [8]: https://help.github.com/articles/basic-writing-and-formatting-syntax/#using-emoji [9]: https://help.github.com/articles/file-attachments-on-issues-and-pull-requests/ [10]: https://guides.github.com/merge-button.png [11]: https://guides.github.com/delete-button.png [12]: https://assets.github.com/images/icons/emoji/octocat.png ":octocat:" [13]: https://assets.github.com/images/icons/emoji/unicode/26a1.png ":zap:" [14]: https://help.github.com/articles/viewing-contributions [15]: http://ducamp.me/GitHub_Flow [16]: http://github.com/explore [17]: http://guides.github.com [18]: http://youtube.com/githubguides