Aide:Syntaxe

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

Résultat	Syntaxe wikilivres
texte en italique	''texte en italique'' (apostrophes et non guillemets)
texte en gras	'''texte en gras'''
liste à puce	* liste * à * puce
liste numérotée	# liste # numérotée
Titre de section	==Titre de section==
Titre de sous-section	===Titre de sous-section===

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 droite indique les codes à saisir, et celle de gauche l'effet obtenu.

Vous pouvez effectuer vos tests sur le Bac à sable qui est réservé à cet usage.

Table des matières

Une table des matières est créée automatiquement si la page comporte plus de 3 titres ou sous-titres (au moins 4).

Pour supprimer le sommaire automatique, il suffit de mettre quelque part __NOTOC__.

Pour modifier l'emplacement de la table des matières : placer __NOTOC__ en haut de la page, puis insérer __TOC__ là où vous désirez voir apparaître la table.

Sections, paragraphes et lignes

Pour les titres :

Résultat	Syntaxe wikilivres
Nouvelle section	== Nouvelle section ==
Nouvelle sous-section	=== Nouvelle sous-section ===
Nouveau paragraphe	==== Nouveau paragraphe ====
Nouveau sous-paragraphe	===== Nouveau sous-paragraphe =====

Les notations ci-dessus sont respectivement équivalentes à l'utilisation des balises HTML <h2>...</h2>, <h3>...</h3> et <h4>...</h4>.

Résultat	Syntaxe wikilivres
Un simple saut à la ligne n'a aucun effet.	Un simple saut à la ligne n'a aucun effet.
Mais une ligne vide permet de séparer les paragraphes.	Mais une ligne vide permet de séparer les paragraphes.
Voilà comment il faut faire pour aller à la ligne.	Voilà comment il faut faire<br/> pour aller à la ligne.

Listes

Résultat	Syntaxe wikilivres
Les listes sont bien pratiques : Elles permettent d'organiser les données Elles embellissent le document	* Les listes sont bien pratiques : ** Elles permettent d'organiser les données ** Elles embellissent le document
Les listes numérotées sont également bien pratiques Bien organisées Faciles à lire	# Les listes numérotées sont également bien pratiques # Bien organisées ## Faciles à lire
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 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>
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 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>
Les lignes peuvent être indentées sur plusieurs niveaux	:Les lignes peuvent être ::indentées :::sur plusieurs niveaux
Avec tout cela, il est maintenant possible de mélanger les types de listes : Une liste numérotée : Premier élément Second élément d'autres branches à l'arborescence	*Une liste numérotée : :#Premier élément :#Second élément *d'autres branches à l'arborescence

Résultat	Syntaxe wikilivres
Terme à expliquer explication du terme	; Terme à expliquer : explication du terme
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 ;	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 : &bull; copier/coller un texte pré-formaté ; <br/><br/> &bull; des descriptions d'algorithmes ;
Le texte est centré.	<center>Le texte est centré.</center>
Une ligne horizontale : au-dessus et en-dessous.	Une ligne horizontale : au-dessus ---- et en-dessous.

Liens, adresses internet et images

Les liens

Résultat	Syntaxe wikilivres
Lien vers Accueil.	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.

Résultat	Syntaxe wikilivres
Le même lien, mais avec un nom différent : page d'accueil.	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 !

Résultat	Syntaxe wikilivres
La sexualité des mouches dans le Vercors oriental est une page qui n'existe pas encore.	[[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 :

Résultat	Syntaxe wikilivres
la planète Jupiter	la planète [[Jupiter (planète)|]]

Pour référencer les pages utilisateur, il existe un raccourci pour éviter de taper deux fois le nom :

Résultat	Syntaxe wikilivres
Dupont est équivalent à Dupont	[[Utilisateur:Dupont|]] est équivalent à [[Utilisateur:Dupont|Dupont]]

