diff --git a/config.yml b/config.yml index f04cb11..e9e4706 100644 --- a/config.yml +++ b/config.yml @@ -27,6 +27,8 @@ preferences: value: es - label: 日本語 value: ja + - label: Français + value: fr before: - type: updateBranchProtection - type: createIssue @@ -49,6 +51,9 @@ steps: es: title: Asígnate description: Asígnate la primera propuesta. + fr: + title: Assignation + description: Assignez-vous la première Issue. ja: title: 担当者になろう description: 初めてのイシューの担当者になりましょう。 @@ -69,6 +74,9 @@ steps: es: title: Activa GitHub Pages description: Activa GitHub Pages en la página de configuración del repositorio. + fr: + title: Activation de GitHub Pages + description: Activez GitHub Pages sur la page de configuration du dépôt. ja: title: GitHub Pagesを有効化しよう description: リポジトリの設定画面でGitHub Pagesを有効化しましましょう。 @@ -93,6 +101,9 @@ steps: es: title: Cierra una propuesta description: Termina una conversación al cerrar una propuesta. + fr: + title: Fermer l'Issue + description: Achevez l'Issue en la cloturant. ja: title: Issueを閉じよう description: Issueを閉じることで議論を終えましょう。 @@ -120,6 +131,9 @@ steps: es: title: Crea una rama description: Crea una rama para introducir nuevos cambios. + fr: + title: Création d'une branche + description: Créez une branche afin d'introduire un changement. ja: title: ブランチを作ろう description: 新しい変更をするためのブランチを作りましょう。 @@ -139,6 +153,9 @@ steps: es: title: Confirma un archivo description: Confirma un archivo a tu rama. + fr: + title: Soumettre un fichier + description: Ajoutez un fichier à votre branche. ja: title: ファイルをコミットしよう description: ブランチにファイルをコミットしましょう。 @@ -159,6 +176,9 @@ steps: es: title: Abre una solicitud de extracción description: Abre una solicitud de extracción para proponer agregar tu nuevo archivo al proyecto. + fr: + title: Ouverture d'une Pull Request + description: Ouvrez une Pull Request afin de proposer l'ajout de votre fichier au projet. ja: title: プルリクエストをオープンしよう description: 新しいファイルをコードベースに追加する提案をするためにプルリクエストをオープンしましょう。 @@ -221,6 +241,9 @@ steps: es: title: Responde a una revisión description: Responde a una revisión en tu solicitud de extracción. + fr: + title: Réponse à une revue + description: Répondez à la relecture de votre Pull Request. ja: title: レビューに対応しよう description: プルリクエストへのレビューへの対応をしましょう。 @@ -241,6 +264,9 @@ steps: es: title: Fusiona tu solicitud de extracción description: Publica tus cambios al fusionar tu solicitud de extracción. + fr: + title: Fusion de la Pull Request + description: Livrez vos changement en fusionant votre Pull Request. ja: title: プルリクエストをマージしよう description: プルリクエストをマージすることで変更を取り込みましょう。 diff --git a/responses/commit-something.md b/responses/commit-something.md index f758c18..7649327 100644 --- a/responses/commit-something.md +++ b/responses/commit-something.md @@ -45,7 +45,7 @@ The following steps will guide you through the process of committing a change on ```shell git add _posts/0000-01-02-{{ user.username }}.md ``` -1. After adding the text, commit the change and a commit message, check out the **Commits 101** drop-down, just above these instructions: +1. After adding the text, commit the change while providing a commit message. For guidelines on commit messages, check out the **Commits 101** drop-down, just above these instructions: ```shell git commit -m "" ``` diff --git a/responses/create-a-branch.md b/responses/create-a-branch.md index 45f407c..81b941f 100644 --- a/responses/create-a-branch.md +++ b/responses/create-a-branch.md @@ -64,7 +64,7 @@ The best way to keep branches organized with a team is to keep them concise and 1. Navigate to the [Code tab]({{ thePayload.repository.html_url }}) 2. Click **Branch: master** in the drop-down 3. In the field, enter a name for your branch, like `my-slide` -4. Click **Create branch: ** or press the “Enter” key to create your branch +4. Click **Create branch: ** or press the Enter key to create your branch {% endif %}
diff --git a/responses/fix-filename.md b/responses/fix-filename.md index 12960d8..584a235 100644 --- a/responses/fix-filename.md +++ b/responses/fix-filename.md @@ -13,17 +13,17 @@ Let's edit this pull request to fix both of these issues. 1. Confirm that you've got a folder titled `_posts`. 1. Step into the folder with `cd _posts`. 1. Type `ls` to see a listing of your `_posts` folder. -1. Ensure you've got a file named `{{ expected }}` -1. If you find you have to any changes, then stage, commit, and push those changes: +1. Ensure you've got a file named `{{ expected }}`. +1. If you find you have to make any changes, then stage, commit, and push those changes: ```shell git add . git commit -m "" git push ``` {% else %} -1. Click the [Files Changed tab]({{ url }}) in this pull request +1. Click the [Files Changed tab]({{ url }}) in this pull request. 1. Verify that the only file edited is named `{{ expected }}`. -1. If the file is improperly named, or not in a proper location, use the edit function to correct it. +1. If the file is improperly named, or not in a proper location, use the edit function to correct it. 1. Above the contents of the file, select all text in the field that contains the filename and delete it. 1. Continue pressing your backspace key to also delete any directory names that exist. 1. Type the proper filename: diff --git a/responses/fr/assign-yourself.md b/responses/fr/assign-yourself.md new file mode 100644 index 0000000..4cb148d --- /dev/null +++ b/responses/fr/assign-yourself.md @@ -0,0 +1,14 @@ +## Étape 1: Assignation + +Les Issues non assignées ne sont sous la responsabilité de personne. Lorsque vous êtes assigné à une Issue ou une Pull Request, les visiteurs du dépôt sont informés que vous êtes le facilitateur de la discussion ou de la tâche :muscle:. + +### :keyboard: Activité + +1. Sur la partie droite de l'écran, sous la section "Assignees", cliquez l'icône engrenage et séléctionnez vous. + +Pour obtenir une version imprimable des étapes de ce cours, visitez le [Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf). + +
+

