* Les listes AsciiDoc peuvent contenir n’importe quel contenu complexe.

[cols="2", options="header"]

[.result] ==== .Table Title

Name of Column 1

Name of Column 2

Name of Column 3

Cell in column 1, row 1

Cell in column 2, row 1

Cell in column 3, row 1

Cell in column 1, row 2

Cell in column 2, row 2

Cell in column 3, row 2

====

.Table with three columns, a header, and two rows of content ----

---- <1> Dans cet exemple, l’attribut cols a deux fonctions. Il spécifie que ce tableau comporte trois colonnes et définit leurs largeurs relatives.

[.result] ==== [cols="2,2,5a"]

Firefox

Browser

Mozilla Firefox is an open-source web browser.

It’s designed for:

* standards compliance * performance * portability

Get Firefox!

====

.Table from CSV data using shorthand (Asciidoctor only) ---- ,=== Artiste,Track,Genre

Baauer,Harlem Shake,Hip Hop ,=== ----

[.result] ==== ,=== Artiste,Track,Genre

Baauer,Harlem Shake,Hip Hop ,=== ====

.Table from DSV data using shorthand (Asciidoctor only) ---- :=== Artiste:Track:Genre

Robyn:Indestructable:Dance :=== ----

[.result] ==== :=== Artiste,Track,Genre

Robyn:Indestructable:Dance :=== ====

.Table with formatted, aligned and merged cells ----

[.result] ====

Shortcut

Purpose

F11

Toggle fullscreen

Ctrl+T

Open a new tab

Ctrl+Shift+N

New incognito window

Ctrl++

Increase zoom

====

== Remplacement de text

//// Included in:

- user-manual: Text Substitutions: Replacements - quick-ref ////

[cols="2,^1l,1l,^1,2"] .Remplacements de symboles textuels

TIP: Toute référence d’entité XML nommée, numérique ou hexadécimale est prise en charge.

== Escaping Text

.Barre oblique ---- *Stars* n’est pas rendu en texte gras. Les astérisques autour du mot sont conservés.

{author} n’est pas résolu par le nom de l’auteur. Les accolades autour du mot sont conservées.

Le caractère barre oblique inverse est automatiquement supprimé. ----

[.result] ==== *Stars* n’est pas rendu en texte gras. Les astérisques autour du mot sont conservés.

{author} n’est pas résolu par le nom de l’auteur. Les accolades autour du mot sont conservées.

Le caractère barre oblique inverse est automatiquement supprimé. ====

.Double dollar ---- *Stars* n’est pas rendu en texte gras. Les astérisques autour du mot sont conservés.

&amp; s’affiche sous la forme d’une entité XML au lieu de &. ----

[.result] ==== *Stars* n’est pas rendu en texte gras. Les astérisques autour du mot sont conservés.

&amp; s’affiche sous la forme d’une entité XML au lieu de &. ====

.Macro triple plus et passthrough en ligne ---- underline me renders as underlined text.

underline me also renders as underlined text. ----

[.result] ==== underline me renders as underlined text.

underline me also renders as underlined text. ====

.Backticks ---- Le texte dans backticks s’affiche exactement tel qu’il a été saisi, en monospace. La référence à l’attribut n’est pas résolu. ----

[.result] ==== Le texte dans backticks s’affiche exactement tel qu’il a été saisi, en monospace. La référence à l’attribut n’est pas résolu. ====

== Table des matières (ToC)

.Document avec Table de matières ---- = AsciiDoc Writer’s Guide Doc Writer <[email protected]> v1.0, 2013-01-01 :toc: ----

.Document avec table des matières à droite ---- = AsciiDoc Writer’s Guide Doc Writer <[email protected]> v1.0, 2013-01-01 :toc: right ----

TIP: The ToC "title, levels, and positioning" can be customized.

== Bibliographie

.Références ---- « The Pragmatic Programmer » [prag] devrait être une lecture obligatoire pour tous les développeurs.

[bibliography] - [] Andy Hunt & Dave Thomas. 'The Pragmatic Programmer: From Journeyman to Master'. Addison-Wesley. 1999. - [] Dan Allen. 'Seam in Action'. Manning Publications. 2008. ----

[.result] ==== « The Pragmatic Programmer » [prag] devrait être une lecture obligatoire pour tous les développeurs.

[bibliography] - [] Andy Hunt & Dave Thomas. 'The Pragmatic Programmer: From Journeyman to Master'. Addison-Wesley. 1999. - [] Dan Allen. 'Seam in Action'. Manning Publications. 2008. ====

== Notes en bas de page

.Notes en pas de pages standards et répétés ---- Une déclaration.^[1]

A bold statement.^[2]

Une autre déclaration en gras.footenoteref:[avertissement] ----

[.result] ==== [.unstyled]

====

== La compatibilité Markdown

