Merge pull request #3302 from chafouin/fix_markdown_fr

[Markdown/fr] Fix formatting & add missing keyboard keys section

fr-fr/markdown-fr.html.markdown

@@ -6,52 +6,69 @@ filename: markdown-fr.md
 lang: fr-fr
 ---
 
+
 Markdown a été créé par John Gruber en 2004. Il se veut être d'une syntaxe
-facile à lire et à écrire, aisément convertible en HTML
+facile à lire et à écrire, aisément convertible en HTML (et dans beaucoup
- (et beaucoup d'autres formats aussi à présent).
+d'autres formats aussi).
 
-Faites moi autant de retours que vous voulez! Sentez vous libre de "forker" 
+Les implémentations du Markdown varient d'un analyseur syntaxique à un autre.
-et envoyer des pull request!
+Ce guide va essayer de clarifier quand une fonctionnalité est universelle ou
+quand elle est specifique à un certain analyseur syntaxique.
 
+- [Balises HTML](#balises-html)
+- [En-têtes](#en-tetes)
+- [Styles de texte basiques](#style-de-text-basiques)
+- [Paragraphes](#paragraphes)
+- [Listes](#listes)
+- [Blocs de code](#blocs-de-code)
+- [Séparateur horizontal](#separateur-horizontal)
+- [Liens hypertextes](#liens-hypertextes)
+- [Images](#images)
+- [Divers](#divers)
+
+## Balises HTML
+
+Markdown est un sur-ensemble du HTML, donc tout fichier HTML est un ficher
+Markdown valide.
 
 ```md
-<!-- Markdown est une sorte de cousin du HTML, si bien que tout document HTML 
+<!-- Ce qui veut dire que vous pouvez utiliser des balises HTML dans un fichier
-est un document Markdown valide. Autrement dit, vous pouvez utiliser des 
+Markdown, comme la balise commentaire dans laquelle nous sommes à présent, car
-balises HTML dans un fichier Markdown, comme la balise commentaire dans 
+celle-ci ne sera pas affectée par l'analyseur syntaxique du Markdown.
-laquelle nous sommes à présent, car celle-ci ne sera pas affectée par 
+Toutefois, si vous voulez créer une balise HTML dans un fichier Markdown,
-le parser( analyseur syntaxique ) Markdown. -->
+vous ne pourrez pas utiliser du Markdown à l'intérieur de cette derniere. -->
+```
 
-<!-- Toutefois, si vous voulez créer un élément HTML dans un fichier Markdown,
+## En-têtes
- vous ne pourrez pas utiliser du Markdown à l'intérieur de ce dernier. -->
 
-<!--  Le Markdown est implémenté de différentes manières, selon le parser. 
+Vous pouvez facilement créer des balises HTML `<h1>` à `<h6>` en précédant le
-Ce guide va alors tenter de trier les fonctionnalités universelles de celles
+texte de votre futur titre par un ou plusieurs dièses ( # ), de un à six, selon
-spécifiques à un parser.  -->
+le niveau de titre souhaité.
 
-<!-- Headers ( En-têtes ) -->
+```md
-<!-- Vous pouvez facilement créer des éléments HTML <h1> à <h6> en précédant
- le texte de votre futur titre par un ou plusieurs dièses ( # ), de un à six,
-  selon le niveau de titre souhaité. -->
 # Ceci est un <h1>
 ## Ceci est un <h2>
 ### Ceci est un <h3>
 #### Ceci est un <h4>
 ##### Ceci est un <h5>
 ###### Ceci est un <h6>
+```
 
-<!-- 
+Markdown fournit également une façon alternative de marquer les h1 et h2.
-Markdown fournit également une façon alternative de marquer les h1 et h2 
--->
 
+```md
 Ceci est un h1
 =============
 
 Ceci est un h2
 -------------
+```
 
-<!-- Styles basiques pour du texte -->
+## Styles de texte basiques
-<!-- On peut facilement rendre un texte "gras" ou "italique" en Markdown -->
 
+On peut facilement rendre un texte "gras" ou "italique" en Markdown.
+
+```md
 *Ce texte est en italique.*
 _Celui-ci aussi._
 
@@ -61,15 +78,21 @@ __Celui-là aussi.__
 ***Ce texte a les deux styles.***
 **_Pareil ici_**
 *__Et là!__*
+```
 
-<!-- Dans le "GitHub Flavored Markdown", utilisé pour interpréter le Markdown 
+Dans le "GitHub Flavored Markdown", utilisé pour interpréter le Markdown sur
-sur GitHub, on a également le strikethrough ( texte barré ) : -->
+GitHub, on a également le texte barré.
 
-~~Ce texte est barré avec strikethrough.~~
+```md
+~~Ce texte est barré.~~
+```
 
-<!--  Les Paragraphes sont représentés par une ou plusieurs lignes de texte 
+## Paragraphes
-séparées par une ou plusieurs lignes vides. -->
 
+Les paragraphes sont représentés par une ou plusieurs lignes de texte séparées
+par une ou plusieurs lignes vides.
+
+```md
 Ceci est un paragraphe. Là, je suis dans un paragraphe, facile non?
 
 Maintenant je suis dans le paragraphe 2.
@@ -77,21 +100,23 @@ Je suis toujours dans le paragraphe 2!
 
 
 Puis là, eh oui, le paragraphe 3!
+```
 
-<!--  
+Si jamais vous souhaitez insérer une balise HTML `<br />`, vous pouvez ajouter
-Si jamais vous souhaitez insérer une balise HTML <br />, vous pouvez ajouter 
+un ou plusieurs espaces à la fin de votre paragraphe, et en commencer un
-un ou plusieurs espaces à la fin de votre paragraphe, et en commencer 
+nouveau.
-un nouveau.
--->
 
-J'ai deux espaces vides à la fin (sélectionnez moi pour les voir). 
+```md
+J'ai deux espaces vides à la fin (sélectionnez moi pour les voir).
 
 Bigre, il y a un <br /> au dessus de moi!
+```
 
-<!-- Les 'Blocs de Citations' sont générés aisément, grâce au caractère > -->
+Les blocs de citations sont générés aisément, grâce au caractère >.
 
+```md
 > Ceci est une superbe citation. Vous pouvez même
-> revenir à la ligne quand ça vous chante, et placer un `>` 
+> revenir à la ligne quand ça vous chante, et placer un `>`
 > devant chaque bout de ligne faisant partie
 > de la citation.
 > La taille ne compte pas^^ tant que chaque ligne commence par un `>`.
@@ -99,191 +124,248 @@ Bigre, il y a un <br /> au dessus de moi!
 > Vous pouvez aussi utiliser plus d'un niveau
 >> d'imbrication!
 > Classe et facile, pas vrai?
+```
 
-<!-- les Listes -->
+## Listes
-<!-- les Listes non ordonnées sont marquées par des asterisques, 
-signes plus ou signes moins. -->
 
+Les listes non ordonnées sont marquées par des asterisques, signes plus ou
+signes moins.
+
+```md
 * Item
 * Item
 * Un autre item
+```
 
 ou
 
+```md
 + Item
 + Item
 + Encore un item
+```
 
 ou
 
+```md
 - Item
 - Item
 - Un dernier item
+```
 
-<!-- les Listes Ordonnées sont générées via un nombre suivi d'un point -->
+Les listes ordonnées sont générées via un nombre suivi d'un point.
 
+```md
 1. Item un
 2. Item deux
 3. Item trois
+```
 
-<!-- Vous pouvez même vous passer de tout numéroter, et Markdown générera 
+Vous pouvez même vous passer de tout numéroter, et Markdown générera les bons
-les bons chiffres. Ceci dit, cette variante perd en clarté.-->
+chiffres. Ceci dit, cette variante perd en clarté.
 
+```md
 1. Item un
 1. Item deux
 1. Item trois
-<!-- ( cette liste sera interprétée de la même façon que celle au dessus ) -->
+```
 
-<!-- Vous pouvez également utiliser des sous-listes -->
+(Cette liste sera interprétée de la même façon que celle au dessus)
 
+Vous pouvez également utiliser des sous-listes.
+
+```md
 1. Item un
 2. Item deux
 3. Item trois
 * Sub-item
 * Sub-item
 4. Item quatre
+```
 
-<!-- Il y a même des "listes de Taches". Elles génèrent des champs HTML 
+Il y a même des listes de taches. Elles génèrent des champs HTML de type case à
-de type checkbox. -->
+cocher.
-
-Les [ ] ci dessous, n'ayant pas de [ x ], 
-deviendront des cases à cocher HTML non-cochées.
 
+```md
+Les [ ] ci-dessous, n'ayant pas de [ x ], deviendront des cases à cocher HTML
+non-cochées.
 - [ ] Première tache à réaliser.
 - [ ] Une autre chose à faire.
 La case suivante sera une case à cocher HTML cochée.
 - [x] Ça ... c'est fait!
+```
 
-<!-- les Blocs de Code -->
+## Blocs de code
-<!-- Pour marquer du texte comme étant du code, il suffit de commencer 
-chaque ligne en tapant 4 espaces (ou un Tab) -->
 
+Pour marquer du texte comme étant du code (qui utilise la balise `<code>`), il
+suffit d'indenter chaque ligne avec 4 espaces ou une tabulation.
+
+```md
     echo "Ça, c'est du Code!";
     var Ça = "aussi !";
+```
 
-<!-- L'indentation par tab ou série de quatre espaces 
+L'indentation par tabulation (ou série de quatre espaces) fonctionne aussi à
-fonctionne aussi à l'intérieur du bloc de code -->
+l'intérieur du bloc de code.
 
+```md
     my_array.each do |item|
        puts item
     end
+```
 
-<!-- Des bouts de code en mode 'inline' s'ajoutent en les entourant de ` -->
+Des bouts de code en mode en ligne s'ajoutent en utilisant le caractères
+`` ` ``.
 
+```md
 La fonction `run()` ne vous oblige pas à aller courir!
+```
 
-<!-- Via GitHub Flavored Markdown, vous pouvez utiliser 
+En "GitHub Flavored Markdown", vous pouvez utiliser des syntaxes spécifiques
-des syntaxes spécifiques -->
+selon le language.
 
-\`\`\`ruby 
+<pre>
-<!-- mais enlevez les backslashes quand vous faites ça, 
+<code class="highlight">&#x60;&#x60;&#x60;ruby
-gardez juste ```ruby ( ou nom de la syntaxe correspondant à votre code )-->
 def foobar
-puts "Hello world!"
+    puts "Hello world!"
 end
-\`\`\` <!-- pareil, pas de backslashes, juste ``` en guise de fin -->
+&#x60;&#x60;&#x60;</code>
+</pre>
 
-<-- Pas besoin d'indentation pour le code juste au dessus, de plus, GitHub 
+Pas besoin d'indentation pour le code juste au dessus, de plus, GitHub va
-va utiliser une coloration syntaxique pour le langage indiqué après les ``` -->
+utiliser une coloration syntaxique pour le langage indiqué après les \`\`\`.
 
-<!-- Ligne Horizontale (<hr />) -->
+## Séparateur horizontal
-<!-- Pour en insérer une, utilisez trois ou plusieurs astérisques ou tirets, 
-avec ou sans espaces entre chaque un. -->
 
+La balise `<hr/>` peut être aisement ajoutée en utilisant trois ou plus
+astérisques ou tirets, avec ou sans espaces entre chacun.
+
+```md
 ***
 ---
 - - -
 ****************
+```
 
-<!-- Liens -->
+## Liens hypertextes
-<!-- Une des fonctionnalités sympathiques du Markdown est la facilité 
-d'ajouter des liens. Le texte du lien entre [ ], l'url entre ( ), 
-et voilà l'travail.
--->
 
+Une des fonctionnalités sympathiques du Markdown est la facilité d'ajouter des
+liens hypertextes. Le texte du lien entre crochet `` [] ``, l'url entre
+parenthèses `` () ``, et voilà le travail.
+
+```md
 [Clic moi!](http://test.com/)
+```
 
-<!-- 
+Pour ajouter un attribut titre, ajoutez le entre les parenthèses entre
-Pour ajouter un attribut Title, collez le entre guillemets, avec le lien. 
+guillemets apres le lien.
--->
 
+```md
 [Clic moi!](http://test.com/ "Lien vers Test.com")
+```
 
-<!-- les Liens Relatifs marchent aussi -->
+Markdown supporte aussi les liens relatifs.
 
+```md
 [En avant la musique](/music/).
+```
 
-<!-- Les liens façon "références" sont eux aussi disponibles en Markdown -->
+Les liens de références sont eux aussi disponibles en Markdown.
 
+```md
 [Cliquez ici][link1] pour plus d'information!
 [Regardez aussi par ici][foobar] si vous voulez.
 
 [link1]: http://test.com/ "Cool!"
-[foobar]: http://foobar.biz/ "Alright!"
+[foobar]: http://foobar.biz/ "Génial!"
+```
 
-<!--  Le titre peut aussi être entouré de guillemets simples, 
+Le titre peut aussi être entouré de guillemets simples, ou de parenthèses, ou
-entre parenthèses ou absent. Les références peuvent être placées 
+absent. Les références peuvent être placées où vous voulez dans le document et
-un peu où vous voulez dans le document, et les identifiants 
+les identifiants peuvent être n'importe quoi tant qu'ils sont uniques.
-(link1, foobar, ...) quoi que ce soit tant qu'ils sont uniques -->
 
-<!-- Il y a également le "nommage implicite" qui transforme le texte du lien
+Il y a également le nommage implicite qui transforme le texte du lien en
- en identifiant -->
+identifiant.
 
+```md
 [Ceci][] est un lien.
 
 [ceci]: http://ceciestunlien.com/
+```
 
-<!-- mais ce n'est pas beaucoup utilisé. -->
+Mais ce n'est pas beaucoup utilisé.
 
-<!-- Images -->
+## Images
-<!-- Pour les images, la syntaxe est identique aux liens, sauf que précédée
- d'un point d'exclamation! -->
 
+Pour les images, la syntaxe est identique à celle des liens, sauf que précédée
+d'un point d'exclamation!
+
+```md
 ![Attribut ALT de l'image](http://imgur.com/monimage.jpg "Titre optionnel")
+```
 
-<!-- Là aussi, on peut utiliser le mode "références" -->
+Là aussi, on peut utiliser les références.
 
+```md
 ![Ceci est l'attribut ALT de l'image][monimage]
 
 [monimage]: relative/urls/cool/image.jpg "si vous voulez un titre, c'est ici."
+```
 
-<!-- Divers -->
+## Divers
-<!-- Liens Automatiques -->
 
+### Liens hypertextes automatiques
+
+```md
 <http://testwebsite.com/> est équivalent à :
 [http://testwebsite.com/](http://testwebsite.com/)
+```
 
-<!-- Liens Automatiques pour emails -->
+### Liens hypertextes automatiques pour emails
 
+```md
 <foo@bar.com>
+```
+
+### Caracteres d'echappement
 
-<!-- Escaping -->
 Il suffit de précéder les caractères spécifiques à ignorer par des backslash \
 
-Pour taper *ce texte* entouré d'astérisques mais pas en italique : 
+```md
+Pour taper *ce texte* entouré d'astérisques mais pas en italique :
 Tapez \*ce texte\*.
+```
 
-<!-- Tableaux -->
+### Touches de clavier
-<!-- les Tableaux ne sont disponibles que dans le GitHub Flavored Markdown
- et c'est ce n'est pas super agréable d'utilisation. 
- Mais si vous en avez besoin :
- -->
 
+Avec le "Github Flavored Markdown", vous pouvez utiliser la balise `<kdb>`
+pour représenter une touche du clavier.
+
+```md
+Ton ordinateur a planté? Essayer de taper :
+<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
+```
+
+### Tableaux
+
+Les tableaux ne sont disponibles que dans le "GitHub Flavored Markdown" et
+ne sont pas tres agréable d'utilisation. Mais si vous en avez besoin :
+
+```md
 | Col1 | Col2 | Col3 |
 | :----------- | :------: | ------------: |
 | Alignement Gauche | Centé | Alignement Droite |
 | bla | bla | bla |
+```
 
-<!-- ou bien, pour un résultat équivalent : -->
+ou bien, pour un résultat équivalent :
 
+```md
 Col 1 | Col2 | Col3
 :-- | :-: | --:
 Ough que c'est moche | svp | arrêtez
-
-<!-- Fin! -->
-
 ```
 
-Pour plus d'information :
+Pour plus d'information, consultez le post officiel de Jhon Gruber à propos de
- consultez [ici](http://daringfireball.net/projects/markdown/syntax) le post officiel de Jhon Gruber à propos de la syntaxe, 
+la syntaxe [ici](http://daringfireball.net/projects/markdown/syntax) et la
- et [là](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) la superbe cheatsheet de Adam Pritchard.
+superbe fiche pense-bête de Adam Pritchard [là](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).