[[WikkaDocumentationFR | Documentation de Wikka]]
----
======Guide de formatage de Wikka======
{{since version="1.1.6.0" align="left"}}

<<**Note:** Tout ce qui est placé entre deux paires de guillemets n'est pas formaté. <<::c::
Au fur et à mesure que vous lirez cette page vous pouvez tester les formatages dans le [[SandBox | "bac à sable"]].

----
===1. Formatage de texte===

~##""**Je suis en gras**""##
~**Je suis en gras **

~##""//Je suis un texte en italique//""##
~//Je suis un texte en italique//

~##""__et moi je suis souligné__""##
~__et moi je suis souligné__

~##""##texte en police non-proportionnée ##""##(type Courrier)
~##texte en police non-proportionnée ##

~##""''texte surligné''""## (deux apostrophes)
~''texte surligné''

~##""++Texte barré++""##
~++Texte barré++

~##""Appuyer sur #%N'IMPORTE QUELLE TOUCHE#%""##
~Appuyer sur #%N'IMPORTE QUELLE TOUCHE#%

~##""@@Texte centré@@""##
~@@Texte centré@@

===2. En-têtes===

Placer entre cinq ##=## (pour les plus grandes en-têtes) et deux ##=## (pour les plus petites en-têtes) de chaque côté d'un bout de texte pour qu'il soit affiché comme une en-tête.

~##""====== Très grande en-tête ======""##
~====== Très grande en-tête ======

~##""===== Grande en-tête =====""##
~===== Grande en-tête =====

~##""==== En-tête moyenne ====""##
~==== En-tête moyenne ====

~##""=== Petite en-tête ===""##
~=== Petite en-tête ===

~##""== Très petite en-tête ==""##
~== Très petite en-tête ==

===3. Séparateur horizontal===
~##""----""##
----

===4. Saut de ligne forcé===
~##""---""##
---

===5. Listes et indentations===

Vous pouvez indenter du texte en utilisant une tilde (**~**), une **tabulation** ou **4 espaces** (qui seront automatiquement convertis en une tabulation).

##""~Ce texte est indenté<br />~~Ce texte est doublement indenté<br />    Ce texte est aussi indenté""##

~Ce texte est indenté
~~Ce texte est doublement indenté
Ce texte est aussi indenté

Pour créer des listes à puces ou des listes ordonnées, utiliser les marqueurs suivants (vous pouvez toujours utiliser 4 espaces au lieu de ##**~**##) :

**Listes à puces**
##""~- Ligne un""##
##""~- Ligne deux""##

~- Line un
~- Line deux

**Listes numérotées**
##""~1) Ligne un""##
##""~1) Ligne deux""##

~1) Ligne un
~1) Ligne deux

**Listes ordonnées utilisant des caractères majuscule**
##""~A) Ligne un""##
##""~A) Ligne deux""##

~A) Ligne un
~A) Ligne deux

**Listes ordonnées utilisant des caractères minuscule**
##""~a) Ligne un""##
##""~a) Ligne deux""##

~a) Ligne un
~a) Ligne deux

**Listes ordonnées utilisant des chiffres romains en majuscule**
##""~I) Ligne un""##
##""~I) Ligne deux""##

~I) Ligne un
~I) Ligne deux

**Listes ordonnées utilisant des chiffres romains en minuscule**
##""~i) Ligne un""##
##""~i) Ligne deux""##

~i) Ligne un
~i) Ligne deux

===6. Commentaires===

Pour formater du texte en tant que commentaire, utiliser une tilde (**~**), une **tabulation** ou **4 espaces** suivi de **""&""**.

**Exemple:**

##""~& Commentaire""##
##""~~& Sous-commentaire""##
##""~~~& Sous-sous-commentaire""##

~& Commentaire
~~& Sous-commentaire
~~~& Sous-sous-commentaire

===7. Images===

Pour placer des images sur une page, vous pouvez utiliser l'action ##image##.

**Exemple:**

~##""{{image class="center" alt="Logo de DVD" title="Lien sur une image" url="images/dvdvideo.gif" link="RecentChanges"}}""##
~{{image class="center" alt="Logo de DVD" title="Lien sur une image" url="images/dvdvideo.gif" link="RecentChanges"}}