Je vous réponderai dès que vous vous serez assigné cette Issue.

+ +> _Parfois je réponds trop rapidement et la page n'a pas le temps de s'actualiser. Si vous avez effectué l'action espérée et que vous ne voyez pas de réponse de ma part, attendez quelques secondes et rafraîchissez la page afin d'obtenir les prochaines instructions._ diff --git a/responses/fr/close-issue.md b/responses/fr/close-issue.md new file mode 100644 index 0000000..d693474 --- /dev/null +++ b/responses/fr/close-issue.md @@ -0,0 +1,14 @@ +## Étape 3: Fermeture de la discussion + +Vous avez activé GitHub Pages! + +Votre site est maintenant public. Jetez-y un oeil à l'adresse {{ pagesUrl }}. + +Maintenant que vous avez effectué les tâches, vous pouvez fermer l'Issue. Fermer une Issue informe les autres contributeurs que cette discussion ou tâche est terminée. + +### :keyboard: Activité + +1. Cliquez sur le boutton **Close issue** ci-dessous + +
+

Je vous répondrai quand vous aurez fermé cette issue.

diff --git a/responses/fr/commit-something.md b/responses/fr/commit-something.md new file mode 100644 index 0000000..df5e83f --- /dev/null +++ b/responses/fr/commit-something.md @@ -0,0 +1,93 @@ +## Étape 5: Soumettre un fichier + +:tada: Vous avez créé une branche! + +Créer une branche vous permet d'apporter des modifications à votre projet sans changer `master`, la branche déployée. Maintenant que vous avez une branche, il est temps de créer un fichier et d'effectuer votre première contribution! + +
Bases de la contribution + +## Bases de la contribution + +Lorsque vous avez fini la création ou l'édition d'un fichier sur GitHub, faites défiler la page jusqu'en bas et répérez la section "Commit new file". + +Saisissez un intitulé à la contribution. Ce message doit informer rapidement les contributeurs sur l'objet du changement introduit dans le fichier. + +### Règles de bienséance pour l'écriture d'un intitulé de contribution: + +- Ne pas terminer votre message par un point. +- Restreignez votre message à 50 caractères ou moins. Ajoutez si nécessaire les détails complémentaires dans la fenêtre de description étendue. Elle se situe juste sous la ligne d'intitulé. +- Utilisez la forme active. Par exemple, "Ajout" au lieu de "Ajouté" and "correction" au lieu de "corrigé". +- Considérez votre intitulé de contribution comme l'expression de votre intention lors de l'introduction du changement. + +
+
+ +### :keyboard: Activité: Votre première contribution + +Les prochaines étapes vous guideront à travers le processus de soumission d'un changement sur GitHub. + +{% if preferences.gitTool == 'cli' %} +1. Récupérez votre branche: + ```shell + git checkout {{ thePayload.ref }} + ``` +1. Créez un nouveau fichier nommé `_posts/0000-01-02-{{ user.username }}.md`. +1. Ajoutez le contenu suivant à votre fichier : + ```yaml + --- + layout: slide + title: "Welcome to our second slide!" + --- + Your text + Use the left arrow to go back! + ``` +1. Ajoutez votre fichier à l'espace de travail: + ```shell + git add _posts/0000-01-02-{{ user.username }}.md + ``` +1. Soumettez le fichiez en fournissant un intitulé : + ```shell + git commit -m "" + ``` +1. Envoyez votre contribution à GitHub: + ```shell + git push + ``` + +{% elsif preferences.gitTool == 'vscode' %} +1. Dans le dossier `_posts`, créez un nouveau fichier nommé `0000-01-02-{{ user.username }}.md`. Le nom complet de votre fichier doit être: `_posts/0000-01-02-{{ user.username }}.md`. +1. Ajoutez le contenu suivant à votre fichier et enregistrez-le : + ```yaml + --- + layout: slide + title: "Welcome to our second slide!" + --- + Your text + Use the left arrow to go back! + ``` +1. Pour ajouter votre fichier à l'espace de travail : allez dans la vue Source Control et cliquez le bouton **+** à côté du fichier. Vous pouvez également vous référer à [la documentation officielle de VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_commit). + ![a screenshot of the staging button in the source control view](https://user-images.githubusercontent.com/16547949/53641057-d5b8d100-3bfb-11e9-9b69-53b0661cd5cd.png) +1. Soumetez le changement en saisissant un intitulé dans le champ de texte puis en pressant Ctrl+Enter sur Windows ou Command ⌘+Enter sur macOS. + ![a screenshot of the commit message on VS Code](https://user-images.githubusercontent.com/16547949/53641276-698a9d00-3bfc-11e9-9b3d-01680fd01d7c.png) +1. Cliquez sur les points de suspension (...) et sélectionnez **Push**. + +{% else %} +1. Sur cette branche, créez un dossier `_posts` et ajoutez y un nouveau fichier nommé `0000-01-02-{{ user.username }}.md`. Vous pouvez le faire en utilisant [ce raccourci]({{ thePayload.repository.html_url }}/new/{{ thePayload.ref }}?filename=_posts/0000-01-02-{{ user.username }}.md) ou manuellement comme suit: + - Retournez à l'onglet "Code" + - Dans la liste déroulante des branches, sélectionnez "{{ thePayload.ref }}" + - Cliquez **Create new file** + - Dans le champ "file name", saisissez `_posts/0000-01-02-{{ user.username }}.md`. La saisie de `/` dans le nom de fichier placera automatiquement votre fichier dans le répertoire `_posts`. +1. Lorsque vous aurez nommé le fichier, ajoutez-y le contenu suivant: + ```yaml + --- + layout: slide + title: "Welcome to our second slide!" + --- + Your text + Use the left arrow to go back! + ``` +1. Après avoir ajouté le texte, vous pouvez soumettre le changement en fournissant un intitulé dans le champ de texte sous la fenêtre d'édition du fichier. Des recommendations relatives aux intitulés de soumission sont disponibles via le lien déroulant **Bases de la contribution**, juste au-dessus de ces instructions +1. Une fois saisis votre intitulé de contribution, cliquez **Commit new file** +{% endif %} +
+

