Les syntaxes de saisie

Vous pouvez rédiger vos billets à l'aide de la syntaxe wiki ou xhtml. Dans les Préférences utilisateur vous déterminerez la syntaxe utilisée par défaut. Celle-ci peut être différente pour un billet particulier en choisissant la syntaxe depuis le petit menu déroulant figurant dans le menu d'édition du billet.

Une présentation synthétique de la description ci-dessous est disponible depuis l'éditeur de billets en cliquant sur le point d'interrogation au côté du ruban de choix de la syntaxe de saisie.

Syntaxe wiki et correspondances xhtml

Présentation : A l'aide de balises simples, la syntaxe wiki permet d'enrichir la présentation sans connaissances particulières. Ces balises sont ensuite interprétées par le moteur du blog et converties en xhtml. Si vous ne maîtrisez pas parfaitement le xhtml il est fortement recommandé d'utiliser le wiki pour éviter ainsi tout risque d'erreur qui risquerait de générer des dysfonctionnement de l'affichage du blog.

Éléments de type bloc

Attention :

Laissez une ligne vide entre chaque bloc de même nature.

	syntaxe wiki	correspondance xhtml
Paragraphes	Paragraphe 1. Paragraphe 2.	<p>Paragraphe 1.</p> <p>Paragraphe 2.</p>
Titre de niveau 3¹⁾	!!!Titre	<h3>Titre</h3>
Titre de niveau 4	!!Titre	<h4>Titre</h4>
Titre de niveau 5	!Titre	<h5>Titre</h5>
Trait horizontal	----	<hr />
Liste non ordonnée	* premier item * deuxième item * troisième item	<ul> <li>premier item</li> <li>deuxième item</li> <li>troisième item</li> </ul>
Liste ordonnée	# item 1 # item 2 # item 3	<ol> <li>item 1</li> <li>item 2</li> <li>item 3</li> </ol>
avec sous-listes	* premier item premier sous-premier item deuxième sous-premier item * deuxième item # et on peut même mélanger # ordonné et non ordonné * troisème item	<ul> <li>premier item <ul> <li>premier sous-premier item</li> <li>deuxième sous-premier item</li> </ul> </li> <li>deuxième item <ol> <li>et on peut même mélanger <li>ordonné et non ordonné</li> </ol> </li> <li>troisième item</li> </ul>
Texte préformaté	Un espace au début de chaque ligne ou placer une ligne contenant trois antislash avant et après le bloc de texte : /// Bloc de texte préformaté respectant les espaces et les retours à la ligne. ///	<pre>Bloc de texte préformaté respectant les espaces et les retours à la ligne </pre>
Bloc de citation	> Bloc de citation. > > Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat…	<blockquote> <p>Bloc de citation.</p> <p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat...</p> </blockquote>

Éléments de formatage

	syntaxe wiki	correspondance xhtml
emphase	''texte''	<em>texte</em>
forte emphase	__texte__	<strong>texte</strong>
retour forcé à la ligne	Première ligne%%% Deuxième ligne	<p>Première ligne<br /> Deuxième ligne</p>
insertion	++texte++	<ins>texte</ins>
suppression	--texte--	<del>texte</del>
liens	[url] [nom\|url] [nom\|url\|langue] [nom\|url\|langue\|titre]	<a href="url-cible">url-cible</a> <a href="url-cible">nom</a> <a href="url-cible" lang="fr">nom</a> <a href="url-cible" lang="fr" title="titre">nom</a>
images	((url\|texte alternatif)) ((url\|texte alternatif\|position)) ((url\|texte alternatif\|position\|description longue)) ²⁾	<img src="url" alt="texte alternatif" /> <img src="url" alt="texte alternatif" style="display:block; float:left; margin:0 1em 1em 0" /> (si position : L ou G) <img src="url" alt="texte alternatif" style="display:block; float:right; margin:0 0 1em 1em" longdesc="description longue" /> (si position : R ou D)
ancre	~ancre~	<a name="ancre"></a>
acronyme	??acronyme\|titre??	<acronym title="titre">acronyme</acronym>
citation en ligne	{{citation}} {{citation\|langue}} {{citation\|langue\|url source}}	<q>citation</q> <q lang="fr">citation</q> <q lang="fr" cite="url">citation</q>
code	@@code ici@@	`<code>code ici</code>`
note de bas de page	texte$$Corps de la note$$	texte<sup>[<a href="url-blog#pnote-xxx-x" id="rev-pnote-xxx-x">x</a>]</sup> (...) <div class="footnotes"><h4>Notes</h4> <p>[<a href="url-blog/#rev-pnote-xxx-x" id="pnote-xxx-x">x</a>] Corps de la note</p></div>''

Compléments

Empêcher le formatage du texte