Les liens peuvent être externes ou internes au Wiki. Il n'est pas indispensable de mettre un lien, dans ce cas seule une image sera insérée. Vous pouvez utiliser les classes optionnelles ##left## (gauche) et ##right## (droite) pour faire flotter les images à gauche ou à droite. Il n'est pas nécessaire d'utiliser tous ces attributs, seul ##url## est requis, tandis que ##alt## est recommandé pour des questions d'accessibilité.


===8. Liens===

Pour créer un **lien vers une page du wiki** plusieurs méthodes sont possibles : ---
~1) Taper un ##""MotWiki""##: --- --- ##""FormattingRulesFR""## --- FormattingRulesFR --- ---
~1) Ajouter un lien forcé en entourant le nom de la page par ##""[[""## | et ##""]]""## : --- --- ##""[[SandBox | Testez vos compétences en formatage]]""## (tout ce qui est placé après l'espace suivant le nom de la page constituera le texte affiché) --- [[SandBox | Testez vos compétences en formatage]] --- --- ##""[[SandBox | 沙箱]]""## --- [[SandBox | 沙箱]] --- ---
~1) Ajouter une image sur un lien (voir les instructions ci-dessus).

To **link to external pages**, you can do any of the following: ---
~1) type a URL inside the page: --- --- ##""http://www.example.com""## --- http://www.example.com --- ---
~1) add a forced link surrounding the URL by ##""[[""## | and ##""]]""## (everything after the first space will be shown as description): --- --- ##""[[http://example.com/jenna/ | Jenna's Home Page]]""## --- [[http://example.com/jenna/ | Jenna's Home Page]] --- --- ##""[[mail@example.com | Write me!]]""## --- [[mail@example.com | Write me!]] --- ---
~1) add an image with a link (see instructions above);
~1) add an interwiki link (browse the [[InterWiki | list of available interwiki tags]]): --- --- ##""WikiPedia:WikkaWiki""## --- WikiPedia:WikkaWiki --- --- ##""Google:CSS""## --- Google:CSS --- --- ##""Thesaurus:Happy""## --- Thesaurus:Happy --- ---

===9. Tableaux===

Pour créer un tableau vous pouvez utiliser l'action ##table##.

**Exemple:**

~##""{{table columns="3" cellpadding="1" cells="BIG;GREEN;FROGS;yes;yes;no;no;no;###"}}""##

~{{table columns="3" cellpadding="1" cells="BIG;GREEN;FROGS;yes;yes;no;no;no;###"}}

Notez que ##""###""## doit être utilisé pour indiquer une cellule vide.
Des tableaux complexes peuvent aussi être créés en insérant du code HTML dans une page Wiki (voir les instructions ci-dessous).

===10. Texte coloré===

Vous pouvez colorer du texte en utilisant l'[[UsingActionsFR | action]] ##color## :

**Exemple:**

~##""{{color c="blue" text="Texte en bleu."}}""##
~{{color c="blue" text="Texte en bleu."}}

Vous pouvez aussi utiliser des valeurs hexadécimales :

**Exemple:**

~##""{{color hex="#DD0000" text="This is another test."}}""##
~{{color hex="#DD0000" text="This is another test."}}

Alternatively, you can specify a foreground and background color using the ##fg## and ##bg## parameters (they accept both named and hex values):

**Examples:**

~##""{{color fg="#FF0000" bg="#000000" text="This is colored text on colored background"}}""##
~{{color fg="#FF0000" bg="#000000" text="This is colored text on colored background"}}

~##""{{color fg="lightgreen" bg="black" text="This is colored text on colored background"}}""##
~{{color fg="lightgreen" bg="black" text="This is colored text on colored background"}}


===11. Boîtes flottantes===

To create a **left floated box**, use two ##<## characters before and after the block.

**Example:**

~##""<<Some text in a left-floated box hanging around<< Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler.""##

<<Some text in a left-floated box hanging around<<Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler.

::c::To create a **right floated box**, use two ##>## characters before and after the block.

**Example:**

~##"">>Some text in a right-floated box hanging around>> Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler.""##

>>Some text in a right-floated box hanging around>>Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler.

::c:: Use ##""::c::""## to clear floated blocks.

===12. Formatage de code===

You can easily embed code blocks in a wiki page using a simple markup. Anything within a code block is displayed literally.
To create a **generic code block** you can use the following markup:

~##""%% This is a code block %%""##.

%% This is a code block %%