Résultat	Syntaxe wikilivres
Lien vers les commentaires associés à cette page ou à une page du domaine Wikipédia : Discussion Wikipédia:Comment modifier une page Lien vers une discussion d'une page normale du Wikipédia Discuter:Accueil	Lien vers les commentaires associés à cette page ou a une page du domaine Wikipédia : [[Discussion_Wikipédia:Comment modifier une page]] Lien vers une discussion d'une page normale du Wikipédia [[Discuter:Accueil]]
Redirection d'une page vers une autre en mettant ce texte dans la première ligne.	#REDIRECT [[France]]
Il existe une notation pour référencer une page sur un Wikipédia dans une autre langue : en:Wikilivres:How to edit a page On peut ici aussi utiliser la barre verticale pour afficher un texte différent du titre de la page pointée : Cette page en anglais 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]] [[:en:Wikilivres:How to edit a page|Cette page en anglais]] [[:en:Wikilivres:How to edit a page|]]
Pour référencer un mot sur Wiktionary : wikt:Mot On peut ici aussi utiliser la barre verticale pour afficher un texte différent du titre de la page pointée : Mot ou directement Mot On peut aussi référencer un mot sur un wiktionary dans une autre langue: wikt:en:Word ou Word	[[wikt:Mot]] [[wikt:Mot|Mot]] ou directement [[wikt:Mot|]] [[wikt:en:Word]] ou [[wikt:en:Word|Word]]

Les liens internes, les ancres