Pour insérer un caractère sans que celui-ci soit reconnu comme un caractère de formatage, ajoutez le caractère \ avant celui-ci. Par exemple : \[texte entre crochet qui n'est pas un lien\].

Insérer du code HTML au sein de la syntaxe wiki

Vous pouvez ponctuellement avoir besoin d'insérer du code HTML dans votre texte au format Wiki. Pour cela, utilisez le code suivant en laissant une ligne vide avant et après cette insertion :

///html
<p style="color:red">mon texte en rouge</p>
///

Acronymes automatiques en syntaxe wiki

Lorsque vous entrez un acronyme en syntaxe wiki, vous avez le choix entre deux syntaxes :

Celle donnant la définition de l'acronyme, par exemple :

??KISS|Keep It Simple Stupid??

Ou celle qui cherchera dans une liste prédéfinie, par exemple :

??AFNOR??

Voici la liste des acronymes définis par défaut par wiki2xhtml. Vous pouvez personnaliser cette liste dans le fichier share/wiki-acronyms.txt.

(X)HTML	: (eXtensible) HyperText Markup Language
AFNOR	: Association Française de NORmalisation
ANSI	: American National Standard Institute
ASCII	: American Standard Code for Information Interchange
ASP	: Active Server Pages
CSS	: Cascading Style Sheets
DHTML	: Dynamic HyperText Markup Language
DOM	: Document Object Model
DTD	: Document Type Definition
ECMA	: European Computer Manufacturer Association
FAI	: Fournisseur d'Acces à Internet
FAQ	: Foire Aux Questions
FTP	: File Transfer Protocol
FIDEV	: Formation et Insertion pour DEficients Visuels
HTML	: HyperText Markup Language
HTTP	: HyperText Transfer Protocol
IP	: Internet Protocol
IRC	: Internet Relay Chat
ISO	: International Standard Organization
JS	: JavaScript
MIME	: Multipurpose Internet Mail Extension
P3P	: Platform for Privacy Preferences Project
PC	: Personnal Computer
PHP	: PHP: Hypertext Preprocessor
PICS	: Platform for Internet Content Selection
PNG	: Portable Network Graphics
RDF	: Resource Description Framework
RFC	: Request For Comment
RSS	: RDF Site Summary
SGML	: Standard Generalized Markup Language
SMIL	: Synchronized Multimedia Integration Language
SSII	: Société de Service et d'Ingénierie Informatique
SVG	: Scalable Vector Graphics
TAG	: Technical Architecture Group
TCP	: Transmission Control Protocol
URI	: Universal Resource Identifier
URL	: Uniform Resource Locator
URN	: Universal Resource Name
W3C	: World Wide Web Consortium
WAI	: Web Accessibility Initiative
WYSIWYG	: What You See Is What You Get
WWW	: World Wide Web
XHTML	: eXtensible HyperText Markup Language
XML	: eXtensible Markup Language
XSL	: eXtensible Stylesheet Language
XSLT	: eXtensible Stylesheet Language Transformation

Suggestions d'acronymes à rajouter par défaut

ADSL: Asymmetrical Digital Subscriber Line
AFUL: Association Francophone des Utilisateurs de Linux et des Logiciels Libres
AMHA: A Mon Humble Avis
IMHO: In My Humble Opinion
ANPE: Agence Nationale Pour l'Emploi
AOL:  America On Line
ATTAC: Association for the Taxation of financial Transactions for the Aid of Citizens
BTW: By The Way
BO: Bande Originale
BIOS: Basic Input/Output System (pas sur du System)
CD: Compact Disc
CQFD: Ce Qu'il Fallait Démontrer
CNRS: Centre National de la Recherche Scientifique
DTP : Dans Ton Parking
E2FS: Ext2 FileSystem
EXIF: EXchangeable Image File Format
FOAF: Friend Of A Friend
FUD:  Fear Uncertainty and Doubt
GNU: GNU is Not Unix
HS: Hors Service
I18N: Internationalization
INSEE: Institut National de la Statistique et des Études Économiques
IPTC: International Press and Telecommunications Council
JAWS : Job Access with Speech
JC: Jésus-Christ
L10N: Localization
LOL: Laughing Out Loud
MDR: Mort De Rire
MP3: Moving Picture Experts Group 1, Layer 3
MP3pro: Moving Picture Experts Group 2, Layer 3
MS: MicroSoft
MSIE: MicroSoft Internet Explorer
OCDE: Organisation de Coopération et de Développement Économiques
ONG: Organisation non-gouvernementale
ONU: Organisation des Nations Unies
PDF: Portable Document Format
PPP: Point-to-Point Protocol
PS: Post-scriptum
RAM: Random Access Memory
ROM: Read Only Memory
SSH: Secured SHell
SSLL: Société de Service en Logiciels Libres
USA: United States of America
VF: Version Française
VO: Version Originale
WAP: Wireless Application Protocol
WCAG: Web Content Accessibility Guideliness
WML:  Wireless Mark-up Language
WYSIWYW: What You See Is What You Want
(X)HTML: (eXtensible) HyperText Markup Language
XML-RPC: eXtensible Markup Language - Remote Procedure Call
XMPP: eXtensible Message Passing Protocol

Aller plus loin

Toutes les balises xhtml
Principales balises xhtml
Contrôle de validité xhtml (en français)

¹⁾ Le titre de niveau 1 est réservé au titre du blog et le niveau 2 est réservé au titre du billet.

²⁾ La position peut prendre les valeurs L ou G (gauche), R ou D (droite) ou C (centré).