Voir la source de Aide:Syntaxe

Cette page vous présente la ''syntaxe propre à wikilivres''. Il résume sous la forme de tableaux les différentes mises en forme possibles. La colonne de gauche indique les codes à saisir, et celle de droite l'effet obtenu.

Pour mettre en forme vos pages, Wikilivres permet d'introduire certains codes ; les plus courants sont :

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
|<pre>''texte en italique''</pre> (apostrophes et non guillemets)
|''texte en italique''
|-
|<pre>'''texte en gras'''</pre>
| '''texte en gras'''
|-
|<pre>* liste
* à
* puce</pre>
|<ul><li>liste</li><li>à</li><li>puce</li></ul>
|-
|<pre># liste
# numérotée</pre>
|<ol><li>liste</li><li>numérotée</li></ol>
|-
|<pre> ==Titre de section== </pre>
|<h2>Titre de section</h2>
|-
|<pre>===Titre de sous-section===</pre>
|<h3>Titre de sous-section</h3>
|}

Vous pouvez effectuer vos tests sur le [[Wikilivres:Bac à sable|Bac à sable]] qui est réservé à cet usage.
Il est également recommandé d'utiliser la prévisualisation pour voir les effets des modifications avant publications.

En cas de doute sur la syntaxe à utiliser, regardez le code source des pages existantes ou [[Wikilivres:Le Bistro|demandez sur le bistro]].

[[Fichier:Guide de la syntaxe Wiki.pdf|thumb|Page résumant la syntaxe wiki.]]
__TOC__

== Table des matières ==

Une table des matières est créée automatiquement si la page comporte au moins 4 titres ou sous-titres, comme cette page par exemple.

Pour supprimer le sommaire automatique, il suffit de mettre quelque part <nowiki>__NOTOC__</nowiki>.

Pour générer le sommaire automatique à l'emplacement par défaut (avant le premier titre), pour contrer l'effet de <nowiki>__NOTOC__</nowiki> ou quand il y a 3 sections ou moins, il suffit de mettre quelque part <nowiki>__FORCETOC__</nowiki> ou <nowiki>__FORCERSOMMAIRE__</nowiki>.

Pour modifier l'emplacement de la table des matières : insérer <nowiki>__TOC__</nowiki> ou <nowiki>__SOMMAIRE__</nowiki> là où vous désirez voir apparaître la table.

== Sections, paragraphes et lignes ==

Pour les titres :

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
|<pre>== Nouvelle section ==</pre>
|<h2> Nouvelle section </h2>
|-
|<pre>=== Nouvelle sous-section ===</pre>
|<h3> Nouvelle sous-section </h3>
|-
|<pre>==== Nouveau paragraphe ====</pre>
|<h4> Nouveau paragraphe </h4>
|-
|<pre>===== Nouveau sous-paragraphe =====</pre>
|<h5> Nouveau sous-paragraphe </h5>
|}

Les notations ci-dessus sont respectivement équivalentes à l'utilisation des balises HTML &lt;h2&gt;...&lt;/h2&gt;, &lt;h3&gt;...&lt;/h3&gt; et &lt;h4&gt;...&lt;/h4&gt;.

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre>Un simple saut à la ligne
n'a aucun effet.</pre>
|Un simple saut à la ligne n'a aucun effet.
|-
|<pre>Mais une ligne vide

permet de séparer les paragraphes.</pre>
|Mais une ligne vide

permet de séparer les paragraphes.
|-
| <pre>Voilà comment il faut faire<br/>
pour aller à la ligne.</pre>
| Voilà comment il faut faire
pour aller à la ligne.
|}

== Listes ==

=== Listes ordonnées et non-ordonnées ===
{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre>* Les listes sont bien pratiques :
** Elles permettent d'organiser les données
** Elles embellissent le document</pre>
|
* Les listes sont bien pratiques :
** Elles permettent d'organiser les données
** Elles embellissent le document
|-
| <pre># Les listes numérotées sont également bien pratiques
# Bien organisées
## Faciles à lire</pre>
|
# Les listes numérotées sont également bien pratiques
# Bien organisées
## Faciles à lire
|-
| <pre><div class="list-upper-roman">
# Premier item numéroté en chiffres romains (majuscules)
# Deuxième item numéroté en chiffres romains (majuscules)
# Troisième item numéroté en chiffres romains (majuscules)
</div></pre>
|
<div class="list-upper-roman">
# Premier item numéroté en chiffres romains (majuscules)
# Deuxième item numéroté en chiffres romains (majuscules)
# Troisième item numéroté en chiffres romains (majuscules)
</div>
|-
| <pre><div class="list-lower-latin">
# Premier item numéroté par des lettres minuscules
# Deuxième item numéroté par des lettres minuscules
# Troisième item numéroté par des lettres minuscules
</div></pre>
|
<div class="list-lower-latin">
# Premier item numéroté par des lettres minuscules
# Deuxième item numéroté par des lettres minuscules
# Troisième item numéroté par des lettres minuscules
</div>
|-
| <pre>:Les lignes peuvent être
::indentées
:::sur plusieurs niveaux</pre>
|
:Les lignes peuvent être
::indentées
:::sur plusieurs niveaux
|-
| colspan="2" | Avec tout cela, il est maintenant possible de mélanger les types de listes :
|-
|
<pre>
*Une liste numérotée :
:#Premier élément
:#Second élément
*d'autres branches à l'arborescence
</pre>
|
*Une liste numérotée :
:#Premier élément
:#Second élément
*d'autres branches à l'arborescence
|}

=== Mélange de type de listes ===
Plusieurs types de listes peuvent se trouver sur la même page.
{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre>
* Item non ordonné
* Un autre item
* Et un dernier
# Item ordonné 1
# Item ordonné 2
# Item ordonné 3</pre>
|
* Item non ordonné
* Un autre item
* Et un dernier
# Item ordonné 1
# Item ordonné 2
# Item ordonné 3
|}

Les items des deux listes ne sont pas alignés car chacun des deux types de liste a des marges différentes.
Pour les recettes de cuisine (liste non ordonnée d'ingrédient puis liste ordonnée d'étapes), l'alignement est corrigé.
Pour les autres pages, il est possible d'utiliser la classe CSS <code>unilist</code> sur un élément <code>&lt;div&gt;</code> encadrant la liste.
{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre>
<div class="unilist">
* Item non ordonné
* Un autre item
* Et un dernier
# Item ordonné 1
# Item ordonné 2
# Item ordonné 3
</div></pre>
|
<div class="unilist">
* Item non ordonné
* Un autre item
* Et un dernier
# Item ordonné 1
# Item ordonné 2
# Item ordonné 3
</div>
|}


=== Listes de définitions ===
{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre>; Terme à expliquer : explication du terme...
: ...sur plusieurs lignes.
; Autre terme : autre définition...</pre>
|
; Terme à expliquer : explication du terme...
: ...sur plusieurs lignes.
; Autre terme : autre définition...
|}

