docs(README_fr_FR): update with info about latest refactorings

Translation in french

Closes #62

Author: forresst

README_fr_FR.md

@@ -1,6 +1,6 @@
 # Dgeni Packages
 
-Ce dépôt contient une collection de packages de dgeni qui peuvent être utilisés par dgeni, le générateur
+Ce dépôt contient une collection de packages de Dgeni qui peuvent être utilisés par Dgeni, le générateur
 de documentation, pour créer une documentation à partir du code source.
 
 
@@ -14,6 +14,7 @@ Actuellement, il y a les packages suivants :
 * ngdoc - La partie spécifique d'angular.js, avec la définition des balises, des processeurs et des templates.
   Celui-ci charge les packages de jsdoc et nunjucks pour vous.
 * examples - Processeurs pour supporter les exemples exécutables qui figurent sur les docs du site d'angular.js.
+* dgeni - support pour la documentation des packages de Dgeni
 
 ## Le package `base`
 
@@ -22,11 +23,13 @@ Actuellement, il y a les packages suivants :
 * `debugDumpProcessor` - extrait l'état courant du tableau docs dans un fichier (désactivé par défaut)
 * `readFilesProcessor` - utilisé pour charger les documents depuis les fichiers. Ce processeur peut-être configuré pour utiliser
 un ensemble de **lecteur de fichier**. Il y a des lecteurs de fichiers (file-readers) dans les packages `jsdoc` et `ngdoc`.
+* `computePathsProcessor` - Détermine le `path` et le `outputPath` des documents en utilisant des templates ou des fonctions
+d'aide, sur la base du `docType`.
 * `renderDocsProcessor` - rendre les documents dans une propriété (`doc.renderedContent`) en utilisant
 un `templateEngine` (moteur de template), qui doit être fourni séparément - voir le package `nunjucks`.
 * `unescapeCommentsProcessor` - reformatte les marqueurs de commentaires pour ne pas casser le style des commentaires de jsdoc,
 par exemple `*/`
-* `writeFilesProcessor` - écrit les docs sur le disque
+* `writeFilesProcessor` - écrit les docs (pour ceux ont un `outputPath`) sur le disque
 
 ### Services
 
@@ -79,8 +82,6 @@ pour rendre les documents en texte, tel que le HTML ou le JS, basé sur des temp
 
 * `codeNameProcessor` - détermine le nom du document selon le code qui suit dans le document
 dans le fichier source.