Je vous répondrai lorsque j'aurai détecté une nouvelle contibution sur cette branche.

diff --git a/responses/fr/create-a-branch.md b/responses/fr/create-a-branch.md new file mode 100644 index 0000000..7136b58 --- /dev/null +++ b/responses/fr/create-a-branch.md @@ -0,0 +1,71 @@ +## Étape 4: Création d'une branche + +Réalisons la première étape d'une démarche typique sur GitHub : la création d'une branche [:book:](https://help.github.com/articles/github-glossary/#branch). + +
Création d'une branche + +## Création d'une branche + +:tv: [Video: Branches](https://www.youtube.com/watch?v=xgQmu81G1yY) + +Vous venez d'apprendre à créer une branche, la première étape du travail sur GitHub. + +Les branches sont des éléments importants de la démarche sur GitHub car elles nous permettent d'isoler le travail en cours de la branche principale `master`. En d'autres termes, le travail des autres est protégé pendant que vous mettez au point votre contribution. + +### Conseils pour l'utilisation de branches + +Un projet seul peut avoir des centaines de branches, chacune comportant une nouvelle modification de la branche `master`. + +La meilleure façon de gérer ces branches quand on travaille en équipe est de veiller à les maintenir concises et éphémères. Autrement dit, une branche doit comporter une seule nouvelle fonctionalité ou correction de bug. Les incompréhensions entre contributeurs sont réduites lorsque les branches ne sont actives que quelques jours avant d'être fusionnées [:book:](https://help.github.com/articles/github-glossary/#merge) avec la branche `master`. + +
+
+ +### :keyboard: Activité : Votre première branche + +{% if preferences.gitTool == 'cli' %} +1. Ouvrez votre interface de ligne de commande préférée, que nous appelerons votre shell à partir de maintenant. +1. Clonez cd dépôt : + ```shell + git clone {{ thePayload.repository.clone_url }} + ``` +1. Naviguez vers ce dépôt dans votre shell : + ```shell + cd {{ thePayload.repository.name }} + ``` +1. Créez une branche avec le nom que vous désirez. Vous pouvez également utiliser le nom suggéré ci-dessous. + ```shell + git branch my-slide + ``` +1. Poussez la branche vers GitHub: + ``` + git push --set-upstream origin + ``` + +{% elsif preferences.gitTool == 'vscode' %} +1. Téléchargez et installez [Visual Studio Code](https://code.visualstudio.com/Download) (aussi appelé VS Code) si vous ne l'avez pas déjà. +1. Dans VS Code, ouvrez la pallette de commandes (Command Palette) avec Ctrl+Shift+P sous Windows, ou Command ⌘+Shift+P sous macOS. Vous pourvez égalememnt consulter [la documentation officielle de VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_cloning-a-repository) sur la création de clones. +1. Tapez: `git clone` et pressez Enter + ![a screenshot of vs code with the command palette open](https://user-images.githubusercontent.com/16547949/53639288-bcf9ec80-3bf6-11e9-9d18-d97167168248.png) +1. Collez l'adresse du dépôt dans la nouvelle fenêtre et pressez Enter: + ```shell + {{ thePayload.repository.clone_url }} + ``` +1. Sélectionnez l'emplacement où sauvegarder le dépôt et cliquez **Choose folder**. Ouvrez ensuite l'emplacement que vous avez sélectionné. +1. Le répertoire du dépôt doit maintenant être ouvert dans votre espace de travail VS Code. Cliquez sur `master` en bas et à gauche de la fenêtre VS Code. Ceci ouvrira la palette avec les commandes relatives aux branches Git. + ![a screenshot of the Git branches in VS Code](https://user-images.githubusercontent.com/16547949/53639606-adc76e80-3bf7-11e9-98ac-bd41ae2b40db.png) +1. Cliquez sur **Create new branch** et saisissez le nom que vous désirez, par exemple `my-slide`. Pressez ensuite Enter. +1. Lorsqu'il vous est demandé de sélectioner la référence à partir de laquelle créer la branche, sélectioner `master`. +1. Allez dans la vue "Source Control", cliquez sur les points de suspension (...) et séléctionnez **Push**. Confirmez lorsque le boite de dialogue vous propose de publier la branche. + ![a screenshot of the source control view in VS Code](https://user-images.githubusercontent.com/16547949/53640015-ee73b780-3bf8-11e9-8c90-be9022b9555a.png) + +{% else %} + +1. Naviguez vers [l'onglet Code]({{ thePayload.repository.html_url }}) +2. Cliquez **Branch: master** dans la liste déroulante +3. Dans le champs de texte, saisissez un nom de branche, tel que `my-slide` +4. Cliquez **Create branch: ** ou pressez la touche Enter pour créer votre branche + +{% endif %} +
+

Je vous répondrai ici lorsque j'aurai détecté qu'une nouvelle branche a été crée dans ce dépôt.

diff --git a/responses/fr/fix-base.md b/responses/fr/fix-base.md new file mode 100644 index 0000000..225bd8f --- /dev/null +++ b/responses/fr/fix-base.md @@ -0,0 +1,12 @@ +Votre branche de référence doit être nommée `master`. Ouvrons une Pull Request afin de corriger cela. + +### :keyboard: Activité: Modifier la direction de la Pull Request + +1. Cliquez sur le bouton **Edit** situé à droite du titre de la PR +1. Sous le champ de texte du titre, dans le menu déroulant "base:", assurez vous que la branche `master` est sélectionnée +1. Une boite de dialogue apparaitra vous demandeant si vous voulez changer la base. Cliquez le bouton vert **Change base** + +Si vous avez besoin d'assistance, créez une conversation sur le forum [GitHub Community]({{ communityBoard }}). Vous pouvez également y effectuer une recherche et vérifiez si d'autres n'ont pas rencontré et résolu un problème similaire dans le passé. + +
+

Je vous répondrai lorsque j'aurai détecté que la référence d'oririne de cette PR a été modifiée.

diff --git a/responses/fr/fix-body.md b/responses/fr/fix-body.md new file mode 100644 index 0000000..9b38682 --- /dev/null +++ b/responses/fr/fix-body.md @@ -0,0 +1,14 @@ +Les bonnes Pull Requests comportent une description qui informe les autres contributeurs du changement que vous suggérez et de son contexte. + +Editons cette Pull Request afin d'ajouter une description. + +## :keyboard: Activité: Améliorer la Pull Request + +1. Le premier commentaire de votre Pull Request comportera le texte par défaut **No description provided**. Cliquez l'icône **...** située en haut à droite de la boite de commentaire, puis cliquez sur **Edit** afin d'effectuer un changement +1. Ajoutez dans la boite de commentaire une description du changement que vous avez effectué. N'hésitez pas à décrire ce que vous avez accompli jusque là. Pour rappel, vous avez : créé une branche, créé un fichier et soumis une contribution puis ouvert une Pull Request +1. Cliquez sur le bouton vert **Update comment** en bas à droite de la boite de commentaire + +Si vous avez besoin d'assistance, créez une convesation sur le forum [GitHub Community]({{ communityBoard }}). Vous pouvez également y effectuer une recherche et vérifier si d'autres n'ont pas rencontré et résolu un problème similaire dans le passé. + +
+

Je vous répondrai lorsque j'aurai détecté que le corps de cette Pull Request a été édité.

diff --git a/responses/fr/fix-filename.md b/responses/fr/fix-filename.md new file mode 100644 index 0000000..9a87f71 --- /dev/null +++ b/responses/fr/fix-filename.md @@ -0,0 +1,41 @@ +J'espérai que votre fichier soit nommé **{{ expected }}**. + +Editons cette Pull Request afin de corriger ce problème. + +## :keyboard: Activité: Corriger votre Pull Request + +{% if preferences.gitTool == 'cli' %} +1. Récupérez votre branche : + ```shell + git checkout {{ branch }} + ``` +1. Tapez `ls` afin d'obtenir le contenu votre répertoire racine. +1. Confirmez que vous possédez un répertoire nommé `_posts`. +1. Déplacez vous dans le répertoire à l'aide de la commande `cd _posts`. +1. Tapez `ls` afin d'obtenir le contenu votre répertoire `_posts`. +1. Vérifiez que vous possédez un fichier nommé `{{ expected }}`. +1. Si vous constatez que vous devez effectuer des changements, ajoutez les à l'espace de travail, soumettez puis publiez les : + ```shell + git add . + git commit -m "" + git push + ``` +{% else %} +1. Cliquez [l'onglet Files Changed]({{ url }}) dans cette Pull Request +1. Vérifiez que le seul fichier édité se nomme `{{ expected }}`. +1. Si le fichier n'est pas correctement nommé, ou n'est pas au bon endroit, utilisez la fonctionalité d'édition afin de corriger cela. +1. Au dessus du contenu du fichier, sélectionnez tout le texte du champ contenant le nom du fichier et supprimez ce texte. +1. Continuez de presser la touche retour arrière (Backspace) afin de supprimer également d'éventuels noms de répertoire. +1. Saisissez le nom de fichier correct: + ```shell + {{ expected }} + ``` +1. Faites défiler la fenêtre jusqu'en bas puis, dans la section **Commit Changes**, saisissez un intitulé de contribution et soumettez le. +{% endif %} + +**Note**: Vous ne trouvez pas le bouton d'édition du fichier ? Il peut ressemble à un crayon ou a des points de suspension. + +ISi vous avez besoin d'assistance, créez une convesation sur le forum [GitHub Community]({{ communityBoard }}). Vous pouvez également y effectuer une recherche et vérifier si d'autres n'ont pas rencontré et résolu un problème similaire dans le passé. + +
+