To create a **code block with syntax highlighting**, you need to specify a //code formatter// (see below for a list of available code formatters).

~##""%%(""{{color c="red" text="php"}}"")<br /><?php<br />echo "Hello, World!";<br />?><br />%%""##

%%(php)
<?php
echo "Hello, World!";
?>
%%

You can also specify an optional //starting line// number.

~##""%%(php;""{{color c="red" text="15"}}"")<br /><?php<br />echo "Hello, World!";<br />?><br />%%""##

%%(php;15)
<?php
echo "Hello, World!";
?>
%%

If you specify a //filename//, this will be used for downloading the code.

~##""%%(php;15;""{{color c="red" text="test.php"}}"")<br /><?php<br />echo "Hello, World!";<br />?><br />%%""##

%%(php;15;test.php)
<?php
echo "Hello, World!";
?>
%%

**List of available code formatters:**
{{table columns="6" cellpadding="1" cells="LANGUAGE;FORMATTER;LANGUAGE;FORMATTER;LANGUAGE;FORMATTER;Actionscript;actionscript;ADA;ada;Apache Log;apache;AppleScript; applescript;ASM;asm;ASP;asp;AutoIT;autoit;Bash;bash;BlitzBasic;blitzbasic;BNF;bnf;C;c;C for Macs;c_mac;c#;csharp;C++;cpp;C++ (QT extensions);cpp-qt;CAD DCL;caddcl;CadLisp;cadlisp;CFDG;cfdg;ColdFusion;cfm; CSS;css;D;d;Delphi;delphi;Diff-Output;diff;DIV; div;DOS;dos;Eiffel;eiffel;Fortran;fortran;FreeBasic;freebasic;GML;gml;Groovy;groovy;HTML;html4strict;INI;ini;IO;io;Inno Script;inno;Java 5;java5;Java;java;Javascript;javascript;LaTeX;latex;Lisp;lisp;Lua;lua;Matlab;matlab;Microchip Assembler;mpasm;Microsoft Registry;reg;mIRC;mirc;MySQL;mysql;NSIS;nsis;Objective C;objc;OpenOffice BASIC;oobas;Objective Caml;ocaml;Objective Caml (brief);ocaml-brief;Oracle 8;oracle8;Pascal;pascal;Perl;perl;PHP;php;PHP (brief);php-brief;PL/SQL;plsql;Python;phyton;Q(uick)BASIC;qbasic;robots.txt;robots;Ruby;ruby;SAS;sas;Scheme;scheme;sdlBasic;sdlbasic;SmallTalk;smalltalk;Smarty;smarty;SQL;sql;TCL/iTCL;tcl;T-SQL;tsql;Text;text;thinBasic;thinbasic;Unoidl;idl;VB.NET;vbnet;VHDL;vhdl;Visual BASIC;vb;Visual Fox Pro;visualfoxpro;WinBatch;winbatch;XML;xml;ZiLOG Z80;z80"}}

===13. Mindmaps===

Wikka has native support for [[Wikka:FreeMind | mindmaps]]. There are two options for embedding a mindmap in a wiki page.

**Option 1:** Upload a ""FreeMind"" file to a webserver, and then place a link to it on a wikka page:
##""http://yourdomain.com/freemind/freemind.mm""##
No special formatting is necessary.

**Option 2:** Paste the ""FreeMind"" data directly into a wikka page:
~- Open a ""FreeMind"" file with a text editor.
~- Select all, and copy the data.
~- Browse to your Wikka site and paste the Freemind data into a page.

===14. Inclusion de code HTML===

You can easily paste HTML in a wiki page by wrapping it into two sets of doublequotes.

~##""[html code]""##

**Examples:**

~##""y = xⁿ⁺¹""##
~""y = xⁿ⁺¹""

~##""<acronym title="Cascade Style Sheet">CSS</acronym>""##
~""<acronym title="Cascade Style Sheet">CSS</acronym>""

Par défaut certaines balises HTML sont retirées par le parseur ""SafeHTML"" par souci de protection contre du code potentiellement dangereux. La liste des balises qui sont enlevées se trouve sur la page Wikka:SafeHTMLFR.

Il est possible d'autoriser l'utilisation de //toutes// les balises HTML, voir Wikka:UsingHTMLFR pour plus d'infromations.

----
CategoryWiki

----
CategoryFR - TranslationPartialFR - CategoryReview