French translation

README.md

@@ -5,18 +5,31 @@ where you can learn the Ruby language. Starting from zero knowledge about
 programming you can learn the basics of Ruby in 56 short lessons.
 
 ## Credits
-Try Ruby version 1 by _why the lucky stiff_  
-Try Ruby version 2 by _Andrew McElroy & David Miani_  
-Try Ruby version 3 by _Eric Allam & Nick Walsh_  
-Try Ruby version 4 by _Ivo Herweijer_  
+Try Ruby version 1 by _why the lucky stiff_
+Try Ruby version 2 by _Andrew McElroy & David Miani_
+Try Ruby version 3 by _Eric Allam & Nick Walsh_
+Try Ruby version 4 by _Ivo Herweijer_
 
 This website is partially based on OpalRb.com by _Adam Beynon_.
 
 ### Translations
-Spanish translation by _Jesus Gabriel y Galan_ & _Pablo García_  
-Dutch translation by _Ivo Herweijer_  
+Spanish translation by _Jesus Gabriel y Galan_ & _Pablo García_
+Dutch translation by _Ivo Herweijer_
 Brazilian Portuguese translation by [_Ricardo da Verdade Silva_](https://github.com/ricardovsilva)<br>
 Japanese translation by _Koji Shimada_ & _Masayoshi Takahashi_
+French translation by _Olivier Lacan_
+
+To add a translation:
+- duplicate the `translations/en` directory and name the new directory
+  with the appropriate [ISO 639-1 code][iso] for the language new
+  language.
+- translate all Markdown files within your new translation directory.
+- duplicate `source/try_ruby_en.json`, replace `en` with your new
+  language code, and translate all lesson titles inside the file.
+- add a reference to your Markdown translation directory and JSON file
+  inside of `collector.rb` so that they can be loaded.
+- submit a Pull Request with a branch named after your translation
+  language.
 
 ## Preparing
 Clone this repo, and use bundler to get dependencies:
@@ -71,3 +84,5 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
+
+[iso]: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

collector.rb

@@ -45,7 +45,7 @@ def source_is_newer?
 
     def collect_sources
       return if @sources.empty?
-    
+
       #@markdown = Redcarpet::Markdown.new(Redcarpet::Render::HTML, extensions = {})
       @markdown = Redcarpet::Markdown.new(HTMLWithPants, extensions = {})
 
@@ -138,6 +138,7 @@ def initialize(app, options_hash={}, &block)
       Collector.new('translations/es/try_ruby_*.md', 'source/try_ruby_es.json').collect
       Collector.new('translations/pt-br/try_ruby_*.md', 'source/try_ruby_pt-br.json').collect
       Collector.new('translations/ja/try_ruby_*.md', 'source/try_ruby_ja.json').collect
+      Collector.new('translations/fr/try_ruby_*.md', 'source/try_ruby_fr.json').collect
 
       # TODO: add any new translations here
 

source/articles/2015-01-01-try-ruby-version-4.html.markdown

@@ -12,19 +12,19 @@ the lucky stiff', a.k.a. \_Why. You can read more about him on
 <a href="http://en.wikipedia.org/wiki/Why_the_lucky_stiff" target="_blank">Wikipedia</a>.
 
 \_Why doesn't exist anymore, but TryRuby lives on. It was first recreated by Andrew McElroy
-and David Miani. Next Eric Allam and Nick Walsh took over (Codeschool/EnvyLabs,
+and David Miani. Next Eric Allam and Nick Walsh took over (Envy Labs/Code School,
 available via <a href="http://tryruby.org/" target="_blank">TryRuby.org</a>).
 
 ### Why_
-This fourth iteration of TryRuby was created for several reasons. 
+This fourth iteration of TryRuby was created for several reasons.
 
 - The lesson content was getting a bit dated. For instance the stuff about reading and writing
   disk files does not really belong in an entry level course these days. Writing blog software
   is also not very appealing anymore
 - Lesson content also missed some important information (like __if__ statements)
 - All previous TryRuby versions consisted of an irb interpreter with a web front-end.
   Even though some security measures have been taken (isolating and restricting the irb process
-  and whitelisting input), this still sounds like a bad idea from a security perspective!  
+  and whitelisting input), this still sounds like a bad idea from a security perspective!
   TryRuby<sup>R4</sup> runs inside the web browser
 
 ### Changes
@@ -39,7 +39,7 @@ I had to make some alterations to the TryRuby lesson content. Also updated some
 - Removed mousehole stuff
 - Improved the feedback given to the user based on the program's output a bit
 - Added support for lesson content in multiple languages. The Spanish, Brazilian Portuguese,
-  Japanese and Dutch translations are available.  
+  Japanese and Dutch translations are available.
   __If YOU would like to add a translation to TryRuby you are most welcome !__
 - Added explanation of if/else statements
 - Changed the subject of the "Class" tutorials from building a blog (so last decade) to making an

source/index.html.markdown

@@ -8,25 +8,26 @@ description: Learn to program in Ruby in 30 minutes
 
     <div id="tryruby-lang-container">
       <div class="row">
-        <div class="col-md-2">
-          <button class="btn btn-default btn-sm" id="tryruby-lang-toggle"><span aria-hidden="true" class="glyphicon glyphicon-globe"></span></button>
+        <div class="col-md-3">
+          <button class="btn btn-default btn-sm" id="tryruby-lang-toggle"><span aria-hidden="true" class="glyphicon glyphicon-globe"></span> Language</button>
         </div>
-        <div class="col-md-10">
+        <div class="col-md-9">
           <div class="hidden" id="tryruby-lang-hider">
             <select class="form-control" id="tryruby-lang-select">
               <option value="en">English</option>
-              <option value="nl">Nederlands</option>
               <option value="es">Espa&ntilde;ol</option>
-              <option value="pt-br">Português do Brasil</option>
+              <option value="fr">Français</option>
               <option value="ja">日本語</option>
+              <option value="nl">Nederlands</option>
+              <option value="pt-br">Português do Brasil</option>
             </select>
           </div>
         </div>
       </div>
     </div>
 
     <select id="tryruby-index" class="form-control"></select>
-  
+
     <div id="tryruby-explanation">
 
       <h2 id="tryruby-title">Got 30 minutes? Give Ruby a shot right now!</h2>
@@ -35,7 +36,7 @@ description: Learn to program in Ruby in 30 minutes
         <p>Ruby is a programming language from Japan which is revolutionizing software development.</p>
         <p>The beauty of Ruby is found in its balance between simplicity and power.</p>
         <p>You can type some Ruby code in the editor and use these buttons to navigate:</p>
-        
+
         <ul>
           <li><strong>Run</strong> &rarr; Executes the code in the editor</li>
           <li><strong>Copy</strong> &rarr; Copies the example code to the editor</li>

translations/fr/README.md

@@ -0,0 +1,21 @@
+## Copyright (C)
+Try Ruby version 4 French translation, 2018, _Olivier Lacan_
+
+## The MIT License
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

translations/fr/try_ruby_10.md

@@ -0,0 +1,26 @@
+---
+lang:   EN
+title:  Vous avez 30 minutes? Essayez Ruby!
+answer:
+class:  stretcher chapmark
+ok:
+error:
+---
+
+Ruby est un language de programmation originaire du Japon et qui a
+revolutionné le développement logiciel.
+
+La beauté de Ruby se situe dans sa balance entre simplicité et puissance.
+
+Vous pouvez saisir du code Ruby dans l'éditeur et utiliser les boutons suivants pour naviguer:
+
+- __Run__ → Execute le code dans l'éditeur
+- __Copy__ → Copie l'example de code dans l'éditeur
+- __Next__ → Vous permet de sauter à la leçon suivante
+- __Back__ → Vous permet de revenir à la leçon précédente
+- __Clear__ → Remets l'éditeur à zéro
+
+Utilise le bouton 'planête' <span aria-hidden="true" class="glyphicon glyphicon-globe"></span>
+ci-dessus pour changer le language de TryRuby.
+
+### Clique sur __Next__ pour commencer à apprendre.

translations/fr/try_ruby_100.md

@@ -0,0 +1,18 @@
+---
+lang:   EN
+title:  Stop, vous êtes barge!
+answer: ^\d{1,}$
+ok:     Seuls les strings peuvent être inversés
+error:
+---
+
+Vous ne pouvez pas inverser le nombre quarante. J'imagine que vous
+pourriez tenir votre moniteur en face d'un mirroir, may inverser un
+nombre ne fait simplement aucun sens.
+
+Ruby a lancé un message d'erreur. Ruby vous dit qu'il n'y a pas de methode
+pour inverser des nombres.
+
+Tu pourrais peut-être transformer ce nombre en string pour commencer:
+
+    40.to_s.reverse

translations/fr/try_ruby_110.md

@@ -0,0 +1,24 @@
+---
+lang:   EN
+title:  Les garçons sont différents des filles
+answer: \[\]
+ok:     Bon, d'accord, voilà une liste vide.
+error:
+---
+
+Et les nombres sont différents des strings.
+
+Bien qu'il soit possible d'utiliser des methodes sur n'importe quel
+objet avec Ruby, certaines methodes ne fonctionnent qu'avec certains
+types de choses. Mais il est toujours possible de passer d'un type à un
+autre avec les methodes "to" to Ruby.
+
+- __to_s__ convertit les choses en __s__trings
+- __to_i__ convertit les choses en __i__ntegers (nombres)
+- __to_a__ convertit les choses en __a__rrays
+
+__Qu'est-ce qu'un array?!__
+
+Ce sont des listes. Saisi une paire de crochets:
+
+    []

translations/fr/try_ruby_120.md

@@ -0,0 +1,21 @@
+---
+lang:   EN
+title:  Faire la queue
+answer: ^\[(\d+)(,\s*\d+){3,}\]$
+ok:     Excellent
+error:  Essaye d'ajouter un quatrième nombre à la liste
+---
+
+Les listes (arrays) stockent des choses __dans un ordre indéfini__.
+
+C'est un peu comme faire la queue pour acheter une baguette. Tu es
+derrière quelqu'un et ce sera impensable de les pousser pour passer
+devant, non? Et le mec derrière toi, tu gardes un oeil sur lui, juste au
+cas où ?
+
+Voilà une liste pour toi. Des numéros de lotterie:
+
+    [12, 47, 35]
+
+Essayes d'ajouter un nombre à cette liste: saisi une virgule après 35
+suivie d'un nombre. L'espace est facultatif.

translations/fr/try_ruby_130.md

@@ -0,0 +1,13 @@
+---
+lang:   EN
+title:  Un d'entre eux lève la main
+answer: ^47$
+ok:     D'accord
+error:
+---
+
+Une liste de numéros de lotterie. Lequel est le plus grand ?
+
+Essaye:
+
+    [12, 47, 35].max

translations/fr/try_ruby_140.md

@@ -0,0 +1,14 @@
+---
+lang:   EN
+title:  Ranger une liste proprement
+answer: ^\[(\d+)(,\s*\d+){2,}\]$
+ok:     Sauvegardé!
+error:
+---
+
+Bien, bien. Cela dit c'est ennuyant d'avoir à retaper cette liste chaque
+fois que tu en as besoin, non ?
+
+Sauvegardons nos numéros dans un ticket comme ça:
+
+    ticket = [12, 47, 35]

translations/fr/try_ruby_150.md

@@ -0,0 +1,12 @@
+---
+lang:   EN
+title:  Maintenant entre ticket
+answer: \[(\d+(, )?){2,}\]
+load:   ticket = [12, 47, 35]
+ok:     Réstoré!
+error:
+---
+
+Maintenant, saisi:
+
+    ticket

translations/fr/try_ruby_160.md

@@ -0,0 +1,27 @@
+---
+lang:   EN
+title:  Sauvegardé, rangé proprement
+answer: \[12, 35, 47\]
+load:   ticket = [12, 47, 35]
+ok:     Tu as organisé la liste en ordre
+error:
+---
+
+Tu as gardé tes numéro de lotto en le rangeant dans une __variable__
+nommée ticket. Mais n'importe quel autre nom, comme _lalistedejimmy_,
+aurait aussi fait l'affaire.
+
+Comme tu découvrira, la programmation c'est surtout jongler des
+variables.
+
+Mettons les numéros de lotto dans l'ordre.
+
+Utilises:
+
+    ticket.sort!
+
+Tu avais une liste. Tu as organisé la liste dans l'ordre. La variable
+ticket a maintenant changé Est-ce que tu as remarqué que la methode
+_sort!_ a un gros point d'exclamation à la fin ? Souvent les methodes
+Ruby crient comme ça lorsqu'elle modifient une variable pour de bon.
+C'est rien de grave, juste une ponctuation.

translations/fr/try_ruby_170.md

@@ -0,0 +1,37 @@
+---
+lang:   EN
+title:  Élementaire
+answer: ^(12|35|47)$
+load:   ticket = [12, 47, 35]
+ok:     D'accord
+error:  Presque
+---
+
+Donc nous avons stocké nos numéros de lotterie dans la variable ticket.
+Comment faire pour les retrouver?
+
+On a déjà vu qu'il est possible d'obtenir le numéro le plus élevé avec __max__.
+On peut également obtenir le premier (__first__) ou le dernier (__last__)
+élement de la liste.
+Mais que faire si on a besoin d'un élement specifique de la liste?
+
+### [ ]
+Ruby utilises des crochets droits [ ] pour viser un élement.
+Les crochets droits sont très commun dans Ruby.
+Ce sont comme des lunettes de visée pour aligner une cible. Exactement.
+Ces crochets signifient, "Je cherche ____". Prêt, vises.
+
+Recupèrons tous nos numéros de lotto:
+
+    puts ticket[0]
+    puts ticket[1]
+    puts ticket[2]
+
+Pourquoi utiliser [0], [1], [2]?
+
+Et pourquoi pas [1], [2] and [3] ? Est-ce que c'est une éspèce de truc Zen japonais ?
+Non, nous autre les amis des ordinateurs on préfère juste commencer à compter à
+partir de zéro. C'est pas juste un truc dans Ruby, ça s'appelle _l'indexation à
+base zéro_ et c'est utilisé dans la plupart des languages de programmation.
+
+> Un petit rappel: tu peux utiliser le bouton __Copy__ pour recopier l'exemple de code dans l'éditeur.

translations/fr/try_ruby_180.md

@@ -0,0 +1,34 @@
+---
+lang:   EN
+title:  Le résumé #2 est arrivé
+answer: \w+
+class:  stretcher chapmark
+load:   poem = "My toast has flown from my hand\nAnd my toast has gone to the moon.\nBut when I saw it on television,\nPlanting our flag on Halley's comet,\nMore still did I want to eat it.\n"
+ok:     Est-ce que ça rime?
+error:
+---
+
+Jettons un oeil à ce qui s'est passé pendant ta deuxième minute:
+
+### Erreurs
+Si tu essayes d'inverser un nombre ou de faire des choses bizzares, Ruby
+te dira ce qui ne va pas.
+
+### Listes
+Les arrays sont des listes pour stocker des choses dans un ordre
+spécifique. On sait égaelement comment créer un array et récuperer des
+élement dans un array.
+
+### Variables
+Les variables sauvegardent une chose et lui donne un nom. Tu as utilisé
+le signe égal pour ça. Par example: ticket = [14, 37, 18].
+
+### 2/8
+En tout il y a huit sections. Tu as fini deux-huitièmes du chemin! C'est
+pas si compliqué, non? Et il y a plein de bonnes choses à suivre.
+
+Changeons de direction pour un instant. J'ai mis un petit bout de poésie
+pour toi dans une certaine variable.
+Jette un oeil. Saisi:
+
+    puts poem