Je vous répondrai lorsque j'aurai détecté une contribution sur cette branche.

diff --git a/responses/fr/head-to-branch.md b/responses/fr/head-to-branch.md new file mode 100644 index 0000000..d74eb00 --- /dev/null +++ b/responses/fr/head-to-branch.md @@ -0,0 +1,4 @@ +## Cette Issue est close! :white_check_mark: + +
+

Procédez à la prochaine tâche maintenant !

diff --git a/responses/fr/introduction.md b/responses/fr/introduction.md new file mode 100644 index 0000000..0f54e88 --- /dev/null +++ b/responses/fr/introduction.md @@ -0,0 +1,119 @@ +# :wave: Bienvenue au cours "Introduction à GitHub" de GitHub Learning Lab + +Pour commencer, je vais vous guider à travers quelques premières étapes importantes de la programmation et la collaboration sur GitHub. + +:point_down: _Cette flèche signifie que vous pouvez agrandir la fenêtre. Cliquez dessus tout au long du cours pour trouver plus d'informations._ +
Qu'est-ce que GitHub? +
+ +## Qu'est-ce que GitHub? + +Merci d'avoir posé cette question! Beaucoup de gens viennent sur GitHub parce qu'ils veulent contribuer à des projets libres (open source [:book:](https://help.github.com/articles/github-glossary/#open-source)), ou ils sont invités par des collègues ou des camarades de classe qui l'utilisent pour leurs projets. Pourquoi les gens utilisent-ils GitHub pour ces projets? + +**GitHub est une plateforme de collaboration.** + +Des logiciels aux documents juridiques, vous pouvez compter sur GitHub pour vous aider à réaliser le meilleur travail possible avec les outils de collaboration et de sécurité dont votre équipe a besoin. Avec GitHub, vous pouvez garder des projets complètement privés ou inviter des personnes à collaborer et fluidifier chaque étape de votre projet. + +**GitHub est également un puissant outil de contrôle de version.** + +GitHub utilise Git [:book:](https://help.github.com/articles/github-glossary/#git), l'outil open source de gestion de version le plus populaire, afin de tracer chaque contribution et contributeur [:book:](https://help.github.com/articles/github-glossary/#contributor) de votre projet, afin que vous sachiez d'où vient chaque ligne de code. + +**GitHub vous aide à faire beaucoup plus.** + +GitHub est utilisé pour créer certaines des technologies les plus avancées au monde. Que vous visualisiez des données ou construisiez un nouveau jeu, il existe toute une communauté et un ensemble d'outils sur GitHub qui peuvent vous aider à passer à l'étape suivante. Ce cours commence par les bases, mais nous approfondirons le reste plus tard! + +:tv: [Qu'est-ce que GitHub?](https://www.youtube.com/watch?v=w3jLJU7DT5E) +
+