IMPORTANT: La compatibilité Markdown n’est disponible que par défaut dans Asciidoctor. Vous pouvez configurer AsciiDoc (Python) pour reconnaître cette syntaxe en plaçant le fichier de compatibilité AsciiDoc d’Asciidoctor dans le même répertoire que le document en cours.

.Titres de niveau de style markdown ---- # Titre du document (Level 0)

Section niveau 1

# Section niveau 2

# Section niveau 3

Section niveau 4

# Section niveau 5 ----

[.result] ==== [float] # Titre du document (Level 0)

[float] Section niveau 1

[float] Section niveau 2

[float] Section niveau 3

[float] # Section niveau 4

[float] # Section niveau 5 ====

.Bloc de code démarqué avec coloration syntaxique ---- ruby require 'sinatra'

get '/hi' do "Bonjour le monde!" end ----

[.result] ==== ruby require 'sinatra'

get '/hi' do "Bonjour le monde!" end ====

.Citation en style markdown ---- > Je considère qu’une petite rébellion de temps en temps est une bonne chose, > et aussi nécessaire dans le monde politique que les tempêtes dans le monde physique." > — Thomas Jefferson, Papers of Thomas Jefferson : Volume 11 ----

[.result] ==== > Je considère qu’une petite rébellion de temps en temps est une bonne chose, > et aussi nécessaire dans le monde politique que les tempêtes dans le monde physique. > — Thomas Jefferson, Papers of Thomas Jefferson: Volume 11 ====

.Citation en style markdown avec contenu du bloc ---- > > Quoi de neuf ? > > J’ai Markdown dans mon AsciiDoc ! > > > Comme quoi ? > > * Blockquotes > * Titres > * Fenced code blocks > > > Is there more? > > Yep. AsciiDoc and Markdown share a lot of common syntax already. ----

[.result] ==== > > Quoi de neuf ?> > J’ai Markdown dans mon AsciiDoc !> > > Comme quoi ?> * Citations * Titres de niveau > * Blocs de code clôturés > > > Y a-t-il plus ? > > Oui. AsciiDoc et Markdown partage beaucoup de syntaxe en commun. ====

.Markdown-style horizontal rules ---- ---

- - -

*

*

* *

====

== Manuel utlisateur et aide

Pour en savoir plus sur Asciidoctor et ses capacités, consultez les autres guides Asciidoctor et son Manuel de l’utilisateur. N’oubliez pas non plus de rejoindre la liste de diffusion Asciidoctor, où vous pouvez poser des questions et laisser des commentaires. = AsciiDoc Syntax Quick Reference Dan Allen; Sarah White v1.0.3, 2014-12-28 :description: Ce guide est une référence rapide pour le balisage de formatage courant et \ les éléments de document dans la syntaxe AsciiDoc. :keywords: AsciiDoc, Asciidoctor, syntax, reference, cheatsheet :imagesdir: images :experimental: :table-caption!: :example-caption!: :figure-caption!: :idprefix: :idseparator: - :linkattrs: :docref: http://asciidoctor.org/docs :user-ref: http://asciidoctor.org/docs/user-manual :fontawesome-ref: http://fortawesome.github.io/Font-Awesome :icon-inline: http://asciidoctor.org/docs/user-manual/#inline-icons :icon-attribute: http://asciidoctor.org/docs/user-manual/#size-rotate-and-flip :video-ref: http://asciidoctor.org/docs/user-manual/#video :checklist-ref: http://asciidoctor.org/docs/user-manual/#checklists :list-marker: http://asciidoctor.org/docs/user-manual/#custom-markers :list-number: http://asciidoctor.org/docs/user-manual/#numbering-styles :imagesdir-ref: http://asciidoctor.org/docs/user-manual/#imagesdir :image-attributes: http://asciidoctor.org/docs/user-manual/#put-images-in-their-place :toc-ref: http://asciidoctor.org/docs/user-manual/#table-of-contents :para-ref: http://asciidoctor.org/docs/user-manual/#paragraph :literal-ref: http://asciidoctor.org/docs/user-manual/#literal-text-and-blocks :admon-ref: http://asciidoctor.org/docs/user-manual/#admonition :bold-ref: http://asciidoctor.org/docs/user-manual/#bold-and-italic :quote-ref: http://asciidoctor.org/docs/user-manual/#quotation-marks-and-apostrophes :sub-ref: http://asciidoctor.org/docs/user-manual/#subscript-and-superscript :mono-ref: http://asciidoctor.org/docs/user-manual/#monospace :css-ref: http://asciidoctor.org/docs/user-manual/#custom-styling-with-attributes :pass-ref: http://asciidoctor.org/docs/user-manual/#passthrough-macros :mailinglist: http://discuss.asciidoctor.org

AsciiDoc est un langage de balisage mature et léger pour la rédaction de notes, d’articles, de documentation, de livres, de pages Web, de présentations de diapositives et de pages de manuel en texte brut. Ce guide est une référence rapide pour le balisage de formatage courant et les éléments de document dans la syntaxe AsciiDoc.

