Merge pull request #3302 from chafouin/fix_markdown_fr

[Markdown/fr] Fix formatting & add missing keyboard keys section
This commit is contained in:
Divay Prakash 2018-10-18 21:32:25 +05:30 committed by GitHub
commit 55870438b3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -6,52 +6,69 @@ filename: markdown-fr.md
lang: fr-fr lang: fr-fr
--- ---
Markdown a été créé par John Gruber en 2004. Il se veut être d'une syntaxe 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 ```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 <h1>
## Ceci est un <h2> ## Ceci est un <h2>
### Ceci est un <h3> ### Ceci est un <h3>
#### Ceci est un <h4> #### Ceci est un <h4>
##### Ceci est un <h5> ##### Ceci est un <h5>
###### Ceci est un <h6> ###### 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 h1
============= =============
Ceci est un h2 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.* *Ce texte est en italique.*
_Celui-ci aussi._ _Celui-ci aussi._
@ -61,15 +78,21 @@ __Celui-là aussi.__
***Ce texte a les deux styles.*** ***Ce texte a les deux styles.***
**_Pareil ici_** **_Pareil ici_**
*__Et là!__* *__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? Ceci est un paragraphe. Là, je suis dans un paragraphe, facile non?
Maintenant je suis dans le paragraphe 2. Maintenant je suis dans le paragraphe 2.
@ -77,19 +100,21 @@ Je suis toujours dans le paragraphe 2!
Puis là, eh oui, le paragraphe 3! 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.
-->
```md
J'ai deux espaces vides à la fin (sélectionnez moi pour les voir). J'ai deux espaces vides à la fin (sélectionnez moi pour les voir).
Bigre, il y a un <br /> au dessus de moi! 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 > 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 > devant chaque bout de ligne faisant partie
@ -99,191 +124,248 @@ Bigre, il y a un <br /> au dessus de moi!
> Vous pouvez aussi utiliser plus d'un niveau > Vous pouvez aussi utiliser plus d'un niveau
>> d'imbrication! >> d'imbrication!
> Classe et facile, pas vrai? > 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
* Item * Item
* Un autre item * Un autre item
```
ou ou
```md
+ Item + Item
+ Item + Item
+ Encore un item + Encore un item
```
ou ou
```md
- Item - Item
- Item - Item
- Un dernier 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 1. Item un
2. Item deux 2. Item deux
3. Item trois 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 un
1. Item deux 1. Item deux
1. Item trois 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 1. Item un
2. Item deux 2. Item deux
3. Item trois 3. Item trois
* Sub-item * Sub-item
* Sub-item * Sub-item
4. Item quatre 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. - [ ] Première tache à réaliser.
- [ ] Une autre chose à faire. - [ ] Une autre chose à faire.
La case suivante sera une case à cocher HTML cochée. La case suivante sera une case à cocher HTML cochée.
- [x] Ça ... c'est fait! - [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!"; echo "Ça, c'est du Code!";
var Ça = "aussi !"; 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| my_array.each do |item|
puts item puts item
end 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! 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 def foobar
puts "Hello world!" puts "Hello world!"
end 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/) [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") [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/). [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! [Cliquez ici][link1] pour plus d'information!
[Regardez aussi par ici][foobar] si vous voulez. [Regardez aussi par ici][foobar] si vous voulez.
[link1]: http://test.com/ "Cool!" [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][] est un lien.
[ceci]: http://ceciestunlien.com/ [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") ![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] ![Ceci est l'attribut ALT de l'image][monimage]
[monimage]: relative/urls/cool/image.jpg "si vous voulez un titre, c'est ici." [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/> est équivalent à :
[http://testwebsite.com/](http://testwebsite.com/) [http://testwebsite.com/](http://testwebsite.com/)
```
<!-- Liens Automatiques pour emails --> ### Liens hypertextes automatiques pour emails
```md
<foo@bar.com> <foo@bar.com>
```
### Caracteres d'echappement
<!-- Escaping -->
Il suffit de précéder les caractères spécifiques à ignorer par des backslash \ Il suffit de précéder les caractères spécifiques à ignorer par des backslash \
```md
Pour taper *ce texte* entouré d'astérisques mais pas en italique : Pour taper *ce texte* entouré d'astérisques mais pas en italique :
Tapez \*ce texte\*. 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 | | Col1 | Col2 | Col3 |
| :----------- | :------: | ------------: | | :----------- | :------: | ------------: |
| Alignement Gauche | Centé | Alignement Droite | | Alignement Gauche | Centé | Alignement Droite |
| bla | bla | bla | | bla | bla | bla |
```
<!-- ou bien, pour un résultat équivalent : --> ou bien, pour un résultat équivalent :
```md
Col 1 | Col2 | Col3 Col 1 | Col2 | Col3
:-- | :-: | --: :-- | :-: | --:
Ough que c'est moche | svp | arrêtez 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 [](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) la superbe cheatsheet de Adam Pritchard. superbe fiche pense-bête de Adam Pritchard [](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).