+ +
Exploration d'un dépôt GitHub +
+ +## Exploration d'un dépôt GitHub + +:tv: [Video: Exploration d'un dépôt](https://www.youtube.com/watch?v=R8OAwrcMlRw) + +### Autres fonctionnalités + +La vidéo a couvert certaines des fonctionnalités les plus utilisées. Voici quelques autres éléments que vous pouvez trouver dans les dépôts GitHub : + +- Tableaux de suvi de projet : créez un tableau de suivi des tâches de style Kanban dans GitHub +- Wiki : créer et stocker la documentation relative à votre projet +- Insights : affichez des outils d'analyse pour votre dépôt, notamment : + - Pulse: tableau de bord de projet pemettant la recherche d'information sur les travaux terminés et les travaux en cours + - Graphiques : les graphiques fournissent une vue plus granulaire de l'activité du dépôt, donnant des détails sur qui a contribué au dépôt, qui l'a créé et quand les contributions ont été effectuées + +### Fichiers spéciaux + +Dans la vidéo, vous avez découvert un fichier spécial appelé README.md. Voici quelques autres fichiers spéciaux que vous pouvez ajouter à vos dépôts : + +- CONTRIBUTING.md: Le fichier `CONTRIBUTING.md` est utilisé pour décrire le processus de contribution aux dépôts. Un lien vers le fichier `CONTRIBUTING.md` est affiché chaque fois que quelqu'un crée une nouvelle Issue ou une Pull Request. +- ISSUE_TEMPLATE.md: ISSUE_TEMPLATE.md est un autre fichier que vous pouvez utiliser pour préremplir le corps d'une Issue. Par exemple, si vous avez toujours besoin des mêmes types d'informations pour les rapports de bugs, incluez-les dans le modèle d'Issue, et chaque nouvelle Issue sera ouverte avec votre texte de démarrage recommandé. + +
+
+ +### Utiliser les Issues + +Ceci est une Issue [:book:](https://help.github.com/articles/github-glossary/#issue): un endroit où vous pouvez avoir des conversations sur les bugs dans votre code, la révision du code et à peu près tout le reste. + +Les titres des Issues sont comme les lignes d'objet des e-mails. Ils indiquent à vos collaborateurs de quoi il s'agit en un coup d'œil. Par exemple, le titre de cette Issue est "Getting started with GitHub". + +
Utiliser les Issues GitHub + +## Utiliser les Issues GitHub + +Les Issues sont utilisées pour discuter des idées, des améliorations, des tâches et des bugs. Elles facilitent la collaboration en : + +- Fournissant à tout le monde (même aux futurs membres de l'équipe) l'historique complet en un seul endroit +- En permettant les références croisées avec d'autres Issues et Pull Requests [:book:](https://help.github.com/articles/github-glossary/#pull-request) +- Centralisant dans un dépôt unique les décisions et leurs motivations +- Vous permettant d'inclure facilement les bonnes personnes et les bonnes équipes dans une conversation avec les @-mentions + +:tv: [Video: Utiliser les Issues GitHub](https://www.youtube.com/watch?v=Zhj46r5D0nQ) + +
+
+ +
Gérer les notifications +
+ +## Gérer les notifications + +:tv: [Video: Watching, notifications, stars, et explore](https://www.youtube.com/watch?v=ocQldxF7fMY) + +Une fois que vous avez commenté une Issue ou une Pull Request, vous commencerez à recevoir des notifications par e-mail dès lors qu'il y aura de l'activité dans le fil d'actualité. + +### Comment faire taire ou réactiver des Issues spécifiques + +1. Aller à l'Issue ou la Pull Request +2. Sous _"Notifications"_, cliquez le bouton **Unsubscribe** à droite afin de taire les notifications ou le bouton **Subscribe** afin de les activer + +Vous verrez une courte description qui explique votre statut de notification actuel. + +### Comment personnaliser les notifications dans vos réglages + +1. Cliquez votre photo de profil +2. Cliquez **Settings** +3. Cliquez **Notifications** depuis le menu de gauche et [ajustez vos préférences de notification](https://help.github.com/articles/managing-notification-delivery-methods/) + +### Options de notification du dépôt + +* **Watch**: Vous recevrez une notification lorsqu'une nouvelle Issue, une Pull Request ou un commentaire est publié, et lorsqu'une Issue est fermé ou qu'une Pull Request est fusionnée +* **Not watching**: Vous ne recevrez plus de notifications sauf si vous êtes @-mentionné +* **Ignore**: Vous ne recevrez plus de notifications du dépôt + +### Comment configurer les notifications des dépots que vous suivez + +1. Cliquez votre photo de profil +1. Cliquez **Settings** +1. Cliquez **Notifications** depuis le menu de gauche +1. Cliquez sur le lien ["things you’re watching"](https://github.com/watching) +1. Sélectionnez l'onglet **Watching** t +1. Cliquez le bouton **Unwatch** pour désactiver les notifications, ou **Watch** les activer + +
+
+ +
+

