New Crowdin updates

fr-FR/meta.yml

@@ -0,0 +1,51 @@
+---
+title: Getting started with Git
+hero_image: images/banner.png
+description: Learn how to use Git and GitHub from the command line on Linux, Mac OS and Windows
+original_url: https://raspberrypi.org/learning/getting-started-with-git
+theme: yellow
+duration: 2
+listed: true
+ingredient: false
+copyedit: true
+curriculum: 2, design-0, programming-0, phys-comp-0, manufacture-0, community-2
+interests: ''
+technologies: ''
+site_areas: projects
+hardware: ''
+software: ''
+version: 3
+last_tested: 2017-01-01
+steps:
+  - 
+    title: Introduction
+  - 
+    title: What you will need
+  - 
+    title: What is Git?
+  - 
+    title: Getting Git
+    completion:
+      - engaged
+  - 
+    title: Setting up Git
+  - 
+    title: Creating your first magic school bag
+  - 
+    title: Adding your books
+  - 
+    title: Adding more books and travelling in time
+  - 
+    title: Making major changes
+  - 
+    title: Working with a sky-bag
+  - 
+    title: Collaborative working
+  - 
+    title: GitHub issues
+  - 
+    title: Pull requests
+    completion:
+      - internal
+  - 
+    title: What next?

fr-FR/resources/example.py

@@ -0,0 +1 @@
+print("Hello world")

fr-FR/step_1.md