[NOTE] ==== Plusieurs exemples se concentrent sur la sortie générée par le backend HTML. AsciiDoc produit une sortie complémentaire lors de la génération de DocBook.

La plupart des fonctionnalités étiquetées « Asciidoctor uniquement » peuvent être mises à la disposition du processeur natif AsciiDoc en utilisant ce fichier de configuration AsciiDoc à partir d’Asciidoctor. projet. ====

== Paragraphs

.Normal ---- Les paragraphes ne nécessitent aucun balisage spécial dans AsciiDoc. Un paragraphe n’est qu’une ou plusieurs lignes de texte consécutives.

Pour commencer un nouveau paragraphe, séparez-le par au moins une ligne vide. ----

[.result] ==== Les paragraphes ne nécessitent aucun balisage spécial dans AsciiDoc. Un paragraphe n’est qu’une ou plusieurs lignes de texte consécutives.

Pour commencer un nouveau paragraphe, séparez-le par au moins une ligne vide. ====

.Sauts de ligne ---- Pour conserver un saut de ligne, terminez la ligne par un espace suivi d’un signe plus.
Cela produit un saut de ligne visible (par exemple, <br>) entre les lignes. ----

[.result] ==== Pour conserver un saut de ligne, terminez la ligne par un espace suivi d’un signe plus. +
Cela produit un saut de ligne visible (par exemple, <br>) entre les lignes. ====

.Attributs litéraux intégrés ---- Un paragraphe normal

Une séquence de lignes commençant par au moins un espace est un paragraphe littéral. Les paragraphes littéraux sont traités comme du texte préformaté. Le texte est affiché dans une police à largeur fixe et les lignes de fin sont conservées.

Un autre paragraphe normale ----

[.result] ==== Un paragraphe normal.

Une séquence de lignes commençant par au moins un espace est un paragraphe littéral. Les paragraphes littéraux sont traités comme du texte préformaté. Le texte est affiché dans une police à largeur fixe et les lignes de fin sont conservées.

Un autre paragraphe normale. ====

.Avertissement ---- NOTE: Un paragraphe d’avertissement attire l’attention du lecteur sur des informations auxiliaires. Son objectif est déterminé par l’étiquette au début du paragraphe.

Voici les autres types d’avertissements intégrés :

TIP : Conseil de pro…​

IMPORTANT: N’oubliez pas…​

WARNING : Attention à…​

CAUTION: Assurez-vous que…​ ----

[.result] ==== NOTE: Un paragraphe d’avertissement attire l’attention du lecteur sur des informations auxiliaires.

Voici les autres types d’avertissements intégrés :

TIP: Conseil de pro…​

IMPORTANT: N’oubliez pas…​

WARNING: Attention à…​

CAUTION: Assurez-vous que…​ ====

NOTE: Vous pouvez aussi créer admonition blocks.

.Style de chapeau ---- [.lead] Ce texte sera formatté avec le style de chapeau (ie police plus grande).ņ ----

[.result] ==== [.lead] Ce texte sera formatté avec le style de chapeau (ie police plus grande). ====

NOTE: Le style par défaut d’AsciiDoctor donne au premier paragraphe du préambule un style de chapeau.

.Plus d’exemples de Paragraphes, Avertisesements, et Bloc litérales * Voir ces sections du manuel utilisateur d’AsciiDoctor pour plus d’information et d’exemples.

sveuxtters

bvieilles lettres italiquestters

monospace bold phrase and letters

monospace bold italic phrase and letters

sveuxtters

bvieilles lettres italiquestters

monospace bold phrase and letters

monospace bold italic phrase and letters

.Autres exemples de formatage de texte Voir ces sections du manuel utilisateur d’AsciiDoctor pour plus d’information et d’exemples.

* Bold and Italic Formatting * Guillemets et apostrophes * Indice et Exposant * Formatage monospace * Style personnalisé avec attributs * Macros de transfert **

== L’en-tête du document

IMPORTANT: Un en-tête est facultatif.

CAUTION: L’entête ne doit pas contenir de ligne blanches et doit être séparée du contenu par au moins une ligne blanche.

.Titre seulement ----

= Titre de mon document

Mon document explique…​ ----

.Titre et ligne d’auteur ---- = Titre de mon document Doc Writer <[email protected]>

Mon document explique…​ ----

.Titre, ligne d’auteur, et ligne de révision ---- = Titre de mon document Doc Writer <[email protected]> v1.0, 2014-01-01

Mon document explique…​ ----

IMPORTANT: Vous ne pouvez pas avoir une ligne de révision sans la ligne d’auteur.

.Entête de document avec attributs ---- = Titre de mon document Doc Writer <[email protected]> v1.0, 2014-01-01 :toc: :imagesdir: assets/images :homepage: http://asciidoctor.org ----