Continuez à lire ci-dessous pour trouver votre première tâche

diff --git a/responses/fr/open-a-pr.md b/responses/fr/open-a-pr.md new file mode 100644 index 0000000..e0daee9 --- /dev/null +++ b/responses/fr/open-a-pr.md @@ -0,0 +1,30 @@ +## Étape 6: Ouvrez une Pull Request + +Bravo pour cette contribution :sparkles: + +Maintenant que vous avez créé une contribution, il est temps de partager la modification que vous proposez via une Pull Request ! Là où les Issues encouragent l'échange avec d'autres contributeurs et collaborateurs sur un projet, les Pull Request vous aident à partager vos modifications, à recevoir des commentaires à leur sujet et à itérer jusqu'à ce qu'elles soient parfaites ! + +
Qu'est-ce qu'une Pull Request ? + +## Pull requests + +Revenons au workflow de GitHub. Vous avez créé une branche, ajouté un fichier et validé le fichier dans votre branche. Il est maintenant temps de collaborer sur votre dossier avec d'autres étudiants qui suivent ce cours. Cette collaboration se produit dans une Pull Request. Visionnez cette vidéo pour en savoir plus : + +:tv: [Video: Introduction aux Pull Requests](https://youtu.be/kJr-PIfLDl4) +
+
+ +Cette Pull Request va conserver les modifications que vous venez de faire sur votre branche tout en proposant de les appliquer également à la branche `master`. + +### :keyboard: Activité: Créer une Pull Request + +1. Ouvrez une Pull Request grâce à [ce raccourci]({{ url }}) ou manuellement comme suit : + - Depuis l'onglet "Pull requests", cliquez **New pull request** + - Dans le menu déroulant "base:", assurez vous que la branche `master` est sélectionnée + - Dans le menu déroulant "compare:", sélectionnez "{{ branch | remove: 'refs/heads/' }}" +1. Lorsque vous avez sélectionné votre branche, saisissez un titre pour votre Pull Request. Par exemple `Ajout du fichier de {{ user.username }}` +1. Le champ suivant vous aide à fournir une description des modifications que vous avez apportées. N'hésitez pas à ajouter une description de ce que vous avez accompli jusqu'à présent. Pour rappel, vous avez: créé une branche, créé un fichier et effectué une contribution, et ouvert une Pull Request +1. Cliquez **Create pull request** + +
+