@@ -0,0 +1,15 @@
+## What you will make
+
+In this resource, you will learn how to use the Git version control software to help you to work on your own projects and contribute to open-source projects.
+
+## What you will learn
+
+In this resource you will learn:
+
+- How to manage your projects using Git
+- How to use GitHub to store remote versions of your projects
+- How to collaborate on open-source software and projects using GitHub
+
+This resource covers elements from the following strands of the [Raspberry Pi Digital Making Curriculum](https://www.raspberrypi.org/curriculum/):
+
+- [Collaborate on digital making projects with other community members](https://www.raspberrypi.org/curriculum/community-and-sharing/builder)

fr-FR/step_10.md

@@ -0,0 +1,49 @@
+## Working with a sky-bag
+
+Now that you know how to do the basics in Git, it's time to learn how to use it to its full potential: use it to share your work and collaborate with others.
+
+There are lots of services that will host your Git repo for you, free of charge. [GitLab](https://about.gitlab.com/) is one such service and [BitBucket](https://bitbucket.org/) is another. In this resource, you are going to be using [GitHub](https://github.com/), which is one of the more popular services.
+
+- The first thing to do is to register for an account on [GitHub](https://github.com/join?source=header-home), and just choose the free plan.
+
+  ![](images/gh-reg.png)
+
+- Now that you have an account, you can create a `snitch-sniffer` repo on GitHub. Find the **New repository** button and click it.
+
+  ![](images/new-repo.png)
+
+- Give the repo a name and a description and click on the **Create repository** button
+
+  ![](images/new-repo2.png)
+
+- This should then bring up a page of instructions
+
+  ![](images/instructions.png)
+
+- As you already have a repo ready to push to GitHub, then all you need to do is make sure you are in your project directory and type:
+
+  ```bash
+  git remote add origin [email protected]:HarryPotter/snitch-sniffer.git
+  ```
+
+  and then
+
+  ```bash
+  git push -u origin master
+  ```
+
+- If you look on GitHub, you should now be able to see your repo, along with the displayed `README.md` file that you wrote.
+
+  ![](images/gh-repo.png)
+
+- Any time you make changes to your project, and you want to push them up to GitHub, you can just type:
+
+  ```bash
+  git push origin master
+  ```
+
+  If you are working on a different branch you would type:
+
+  ```bash
+  git push origin <branch-name>
+  ```

fr-FR/step_11.md

@@ -0,0 +1,5 @@
+## Collaborative working
+
+The true power of services like GitHub becomes apparent when you start working with other people. GitHub lets other people make their own copies of your projects, or you to make copies of theirs. Either of you can then make improvements to the project and then push the improvements up to GitHub for everyone to share.
+
+This resource is itself a GitHub repo. You can find it at [https://github.com/raspberrypilearning/getting-started-with-git](https://github.com/raspberrypilearning/getting-started-with-git). That means that if you found a mistake in the resource, or if you just wanted to make some improvements, you can. There are two main ways to get involved with other people's projects: **issues** and **pull requests**.

fr-FR/step_12.md

@@ -0,0 +1,23 @@
+## GitHub issues
+
+Our copy editors at Raspberry Pi are pretty amazing, so the chances of you spotting a typo in this resource are pretty slim. You might spot a mistake in some of the code though, and that's where you can help out. Take this bit of code for example:
+
+```python
+print("Hello World!)
+```
+
+Let's see how you could help fix this error.
+
+- Head on over to [https://github.com/raspberrypilearning/getting-started-with-git](https://github.com/raspberrypilearning/getting-started-with-git), and make sure you are logged in.
+
+- Now, you want to find the **Issues** tab
+
+  ![](images/issues.png)
+
+- You can now create a new issue, and give a description
+
+  ![](images/issue.png)
+
+- Once that's completed, the maintainers of the repo will be able to reply to you, and close the issue once it's fixed.
+
+  ![](images/closed.png)

fr-FR/step_13.md

@@ -0,0 +1,31 @@
+## Pull requests
+
+Issues are great, but if you want to help out even more, then project maintainers are usually very happy for you to fix or improve projects yourself. To do this, you need to make your own copy of the repo so that you can work on it.
+
+- On the projects main page, find the **Fork** button, and click it.
+
+  ![](images/fork.png)
+
+- You will now have a copy of the repo. You should see a **Clone or download** button. Clicking this will reveal the uniform resource identifier (URI) of the repo. Now, using the terminal, you can clone the repo to your computer with `git clone`:
+
+  ```bash
+  git clone https://github.com/HelpfulUser/getting-started-with-git.git
+  ```
+
+- All the files and directories will now be on your computer. Go ahead and make the changes you want, then commit them and push them back up to GitHub, just like you would normally do. Here your commit message is particularly important, as it will explain the changes you have made to the resource's original owner.
+
+- You can now head back over to GitHub. Find the button that says **New pull request**.
+
+  ![](images/pull.png)
+
+- Click the button and then click on the **Create pull request** button.
+
+  ![](images/pull2.png)
+
+- Your commit message will be there, but you can change it and even add a more detailed description if you like.
+
+  ![](images/pull3.png)
+
+- Once you're happy, click the **Create pull request** button. The maintainer of the repo will then be able to see your pull request. They can then choose to merge it into their repo, or close it.
+
+  ![](images/pull4.png)

fr-FR/step_14.md

@@ -0,0 +1,7 @@
+## What next?
+
+- Now that you have an understanding of the way Git and GitHub works, you could start using it for all your projects.
+
+- When you create a project, don't forget to tell people about it, and send them links to your GitHub repos. That way they can use your code and maybe even help to make it better.
+
+- Why not find a project that you could help out with on GitHub? You can help with anything from improving the code and the documentation to fixing little typos.

fr-FR/step_2.md

@@ -0,0 +1,3 @@
+## What you will need
+
+- An internet connected computer

fr-FR/step_3.md

@@ -0,0 +1,13 @@
+## What is Git?
+
+![logo](images/git-logo.png)
+
+Git is a version control system (VCS) for tracking changes to files and coordinating changes between multiple people who are all working on the same code base.
+
+One way to think about Git is to imagine a magical school bag. You can pull books out of your bag and do some work whenever you like. Once you've finished your homework, you can put the books back into your school bag, and the bag remembers what changes you made to all the books inside it.
+
+What's really clever is that this school bag can be synchronised with another magical school bag that lives in the clouds. Whenever you like, you can tell the bag to copy the contents of all the books to the sky-bag. If you lose your own school bag, you don't have to worry, as you can just get a new one and grab all the books and writing from the sky-bag.
+
+That's not all though. All your friends at school also have magical school bags. They also keep their bags synchronised with the sky-bag. This means that you and your friends can all work on the homework together. If a friend has a better answer to a science question than you do, you can copy their answer from the sky-bag to your book.
+
+It gets even better than that: your teacher also has a magical school bag. When she wants to check the homework, she just copies all the books from the sky-bag to her bag. She can then check through the answers from the whole class in one go. If she spots a mistake, she can write a comment in the margin of the book, and then all the magical bags from the whole class will receive the comment. Only one person in the class needs to correct the mistake though, and then everyone in the class immediately has the correct answer.

fr-FR/step_4.md

@@ -0,0 +1,70 @@
+## Getting Git
+
+If you're working on a Raspberry Pi, then congratulations: Git already is installed in Raspbian by default. If you're using Mac OS, then you can follow the collapsed section below to instal Git and then return here to learn how to use it.
+
+## --- collapse ---
+
+## title: Installing Git on Mac OS
+
+Getting Git set up on Mac OS is easy, and has the added benefit of giving you a package manager to install lots of other awesome and open-source software.
+
+1. You're going to need to start by typing a command into a terminal window on Mac OS. This will install the [Homebrew package manager](https://brew.sh/), which is pretty similar to **apt** on Linux.
+
+   ![homebrew](images/homebrew.png)
+
+2. Open up a terminal window by typing `Cmd + Space` to open Spotlight and then type `terminal` into the search field.
+
+   ![spotlight](images/spotlight.png)
+
+3. Now copy and past the following command into the terminal window to install Homebrew.
+
+   ```bash
+   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+   ```
+
+   ![terminal](images/terminal.png)
+
+4. You can hit **Return** at the prompts and allow Homebrew to install. Once it is finished, you'll have Git installed on Mac OS, as it's an integral part of Homebrew. You can return to the [main worksheet](worksheet.md), and carry on following the guide.
+
+   ![installed](images/installed-git.png)
+
+5. As an added bonus, you now have an amazing package manager which you can use to install software. For instance, you can install Emacs just by typing `brew install emacs` into a terminal window.
+   \--- /collapse ---
+
+If you're on Windows, then you can follow the collapsed section below to install the Git shell.
+
+## --- collapse ---
+
+## title: Installing Git on Windows
+
+The easiest way to install Git on Windows is to use GitHub's application. If you do not already have a GitHub account, you should begin by setting one up, as this will make things easier later on.
+
+1. Register for an account on [GitHub](https://github.com/join?source=header-home), and choose the free plan.
+
+   ![](images/gh-reg.png)
+
+2. Head over to [desktop.github.com](https://desktop.github.com/) and click on the **Download** button to download the GitHub app.
+
+   ![github](images/download-git.png)
+
+3. Once the file has downloaded, double click on the `.exe` file and follow the onscreen instructions to install. Near the end of the registration, you'll need to use your GitHub credentials to log in, and then proceed through the rest of the steps.
+
+   ![authenticate](images/login-github.png)
+
+4. Once the setup has completed, you should see two new icons on your desktop and in your Application menu.
+
+   ![icons](images/git-icons.png)
+
+5. You can use the graphical version of the GitHub app, but if you want to follow the rest of the [worksheet](worksheet.md), you should use the **Git shell** app, which is a command line interface (CLI), to use Git. This way, you'll feel comfortable working on other operating systems, and you will also learn a little Bash (Bourne-again shell).
+
+   ![github-shell](images/github-shell.png)
+
+6. As the GitHub app has configured your username and email address, you can skip the **Setting up Git** section of the main worksheet.
+
+\--- /collapse ---
+
+Lastly, if you're on Linux, and you don't have Git installed, then you can just use your package manager to grab the software. Something like this should work:
+
+```bash
+sudo apt install git
+```

fr-FR/step_5.md

@@ -0,0 +1,16 @@
+## Setting up Git
+
+You're going to be working in a terminal window for the duration of this resource, so open it up by clicking on the icon on the desktop, or by pressing `Ctrl + Alt + T` on your keyboard.
+
+- The first thing to do is to tell Git who you are. This is important, as Git can be used collaboratively by lots of people, so it needs to know who made changes to which files. You can use your own username and email address, unless you are in fact the Boy Who Lived.
+
+  ```bash
+  git config --global user.name "Harry Potter"
+  git config --global user.email "[email protected]"
+  ```
+
+- Next you need to tell Git which text editor you want to use. If you don't have any particularly strong feelings about text editors, then you can just type:
+
+  ```bash
+  git config --global core.editor nano
+  ```

fr-FR/step_6.md

@@ -0,0 +1,66 @@
+## Creating your first magic school bag
+
+So you want to start a new project? Maybe it's a special ultrasonic range finder for tracking flying objects in the air. You'll want a directory on your computer for all your files to sit in, so the first thing to do is create that directory.
+
+- In the terminal, you can use the `mkdir` (make directory) command to create a new directory.
+
+  ```bash
+  mkdir snitch-sniffer
+  ```
+
+- Now you want to go into that directory. You can use the `cd` (change directory) command to do this.
+
+  ```bash
+  cd snitch-sniffer
+  ```
+
+- Next, you can create a file that will tell people what the project is about. You can use any text editor to do this, such as Notepad, TextEdit or Gedit. Create a file called `README.md`. The `.md` extension stands for **Markdown**, which is a markup language. You can learn more about Markdown [here](https://daringfireball.net/projects/markdown/).
+
+- You can now give the file a title and write a short explanation of what your project is about.
+
+  ```markdown
+  # The Golden Snitch Sniffer
+  This is a project that uses multiple long-range ultrasonic sensors to find and track 
+  an object flying in three-dimensional space. It displays the object's coordinates, 
+  speed, and trajectory through a VR headset.
+  ```
+
+- Pressing `Ctrl + X` will cause a save prompt to appear. You can type `Y` to save and then hit `Enter` to close nano.
+
+- Your file should have been created and will now be sitting in your directory. You can type `ls` in the terminal or `dir` if you are using Windows, to see a list of files.
+
+  ```bash
+  ls
+  ```
+
+- At the moment, the directory is just like any other directory on your system. You now need to make the magical school bag part. This is known as a **Git repository**, and it takes the form of a hidden directory that keeps track of all the changes to the working directory. Type the following to create the repository, which from now on will just be called a **repo**:
+
+  ```bash
+  git init
+  ```
+
+- If you type `ls` again, nothing will appear to have changed. You can use `ls -a` to see all the hidden files and directories, though. If you are using Windows then type `dir /A` instead.
+
+  ```
+  ls -a
+  ```
+
+- You should now see something like this in your terminal window:
+
+  ```bash
+  .  ..  .git  README.md
+  ```
+
+- That `.git` directory is the **repo skeleton**. You can have a look inside it by typing the following. (Remember if you are using Windows it would be `dir /A .git`.)
+
+  ```bash
+  ls -a .git
+  ```
+
+- This should bring up something like:
+
+  ```bash
+  branches  config  description  HEAD  hooks  info  objects  refs
+  ```
+
+- You don't really need to worry about this directory at all now. Just know that it is there and that it is tracking all the changes to the parent directory `snitch-sniffer`.