L10n fr

.gitignore

@@ -1,2 +1,3 @@
 .DS_Store
-node_modules
+node_modules
+exercises/stylish_css/public/main.css

exercises/good_old_form/exercise.js

@@ -0,0 +1,70 @@
+var qs            = require('querystring')
+  , through2      = require('through2')
+  , superagent    = require('superagent')
+  , exercise      = require('workshopper-exercise')()
+  , filecheck     = require('workshopper-exercise/filecheck')
+  , execute       = require('workshopper-exercise/execute')
+  , comparestdout = require('workshopper-exercise/comparestdout')
+  , rndport       = require('../../lib/rndport');
+
+// checks that the submission file actually exists
+exercise = filecheck(exercise)
+
+// execute the solution and submission in parallel with spawn()
+exercise = execute(exercise)
+
+// set up ports to be passed to submission and solution
+exercise.addSetup(function(mode, callback) {
+  this.submissionPort = rndport()
+  this.solutionPort   = this.submissionPort + 1
+
+  this.submissionArgs = [this.submissionPort]
+  this.solutionArgs   = [this.solutionPort]
+
+  process.nextTick(callback)
+})
+
+// add a processor for both run and verify calls, added *before*
+// the comparestdout processor so we can mess with the stdouts
+exercise.addProcessor(function (mode, callback) {
+  this.submissionStdout.pipe(process.stdout)
+
+  // replace stdout with our own streams
+  this.submissionStdout = through2()
+  if (mode == 'verify')
+    this.solutionStdout = through2()
+
+  setTimeout(query.bind(this, mode), 500)
+
+  process.nextTick(function () {
+    callback(null, true)
+  })
+})
+
+
+// compare stdout of solution and submission
+exercise = comparestdout(exercise)
+
+// delayed for 500ms to wait for servers to start so we can start
+// playing with them
+function query (mode) {
+  var exercise = this
+
+  function connect (port, stream) {
+    var url = 'http://localhost:' + port + '/form'
+    var text = exercise.__('exercises.good_old_form.source').split('').reverse().join('');
+
+    superagent
+      .post(url)
+      .type('form')
+      .send({str: text})
+      .pipe(stream)
+  }
+
+  connect(this.submissionPort, this.submissionStdout)
+
+  if (mode == 'verify')
+    connect(this.solutionPort, this.solutionStdout)
+}
+
+module.exports = exercise

exercises/good_old_form/problem.fr.md

@@ -0,0 +1,65 @@
+Écrivez une route (`'/form'`) qui traite les données d’un formulaire HTML
+(`<form><input name="str"/></form>`) en renvoyant le texte du champ
+`str` à l’envers.
+
+-----------------------------
+
+## CONSEILS
+
+Pour gérer une requête POST, utilisez la méthode `post()` de la même
+façon que vous utilisez `get()` jusqu’à présent :
+
+```js
+app.post('/path', function(req, res){...})
+```
+
+Express.js utilise des middlewares pour fournir des fonctions supplémentaires
+à votre serveur web.
+
+Pour faire simple, un middleware est une fonction invoquée par Express.js avant
+votre gestionnaire de requête.
+
+Les middlewares fournissent un large éventail de fonctionnalités telles que
+la journalisation (logs), les fichiers statiques ou la gestion des erreurs.
+
+Un middleware est ajouté en appelant `use()` sur l’application et en passant
+le middleware en argument.
+
+Pour analyser les corps de requête `x-www-form-urlencoded` que génèrent les
+formulaires, Express.js peut recourir au middleware `urlencoded()` fourni par
+le module `body-parser`.
+
+```js
+var bodyParser = require('body-parser')
+app.use(bodyParser.urlencoded({extended: false}))
+```
+
+Vous pouvez en apprendre plus sur les middlewares Connect ici :
+
+  https://github.com/senchalabs/connect#middleware
+
+La documentation du module `body-parser` est disponible ici :
+
+  https://github.com/expressjs/body-parser
+
+Et voici comment inverser les caractères d’une `String` :
+
+```js
+req.body.str.split('').reverse().join('')
+```
+
+-----------------------------
+
+## NOTE
+
+Quand on crée un projet à partir de zéro, on aura besoin d’installer le
+module `body-parser` avec npm, en tapant la commande suivante :
+
+```sh
+$ npm install body-parser
+```
+
+…dans votre terminal.
+
+Pour rappel, le numéro de port à utiliser vous sera fourni par {appname}
+dans `process.argv[2]`.

exercises/good_old_form/problem.md