Résultat	Syntaxe wikilivres
Les ancres : ancre 1. ancre 2. Ces deux lignes sont des ancres vers lesquelles des liens internes à cette pages peuvent pointer. Des liens de pages externes aussi, d'ailleurs.	<span id="ancre_1">ancre 1.</span> <span id="ancre_2">ancre 2.</span> remarquer que la balise <span> 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 liens vers des ancres externes sont des liens normaux qui pointent vers une ancre de la page vers laquelle ils dirigent. lien vers l'ancre 1 externe. lien vers l'ancre 2 externe. Ces deux ancres se trouvent sur la page d'explication des liens ancrés.	[[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. 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 internes sont des liens normaux qui pointent vers des ancres de la page courante : lien vers l'ancre 1. lien vers l'ancre 2.	[[#ancre_1|lien vers l'ancre 1]]. [[#ancre_2|lien vers l'ancre 2]]. Le nom de la page courante est toutefois implicite.

Les adresses internet

Résultat	Syntaxe wikilivres
Lien externe : Nupedia	Lien externe : [http://www.nupedia.com Nupedia]
Mais l'adresse internet suffit : http://www.nupedia.com. (Bien pratique si on veut imprimer la page.)	Mais l'adresse internet suffit : http://www.nupedia.com.
Il existe toute une liste de préfixes utilisables ainsi: [[prefixe:valeur]]. Une liste complète est disponible sur m:Interwiki map (en anglais)	Exemple: [[google:Wikipédia]] donne 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

Résultat	Syntaxe wikilivres
Insérer une image : 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 Il faut ensuite placer le lien de l'image dans votre page. 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.	[[Image:wiki-exemple.png]] ou [[Image:wiki-exemple.png|nom de l'image]]
Faire "flotter" une image 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. 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. Si vous souhaitez placer l'image du côté droit, remplacer left par right	[[Image:nom-image.png|left|Légende]] Quand une image n'occupe pas la largeur de la page ...
Faire "flotter" plusieurs images Plusieurs images qui "flottent" à la suite elles se positionnent les unes à côté des autres. 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).	[[Image:Icon_no.png|left]][[Image:Icon_yes.png|left]] Pour faire flotter un à côté de l'autre. <div style="float:right;">[[Image:Icon_no.png]]<br/>[[Image: Icon_yes.png]]</div> Pour faire flotter l'un en dessous de l'autre.

Syntaxe étendue pour les images

Résultat

Syntaxe wikilivres

Une syntaxe étendue permet de contrôler la taille et la position des images: Les options disponibles sont les suivantes (si plusieurs options sont présentes, elles doivent être séparées par un signe |; il faut un | après la dernière option même s'il n'y a pas de légende): thumb ou thumbnail 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. framed l'image est placée dans un cadre, comme avec l'option thumb, et accepte donc une légende mais n'est disponible que dans sa taille normale et l'"icône loupe" est donc absente. right permet d'aligner l'image à droite. Peut s'utiliser avec ou sans l'option thumb. center permet de centrer l'image. Peut s'utiliser avec ou sans l'option thumb. left permet d'aligner l'image à gauche. Peut s'utiliser avec ou sans l'option thumb. none permet de supprimer l'alignement par defaut. Cette option est surtout utile pour les images insérées dans un tableau. largeur px 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.

[[Image:nom de l'image|options|légende]]

Mise en forme des caractères

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

Tableaux

Pour avoir tous les détails, voir la sous-page de la syntaxe des tableaux dans la Wikipédia;

Exemple

Un exemple de tableau

Premier en-tête	Deuxième en-tête	Troisième en-tête
Haut gauche	Haut milieu	Côté droit
Bas gauche	Bas milieu
ligne du bas

Syntaxe wiki

{| 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
|}

Voir également mw:Markup spec/DTD, la page d'aide sur les 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.

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

Identification dans les pages de discussion

Résultat	Syntaxe wikilivres
Seulement le pseudonyme: Aoineko	~~~ (3 tildes)
Pseudonyme et date: Aoineko 03:17 Nov 8, 2002 (CET)	~~~~ (4 tildes)
Date: 03:17 Nov 8, 2002 (CET)	~~~~~ (5 tildes)

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 dans certains langages.

Voir :

• anglais Extension GeSHi

Les erreurs à éviter

Les conseils suivants vous indiquent les erreurs courantes à éviter :

Évitez d'utiliser les signes inférieur ( < ) et supérieur ( > )

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 :

&lt; pour < (Lower Than en anglais)

> pour > (Greater Than en anglais)

Pour indiquer un paramètre formel dans une syntaxe, utilisez une mise en forme plutôt que les signes < et > (italique par exemple) :

Afficher( expression )

Evitez d'utiliser certaines balises de formattage 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 :

Balisage HTML	Équivalent wiki
<br/> ou <p/>	Utilisez un double saut de ligne pour passer au paragraphe suivant.
<b>Un texte en gras</b>	'''Un texte en gras''' Encadrez le texte par les triples apostrophes.
<i>Un texte en italique</i>	''Un texte en italique'' Encadrez le texte par les doubles apostrophes.
<pre>Du texte préformatté</pre>	Du texte préformatté Commencez chaque ligne par le caractère espace.
<ul> <li>premier item non ordonné</li> <li>deuxième item non ordonné</li> </ul>	*premier item non ordonné *deuxième item non ordonné Commencez chaque ligne par une étoile pour chaque item de la liste.
<ol> <li>premier item numéroté</li> <li>deuxième item numéroté</li> </ol>	#premier item numéroté #deuxième item numéroté Commencez chaque ligne par un dièse pour chaque item de la liste.
<dl> <dt>Terme 1</dt> <dd>Définition du terme 1</dd> <dt>Terme 2</dt> <dd>Définition du terme 2</dd> </dl>	;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.

Fermez les balises ouvertes

Toute balise HTML ouverte doit être suivie d'une balise fermante.

NB: Quand plusieurs balises sont imbriquées, les fermetures se font dans l'ordre inverse de celui des ouvertures. Exemple :

<font color="blue">

Voici

<small>

un petit texte

</small>

au milieu d'un texte bleu de taille normale.

</font>

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

Tout médiawiki de Wikimédia propose les balises suivantes :

Résultat	Syntaxe wikilivres
Phrase == Références ==	Phrase<ref>http://URL.com</ref> == Références == <references/>
Il est possible d'appeler la même note en plusieurs endroits différents comme ceci == Références ==	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/>