Translate: "Markdown Guide"

[coderanger]

XXX Trouver traduction pour les termes en UPPERCASE!

Guide pour Markdown

Ceci devrait couvrir 99% de vos besoins en Markdown pour PyCon.

Conseil: Assurez-vous que votre soumission paraisse bien.

---

Ajoutez toujours des fin de ligne / BREAKS entre les blocs et éléments. La documentation officielle n'est pas claire sur ce point, et ce ne sont pas tous les PARSERS qui exigent des fins de ligne / BREAKS entre les blocs.

BLOCKQUOTES

Pour entourer un segment de texte en BLOCKQUOTES, vous devez préfixer chaque ligne avec un signe plus-petit-que. N'oubliez pas d'ajouter une fin de ligne avec de créer un BLOCKQUOTE.

Markdown:

> ## En-tête BLOCKQUOTED
>
> Ceci est du texte en BLOCKQUOTE.
>
> Ceci est un deuxième paragraphe à l'intérieur du texte en BLOCKQUOTE.

Résultat:

<blockquote>
    <h2>En-tête BLOCKQUOTED</h2>

    <p>Ceci est du texte en BLOCKQUOTE.</p>

    <p>Ceci est un deuxième paragraphe à l'intérieur du texte en BLOCKQUOTE.</p>

</blockquote>

Code: Bloc

Pour spécifier un bloc entier de code pré-formatté, indentez chaque ligne du bloc avec un TAB ou 4 espaces. Les charactères '&', '<' et '>' seront automatiquement convertis en entités HTML. N'oubliez pas d'ajouter une fin de ligne avant de créer un bloc de code.

Markdown:

Si vous voulez marquer un bloc de texte comme étant du code, indentez-le avec 4 espaces.

<p>Ceci a été indenté avec 4 espaces.</p>

Résultat:

<p>Si vous voulez marquer un bloc de texte comme étant du code, indentez-le avec 4 espaces.</p>

&lt;p&gt;Ceci a été indenté avec 4 espaces.&lt;/p&gt;

Code: INLINE

Inline code descriptions can be done via the use of the backtick quotes. Any ampersands and angle brackets will automatically be translated into HTML entities.

Markdown:

Markdown est un outil de conversion `<em>texte-à-html</em>` pour auteurs.

Résultat:

<p>Markdown est un outil de conversion `&lt;em&gt;texte-à-html&lt;/em&gt;` pour auteurs.</p>

Emphase: Italique

Pour mettre l'emphase sur un bout de texte, entourez-le avec des astérisques ou des soulignés.

Markdown:

Ceci est du _texte_ en *emphase*.

Résultat:

.. code-block:: html

<p>Ceci est du <em>texte</em> en <em>emphase</em> .</p>

Emphase: STRONG

Pour mettre l'emphase avec plus de force sur un bout de texte, entourez-le avec des doubles astérisques ou doubles soulignés.

Markdown:

Ceci est du __texte__  avec **emphase** très forte.

Résultat:

<p>Ceci est du <strong>texte</strong> avec <strong>emphase</strong> très forte.</p>

En-têtes

Les en-têtes HTML sont produits en plaçant un nombre de dièses correspondant au niveau d'en-tête désiré avant le texte d'en-tête (le HTML offre six niveaux d'en-têtes). N'oubliez pas d'ajouter une fin de ligne avant de créer un en-tête.

Markdown:

# En-tête de premier niveau

#### En-tête de quatrième niveau

Résultat:

<h1>En-tête de premier niveau</h1>

<h4>En-tête de quatrième niveau</h4>

Règles horizontales

Vous pouvez créer une règles horizontale (<hr />) en plaçant 3 ou plus traits d'union, astérisques ou soulignés sur une seule ligne.Vous pouvez aussi placer des espaces entre ces charactères. N'oubliez pas d'ajouter une fin de ligne avant de créer une règles horizontale.

Markdown:

* * *

***

*****

- - -

---------------------------------------

Résultat:

<hr />

<hr />

<hr />

<hr />

<hr />

Images: INLINE

La syntaxe pour les images INLINE est très similaire à celle des hyperliens, mais utilise un point d'exclamation comme préfixe.

Markdown:

![alt text](http://path/to/img.jpg "Titre")

Résultat:

<img src="http://path/to/img.jpg" alt="alt text" title="Titre" />

Fin de ligne

Pour forcer une fin de ligne, placez deux espaces à la fin d'une ligne.

Markdown:

Forcer une fin de ligne\s\s
Prochaine ligne dans la liste

Résultat:

Forcer une fin de ligne<br>
Prochaine ligne dans la liste

Hyperliens: INLINE

Les hyperliens de style INLINE utilisent des parenthèses immédiatement après le texte de l'hyperlien.

Markdown:

Ceci est un [exemple d'hyperlien](http://example.com/).

Résultat:

<p>Ceci est un <a href="http://example.com/">exemple d'hyperlien</a>.</p>

Hyperliens: INLINE avec titre

Markdown:

Ceci est un [exemple d'hyperlien](http://example.com/ "Avec un titre").

Résultat:

<p>Ceci est un <a href="http://example.com/" 
    title="Avec un titre">exemple d'hyperlien</a>.</p>

Hyperliens: Référence

Les hyperliens de style référence vous permettent de référer à vos hyperliens avec des noms que vous définissez ailleurs.

Markdown:

Ceci est un guide portant sur [Markdown][1].

[1]: http://en.wikipedia.org/wiki/Markdown        "Markdown"

Résultat:

<p>Ceci est un guide portant sur <a href="http://en.wikipedia.org/wiki/Markdown">Markdown</a>.</p>

Listes: Simple

Créer une liste simple s'effectue en utilisant des signes plus, des traits d'union ou des astérisques comme marqueurs de liste. Tous ces derniers sont interchangeables l'un avec l'autre. N'oubliez pas d'ajouter une fin de lgne avant de commencer une liste.

Markdown:

+ Un
- Deux
* Trois

Résultat:

<ul>
    <li>Un</li>
    <li>Deux</li>
    <li>Trois</li>
</ul>

Listes: Imbriquées

Imbriquer une liste requiert que vous indentiez avec exactement quatre espaces. N'oubliez pas d'ajouter une fin de ligne avec de créer une liste.

Markdown:

+ Un
+ Deux
+ Trois
    - Un, imbriqué
    - Deux, imbriqué

Résultat:

<ul>
    <li>Un</li>
    <li>Deux</li>
    <li>Trois
        <ul>
            <li>Un, imbriqué</li>
            <li>Deux, imbriqué</li>
        </ul>
    </li>
</ul>

Paragraphes

Un paragraphe est constitué d'une ou plusieurs lignes de texte, séparés par une ou plusieurs lignes vides. Les paragraphes ordinaires ne devraient pas être indentés avec des espaces ou tab. N'oubliez pas d'ajouter une fin de ligne avant de créer un nouveau paragraphe.

Markdown:

Ceci est un paragraphe. Il contient deux phrases.

Ceci est un autres paragraphe. Il contient aussi deux phrases.

Résultat:

<p>Ceci est un paragraphe. Il contient deux phrases.</p>

<p>Ceci est un autres paragraphe. Il contient aussi deux phrases.</p>