@@ -0,0 +1,60 @@
+Write a route (`'/form'`) that processes HTML form input
+(`<form><input name="str"/></form>`) and prints backwards the `str` value.
+
+-----------------------------
+
+## HINTS
+
+To handle POST request use the `post()` method which is used the same way as `get()`:
+
+```js
+app.post('/path', function(req, res){...})
+```
+
+Express.js uses middleware to provide extra functionality to your web server.
+
+Simply put, a middleware is a function invoked by Express.js before your own
+request handler.
+
+Middlewares provide a large variety of functionalities such as logging, serving
+static files and error handling.
+
+A middleware is added by calling `use()` on the application and passing the
+middleware as a parameter.
+
+To parse `x-www-form-urlencoded` request bodies Express.js can use `urlencoded()`
+middleware from the `body-parser` module.
+
+```js
+var bodyparser = require('body-parser')
+app.use(bodyparser.urlencoded({extended: false}))
+```
+
+Read more about Connect middleware here:
+
+  https://github.com/senchalabs/connect#middleware
+
+The documentation of the body-parser module can be found here:
+
+  https://github.com/expressjs/body-parser
+
+Here is how we can flip the characters:
+
+```js
+req.body.str.split('').reverse().join('')
+```
+
+-----------------------------
+
+## NOTE
+
+When creating your projects from scratch, install the `body-parser` dependency
+with npm by running:
+
+```sh
+$ npm install body-parser
+```
+
+…in your terminal.
+
+Again, the port to use is passed {appname} to the application as `process.argv[2]`.

exercises/hello_world/exercise.js

@@ -0,0 +1,71 @@
+var through2      = require('through2')
+  , superagent    = require('superagent')
+  , exercise      = require('workshopper-exercise')()
+  , filecheck     = require('workshopper-exercise/filecheck')
+  , execute       = require('workshopper-exercise/execute')
+  , comparestdout = require('workshopper-exercise/comparestdout')
+  , rndport       = require('../../lib/rndport');
+
+// checks that the submission file actually exists
+exercise = filecheck(exercise)
+
+// execute the solution and submission in parallel with spawn()
+exercise = execute(exercise)
+
+// set up ports to be passed to submission and solution
+exercise.addSetup(function(mode, callback) {
+  this.submissionPort = rndport()
+  this.solutionPort   = this.submissionPort + 1
+
+  this.submissionArgs = [this.submissionPort]
+  this.solutionArgs   = [this.solutionPort]
+
+  process.nextTick(callback)
+})
+
+// add a processor for both run and verify calls, added *before*
+// the comparestdout processor so we can mess with the stdouts
+exercise.addProcessor(function (mode, callback) {
+  this.submissionStdout.pipe(process.stdout)
+
+  // replace stdout with our own streams
+  this.submissionStdout = through2()
+  if (mode == 'verify')
+    this.solutionStdout = through2()
+
+  setTimeout(query.bind(this, mode), 500)
+
+  process.nextTick(function () {
+    callback(null, true)
+  })
+})
+
+
+// compare stdout of solution and submission
+exercise = comparestdout(exercise)
+
+// delayed for 500ms to wait for servers to start so we can start
+// playing with them
+function query (mode) {
+  var exercise = this
+
+  function connect (port, stream) {
+    var url = 'http://localhost:' + port + '/home'
+
+    superagent.get(url)
+      .on('error', function (err) {
+        exercise.emit(
+            'fail'
+          , exercise.__('fail.connection', {address: url, message: err.message})
+        )
+      })
+      .pipe(stream)
+  }
+
+  connect(this.submissionPort, this.submissionStdout)
+
+  if (mode == 'verify')
+    connect(this.solutionPort, this.solutionStdout)
+}
+
+module.exports = exercise

exercises/hello_world/problem.fr.md

@@ -0,0 +1,27 @@
+Créez une application Express.js qui affiche « Bonjour monde ! » lorsqu’on
+va sur `/home`.
+
+Le numéro de port vous sera fourni par {appname} comme premier argument de la
+ligne de commande, donc sur `process.argv[2]`.
+
+-----------------------------
+
+## CONSEILS
+
+Voici comment nous pourrions créer une application Express.js qui écoute sur
+le port 3000 et répond aux requêtes sur `'/'` :
+
+```js
+var express = require('express')
+var app = express()
+app.get('/', function(req, res) {
+  res.end('Bonjour, monde !')
+})
+app.listen(3000)
+```
+
+Pensez à utiliser `process.argv[2]` plutôt qu’un numéro de port fixe :
+
+```js
+app.listen(process.argv[2])
+```

exercises/hello_world/problem.md

@@ -0,0 +1,26 @@
+Create an Express.js app that outputs "Hello World! when somebody goes to `/home`.
+
+The port number will be provided to you by {appname} as the first argument of
+the application, ie. `process.argv[2]`.
+
+-----------------------------
+
+## HINTS
+
+This is how we can create an Express.js app on port 3000, that responds with
+a string on `'/'`:
+
+```js
+var express = require('express')
+var app = express()
+app.get('/', function(req, res) {
+  res.end('Hello World!')
+})
+app.listen(3000)
+```
+
+Please use `process.argv[2]` instead of a fixed port number:
+
+```js
+app.listen(process.argv[2])
+```

exercises/hello_world/solution_fr/solution.js

@@ -0,0 +1,6 @@
+var express = require('express')
+var app = express()
+app.get('/home', function(req, res) {
+  res.end('Bonjour, monde !')
+})
+app.listen(process.argv[2])