Je vous répondrai dans votre nouvelle Pull Request.

diff --git a/responses/fr/pr-succeeds.md b/responses/fr/pr-succeeds.md new file mode 100644 index 0000000..8d6e3ed --- /dev/null +++ b/responses/fr/pr-succeeds.md @@ -0,0 +1,33 @@ +## Étape 8: Fusionnez votre Pull Request + +Bien joué @{{ user.username }} ! :sparkles: + +Vous avez créé avec succès une Pull Request et elle a passé tous les tests avec succès. Vous pouvez maintenant fusionner votre Pull Request. + +### :keyboard: Activité: Fusionnez votre Pull Request + +{% if preferences.gitTool == 'cli' %} +1. Récupérez votre branche `master` : + ```shell + git checkout master + ``` +2. Fusionnez votre branche : + ```shell + git merge {{ branch }} + ``` +3. Publiez l'historique combiné vers GitHub : + ```shell + git push + ``` +4. Supprimez la branche locale : + ```shell + git branch -d {{ branch }} + ``` +{% else %} +1. Cliquez sur **Merge pull request** +1. Cliquez sur **Confirm merge** +{% endif %} +1. Une fois votre branche fusionnée, vous n'en avez plus besoin. Cliquez **Delete branch**. + +
+

Je vous répondrai lorsque cette Pull Request sera fusionnée.

diff --git a/responses/fr/reminder-delete.md b/responses/fr/reminder-delete.md new file mode 100644 index 0000000..4fcedeb --- /dev/null +++ b/responses/fr/reminder-delete.md @@ -0,0 +1,40 @@ +## Bon boulot + +![celebrate](https://octodex.github.com/images/collabocats.jpg) + +Félicitations @{{ user.username }}, vous avez achevé ce cours ! + +## Les temps forts + +Vous avez désormais votre présentation déployée [ici](https://{{ user.username }}.github.io/{{ repo }}) et vous l'avez fait en suivant le workflow de GitHub. + +Avant de vous dire au revoir, récapitulons les tâches accomplies dans ce dépôt: + +- Vous avez effectué votre première contribution ! :tada: +- Vous avez découvert les Issues, les Pull Requests et la structure d'un dépôt GitHub +- Vous avez découvert les branches +- Vous avez créé une soumission +- Vous avez consulté et répondu aux relectures sur les Pull Requests +- Vous avez édité un fichier existant +- Vous avez activé GitHub Pages +- Vous avez effectuer votre première contribution ! + +## Partagez vos commentaires + +Nous aimerions savoir ce que vous avez pensé de ce cours. Merci de partager votre opinion dans [cette enquête rapide](https://www.surveymonkey.com/r/intro-to-github-1). + +## Prochaine étape + +Nous espérons que ce cours vous a aidé à vous sentir plus à l'aise avec GitHub. N'oubliez pas : vous pouvez toujours répéter les sujets du cours si vous souhaitez vous entraîner davantage. Si vous êtes prêt à développer vos nouvelles compétences, voici ci-dessous quelques idées. + +### Contribuez à un projet + +Trouvez des projets auxquels contribuer en consultant [GitHub Explore](https://github.com/explore). Les projets y sont regroupés par sujets populaires ou dans des collections organisées. + +### Continuez à apprendre + +Voici quelques suggestions de futurs cours que vous pourrez suivre : +- [GitHub Pages]({{ host }}/{{ course.Owner.login }}/github-pages): Continuez à en apprendre davantage sur GitHub Pages, que nous avons abordées dans ce cours. +- [Communication à l'aide de Markdown]({{ host }}/{{ course.Owner.login }}/communicating-using-markdown): Nous avons utilisé un peu de Markdown dans ce cours, mais si vous voulez tout savoir au sujet de cette :sparkles: syntaxe, suivez le cours! + +[Qu'allez vous apprendre maintenant]({{ host }}/courses)? diff --git a/responses/fr/reopen.md b/responses/fr/reopen.md new file mode 100644 index 0000000..1e97c7f --- /dev/null +++ b/responses/fr/reopen.md @@ -0,0 +1,9 @@ +### :keyboard: Activité : Rouvrir une Pull Request + +Oooops! Il semble que vous ayez accidentellement fermé votre Pull Request. + +1. Cliquez **Reopen pull request**. Si ce bouton n'est pas actif, il vous faudra d'abord cliquer sur **Restore branch** +1. Fusionnez la Pull Request. + +
+

Je vous répondrai lorsque cette Pull Request aura été fusionnée.

