diff options
| -rw-r--r-- | fr-fr/markdown-fr.html.markdown | 294 |
1 files changed, 188 insertions, 106 deletions
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). + +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) -Faites moi autant de retours que vous voulez! Sentez vous libre de "forker" -et envoyer des pull request! +## 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 -est un document Markdown valide. Autrement dit, vous pouvez utiliser des -balises HTML dans un fichier Markdown, comme la balise commentaire dans -laquelle nous sommes à présent, car celle-ci ne sera pas affectée par -le parser( analyseur syntaxique ) Markdown. --> +<!-- Ce qui veut dire que vous pouvez utiliser des balises HTML dans un fichier +Markdown, comme la balise commentaire dans laquelle nous sommes à présent, car +celle-ci ne sera pas affectée par l'analyseur syntaxique du Markdown. +Toutefois, si vous voulez créer une balise HTML dans un fichier 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, - vous ne pourrez pas utiliser du Markdown à l'intérieur de ce dernier. --> +## En-têtes -<!-- Le Markdown est implémenté de différentes manières, selon le parser. -Ce guide va alors tenter de trier les fonctionnalités universelles de celles -spécifiques à un parser. --> +Vous pouvez facilement créer des balises 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é. -<!-- Headers ( En-têtes ) --> -<!-- 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é. --> +```md # 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 de texte basiques -<!-- Styles basiques pour du texte --> -<!-- 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 -sur GitHub, on a également le strikethrough ( texte barré ) : --> +Dans le "GitHub Flavored Markdown", utilisé pour interpréter le Markdown sur +GitHub, on a également le texte barré. -~~Ce texte est barré avec strikethrough.~~ +```md +~~Ce texte est barré.~~ +``` + +## Paragraphes -<!-- Les Paragraphes sont représentés par une ou plusieurs lignes de texte -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 -un ou plusieurs espaces à la fin de votre paragraphe, et en commencer -un nouveau. ---> +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 +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? +``` + +## Listes -<!-- les 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 -les bons chiffres. Ceci dit, cette variante perd en clarté.--> +Vous pouvez même vous passer de tout numéroter, et Markdown générera les bons +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 -de type checkbox. --> - -Les [ ] ci dessous, n'ayant pas de [ x ], -deviendront des cases à cocher HTML non-cochées. +Il y a même des listes de taches. Elles génèrent des champs HTML de type case à +cocher. +```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! +``` + +## Blocs de code -<!-- les 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 -fonctionne aussi à l'intérieur du bloc de code --> +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 '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 -des syntaxes spécifiques --> +En "GitHub Flavored Markdown", vous pouvez utiliser des syntaxes spécifiques +selon le language. -\`\`\`ruby -<!-- mais enlevez les backslashes quand vous faites ça, -gardez juste ```ruby ( ou nom de la syntaxe correspondant à votre code )--> +<pre> +<code class="highlight">```ruby def foobar -puts "Hello world!" + puts "Hello world!" end -\`\`\` <!-- pareil, pas de backslashes, juste ``` en guise de fin --> +```</code> +</pre> -<-- 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 \`\`\`. -<!-- Ligne Horizontale (<hr />) --> -<!-- Pour en insérer une, utilisez trois ou plusieurs astérisques ou tirets, -avec ou sans espaces entre chaque un. --> +## Séparateur horizontal +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 --> -<!-- 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. ---> +## 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 Title, collez le entre guillemets, avec le lien. ---> +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") +``` -<!-- 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, -entre parenthèses ou absent. Les références peuvent être placées -un peu où vous voulez dans le document, et les identifiants -(link1, foobar, ...) quoi que ce soit tant qu'ils sont uniques --> +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 --> +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é. -<!-- 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  +``` -<!-- 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\*. +``` + +### Touches de clavier -<!-- Tableaux --> -<!-- 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 : - 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). |