-* `computePathProcessor` - détermine le chemin du document, utilisé pour écrire le fichier et pour naviguer
-vers le document dans une application web.
 * `parseTagsProcessor` - utilise un `tagParser` pour analyser les balises de jsdoc dans le contenu du document.
 * `extractTagsProcessor` - utilise un `tagExtractor` pour extraire l'information depuis les balises analysées.
 * `inlineTagsProcessor` - recherche les docs pour les balises [`inline`](http://usejsdoc.org/about-inline-tags.html) qui ont besoin d'avoir de l'injection de contenu
@@ -92,10 +93,10 @@ Le package `jsdoc` contient des définitions pour un certain nombre de balise st
 `animations`, `constructor`, `class`, `classdesc`, `global`, `namespace`, `method`, `type` et
 `kind`.
 
-### Services
+### Services (Transformations de balise)
 
-Ce package fournit un certain nombre de services tagTransform qui sont utilisés dans les définitions de balise pour transformer
-la valeur de la balise depuis le string dans le commentaire en quelque chose de plus significatif dans le doc.
+Ce package fournit un certain nombre de services **Transform** qui sont utilisés dans les **définitions de balise** pour transformer
+la valeur de la balise depuis le string du commentaire en quelque chose de plus significatif dans le doc.
 
 * `extractNameTransform` - extrait un nom à partir d'une balise
 * `extractTypeTransform` - extrait un type à partir d'une balise
@@ -108,6 +109,11 @@ la valeur de la balise depuis le string dans le commentaire en quelque chose de
 **Ce package ne fournit pas de templates, ni un `templateEngine` pour rendre les templates (utilisez le
 package `nunjucks` pour faire cela).**
 
+### Définitions des balises
+
+Ce package fournit une implémentation minimale des balises du projet JSDoc. Elles extraient le nom et
+le type depuis la description de la balise trouvée, mais elles n'implémentent pas la totalité des fonctionnalités des balises JSDoc.
+
 ## Le package `ngdoc`
 
 Le package `ngdoc` dépend des packages `jsdoc` et `nunjucks`.
@@ -144,25 +150,34 @@ Génère des documents pour chaque groupe de composants (par type) dans un modul
 * `computeIdProcessor` -
 Détermine la propriété id du doc sur la base des balises et d'autres méta-données
 
-* `computePathProcessor` -
-Détermine path et outputPath pour les docs qui n'ont pas déjà
-
 * `filterNgdocsProcessor` -
 Pour AngularJS, nous sommes seulement intéressés aux documents qui contiennent les balises @ngdoc. Ce processeur
 supprime les docs qui ne contiennent pas cette balise.
 
 * `collectPartialNames` -
-Ajoute tous les docs à partialNameMap
+Ajoute tous les docs à `partialNameMap`
+
+
+### Définitions des balises
+
+Ce package modifie et ajoute de nouvelles définitions de balises en plus de celles fournies par le package `jsdoc`.
+
+
+### Définitions des balises Inline
+
+* `link` - Traite les balises Inline de lien (sous la forme {@link une/uri Un Titre}), en les remplaçant par
+des ancres HTML
 
 
 ### Services
 
-* `getLinkInfo()`
-* `getPartialNames()`
-* `gettypeClass()`
-* `moduleMap`
-* `parseCodeName()`
-* `patialNameMap`
+* `getLinkInfo()` - Récupère les informations du lien depuis un document qui correspond à l'url donné
+* `getPartialNames()` - Récupère une liste de tous les noms de code de partiel qui peuvent être utilisés à partir d'un ensemble
+donné
+* `gettypeClass()` - Récupère un string de classe CSS pour un string de type donné
+* `moduleMap` - Une collection de modules correspondant au nom du module
+* `parseCodeName()` - Découpe le nom de code en plusieurs morceaux
+* `patialNameMap` - Une map de nom de partiel pour les docs
 
 
 ### Templates
@@ -181,10 +196,39 @@ templateEngine.config.tags = {
 };
 ```
 
+### Filtres de rendu
+
+* `code` - Rend un span de text comme du code
+* `link` - Rend un lien HTML
+* `typeClass` - Rend une classe CSS pour un type donné
+
+### Balises de rendu
+
+* `code` - Rend un bloc de code
+
+
 ## Le package `examples`
 
 Ce package est un mix qui fournit des fonctionnalités pour travailler avec des exemples dans les docs.
 
+À l'intérieur de vos documents, vous pouvez baliser example de la manière suivante :
+
+```
+Du texte avant l'exemple
+
+<example name="example-name">
+  <file name="index.html">
+    <div>Le HTML principal de l'exemple</div>
+  </file>
+  <file name="app.js">
+    // Du code JavaScript à inclure dans l'exemple
+  </file>
+</example>
+
+Du texte après l'exemple
+```
+
+
 ### Processeurs
 
 * `parseExamplesProcessor` -
@@ -193,8 +237,15 @@ Analyse les balises `<example>` depuis le contenu et les ajoute au service `exam
 Ajoute les nouveaux docs à la collection de docs pour chaque exemple dans le service `examples` qui sera rendue
 comme des fichiers qui peuvent être exécutés dans le navigateur, par exemple en direct des démos ou pour
 des tests de e2e.
+* `generateProtractorTests` - Génère les fichiers de test de protractor depuis les tests e2e dans les exemples
+
+### Définitions des balises Inline
+
+* `runnableExample` -  Injecte l'exemple exécutable spécifié dans la doc
+
 
 ### Services
 
-* examples - une map contenant chaque exemple par le nom
+* `exampleMap` - une map contenant chaque exemple par un id. Cet id est généré de façon unique à partir
+du nom de l'exemple