Revision [1572]
This is an old revision of TextFormattingFR made by VincentMayoux on 2008-12-05 03:05:18.
Guide de formatage de Wikka
NOTE
This feature is available since:
WikkaWiki 1.1.6.0
WikkaWiki 1.1.6.0
Note: Tout ce qui est placé entre deux paires de guillemets n'est pas formaté.
Au fur et à mesure que vous lirez cette page vous pouvez tester les formatages dans le BacASable.
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 ======
===== Grande en-tête =====
==== En-tête moyenne ====
=== 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é
~~Ce texte est doublement indenté
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
- Ligne un
- Ligne deux
Listes ordonnées utilisant des caractères majuscule
~A) Ligne un
~A) Ligne deux
- Ligne un
- Ligne deux
Listes ordonnées utilisant des caractères minuscule
~a) Ligne un
~a) Ligne deux
- Ligne un
- Ligne deux
Listes ordonnées utilisant des chiffres romains en majuscule
~I) Ligne un
~I) Ligne deux
- Ligne un
- Ligne deux
Listes ordonnées utilisant des chiffres romains en minuscule
~i) Ligne un
~i) Ligne deux
- Ligne un
- 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"}}
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é.
- Comment traduire 'accessibility' -- VincMay
8. Liens
Pour créer un lien vers une page du wiki vous pouvez utiliser n'importe quelle méthode parmi celles-ci :
- Taper un MotWiki:
FormattingRulesFR
FormattingRulesFR
- add a forced link surrounding the page name by [[ | and ]] (everything after the first space will be shown as description):
[[SandBox | Test your formatting skills]]
Test your formatting skills
[[SandBox | 沙箱]]
沙箱
- add an image with a link (see instructions above).
To link to external pages, you can do any of the following:
- type a URL inside the page:
http://www.example.com
http://www.example.com
- 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]]
Jenna's Home Page
[[mail@example.com | Write me!]]
Write me!
- add an image with a link (see instructions above);
- add an interwiki link (browse the list of available interwiki tags):
WikiPedia:WikkaWiki
WikiPedia:WikkaWiki
Google:CSS
Google:CSS
Thesaurus:Happy
Thesaurus:Happy
9. Tables
To create a table, you can use the table action.
Example:
{{table columns="3" cellpadding="1" cells="BIG;GREEN;FROGS;yes;yes;no;no;no;###"}}
BIG | GREEN | FROGS |
yes | yes | no |
no | no |
Note that ### must be used to indicate an empty cell.
Complex tables can also be created by embedding HTML code in a wiki page (see instructions below).
10. Colored Text
Colored text can be created using the color action:
Example:
{{color c="blue" text="This is a test."}}
This is a test.
You can also use hex values:
Example:
{{color hex="#DD0000" text="This is another test."}}
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"}}
This is colored text on colored background
{{color fg="lightgreen" bg="black" text="This is colored text on colored background"}}
This is colored text on colored background
11. Floats
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.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.12. Code formatters
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).
%%(php)
<?php
echo "Hello, World!";
?>
%%
<?php
echo "Hello, World!";
?>
%%
<?php
echo "Hello, World!";
?>
echo "Hello, World!";
?>
You can also specify an optional starting line number.
%%(php;15)
<?php
echo "Hello, World!";
?>
%%
<?php
echo "Hello, World!";
?>
%%
- <?php
- echo "Hello, World!";
- ?>
If you specify a filename, this will be used for downloading the code.
%%(php;15;test.php)
<?php
echo "Hello, World!";
?>
%%
<?php
echo "Hello, World!";
?>
%%
test.php (line 15)
- <?php
- echo "Hello, World!";
- ?>
List of available code formatters:
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 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. Embedded HTML
You can easily paste HTML in a wiki page by wrapping it into two sets of doublequotes.
""[html code]""
Examples:
""y = x<sup>n+1</sup>""
y = xn+1
""<acronym title="Cascade Style Sheet">CSS</acronym>""
CSS
By default, some HTML tags are removed by the SafeHTML parser to protect against potentially dangerous code. The list of tags that are stripped can be found on the Wikka:SafeHTML page.
It is possible to allow all HTML tags to be used, see Wikka:UsingHTML for more information.
CategoryWiki
CategoryFR - TranslationPartialFR - CategoryReview