diff --git a/fr-fr/markdown-fr.html.markdown b/fr-fr/markdown-fr.html.markdown index 8518f35c..2955fd14 100644 --- a/fr-fr/markdown-fr.html.markdown +++ b/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 - (et beaucoup d'autres formats aussi à présent). +facile à lire et à écrire, aisément convertible en HTML (et dans beaucoup +d'autres formats aussi). -Faites moi autant de retours que vous voulez! Sentez vous libre de "forker" -et envoyer des pull request! +Les implémentations du Markdown varient d'un analyseur syntaxique à un autre. +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 - + +``` - +## En-têtes - +Vous pouvez facilement créer des balises HTML `
`), 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 tabulation (ou série de quatre espaces) fonctionne aussi à
+l'intérieur du bloc de code.
+```md
my_array.each do |item|
puts item
end
+```
-
+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!
+```
-
+En "GitHub Flavored Markdown", vous pouvez utiliser des syntaxes spécifiques
+selon le language.
-\`\`\`ruby
-
+
+```ruby
def foobar
-puts "Hello world!"
+ puts "Hello world!"
end
-\`\`\`
+```
+
-<-- Pas besoin d'indentation pour le code juste au dessus, de plus, GitHub
-va utiliser une coloration syntaxique pour le langage indiqué après les ``` -->
+Pas besoin d'indentation pour le code juste au dessus, de plus, GitHub va
+utiliser une coloration syntaxique pour le langage indiqué après les \`\`\`.
-
-
+## Séparateur horizontal
+La balise `
` peut être aisement ajoutée en utilisant trois ou plus
+astérisques ou tirets, avec ou sans espaces entre chacun.
+
+```md
***
---
- - -
****************
+```
-
-
+## Liens hypertextes
+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
+guillemets apres le lien.
+```md
[Clic moi!](http://test.com/ "Lien vers Test.com")
+```
-
+Markdown supporte aussi les liens relatifs.
+```md
[En avant la musique](/music/).
+```
-
+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, ou de parenthèses, ou
+absent. Les références peuvent être placées où vous voulez dans le document et
+les identifiants peuvent être n'importe quoi tant qu'ils sont uniques.
-
+Il y a également le nommage implicite qui transforme le texte du lien en
+identifiant.
+```md
[Ceci][] est un lien.
[ceci]: http://ceciestunlien.com/
+```
-
+Mais ce n'est pas beaucoup utilisé.
-
-
+## Images
+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 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
+### Liens hypertextes automatiques
+
+```md
est équivalent à :
[http://testwebsite.com/](http://testwebsite.com/)
+```
-
+### Liens hypertextes automatiques pour emails
+```md
+```
+
+### Caracteres d'echappement
-
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\*.
+```
-
-
+### Touches de clavier
+Avec le "Github Flavored Markdown", vous pouvez utiliser la balise ``
+pour représenter une touche du clavier.
+
+```md
+Ton ordinateur a planté? Essayer de taper :
+Ctrl+Alt+Del
+```
+
+### 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 :
+```md
Col 1 | Col2 | Col3
:-- | :-: | --:
Ough que c'est moche | svp | arrêtez
-
-
-
```
-Pour plus d'information :
- consultez [ici](http://daringfireball.net/projects/markdown/syntax) le post officiel de Jhon Gruber à propos de la syntaxe,
- et [là](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) la superbe cheatsheet de Adam Pritchard.
+Pour plus d'information, consultez le post officiel de Jhon Gruber à propos de
+la syntaxe [ici](http://daringfireball.net/projects/markdown/syntax) et la
+superbe fiche pense-bête de Adam Pritchard [là](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).