diff --git a/responses/fr/request-changes.md b/responses/fr/request-changes.md new file mode 100644 index 0000000..b689480 --- /dev/null +++ b/responses/fr/request-changes.md @@ -0,0 +1,46 @@ +## Étape 7: Répondre à une relecture + +Votre Pull Request à l'air sensationelle! + +Continuons en ajoutant du contenu à votre fichier. Remplacez la ligne 5 de votre fichier par une citation ou un meme et une légende pleine d'esprit. N'oubliez pas: le [Markdown](https://guides.github.com/features/mastering-markdown/) est supporté. + +### :keyboard: Activité : Modifier un fichier + +{% if preferences.gitTool == 'cli' %} +1. Récupérez votre branche: + ```shell + git checkout {{ branch }} + ``` +1. Ouvrez le fichier `_posts/0000-01-02-{{ user.username }}.md`. +1. Remplacez la ligne 5 du fichier par quelque chose de nouveau. +1. Ajoutez vos changements à l'espace de travail : + ```shell + git add _posts/0000-01-02-{{ user.username }}.md + ``` +1. Soumettez vos changements : + ```shell + git commit -m "" + ``` +1. Publiez vers GitHub : + ```shell + git push + ``` + +{% elsif preferences.gitTool == 'vscode' %} +1. Ouvrez le fichier `_posts/0000-01-02-{{ user.username }}.md`. +1. Remplacez la ligne 5 du fichier par quelque chose de nouveau. +1. Ajoutez vos changements à l'espace de travail. Pour rappel, vous pouvez effectuer cela dans la vue Source Control, cliquez le symbole **+** à côté du fichier. +1. Soumettez vos changements. Ceci peut se faire depuis la vue Source Control : saisissez un message de commit dans le champ de texte et pressez Ctrl+Enter sous Windows ou Command ⌘+Enter sous macOS. +1. Publiez vers GitHub. Dans la vue Source Control, cliquez sur les points de suspension (...) et sélectionnez **Push**. + +{% else %} +1. Cliquez [l'onglet Files Changed]({{ url }}) de cette Pull Request +1. Editez votre fichier nouvellement ajouté +1. Remplacez la ligne 5 du fichier par quelque chose de nouveau +1. Défilez vers le bas et cliquez **Commit Changes** +{% endif %} + +**Note**: Vous ne trouvez pas le bouton d'édition du fichier ? Il peut ressemble à un crayon ou a des points de suspension. + +
+

Je vous répondrai lorsque j'aurai détecté une nouvelle contibution sur cette branche.

\ No newline at end of file diff --git a/responses/fr/turn-on-gh-pages.md b/responses/fr/turn-on-gh-pages.md new file mode 100644 index 0000000..011c8ab --- /dev/null +++ b/responses/fr/turn-on-gh-pages.md @@ -0,0 +1,20 @@ +## Étape 2: Activez GitHub Pages + +:tada: Vous êtes maintenant le fier gestionnaire de cette Issue ! Maintenant que vous vous êtes assigné, les personnes qui passent savent qu'elles sont les bienvenues pour participer, mais aussi que vous êtes chargé de faire avancer le sujet jusqu'à la ligne d'arrivée. :sunglasses:. + +### Utilisons GitHub Pages + +Maintenant, au boulot ! GitHub Pages vous permet de servir un site statique à partir d'un dépot. Nous avons rempli ce dépot avec du contenu de site, mais le site rendu n'est pas visible pour le moment. Changeons cela. + +### :keyboard: Activité: Activez GitHub Pages + +1. Cliquez sur l'onglet [**Settings**]({{ repoUrl }}/settings) de ce dépôt +1. Défilez jusqu'à la section "GitHub Pages" +1. Depuis le menu déroulant "Source", selectionnez **master branch** + +> Note : même si vous voyez une option pour choisir un thème, n'appliquez pas de thème à ce stade. Nous avons protégé le code afin que vous ne puissiez pas apporter de modifications involontaires. Vous aurez la possibilité d'appliquer un thème une fois le cours terminé. + +
+

Je répondrai dans cette discussion lorsque j'aurai détecté que GitHub Pages a déployé votre site.

+ +> Activer GitHub Pages déclenche le déploiement de votre dépôt. Ceci peut prendre jusqu'à une minute. diff --git a/responses/fr/your-first-contribution.md b/responses/fr/your-first-contribution.md new file mode 100644 index 0000000..2493b8c --- /dev/null +++ b/responses/fr/your-first-contribution.md @@ -0,0 +1,10 @@ +### Introduction au flux GitHub + +Maintenant que vous connaissez les Issues, utilisons ce problème pour suivre votre cheminement vers votre première contribution. + +Les gens utilisent différents workflows pour contribuer à des projets logiciels, mais le moyen le plus simple et le plus efficace de contribuer sur GitHub est le workflow GitHub. + +:tv: [Video: Comprendre le flux GitHub](https://www.youtube.com/watch?v=PBI2Rz-ZOxU) + +
+

Lisez les étapes suivantes ci-dessous

diff --git a/responses/introduction.md b/responses/introduction.md index a6b9ab6..91c50f6 100644 --- a/responses/introduction.md +++ b/responses/introduction.md @@ -109,7 +109,7 @@ You'll see a short description that explains your current notification status. 1. Click your profile icon 2. Click **Settings** 3. Click **Notification** from the menu on the left -4. Click on the [repositories you’re watching](https://github.com/watching) link +4. Click on the [things you’re watching](https://github.com/watching) link 5. Select the **Watching** tab 6. Click the **Unwatch** button to disable notifications, or **Watch** to enable them pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy