french translation proposal

_includes/lang_list.html

@@ -1 +1,2 @@
 <li><a href="/en/">English</a></li>
+<li><a href="/fr/">Français</a></li>

_includes/nav_fr.html

@@ -0,0 +1,31 @@
+    <nav class="navbar navbar-default navbar-fixed-top">
+      <div class="container">
+          <div class="navbar-header">
+              <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false">
+              <span class="sr-only">Basculer la navigation</span>
+              <span class="icon-bar"></span>
+              <span class="icon-bar"></span>
+              <span class="icon-bar"></span>
+              </button>
+              <a class="navbar-brand" href="/fr">
+                <img class="brand" alt="Mu Logo" src="/img/brand.png"/>
+              </a>
+          </div>
+          <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+              <ul class="nav navbar-nav">
+                  <li><a href="/fr/download">Téléchargement</a></li>
+                  <li><a href="/fr/about">A propos</a></li>
+                  <li><a href="/fr/tutorials">Tutoriels</a></li>
+                  <li><a href="/fr/howto">Comment faire.. ?</a></li>
+                  <li><a href="/fr/discuss">Discuster</a></li>
+                  <li><a href="/fr/developers">Développeurs</a></li>
+                  <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Language<span class="caret"></span></a>
+                      <ul class="dropdown-menu">
+                        {% include lang_list.html %}
+                      </ul>
+                  </li>
+              </ul>
+          </div>
+      </div>
+    </nav>

fr/about.html

@@ -0,0 +1,41 @@
+---
+layout: default
+title: A propos de Mu
+i18n: fr
+---
+<h1>A propos de Mu</h1>
+<p class="lead">Mu est un éditeur de code Python pour les débutants basé sur un <a href="/en/discuss">feedback</a> approfondi d'enseignants et d'élèves.</p>
+
+<div class="row text-center">
+    <a class="btn btn-lg btn-success" href="/fr/download" role="button">Téléchargement</a>
+    <a class="btn btn-lg btn-primary" href="/fr/tutorials" role="button">Tutoriels</a>
+    <a class="btn btn-lg btn-info" href="/fr/howto" role="button">Comment faire.. ?</a>
+</div>
+<img src="/img/logo.png" alt="Mu's world" class="img-responsive center-block img-rounded"/>
+
+
+<div class="row marketing">
+  <div class="col-lg-6">
+    <h4>Moins c'est mieux.</h4>
+    <p>Mu ne propose que les fonctionnalités essentielles, évitant aux utilisateurs d'être intimidés par 
+      une interface déroutante.</p>
+    <h4>Empruntez le chemin de l'évidence.</h4>
+    <p>Quelque soit la tâche, il n'y a qu'une seule manière de la réaliser avec Mu.</p>
+  </div>
+
+  <div class="col-lg-6">
+    <h4>Restez simples.</h4>
+    <p>Il est très rapide et facile d'apprendre à utiliser Mu ~ la complexité est l'obstacle principal des premiers pas d'un programmeur.</p>
+    <h4>Amusez vous !</h4>
+    <p>Apprendre devrait induire du plaisir ~ Mu aide les novices à créer et tester rapidement leur code.</p>
+  </div>
+</div>
+
+<img src="/img/en/kay_quote.jpg" alt="Alan Kay" class="img-responsive center-block img-rounded"/>
+<p class="text-center">
+<a href="https://commons.wikimedia.org/wiki/File:Alan_Kay_(3097597186).jpg">Image source</a>
+</p>
+
+<p class="lead"><a href="https://www.fastcompany.com/40435064/what-alan-kay-thinks-about-the-iphone-and-technology-now">Une citation sur l'apprentissage de la programmation</a>
+de <a href="https://en.wikipedia.org/wiki/Alan_Kay">Alan Kay</a> résume bien la vision de Mu. Mu aspire à être "la chose authentique" comme environnement
+pour les programmeurs débutants faisant leurs premiers pas avec Python.</p>

fr/developers.html

@@ -0,0 +1,26 @@
+---
+layout: default
+title: Développent de Mu
+i18n: fr
+---
+
+<h1>Développent de Mu</h1>
+
+<p>Souhaitez-vous contribuer au développement de Mu ? (Si vous pensez que cela
+est réservé aux développeurs expérimentés, veuillez reconsidérer votre avis, il y a
+tellement de façons de contribuer à Mu, peu importe votre niveau d'expérience ou
+vos compétences).</p>
+
+<p>Notre documentation technique est hébergée par le magnifique
+service qu'est <a href="https://mu.readthedocs.io/en/latest/" target="_blank">Read the
+Docs (http://mu.readthedocs.io/)</a>. Non seulement elle contient tous les détails nécessaires 
+pour proposer une contribution de code à Mu, mais elle décrit également bien d'autres manières d'apporter 
+votre contribution (y compris proposer des mises à jour de ce site web). Enfin, elle propose un 
+guide de nos processus et attentes pour les différentes contributions possibles 
+que vous pouvez apporter à Mu.</p>
+
+<p>Le code source est <a href="https://github.com/mu-editor/mu">hébergé sur
+GitHub</a>.</p>
+
+<p>En cas de doute, il suffit de <a href="/fr/discuss">demander dans notre espace de discussion</a> et 
+quelqu'un sera à même de vous montrer la marche à suivre.</p>

fr/discuss.html

@@ -0,0 +1,37 @@
+---
+layout: default
+title: Discuter de Mu 
+i18n: fr
+---
+
+<h1>Discuter de Mu</h1>
+
+<p>C'est une bonne chose de parler, partager les connaissances et apprendre les uns des autres. Peut être
+que vous avez une question, un problème ou bien que vous ne savez pas comment faire quelque chose avec Mu ?
+Discuter de telles choses dans un environnement qui vous soutient est un bon moyen de progresser, 
+se faire des amis et réussir des tas de choses. Pour le dire simplement, Mu est un
+projet communautaire et nous avons créé un groupe de discussion en ligne
+où la communauté peut se retrouver.</p>
+
+<p>Toutes les contributions sont les bienvenues quelque soit votre âge,
+genre, religion, race ou sexualité. Si vous pensez "mais ça ne me concerne pas"
+, alors cela VOUS concerne tout particulièrement.</p>
+
+<p>Notre plateforme de discussion est assurée par un service appelé "Gitter" et vous
+pouvez vous enregistrer et vous connecter à la communauté en cliquant sur le bouton ci dessous ou
+en vous rendant sur : <a href="https://gitter.im/mu-editor/general" target="_blank">https://gitter.im/mu-editor/general</a></p>
+<p><a href="https://gitter.im/mu-editor/general" target="_blank" class="btn btn-primary btn-lg">Connection aux Discussions</a></p>
+
+<div class="alert alert-info" role="alert">
+<h4><strong>Code de Conduite</strong></h4>
+<p>Nous attendons des participants qu'ils respectent le code de conduite de la Python Software foundation
+<a href="https://www.python.org/psf/codeofconduct/" target="_blank"><strong>Code de Conduite</strong></a>.</p>
+
+<p>Nous n'hésiterons pas à donner un avertissement clair et, s'il est ignoré, nous bannirons 
+les personnes qui ne se comporteraient pas dans le respect de l'esprit de ce code de conduite. Nous voulons que notre 
+communauté soit sûre, accueillante et amicale. Si un problème lié au comportement se présente, 
+nous nous efforcerons d’agir de manière discrète, sympathique et juste envers toutes les personnes concernées.</p>
+</div>
+
+
+

fr/download.md

@@ -0,0 +1,95 @@
+---
+layout: default
+title: Télécharger Mu
+i18n: fr
+---
+
+# Télécharger Mu
+
+Il y a plusieurs manières d'installer Mu. La plus simple est de télécharger
+le programme d'installation officiel pour Windows ou Mac OSX. Si vous vous
+rendez compte que l'ordinateur est verrouillé, vous pouvez essayer PortaMu :
+une méthode pour utiliser Mu depuis une clé USB sous Windows ou Mac OSX. Vous
+pouvez aussi utiliser l'outil `pip` inclus avec Python. Certaines distributions
+Linux ont un paquet disponible pour Mu (et vous devriez utiliser le gestionnaire
+de paquets de votre OS pour l'installer). Enfin, si vous êtes sous Raspbian (la 
+distribution Linux pour Raspberry Pi) vous pouvez installer le paquet Mu.
+
+Si vous êtes un développeur, vous trouverez le code source
+[sur GitHub](https://github.com/mu-editor/mu).
+
+<div class="media">
+  <div class="media-left">
+    <img src="/img/windows_logo.png" alt="Windows Logo" class="media-object">
+  </div>
+  <div class="media-body">
+    <h4 class="media-heading">Installation Windows</h4>
+    <p><a href="https://github.com/mu-editor/mu/releases/download/1.0.1/mu-editor_1.0.1_win32.exe" class="btn btn-primary" role="button">32-bit</a>
+    <a href="https://github.com/mu-editor/mu/releases/download/1.0.1/mu-editor_1.0.1_win64.exe" class="btn btn-primary" role="button">64-bit</a>
+    <a href="/fr/howto/install_windows" class="btn btn-default" role="button">Instructions</a></p>
+  </div>
+</div>
+
+<hr/>
+
+<div class="media">
+  <div class="media-left">
+    <img src="/img/apple_logo.png" alt="Apple Logo" class="media-object">
+  </div>
+  <div class="media-body">
+    <h4 class="media-heading">Installation Mac OSX</h4>
+    <p><a href="https://github.com/mu-editor/mu/releases/download/1.0.1/mu-editor_1.0.1_osx.dmg" class="btn btn-primary" role="button">Télécharger</a>
+    <a href="/fr/howto/install_macos" class="btn btn-default" role="button">Instructions</a></p>
+  </div>
+</div>
+
+<hr/>
+
+<div class="media">
+  <div class="media-left">
+    <img src="/img/portamu.png" alt="PortaMu Logo" class="media-object">
+  </div>
+  <div class="media-body">
+    <h4 class="media-heading">PortaMu - Utilisez Mu depuis une clé USB</h4>
+    <p><a href="https://github.com/mu-editor/mu/releases/download/1.0.1/portamu_1.0.1_win32.zip" class="btn btn-primary" role="button">Windows 32-bit</a>
+    <a href="https://github.com/mu-editor/mu/releases/download/1.0.1/portamu_1.0.1_win64.zip" class="btn btn-primary" role="button">Windows 64-bit</a>
+    <a href="https://github.com/mu-editor/mu/releases/download/1.0.1/mu-editor_1.0.1_osx.dmg" class="btn btn-primary" role="button">Mac OSX</a>
+    <a href="/fr/howto/use_portamu" class="btn btn-default" role="button">Instructions</a></p>
+  </div>
+</div>
+
+<hr/>
+
+<div class="media">
+  <div class="media-left">
+    <img src="/img/python_logo.png" alt="Python Logo" class="media-object">
+  </div>
+  <div class="media-body">
+    <h4 class="media-heading">Package Python</h4>
+        <p><a href="/fr/howto/install_with_python" class="btn btn-default" role="button">Instructions</a></p>
+  </div>
+</div>
+
+<hr/>
+
+<div class="media">
+  <div class="media-left">
+    <img src="/img/rpi_logo.png" alt="Raspberry Pi Logo" class="media-object">
+  </div>
+  <div class="media-body">
+    <h4 class="media-heading">Raspbian</h4>
+        <p><a href="/fr/howto/install_raspberry_pi" class="btn btn-default" role="button">Instructions</a></p>
+  </div>
+</div>
+
+<br/>
+
+<div class="panel panel-danger">
+    <div class="panel-heading"><h3 class="panel-title">UTILISATEURS LINUX, ATTENTION !</h3></div>
+    <div class="panel-body">
+    <p>Sous Linux, pour que Mu fonctionne avec des appareils basés sur MicroPython vous devez
+    vous assurer d'ajouter votre utilisateur au bon groupe d'autorisations (il s'agit généralement du groupe 
+    <code>dialout</code> ou <code>uucp</code>). Faites également attention à ce que votre distribution monte bien
+    de manière automatique les appareils USB avec mémoire flash ou bien assurez vous de le faire manuellement.</p>
+    </div>
+</div>

fr/howto/bugs.md

@@ -0,0 +1,65 @@
+---
+layout: default
+title: How to report a bug in Mu
+i18n: en
+---
+# How to report a bug in Mu
+
+<div class="row">
+  <img src="/img/en/howto/bug.png" alt="The first bug" class="img-responsive center-block img-rounded movie"/>
+  <br/>
+</div>
+
+If you've ever written a line of code, you'll know that
+[all software has bugs](https://www.history.navy.mil/our-collections/photography/numerical-list-of-images/nhhc-series/nh-series/NH-96000/NH-96566-KN.html).
+This will be the case with Mu.
+
+If you think you have found a bug, simply click on the button below (you'll
+need to have an account on GitHub) and then click the green "New Issue" button
+found at the top right hand side of the page:
+
+<div class="row text-center">
+<p><a class="btn btn-lg btn-danger" href="https://github.com/mu-editor/mu/issues"
+        role="button" target="_blank">Report a Bug in Mu</a></p>
+</div>
+
+When you create a new issue it will be given a number and the volunteer
+developers, who write and maintain the code, will be informed by email. They
+may annotate questions to your issue, if things are not clear. They may
+immediately close it and mark it as "duplicate" (someone else has already
+reported the bug -- and they'll reference the original issue). Sometimes
+they'll close the bug and say "won't fix", because they disagree that it's a
+bug *or* it's too trivial in order to invest any time. Finally, please be aware
+of the famous [PEBCAK](https://en.wiktionary.org/wiki/PEBCAK) bug (Problem
+Exists Between Chair and Keyboard). This simply indicates the user has caused
+the problem (rather than the software): a misconfigured computer, a
+misunderstanding, or perhaps a mismatch of expectation. ;-)
+
+There are generally two sorts of bugs:
+
+* Technical: the code has a mistake in it which causes the program to break.
+* Behavioural: the code works correctly, but is doing the wrong thing.
+
+In both cases, for us to be able to fix the bug, we need **as much information
+as possible**. When you create a new issue you should try to include, where
+relevant, the following sorts of information:
+
+* What you were trying to do,
+* What steps you took to make this happen,
+* What you expected to happen,
+* What actually happened,
+* Why this difference is problematic (it may not be a bug!),
+* Technical details like the version of Mu you're using, your OS version and
+  other aspects of the context in which Mu was running. 
+
+Please remember to attach a [copy of the full log files for Mu](read_logs).
+
+Use plain and simple language to describe the problem and, if helpful, break
+it down into steps so developers can easily recreate the issue. Please don't
+assume we'll understand what you were trying to achieve -- honestly, it's best
+if you try to imagine we (the developers) are a bunch of clever 5-year-olds. 
+Try to explain *everything* about the problem and don't assume we know what you
+mean. We won't mind! ;-)
+
+If you would like to get more involved in the development of Mu, we'd love to
+welcome you via the [Mu developer's website](http://mu.rtfd.io/).

fr/howto/copy_files_microbit.md

@@ -0,0 +1,44 @@
+---
+layout: default
+title: How to copy files on and off a micro:bit
+i18n: en
+---
+# How to Copy Files On and Off a micro:bit
+
+MicroPython on the BBC micro:bit has [a very small filesystem](https://microbit-micropython.readthedocs.io/en/latest/tutorials/storage.html).
+Often you'll want to copy small files onto the device, or copy them from the
+micro:bit onto your own computer for further processing.
+
+Happily, Mu has a visual way to do this by dragging and dropping files. Click
+on the button shown below:
+
+<div class="row">
+  <img src="/img/en/howto/microbit_files.png" alt="Files button" class="img-responsive center-block img-rounded movie"/>
+</div>
+
+The pane shown below will appear at the bottom of Mu's window. Simply click and
+drag a file between the list of files on the micro:bit and those on your
+computer (as the animation shows). The files on your computer can be found in
+the folder Mu uses as your working directory (see the tutorial called
+[where are my files?](/en/tutorials/1.0/files)).
+
+<div class="row">
+  <img src="/img/en/howto/microbit_files.gif" alt="Moving files with a micro:bit" class="img-responsive center-block img-rounded movie"/>
+  <br/>
+</div>
+
+<div class="panel panel-danger">
+    <div class="panel-heading"><h3 class="panel-title">
+    <strong>WARNING:</strong> Don't toggle files off while the micro:bit is
+    busy!</h3></div>
+    <div class="panel-body"><p>If you click the "Files" button while the
+    micro:bit is still reacting to instructions from Mu (such as listing files,
+    getting the content of a file, and so on), then you may find that
+    afterwards the REPL behaves strangely.</p>
+    <p>The solution is simply to press restart on the device while the "Files"
+    or "REPL" panes are off.</p>
+    <p>If in doubt while using the "Files" pane, just wait for Mu to confirm
+    that whatever file related activity is happening, is reported as finished
+    (as shown above).</p>
+    </div>
+</div>

fr/howto/create_load_save.md

@@ -0,0 +1,41 @@
+---
+layout: default
+title: How to create, load and save files in Mu.
+i18n: en
+---
+# How to create, load and save files in Mu
+
+You need to understand what each of the following three buttons do:
+
+<div class="row">
+  <img src="/img/en/howto/create_load_save.png" alt="New, Load and Save buttons" class="img-responsive center-block img-rounded movie"/>
+  <br/>
+</div>
+
+* **New** - Click on this button to create a new empty file. Before you can run
+  your code you'll need to save it (i.e. give it a filename).
+* **Load** - When you click this button a file selector dialog box pops up and
+  you should click on the Python file you'd like to load into Mu (or press
+  cancel).
+* **Save** - Clicking this button saves the file in the currently selected tab.
+  If the file was newly created then Mu will ask you for a name for the file.
+
+<div class="panel panel-info">
+    <div class="panel-heading"><h3 class="panel-title">Copy/Rename Files</h3></div>
+    <div class="panel-body">
+        <p>If you want to create a newly named copy of the current file you
+        can rename it by clicking on the filename in the file's tab in Mu.</p>
+    </div>
+</div>
+
+<div class="panel panel-danger">
+    <div class="panel-heading"><h3 class="panel-title">Don't Use Python Module Names</h3></div>
+    <div class="panel-body">
+        <p>It's tempting to name your new file that uses the <code>turtle</code>
+        module as "turtle.py". <strong>Don't do this!</strong> If you name
+        your file after a module you're using <strong>in your code</strong>
+        then Python will break because it's trying to import
+        <strong>your</strong> code rather than the code from Python's standard
+        library!</p>
+    </div>
+</div>