mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-18 12:52:29 +03:00
dd6624856b
code demo in the hyperliens section was not rendered in the built site converted from md ``` syntax to plain html <code>
368 lines
8.8 KiB
Markdown
368 lines
8.8 KiB
Markdown
---
|
|
language: markdown
|
|
contributors:
|
|
- ["Andrei Curelaru", "http://www.infinidad.fr"]
|
|
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 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)
|
|
|
|
## Balises HTML
|
|
|
|
Markdown est un sur-ensemble du HTML, donc tout fichier HTML est un ficher
|
|
Markdown valide.
|
|
|
|
```md
|
|
<!-- 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. -->
|
|
```
|
|
|
|
## En-têtes
|
|
|
|
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é.
|
|
|
|
```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>`
|
|
|
|
```md
|
|
Ceci est un h1
|
|
=============
|
|
|
|
Ceci est un h2
|
|
-------------
|
|
```
|
|
|
|
## Styles de texte basiques
|
|
|
|
On peut facilement rendre un texte "gras" ou "italique" en Markdown.
|
|
|
|
```md
|
|
*Ce texte est en italique.*
|
|
_Celui-ci aussi._
|
|
|
|
**Ce texte est en gras.**
|
|
__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 texte barré.
|
|
|
|
```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.
|
|
|
|
```md
|
|
Ceci est un paragraphe. Là, je suis dans un paragraphe, facile non?
|
|
|
|
Maintenant je suis dans le paragraphe 2.
|
|
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.
|
|
|
|
```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 `>`.
|
|
|
|
```md
|
|
> Ceci est une superbe citation. Vous pouvez même
|
|
> 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 `>`.
|
|
|
|
> Vous pouvez aussi utiliser plus d'un niveau
|
|
>> d'imbrication!
|
|
> Classe et facile, pas vrai?
|
|
```
|
|
|
|
## Listes
|
|
|
|
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.
|
|
|
|
```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é.
|
|
|
|
```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.
|
|
|
|
```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 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
|
|
|
|
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 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 Markdown GitHub, vous pouvez utiliser des syntaxes spécifiques.
|
|
|
|
```ruby
|
|
def foobar
|
|
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 <code>```</code>.
|
|
|
|
## Ligne Horizontale
|
|
|
|
Pour insérer une ligne horizontale, utilisez trois ou plusieurs astérisques ou tirets, avec ou sans espaces entre.
|
|
|
|
```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 `Title`, collez-le entre guillemets, avec 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.
|
|
|
|
<div class="highlight"><code><pre>
|
|
[<span class="nv">Cliquez ici</span>][<span class="ss">link1</span>] pour plus d'information!
|
|
[<span class="nv">Regardez aussi par ici</span>][<span class="ss">foobar</span>] si vous voulez.
|
|
|
|
[<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Cool!"</span>
|
|
[<span class="nv">foobar</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Génial!"</span>
|
|
</pre></code></div>
|
|
|
|
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.
|
|
|
|
<div class="highlight"><code><pre>
|
|
[<span class="nv">Ceci</span>][] est un lien.
|
|
|
|
[<span class="nv">Ceci</span>]:<span class="sx">http://ceciestunlien.com/</span>
|
|
</pre></code></div>
|
|
|
|
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
|
|
|
|
```
|
|
|
|
Là aussi, on peut utiliser le mode "références".
|
|
|
|
|
|
<div class="highlight"><code><pre>
|
|
![<span class="nv">Ceci est l'attribut ALT de l'image</span>][<span class="ss">monimage</span>]
|
|
|
|
[<span class="nv">monimage</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"si vous voulez un titre, c'est ici."</span>
|
|
</pre></code></div>
|
|
|
|
## Divers
|
|
|
|
### Liens Automatiques
|
|
|
|
```md
|
|
<http://testwebsite.com/> est équivalent à :
|
|
[http://testwebsite.com/](http://testwebsite.com/)
|
|
```
|
|
|
|
### Liens Automatiques pour emails
|
|
|
|
```md
|
|
<foo@bar.com>
|
|
```
|
|
|
|
### Caracteres d'echappement
|
|
|
|
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 :
|
|
Tapez \*ce texte\*.
|
|
```
|
|
|
|
### Touches de clavier
|
|
|
|
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 | Centré | 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 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).
|