== Formatage de paragraphe ==
{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre> SI (une ligne commence par une espace) ALORS
    elle apparaîtra exactement telle qu'elle a été saisie;
    dans une police non proportionnelle;
    les sauts de ligne ne seront pas automatiques ;
  FIN SI
  C'est bien utile pour :
  &amp;bull; copier/coller un texte pré-formaté ;
<br/><br/>
  &amp;bull; des descriptions d'algorithmes ;</pre>
|
  SI (une ligne commence par une espace) ALORS
    elle apparaîtra exactement telle qu'elle a été saisie ;
    dans une police non proportionnelle ;
    les sauts de ligne ne seront pas automatiques ;
  FIN SI
  C'est bien utile pour :
  • copier/coller un texte pré-formaté ;
  • des descriptions d'algorithmes ;
|-
| <pre>&lt;div style="text-align: center;"&gt;Le texte est centré.&lt;/div&gt;</pre>
| <div style="text-align: center;">Le texte est centré.</div>
|-
| <pre>Une ligne horizontale : texte au-dessus
----
et texte en-dessous.</pre>
| Une ligne horizontale : texte au-dessus
----
et texte en-dessous.
|}

=== Citation ===

* {{m|BlocCitation}}

 <nowiki>{{BlocCitation|Ce modèle permet de présenter des citations de texte dans les pages de contenu des livres sous la forme d'un bloc avec guillemets français par défaut.|auteur=[[Modèle:BlocCitation|fr.wikibooks.org]]}}</nowiki>
{{BlocCitation|Ce modèle permet de présenter des citations de texte dans les pages de contenu des livres sous la forme d'un bloc avec guillemets français par défaut.|auteur=[[Modèle:BlocCitation|fr.wikibooks.org]]}}

* {{m|Citation}}

 <nowiki>{{Début citation|fr.wikibooks.org}}</nowiki>
 <nowiki>Ce modèle permet de présenter des citations de texte dans les pages de contenu des livres sous la forme d'un bloc.</nowiki>
 <nowiki>{{Fin citation|fr.wikibooks.org}}</nowiki>
{{Début citation|fr.wikibooks.org}}
Ce modèle permet de présenter des citations de texte dans les pages de contenu des livres sous la forme d'un bloc.
{{Fin citation|fr.wikibooks.org}}

* Plus de modèles ici : [[:Catégorie:Modèle citation|Modèle citation]]

=== Plusieurs colonnes ===

La présentation du texte peut se faire sur plusieurs colonnes.
La syntaxe suivante est adaptative : sur les vues de largeur moindre (mobile par exemple), le texte sera affiché sur une seule colonne.

* 2 colonnes
 <nowiki><div class="flex-content"></nowiki>
 <nowiki><div class="flex-content-half"></nowiki>
 ...colonne 1...
 <nowiki></div></nowiki>
 <nowiki><div class="flex-content-half"></nowiki>
 ...colonne 2...
 <nowiki></div></nowiki>
 <nowiki></div></nowiki>

* 3 colonnes
 <nowiki><div class="flex-content"></nowiki>
 <nowiki><div class="flex-content-third"></nowiki>
 ...colonne 1...
 <nowiki></div></nowiki>
 <nowiki><div class="flex-content-third"></nowiki>
 ...colonne 2...
 <nowiki></div></nowiki>
 <nowiki><div class="flex-content-third"></nowiki>
 ...colonne 3...
 <nowiki></div></nowiki>
 <nowiki></div></nowiki>

== Liens, adresses internet et images ==

=== Les liens ===
{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
|<pre>Lien vers [[Accueil]].</pre>
|Lien vers [[Accueil]].
|}
La première lettre apparaît automatiquement en majuscule.
Les espaces sont convertis en « _ ».

Pour créer une nouvelle page, créez d'abord un lien vers cette page, puis cliquez sur le lien en rouge qui apparaît.

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre>Le même lien, mais avec un nom différent :
[[Accueil|page d'accueil]].</pre>
| Le même lien, mais avec un nom différent :
[[Accueil|page d'accueil]].
|}
Les liens ne peuvent contenir que des lettres et des espaces !

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre>[[La sexualité des mouches dans le Vercors oriental]] est une page qui n'existe pas encore.</pre>
| [[La sexualité des mouches dans le Vercors oriental]] est une page qui n'existe pas encore.
|}
Vous pouvez la créer en cliquant simplement sur le lien.
Après l'avoir créée, faites une recherche sur son titre, et assurez-vous que les autres pages y font correctement référence.

Pour les pages d'homonymie, il existe un raccourci pour cacher le domaine :
{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-----
| <pre>la planète [[Jupiter (planète)|]]</pre>
| la planète [[w:Jupiter (planète)|Jupiter]]
|}

Pour référencer les pages utilisateur, il existe un raccourci pour éviter de taper deux fois le nom :
{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre>[[Utilisateur:Dupont|]] est équivalent à [[Utilisateur:Dupont|Dupont]]</pre>
|[[Utilisateur:Dupont|Dupont]] est équivalent à [[Utilisateur:Dupont|Dupont]]
|}

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|- valign="top"
| <pre>Lien vers les commentaires associés à cette page ou a une page du domaine Wikipédia :
<nowiki>[[Discussion_Wikipédia:Comment modifier une page]]</nowiki><br />
Lien vers une discussion d'une page normale du Wikipédia <nowiki>[[Discuter:Accueil]]</nowiki></pre>
| Lien vers les commentaires associés à cette page ou à une page du domaine Wikipédia :
[[Discussion Wikipédia:Comment modifier une page]]<br />
Lien vers une discussion d'une page normale du Wikipédia [[Discuter:Accueil]]<br />
|- valign="top"
| <pre>#REDIRECT [[France]]</pre>
| [[Wikipédia:Redirection|Redirection]] d'une page vers une autre en mettant ce texte dans la première ligne.
|- valign="top"
| <pre><nowiki>[[:en:Wikilivres:How to edit a page]]</nowiki>
<br /><br />
<nowiki>[[:en:Wikilivres:How to edit a page|Cette page en anglais]]</nowiki>
<br /><br />
<nowiki>[[:en:Wikilivres:How to edit a page|]]</nowiki>
</pre>
| Il existe une notation pour référencer une page sur un projet wikibooks dans une autre langue : [[:en:Wikilivres:How to edit a page]]
<br /><br />
On peut ici aussi utiliser la barre verticale pour afficher un texte différent du titre de la page pointée : [[:en:Wikilivres:How to edit a page|Cette page en anglais]]
<br /><br />
Attention, ici la barre verticale seule en fin de lien ne permet pas de réduire le texte affiché au strict nécessaire : [[:en:Wikilivres:How to edit a page|en:Wikilivres:How to edit a page]]
|- valign="top"
| <pre><nowiki>[[wikt:Mot]]</nowiki> 
<br /><br />
<nowiki>[[wikt:Mot|Mot]]</nowiki> ou directement <nowiki>[[wikt:Mot|]]</nowiki>
<br /><br />
<nowiki>[[wikt:en:Word]]</nowiki> ou <nowiki>[[wikt:en:Word|Word]]</nowiki>
</pre>
| Pour référencer un mot sur [[Wiktionary]] : [[wikt:Mot]]
<br /><br />
On peut ici aussi utiliser la barre verticale pour afficher un texte différent du titre de la page pointée : [[wikt:Mot|Mot]] ou directement [[wikt:Mot|Mot]]
<br /><br />
On peut aussi référencer un mot sur un wiktionary dans une autre langue: [[wikt:en:Word]] ou [[Wikt:en:Word|Word]]
|}

=== Les liens internes, les ancres ===

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|- valign="top"
|
<pre><nowiki><span id="ancre_1">ancre 1.</span>

<span id="ancre_2">ancre 2.</span></nowiki></pre>

Remarquez que la balise <nowiki><span></nowiki> n'est effectivement pas censée avoir d'effet de mise en forme. Elle n'est là que parce qu'il est nécessaire d'utiliser une balise HTML afin d'y placer un paramètre ''id'' qui indique le nom de l'ancre. Ça devrait pouvoir être n'importe quelle balise HTML que le wiki reconnaît.
|
Les ancres :

<span id="ancre_1">ancre 1.</span>

<span id="ancre_2">ancre 2.</span>

Ces deux lignes sont des ancres vers lesquelles des liens internes à cette pages peuvent pointer. Des liens de pages externes aussi, d'ailleurs.
|- valign="top"
|
<pre><nowiki>[[Wikilivres:Syntaxe wikilivres/Lien ancré#ancre_1|lien]] vers
l'ancre 1 externe.

[[Wikilivres:Syntaxe wikilivres/Lien ancré#ancre_2|lien]] vers
l'ancre 2 externe.</nowiki></pre>
On crée un lien normalement, en ajoutant un dièse (#) suivi du nom de l'ancre vers laquelle le lien pointe à la fin du nom de la page pointée.
|
Les liens vers des ancres externes sont des liens normaux qui pointent vers une ancre de la page vers laquelle ils dirigent.

[[Wikilivres:Syntaxe wikilivres/Lien ancré#ancre_1|lien]] vers
l'ancre 1 externe.

[[Wikilivres:Syntaxe wikilivres/Lien ancré#ancre_2|lien]] vers
l'ancre 2 externe.

Ces deux ancres se trouvent sur la [[Wikilivres:Syntaxe wikilivres/Lien ancré|page d'explication des liens ancrés]].
|- valign="top"
|
<pre><nowiki>[[#ancre_1|lien vers l'ancre 1]].


[[#ancre_2|lien vers l'ancre 2]].</nowiki></pre>
Le nom de la page courante est toutefois implicite.
|
Les liens internes sont des liens normaux qui pointent vers des ancres de la page courante :

[[#ancre_1|lien vers l'ancre 1]].

[[#ancre_2|lien vers l'ancre 2]].
|}

=== Les adresses internet === 

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|----- valign="top"
| <pre>Lien externe : [http://www.nupedia.com Nupedia]</pre>
| Lien externe : [http://www.nupedia.com Nupedia]
|----- valign="top"
| <pre>Mais l'adresse internet suffit : http://www.nupedia.com.</pre>
| Mais l'adresse internet suffit : http://www.nupedia.com.<br />
(Bien pratique si on veut imprimer la page.)
|}

Il existe toute une liste de ''préfixes'' utilisables ainsi: <nowiki>[[prefixe:valeur]]</nowiki>.<br />Une liste complète est disponible sur [[m:Interwiki map]] (en anglais)
Exemple: <nowiki>[[google:Wikipédia]]</nowiki> donne [[google:Wikipédia|ceci]]

Remarque : attention à ne pas créer de lien vers des publicités, des sites criblés de fautes d'orthographe ou hors sujet.

=== Les images === 

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="60%" | Résultat !! width="40%" | Syntaxe wikilivres
|----- valign="top"
| '''Insérer une image :'''
[[Image:wiki-exemple.png]]<br />
Pour ajouter une image, vous devez d'abord la copier sur le serveur, ce qui suppose de vous connecter comme utilisateur identifié. Vous pouvez alors accéder à la page de copie sur le serveur de commons : [[commons:Special:UploadWizard]]<br />
<br />
Il faut ensuite placer le lien de l'image dans votre page.<br />
NE FAITES PAS de liens externes vers des fichiers se trouvant sur un serveur dont vous ne contrôlez pas le contenu !

Pour l'accessibilité des mal-voyants, il est conseillé d'ajouter le "nom de l'image", ceci permet au lecteur vocal ou à la tablette braille de fournir un descriptif parlant, là où il y a une image.

Voir [[w:Wikipédia:Règles d'utilisation des images]] pour de plus amples informations à ce sujet.
|
<pre><nowiki>[[Image:wiki-exemple.png]]</nowiki></pre> ou <br />
<pre><nowiki>[[Image:wiki-exemple.png|nom de l'image]]</nowiki></pre>
|-----
| '''Faire "flotter" une image'''<br /><br />
[[Image:wiki-exemple.png|left]]
Quand une image n'occupe pas la largeur de la page, il peut être agréable de la placer à gauche et que le texte s'écrive le long de celle-ci du côté droit.<br />
Pour cela, il vous suffit de recopier le code ci-contre à l'endroit où vous souhaitez voir l'image et de remplacer les parties en italique par le lien vers l'image et par la légende de l'image.<br /><br />
Si vous souhaitez placer l'image du côté droit, remplacer ''left'' par ''right''<br />
|
<code><nowiki>[[</nowiki>Image:<i>nom-image.png</i>|left|<i>Légende</i>]]<br />
Quand une image n'occupe pas la largeur de la page ...
</code>
|-----
| '''Faire "flotter" plusieurs images'''<br />
[[Image:Icon_no.png|left]][[Image: Icon_yes.png|left]]Plusieurs images qui "flottent" à la suite elles se positionnent les unes à côté des autres.

<div style="float:right;padding:15px">[[Image:Icon_no.png]]<br />[[Image: Icon_yes.png]]</div>Il est possible de forcer l'affichage d'images les unes en dessous des autres. Pour un meilleur rendu, cette astuce est à utiliser avec des images qui font la même largeur (voir ci dessous "Syntaxe étendue pour les images" pour imposer la taille des images).
| <code><nowiki>[[Image:Icon_no.png|left]][[Image:Icon_yes.png|left]]</nowiki></code> Pour faire flotter un à côté de l'autre.
<code><nowiki><div style="float:right;">[[Image:Icon_no.png]]<br/>[[Image: Icon_yes.png]]</div></nowiki></code> Pour faire flotter l'un en dessous de l'autre.
|}

=== Syntaxe étendue pour les images === 

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="60%" | Résultat !! width="40%" | Syntaxe wikilivres
|----- valign="top"
| Une syntaxe étendue permet de contrôler la taille et la position des images:<br />
Les options disponibles sont les suivantes (si plusieurs options sont présentes, elles doivent être séparées par un signe <code>|</code>; il faut un <code>|</code> après la dernière option même s'il n'y a pas de légende):<br />
*<code>thumb</code> ou <code>thumbnail</code>
:permet de générer automatiquement une version réduite de l'image, dans un cadre. Par défaut, l'image sera alignée à droite. La légende, si présente, sera placée en dessous de l'image;  une "icône avec deux cadres" placée à droite permet d'accéder à l'image en grandeur réelle.
*<code>framed</code>
:l'image est placée dans un cadre, comme avec l'option <code>thumb</code>, et accepte donc une légende mais n'est disponible que dans sa taille normale et l'"icône loupe" est donc absente.
*<code>right</code>
:permet d'aligner l'image à droite. Peut s'utiliser avec ou sans l'option <code>thumb</code>.
*<code>center</code>
:permet de centrer l'image. Peut s'utiliser avec ou sans l'option <code>thumb</code>.
*<code>left</code>
:permet d'aligner l'image à gauche. Peut s'utiliser avec ou sans l'option <code>thumb</code>.
*<code>none</code>
:permet de supprimer l'alignement par defaut. Cette option est surtout utile pour les images insérées dans un tableau.
*<code>''largeur'' px</code>
:permet de specifier la largeur de la version réduite. L'image affichée gardera le même aspect que l'image grandeur réelle.
|
<code><nowiki>[[</nowiki>Image:''nom de l'image''|''options''|''légende'']]</code>
|}

== Mise en forme des caractères ==

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
| <pre>''Faire ressortir un mot'',
'''un peu plus''',
'''''encore plus'''''.

'''F''' = ''m'' '''a'''.</pre>
| ''Faire ressortir un mot'', '''un peu plus''', '''''encore plus'''''.<br />
À utiliser également dans les formules : '''F''' = ''m'' '''a'''.
|-
| <pre>Police machine à écrire
pour les&lt;code&gt;termes techniques&lt;/code&gt;</pre>
| Police machine à écrire pour les <code>termes techniques</code>.
|-
| <pre>Vous pouvez &lt;strike&gt;barrer&lt;/strike&gt;
certains mots
et &lt;u&gt;en souligner d'autres...&lt;/u&gt;</pre>
| Vous pouvez <s>barrer</s> certains mots et <u>en souligner d'autres...</u>.
|-
| <pre>
&amp;Agrave; &amp;Aacute; &amp;Acirc; &amp;Atilde; &amp;Auml; &amp;Aring; &amp;AElig;
&amp;Ccedil; &amp;Egrave; &amp;Eacute; &amp;Ecirc; &amp;Euml; &amp;Igrave; &amp;Iacute;
&amp;Icirc; &amp;Iuml; &amp;Ntilde; &amp;Ograve; &amp;Oacute; &amp;Ocirc; &amp;Otilde; &amp;OElig;
&amp;Ouml; &amp;Oslash; &amp;Ugrave; &amp;Uacute; &amp;Ucirc; &amp;Uuml; &amp;szlig;
&amp;agrave; &amp;aacute; &amp;acirc; &amp;atilde; &amp;auml; &amp;aring; &amp;aelig;
&amp;ccedil; &amp;egrave; &amp;eacute; &amp;ecirc; &amp;euml; &amp;igrave; &amp;iacute;
&amp;icirc; &amp;iuml; &amp;ntilde; &amp;ograve; &amp;oacute; &amp;ocirc; &amp;otilde; &amp;oelig;
&amp;ouml; &amp;oslash; &amp;ugrave; &amp;uacute; &amp;ucirc; &amp;uuml; &amp;yuml;</pre>
| Umlauts et accents :<br />
À Á Â Ã Ä Å Æ <br />
Ç È É Ê Ë Ì Í <br />
Î Ï Ñ
Ò Ó Ô Õ Œ<br />
Ö Ø Ù Ú Û Ü ß <br />
à á â ã ä å æ <br />
ç è é ê ë ì í <br />
î ï ñ ò ó ô õ œ<br />
ö ø ù ú û ü ÿ<br />
Note : depuis le passage à l'[[w:unicode|unicode]] on peut aussi parfaitement écrire les caractères spéciaux directement sans aucun souci.
|- valign="top"
| <pre>&amp;iquest; &amp;iexcl; &amp;laquo; &amp;raquo; &amp;sect; &amp;para;
&amp;dagger; &amp;Dagger; &amp;bull;
</pre>
| Ponctuations : ¿ ¡ « » § ¶<br />
† ‡ •
|- valign="top"
| <pre>&amp;trade; &amp;copy; &amp;reg; &amp;cent; &amp;euro; &amp;yen; &amp;pound; &amp;curren;
</pre>
| Caractères spéciaux : ™ © ® ¢ € ¥ £ ¤
|- valign="top"
| <pre>Indice : x&lt;sub&gt;2&lt;/sub&gt; et Exposant : x&lt;sup&gt;2&lt;/sup&gt;</pre>
| Indice (subscript en anglais) : x<sub>2</sub> et<br /> Exposant (superscript en anglais) : x{{exp|2}}
|- valign="top"
| <pre>&amp;alpha; &amp;beta; &amp;gamma; &amp;delta; &amp;epsilon; &amp;zeta; &amp;eta;
&amp;theta; &amp;iota; &amp;kappa; &amp;lambda; &amp;mu; &amp;nu; &amp;xi;
&amp;pi; &amp;rho;  &amp;sigma; &amp;sigmaf; &amp;tau; &amp;upsilon; &amp;phi;
&amp;chi; &amp;psi; &amp;omega;
&amp;Gamma; &amp;Delta; &amp;Theta; &amp;Lambda; &amp;Xi; &amp;Pi; &amp;Sigma;
&amp;Phi; &amp;Psi; &amp;Omega;
</pre>
| Caractères grecs : α β γ δ
ε ζ η<br />
θ ι κ λ μ ν ξ <br />
π ρ  σ ς τ υ φ<br />
χ ψ ω <br />
Γ Δ Θ Λ Ξ Π Σ <br />
Φ Ψ Ω
|- valign="top"
| valign="middle" | <pre>&amp;int; &amp;sum; &amp;prod; &amp;radic; &amp;plusmn; &amp;infin;
&amp;asymp; &amp;prop; &amp;equiv; &amp;ne; &amp;le; &amp;ge; &amp;rarr;
&amp;times; &amp;middot; &amp;divide; &amp;part; &amp;prime; &amp;Prime; &amp;nabla;
&amp;permil; &amp;deg; &amp;there4; &amp;alefsym;
&amp;oslash; &amp;isin; &amp;ni; &amp;cap; &amp;cup; &amp;sub; &amp;sup; &amp;sube; &amp;supe;
&amp;not; &amp;and; &amp;or; &amp;exist; &amp;forall; &amp;rArr; &amp;hArr;</pre>
| Caractères mathématiques : (cf. [[Wikilivres:Caractères spéciaux]]) <br />
∫ ∑ ∏ √ ± ∞ <br />
≈ ∝ ≡ ≠ ≤ ≥ → <br />
× · ÷ ∂ ′ ″ ∇ <br />
‰ ° ∴ ℵ<br />
ø ∈ ∋ ∩ ∪ ⊂ ⊃ ⊆ ⊇<br />
¬ ∧ ∨ ∃ ∀ ⇒ ⇔
|- valign="top"
| <pre>;x<sup>2</sup>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;ge;&amp;nbsp;&amp;nbsp;&amp;nbsp;0
</pre>
| Plus d'espace que d'habitude, sans saut de ligne : x{{exp|2}}&nbsp;&nbsp;&nbsp;≥&nbsp;&nbsp;&nbsp;0 est vrai.<br />
Utile pour les formules.
|-
| <pre><nowiki> 
<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
</nowiki></pre>
| Formules mathématiques compliquées :<br />
&nbsp;&nbsp;<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
* Voir [[w:Wikipédia:Formules TeX|Wikipédia:Formules TeX]]
|-
|<pre><nowiki><nowiki>Lien → (<i>vers</i>) la [[w:Wikipédia:FAQ|]]</nowiki></nowiki></pre>
| Suppression de l'interprétation de la syntaxe wiki :<br />
<nowiki>Lien → (<i>vers</i>) la [[w:Wikipédia:FAQ|]]</nowiki>
* Est utilisé pour montrer littéralement des données qui autrement auraient une signification spéciale.
* Tous les ''markup'' wiki sont ignorés, y compris ceux ressemblant à des tags HTML.
* Les caractères HTML spéciaux sont toujours interprétés.
|}

== Formules mathématiques ou chimiques ==

Les balises &lt;math&gt; et &lt;chem&gt; permettent l'écriture de formules mathématiques et chimiques (respectivement) dans les chapitres des livres, au format [[LaTeX]].
* La balise &lt;math&gt; est celle qui est préférablement utilisée pour les mathématiques.
* La balise &lt;chem&gt; est celle qui est préférablement utilisée pour les formules chimiques. Elle est un raccourci de la syntaxe <code><nowiki><math chem>\ce{ ... }</math></nowiki></code>.

Exemples :

{| class="wikitable altlines1"
|
 <nowiki><math>x=1+2/3</math></nowiki>
|
<math>x=1+2/3</math>
|-
|
 <nowiki><chem>x=1+2/3</chem></nowiki>
|
<chem>x=1+2/3</chem>
|-
|
 <nowiki><math>x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</math></nowiki>
|
<math>x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</math>
|-
|
 <nowiki><chem>x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</chem></nowiki>
|
<chem>x=\frac{-b\pm\sqrt{\color{Red}b^2-4ac}}{2a}</chem>
|-
|
 <nowiki><math>x=\frac{-b\pm\sqrt{\color{Red}b^2-4ac}}{2a}</math></nowiki>
|
<math>x=\frac{-b\pm\sqrt{\color{Red}b^2-4ac}}{2a}</math>
|-
|
 <nowiki><chem>x=\frac{-b\pm\sqrt{\color{Red}b^2-4ac}}{2a}</chem></nowiki>
|
<chem>x=\frac{-b\pm\sqrt{\color{Red}b^2-4ac}}{2a}</chem>
|}

{| class="wikitable"
|+ Formules chimiques
|-
|
 <nowiki><chem>2R3B\ +  3CO\  + 4H^-  ->[\text{DG}][\text{45°}] ->[\text{KOH}] 4ROH\ + 2 RCH2OH</chem></nowiki>
|
<chem>2R3B\ +  3CO\  + 4H^-  ->[\text{DG}][\text{45°}] ->[\text{KOH}] 4ROH\ + 2 RCH2OH</chem>
|-
|
 <nowiki><math chem>\ce{2R3B\ +  3CO\  + 4H^-  ->[\text{DG}][\text{45°}] ->[\text{KOH}] 4ROH\ + 2 RCH2OH}</math></nowiki>
|
<math chem>\ce{2R3B\ +  3CO\  + 4H^-  ->[\text{DG}][\text{45°}] ->[\text{KOH}] 4ROH\ + 2 RCH2OH}</math>
|}

L'attribut <code>display</code> permet de modifier l'affichage de la formule<ref>[[mw:Extension:Math/Displaystyle|Extension Displaystyle]] sur le site de mediawiki.</ref> :
* la valeur ''<code>inline</code>'' diminue la taille pour une meilleur intégration dans les lignes du texte.
* la valeur ''<code>block</code>'' place la formule dans un paragraphe séparé, centré par défault.

{| class="wikitable altlines1"
|
 <nowiki>La formule est <math display="inline">x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</math> au milieu du texte.</nowiki>
| style="min-width: 300px;" |
La formule est <math display="inline">x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</math> au milieu du texte.
|-
|
 <nowiki>La formule est <chem display="inline">x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</chem> au milieu du texte.</nowiki>
|
La formule est <chem display="inline">x=\frac{-b\pm\sqrt{\color{Red}b^2-4ac}}{2a}</chem> au milieu du texte.
|-
|
 <nowiki>La formule est <math display="block">x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</math> au milieu du texte.</nowiki>
|
La formule est <math display="block">x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</math> au milieu du texte.
|-
|
 <nowiki>La formule est <chem display="block">x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}</chem> au milieu du texte.</nowiki>
|
La formule est <chem display="block">x=\frac{-b\pm\sqrt{\color{Red}b^2-4ac}}{2a}</chem> au milieu du texte.
|}

== Tableaux ==

Les tableaux sont introduits par une accolade ouvrante suivie d'une barre verticale <code><nowiki>{|</nowiki></code>.
La fin est indiquée par une ligne de fermeture composée d'une barre verticale suivie d'une accolade fermante <code><nowiki>|}</nowiki></code>.

Entre les deux lignes, les lignes commençant par une barre verticale concernent la composition du tableau :
;<code>|+ ''texte''</code>:(optionnel) Légende pour le tableau.
;<code>| ''texte''</code>:Contenu d'une nouvelle cellule dans le tableau. Le contenu peut s'étaler sur plusieurs lignes.
;<code>! ''texte''</code>:Contenu d'une nouvelle cellule d'entête de tableau. Le point d'exclamation remplace la barre verticale pour indiquer qu'il s'agit d'une cellule d'entête plutôt que de contenu. Elle est affichée en gras et son contenu est centré.
;<code>|-</code>:Déclarer une nouvelle ligne de cellules dans le tableau. Cette ligne peut contenir des attributs (en général ''style'' ou ''class'').

Les cellules peuvent avoir des attributs en utilisant la syntaxe suivante :
 <nowiki>|</nowiki> ''attributs'' <nowiki>|</nowiki> ''contenu''
Pour les cellules d'entêtes, une syntaxe similaire est utilisable en remplaçant la barre en début de ligne par un point d'exclamation :
 <nowiki>!</nowiki> ''attributs'' <nowiki>|</nowiki> ''contenu d'entête''

Il est possible de rassembler plusieurs cellules sur une ligne wiki en utilisant deux barres verticales à la suite pour les séparer :
 <nowiki>|</nowiki> ''cellule 1'' <nowiki>||</nowiki> ''cellule 2''

;Exemple
{| class="wikitable"
|+ Un exemple de tableau
|-
! Premier en-tête
! Deuxième en-tête
! Troisième en-tête
|-
| Haut gauche || Haut milieu || rowspan="2" | Côté droit
|-
| Bas gauche || Bas milieu
|-
| colspan="3" align="center" | ligne du bas
|}

;Syntaxe wiki
<pre>
{| class="wikitable"
|+Un exemple de tableau
|-
! Premier en-tête
! Deuxième en-tête
! Troisième en-tête
|-
| Haut gauche
| Haut milieu
| rowspan="2" | Coté droit
|-
| Bas gauche
| Bas milieu
|-
| colspan="3" align="center" | Ligne du bas
|}
</pre>

La ligne d'ouverture d'une table peut être suivie d'attributs pour la table (en général ''class'' et parfois ''style'').
Les classes disponibles pour les tables sont les suivantes :
;wikitable:Style prédéfini pour les tables avec bordures (voir l'exemple précédent).
;sortable:Permet de trier les lignes selon l'entête de colonne cliqué. Le premier clic classe dans l'ordre croissant, le deuxième dans l'ordre décroissant et le troisième restaure l'ordre original.
;altlines1:Alternance de la couleur de fond des lignes. L'alternance est conservé après le tri.
;altlines2:Alternance de la couleur de fond des lignes, alternative à altlines1.

;Exemple
{| class="wikitable sortable altlines1"
|+ Un exemple de tableau triable
|-
! Mois
! Nouveaux contributeurs
! Nouvelles pages de livres
|-
| Janvier || 25 || 125
|-
| Février || 11 || 58
|-
| Mars || 18 || 321
|-
| Avril || 41 || 273
|-
| Mai || 8 || 1008
|-
| Juin || 17 || 215
|-
| Juillet || 23 || 310
|-
| Août || 11 || 145
|-
| Septembre || 52 || 150
|-
| Octobre || 45 || 318
|-
| Novembre || 19 || 875
|-
| Décembre || 29 || 414
|}

;Syntaxe wiki
<pre>
{| class="wikitable sortable altlines1"
|+ Un exemple de tableau triable
|-
! Mois
! Nouveaux contributeurs
! Nouvelles pages de livres
|-
| Janvier || 25 || 125
|-
| Février || 11 || 58
|-
| Mars || 18 || 321
|-
| Avril || 41 || 273
|-
| Mai || 8 || 1008
|-
| Juin || 17 || 215
|-
| Juillet || 23 || 310
|-
| Août || 11 || 145
|-
| Septembre || 52 || 150
|-
| Octobre || 45 || 318
|-
| Novembre || 19 || 875
|-
| Décembre || 29 || 414
|}
</pre>

Les cellules peuvent être hachurées pour les cas inexistants ou non applicables :

;Exemple
{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
|<pre>
{| class="wikitable"
|-
! Premier en-tête
! Deuxième en-tête
|-
| A
| B
|-
| C
| class="hachure" |
|}
</pre>
|
{| class="wikitable"
|-
! Premier en-tête
! Deuxième en-tête
|-
| A
| B
|-
| C
| class="hachure" |
|}
|}

Pour avoir tous les détails, voir la [[w:fr:Aide:Syntaxe wikipédia/tableaux|sous-page de la syntaxe des tableaux dans la Wikipédia]];

'''Voir également''' [[mw:Markup spec/DTD]], la page d'aide sur les [[w:Aide:Tableaux|tableaux]] sur Wikipedia et [[Wikilivres:Modèles]]

== Commentaire ==

Attention, les commentaires dans les pages sont '''strictement''' réservés à la maintenance de la page. Les commentaires sur le contenu de la page sont à mettre dans la page discussion attachée à la page en question.

<pre><!-- Note : Cette page est en cours de rédaction, veuillez patienter avant de l'éditer. --></pre>

== Identification dans les pages de discussion ==

{| class="wikitable" style="width:100%;"
|- style="background-color:#0033ff40;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
|
<pre>~~~ (3 tildes)</pre>
|
Seulement le pseudonyme :<br />
[[Utilisateur:Aoineko|Aoineko]]
|-
|
<pre>~~~~ (4 tildes)</pre>
|
Pseudonyme et date :<br />
[[Utilisateur:Aoineko|Aoineko]] 03:17 Nov 8, 2002 (CET)
|-
|
<pre>~~~~~ (5 tildes)</pre>
|
Date :<br />
03:17 Nov 8, 2002 (CET)
|}

== Catégories ==
Pour la syntaxe propre à l'utilisation des catégories, voir la page [[Wikilivres:Catégories]]

== Coloration syntaxique ==
L'extension GeSHi permet de colorer le code source de beaucoup de langages (programmation et autres).
Il suffit de placer le code source tel quel entre les balises {{Balise|1=syntaxhighlight lang="''langage''"}} et {{Balise|/syntaxhighlight}}.

Exemple en HTML 5 :
{| class="wikitable" style="width:100%;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
|
<pre>
<syntaxhighlight lang="html5">
<!DOCTYPE html>
<html>
<head><title>Exemple illustratif de la syntaxe</title></head>
<body>Exemple illustratif de la syntaxe sur fr.wikibooks.org</body>
</html>
</syntaxhighlight>
</pre>
|
<syntaxhighlight lang="html5">
<!DOCTYPE html>
<html>
<head><title>Exemple illustratif de la syntaxe</title></head>
<body>Exemple illustratif de la syntaxe sur fr.wikibooks.org</body>
</html>
</syntaxhighlight>
|}

Ou en shell Bash :
{| class="wikitable" style="width:100%;"
! width="50%" | Syntaxe wikilivres !! width="50%" | Résultat
|-
|
<pre>
<syntaxhighlight lang="bash">
#!/bin/sh

export SITE=fr.wikibooks.org

echo Ceci permet d'illustrer la syntaxe à utiliser.
mkdir archives && cp pages/*.html archives

</syntaxhighlight>
</pre>
|
<syntaxhighlight lang="bash">
#!/bin/sh

export SITE=fr.wikibooks.org

echo Ceci permet d'illustrer la syntaxe à utiliser.
mkdir archives && cp pages/*.html archives

</syntaxhighlight>
|}

Voir :
*{{en}} [[mw:Extension:SyntaxHighlight|Extension SyntaxHighlight]]

{{Attention|Veillez à ne pas trop utiliser la coloration syntaxique pour pouvoir générer une version imprimable, particulièrement dans les livres de programmation :
* ne pas l'utiliser pour les petits extraits de code ou pour du code inclut dans le texte ;
* ne pas l'utiliser pour les extraits de code peu colorés ;
* ne pas l'utiliser pour les langages non supportés ou peu colorés (ex : bash) ;
* si possible, groupez plusieurs blocs ensemble en les séparant par des commentaires.
Remplacez-les par {{Balise|pre}} ou une indentation d'un caractère espace pour les blocs de code ; ou par {{Balise|code}} pour du code dans le texte.
}}

== Les erreurs à éviter ==

Les conseils suivants vous indiquent les erreurs courantes à éviter :
;Évitez d'utiliser les signes inférieur ( <code>&lt;</code> ) et supérieur ( <code>&gt;</code> ):Ces deux signes sont interprétés par le système wiki et le navigateur.
:Pour insérez ces signes, utilisez les entités HTML lt et gt :
::<code>&amp;lt; pour &lt; (''Lower Than'' en anglais)</code>
::<code>&amp;gt; pour &gt; (''Greater Than'' en anglais)</code>
:Pour indiquer un paramètre formel dans une syntaxe, utilisez une mise en forme plutôt que les signes <code>&lt;</code> et <code>&gt;</code> (italique par exemple) :
::<code>Afficher( ''expression'' )</code>
;Évitez d'utiliser certaines balises de formatage HTML:Même si le résultat est équivalent, il est préférable d'utiliser l'équivalent wiki, afin d'avoir un code wiki plus simple :
{| class="wikitable altlines1"
! width="50%" | Balisage HTML
! width="50%" | Équivalent wiki
|-
| <code>&lt;br/&gt;</code> ou <code>&lt;p/&gt;</code>
| Utilisez un double saut de ligne pour passer au paragraphe suivant.
|-
| <code>&lt;b&gt;Un texte en gras&lt;/b&gt;</code>
| 
 <nowiki>'''Un texte en gras'''</nowiki>

Encadrez le texte par les triples apostrophes.
|-
| <code>&lt;i&gt;Un texte en italique&lt;/i&gt;</code>
|
 <nowiki>''Un texte en italique''</nowiki>

Encadrez le texte par les doubles apostrophes.
|-
| <code>&lt;pre&gt;Du texte préformaté&lt;/pre&gt;</code>
|
 &nbsp;Du texte préformaté

Commencez chaque ligne par le caractère espace.
|-
| <code>&lt;ul&gt;<br />  &lt;li&gt;premier item non ordonné&lt;/li&gt;<br />  &lt;li&gt;deuxième item non ordonné&lt;/li&gt;<br />&lt;/ul&gt;</code>
|
 *premier item non ordonné
 *deuxième item non ordonné

Commencez chaque ligne par une étoile pour chaque item de la liste.
|-
| <code>&lt;ol&gt;<br />  &lt;li&gt;premier item numéroté&lt;/li&gt;<br />  &lt;li&gt;deuxième item numéroté&lt;/li&gt;<br />&lt;/ol&gt;</code>
|
 #premier item numéroté
 #deuxième item numéroté

Commencez chaque ligne par un dièse pour chaque item de la liste.
|-
| <code>&lt;dl&gt;<br />  &lt;dt&gt;Terme 1&lt;/dt&gt;<br />  &lt;dd&gt;Définition du terme 1&lt;/dd&gt;<br />  &lt;dt&gt;Terme 2&lt;/dt&gt;<br />  &lt;dd&gt;Définition du terme 2&lt;/dd&gt;<br />&lt;/dl&gt;</code>
|
 ;Terme 1:Définition du terme 1
 ;Terme 2:Définition du terme 2

Chaque ligne commence par le terme précédé d'un point-virgule, immédiatement suivi du caractère deux-points et de la définition.
|-
| <code>&lt;small&gt;Du texte petit&lt;/small&gt;</code>
|
 <nowiki><span style="font-size:85%;">Du texte petit</span></nowiki>

Utilisez les styles plutôt que les balises de formatage direct.
|-
| <code>&lt;big&gt;Du texte grand&lt;/big&gt;</code>
|
 <nowiki><span style="font-size:120%;">Du texte grand</span></nowiki>

Utilisez les styles plutôt que les balises de formatage direct (de plus, <code>&lt;big&gt;</code> est obsolète en HTML5).
|-
| <code>&lt;font color="blue" size="+1"&gt;Du texte bleu de grande taille&lt;/font&gt;</code>
<code>&lt;font color="blue" size="large"&gt;Du texte bleu de grande taille&lt;/font&gt;</code>
|
 <nowiki><span style="font-size:18pt;color:blue;">Du texte bleu de grande taille</span></nowiki>

Utilisez les styles plutôt que les balises de formatage direct (de plus, <code>&lt;font&gt;</code> est obsolète en HTML5).
Pour les tailles équivalentes, voir le tableau ci-dessous.
|-
| <code>&lt;div style="display:inline-block;"&gt;...&lt;/div&gt;</code>

|
 <nowiki><span>...</span></nowiki>

{{Attention|Il n'est plus possible d'utiliser d'éléments avec <code>display:inline-block</code> dans les versions récentes de Mediawiki, car désormais Mediawiki introduit des éléments &lt;p&gt; avant et après les éléments &lt;div&gt; sans tenir compte des propriétés CSS.
L'équivalence peut donc ne pas être exacte dans certains cas.}}.
|}

La balise <code>&lt;font&gt;</code>, obsolète en HTML5, permettait de changer la taille et la couleur du texte.
Il est recommandé de la remplacer par une balise <code>&lt;span&gt;</code> avec un attribut style pour spécifier la couleur ([[Le langage CSS/Texte#color : couleur des caractères|color]]) et la taille ([[Le langage CSS/Texte#font-size : taille des caractères|font-size]]).
Le tableau ci-dessous donne l'équivalence entre les valeurs possible de size de la balise <code>&lt;font&gt;</code> et les valeurs pour font-size.

{| class="wikitable"
! Taille absolue, élément obsolète
! Taille relative, élément obsolète
! CSS font-size équivalent
! CSS font-size équivalent en points
|-
|
|
| style="font-size:xx-small" | font-size: xx-small
| style="font-size:7pt" | font-size: 7pt
|-
|
<font size="1">&lt;font size=1&gt;</font>
|
<font size="-2">&lt;font size=-2&gt;</font>
| style="font-size:x-small" | font-size: x-small
| style="font-size:8pt" | font-size: 8pt
|-
|
<font size="2">&lt;font size=2&gt;</font>
|
<font size="-1">&lt;font size=-1&gt;</font>
| style="font-size:small" | font-size: small
| style="font-size:10pt" | font-size: 10pt
|-
|
<font size="3">&lt;font size=3&gt;</font>
|
<font size="+0">&lt;font size=+0&gt;</font>
| style="font-size:medium" | font-size: medium
| style="font-size:12pt" | font-size: 12pt
|-
|
<font size="4">&lt;font size=4&gt;</font>
|
<font size="+1">&lt;font size=+1&gt;</font>
| style="font-size:large" | font-size: large
| style="font-size:14pt" | font-size: 14pt
|-
|
<font size="5">&lt;font size=5&gt;</font>
|
<font size="+2">&lt;font size=+2&gt;</font>
| style="font-size:x-large" | font-size: x-large
| style="font-size:18pt" | font-size: 18pt
|-
|
<font size="6">&lt;font size=6&gt;</font>
|
<font size="+3">&lt;font size=+3&gt;</font>
| style="font-size:xx-large" | font-size: xx-large
| style="font-size:24pt" | font-size: 24pt
|-
|
<font size="7">&lt;font size=7&gt;</font>
|
<font size="+4">&lt;font size=+4&gt;</font>
| style="font-size:xxx-large" | font-size: xxx-large
| style="font-size:36pt" | font-size: 36pt
|}

Pour la coloration, pour pouvez utiliser les modèles existants comme {{m|Vert}}, {{m|Rouge}}, {{m|Orange}} ...
Cependant, '''évitez d'utiliser des couleurs''' dans le texte car cela peut rendre la lecture plus difficile surtout quand les couleurs sont mal choisies.
Pour la coloration syntaxique, utilisez plutôt la balise <code>&lt;syntaxhighlight lang="''langage''"&gt;</code> pour le langage approprié : <code>css</code>, <code>html</code>, <code>xml</code>, <code>json</code>, <code>java</code>, <code>c++</code>...

;Fermez les balises ouvertes:Toute balise HTML ouverte doit être suivie d'une balise fermante.
:N.B. : Quand plusieurs balises sont imbriquées, les fermetures se font dans l'ordre inverse de celui des ouvertures. Exemple :
::<code>&lt;div style="color:blue;"&gt;</code>
:::<code>Voici</code>
:::<code>&lt;span style="font-size:85%;"&gt;</code>
::::<code>un petit texte</code>
:::<code>&lt;/span&gt;</code>
:::<code>au milieu d'un texte bleu de taille normale.</code>
::<code>&lt;/div&gt;</code>
;Utilisez la prévisualisation:Après une modification, utilisez le bouton "Prévisualisation" avant de sauvegarder pour vérifier l'apparence de la page corrigée.

== Références en bas de page ==

Les références dans le texte sont notamment utilisées pour lister des sources externes (URL, ouvrage, ...) et pour créer des notes de base de page.
La syntaxe emploie deux balises :
* La balise &lt;ref&gt; ajoute une référence à une note de bas de page là ou elle est placée dans le texte ;
* La balise &lt;references&gt; contient toutes les références définies dans la page.

Par exemple, cette page d'aide contient une référence définie plus haut avec &lt;ref&gt; :
<pre>
<nowiki>L'attribut <code>display</code> permet de modifier l'affichage de la formule<ref>[[mw:Extension:Math/Displaystyle|Extension Displaystyle]] sur le site de mediawiki.</ref></nowiki>
</pre>

Le contenu de la balise n'est pas affiché ; à la place, il y a un lien numéroté entre crochet : [1], puis [2] pour la suivante, ...
Le contenu de ces balises est affiché sous la forme d'une liste numérotée là où est placée la balise &lt;references&gt;, notamment ici :
<references/>


{| class="wikitable altlines1"
|-
! width="40%" | Syntaxe wikilivres
! width="60%" | Résultat
|-
| style="font-family: courier, monospace;" | Phrase<nowiki><ref>http://URL.com</ref></nowiki><br /><nowiki>=== Références ===</nowiki><br /><nowiki><references/></nowiki>
| Phrase<ref>http://fr.wikibooks.org</ref>
=== Références ===

<references/>
|-
| style="font-family: courier, monospace;" | <nowiki>Il est possible d'appeler la même note<ref name="nom de la ref">texte de la note nommée</ref> en plusieurs endroits différents comme ceci<ref name="nom de la ref" /></nowiki><br /><nowiki>=== Références ===</nowiki><br /><nowiki><references/></nowiki>
| Il est possible d'appeler la même note<ref name="nom de la ref">texte de la note nommée</ref> en plusieurs endroits différents comme ceci<ref name="nom de la ref" />
=== Références ===

<references/>
|}

=== Groupes ===

Il est possible de séparer les notes en différents groupes, en définissant par exemple un groupe pour les sources externes nommé {{g|source}} et un autre pour les notes de bas de pages nommé {{g|note}}.
Le nom du groupe doit alors être spécifié avec l'attribut <code>group</code> dans les balises &lt;ref&gt; et &lt;references&gt; comme dans l'exemple ci-dessous :

{| class="wikitable altlines1"
|-
! width="50%" | Syntaxe wikilivres
! width="50%" | Résultat
|-
| style="font-family: courier, monospace;" |
Ceci est un texte&lt;ref {{Ceci|1=group="note"}}&gt;Un texte d'exemple&lt;/ref&gt; illustrant le groupement des références&lt;ref {{Ceci|1=group="source"}}&gt;<nowiki>https://</nowiki>fr.wikibooks.org/wiki/Aide:Syntaxe&lt;/ref&gt; se terminant avec une seconde note de bas de page&lt;ref {{Ceci|1=group="note"}}&gt;Dont le contenu n’apparaît pas directement dans le texte.&lt;/ref&gt;.

Notes de bas de page :<br/>
&lt;references {{Ceci|1=group="note"}}/&gt;

Sources :<br/>
&lt;references {{Ceci|1=group="source"}}/&gt;
|
Ceci est un texte<ref group="note">Un texte d'exemple</ref> illustrant le groupement des références<ref group="source">https://fr.wikibooks.org/wiki/Aide:Syntaxe</ref> se terminant avec une seconde note de bas de page<ref group="note">Dont le contenu n’apparaît pas directement dans le texte.</ref>.

Notes de bas de page :
<references group="note"/>

Sources :
<references group="source"/>
|}

=== Références définies en bas de page ===

La définition du contenu peut se faire classiquement dans le texte, dans le contenu de la balise &lt;ref&gt;.
Le texte peut réutiliser les mêmes références en la nommant comme vu précédemment.
Pour un même nom, le contenu ne doit être défini qu'une seule fois, sinon une erreur se produit.
Éviter cette erreur est difficile dans un long texte, ou quand il y a beaucoup de références.

Dans ce cas, pour mieux gérer les références, il est possible de définir le contenu dans la balise &lt;references&gt; sous forme de balises &lt;ref&gt; nommées.
Le texte de la page ne contient alors plus de contenu directement.
Cela permet de regrouper le contenu de toutes les références en bas de page.
Il faut cependant veiller à référencer toutes les notes dans le texte, car les références non utilisées provoquent la génération d'une erreur.
Définir les notes en bas de page plutôt que dans le texte permet de ne pas interrompre le flux du texte par une longue note dans le code source, le rendant plus lisible et facile à modifier.

Si les groupes sont utilisés, il faut également spécifier le groupe dans le texte :

{| class="wikitable altlines1"
|-
! width="50%" | Syntaxe wikilivres
! width="50%" | Résultat
|-
| style="font-family: courier, monospace;" |
Ceci est un texte&lt;ref {{Ceci|1=group="note" name="expliquer_un"}}/&gt; illustrant le groupement des références&lt;ref {{Ceci|1=group="source" name="source_un"}}/&gt; se terminant avec une seconde note de bas de page&lt;ref {{Ceci|1=group="note" name="expliquer_deux"}}/&gt;.

Notes de bas de page :<br/>
&lt;references {{Ceci|1=group="note"}}&gt;<br/>
&lt;ref {{Ceci|1=name="expliquer_un"}}&gt;Un texte d'exemple&lt;/ref&gt;<br/>
&lt;ref {{Ceci|1=name="expliquer_deux"}}&gt;Dont le contenu n’apparaît pas directement dans le texte.&lt;/ref&gt;<br/>
&lt;/references&gt;

Sources :<br/>
&lt;references {{Ceci|1=group="source"}}&gt;<br/>
&lt;ref {{Ceci|1=name="source_un"}}&gt;<nowiki>https://</nowiki>fr.wikibooks.org/wiki/Aide:Syntaxe&lt;/ref&gt;<br/>
&lt;/references&gt;
|
Ceci est un texte<ref group="note" name="expliquer_un"/> illustrant le groupement des références<ref group="source" name="source_un"/> se terminant avec une seconde note de bas de page<ref group="note" name="expliquer_deux"/>.

Notes de bas de page :
<references group="note">
<ref name="expliquer_un">Un texte d'exemple</ref>
<ref name="expliquer_deux">Dont le contenu n’apparaît pas directement dans le texte.</ref>
</references>

Sources :
<references group="source">
<ref name="source_un">https://fr.wikibooks.org/wiki/Aide:Syntaxe</ref>
</references>
|}

== Voir aussi ==
{{Autres projets
|w=Aide:Syntaxe
|wikt=Aide:Syntaxe
|v=Aide:Syntaxe
|n=Aide:Syntaxe Wikinews
|s=Aide:La syntaxe Wiki
|q=Aide:Syntaxe
}}
{{Contribuer}}

[[Catégorie:Aide sur Wikilivres|Syntaxe Wikilivre]]