Ceci est la traduction qui est en cours de la page syntax

Syntaxe de Formatage

DokuWiki supporte beaucoup de marquages de languages simple, qui essayent de rendre les fichiers aussi lisibles que possible. Cette page contient toutes les syntaxes possibles que vous pouvez utiliser lorsque vous éditer les pages. Il suffit simplement de regarder la source de cette page en pressant le bouton Editer qui se situe en haut ou en bas de la page. Si vous voulez essayer quelque chose, utilisez le bac à sable. Le marquage est aussi simplement accessible via quickbuttons.

Formatage de base des textes

DokuWiki supporte les textes gras, italiques, soulignés et à espacement fixe. Bien-sûr, vous pouvez tous les combiner.

Vous pouvez aussi utiliser les <sub>indices</sub> et <sup>exposants</sup>.
Vous pouvez aussi bien marquer quelquechose comme <del>supprimé</del>.

Les paragraphes sont créés par des lignes vides. Si vous voulez forcer une nouvelle ligne sans créer de paragraphe, vous pouvez utiliser deux backslashes suivis par un espace ou une fin de ligne.

Ceci est un texte avec quelques retours chariot
Notez que les deux backslashes sont seulement reconnus à la fin d’une ligne
ou suivis par
un espace \\ceci arrive sinon.

Vous ne devriez utiliser les retours à la ligne forcés uniquement si c’est vraiment nécessaire.

Liens

DokuWiki permet de créer des liens de différentes manière.

Externes

Les liens externes sont reconnu automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez mettre un titre au lien : Ce lien pointe sur google. Les addresses email s’uilisent de cette manière : andi@splitbrain.org.

DokuWiki permet de créer des liens de différentes manière. Les liens externes
sont reconnu automatiquement : http://www.google.com ou simplement www.google.com
- Vous pouvez mettre un titre au lien : [[http://www.google.com|Ce lien pointe sur google]].
Les addresses email s'uilisent de cette manière : <andi@splitbrain.org>.

Internes

Internal links are created by using square brackets. You can either just give a wiki:pagename or use an additional Title Text. Le nom de pages Wiki sont convertis automatiquement en minuscules, les caractères spéciaux are not allowed.

Les liens internes are created by using square brackets. You can either just give
a [[NomDeLaPage]] or use an additional [[NomDeLaPage|Title Text]]. Wiki pagenames
are converted to lowercase automatically, special chars are not allowed.

You can use namespaces by using a colon in the pagename.

You can use [[wiki:namespaces]] by using a colon in the pagename.

For details about namespaces see wiki:namespaces.

Linking to a specific section is possible, too. Just add the sectionname behind a hash character as known from HTML. This links to this Section.

This links to [[syntax#internal|this Section]].

Notes:

  • Links to existing pages are shown in a different style from nonexisting ones.
  • DokuWiki does not use CamelCase to automatically create links by default, but this behaviour can be enabled in the config file. Hint: If DokuWiki is a link, then it’s enabled.
  • When a section’s heading is changed, it’s bookmark changes, too. So don’t rely on section linking too much.

Interwiki

DokuWiki supports wiki:interwiki links. These are quick links to other Wikis. For example this is a link to Wikipedia’s page about Wikis: Wiki.

DokuWiki supports [[doku>wiki:interwiki]] links. These are quick links to other Wikis.
For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].

Windows Shares

Windows shares like this are recognized, too. Please note that these only make sense in a homogenous user group like a corporate Intranet.

Windows Shares like [[\\server\share|this]] are recognized, too.

Notes:

  • For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the “local zone”).
  • For Mozilla and Firefox it can be enabled through the config option security.checkloaduri but this is not recommended
  • Voir 151 pour plus d’info

Image Links

Vous pouvez aussi utiliser une image to link to another internal or external page by combining the syntax for links and images (see below) like this:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Veuillez noter : The image formatting is the only formatting syntax accepted in link names.

Footnotes

You can add footnotes 1) by using double parenthesises.

You can add footnotes ((This is a footnote)) by using double parenthesises.

Sectioning

You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically – this can be disabled by including the string ~~NOTOC~~ in the document.

Headline Level 3

Headline Level 4

Headline Level 5
==== Headline Level 3 ====
=== Headline Level 4 ===
== Headline Level 5 ==

By using four or more dashes, you can make a horizontal line:


Images et autres fichiers

You can include external and internal images with curly brackets. Optionally you can specify the size of them.

Taille réelle :

Redimensionner en donnant la largeur :

Redimensionner en donnant la hauteur et la largeur :

Redimensionner une image externe :

Taille réelle :                                      {{wiki:dokuwiki-128.png}}
Redimensionner en donnant la largeur :               {{wiki:dokuwiki-128.png?50}}
Redimensionner en donnant la hauteur et la largeur : {{wiki:dokuwiki-128.png?200x50}}
Redimensionner une image externe :                   {{http://de3.php.net/images/php.gif?200x50}}

By using left or right whitespaces you can choose the alignment

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Bien sûr, vous pouvez ajouter un titre (displayed as a tooltip by most browsers), too.

This is the caption

{{ wiki:dokuwiki-128.png |This is the caption}}

If you specify a filename (external or internal) that is not an image (gif,jpeg,png), then it will be displayed as a link instead.

Listes

Dokuwiki supporte les listes ordonnées et non ordonnées. Pour créer un élément de liste, indentez votre texte avec deux espaces et utilisez un * pour une liste non ordonnée ou un - pour une ordonnée.

  • Ceci est une liste
  • Le deuxième élément
    • Vous pouvez avoir différents niveaux
  • Un autre élément
  1. La même liste, mais non ordonnée
  2. Un autre élément
    1. Utilisez juste une identation pour les sous niveaux
  3. Encore un autre élément
  * Ceci est une liste
  * Le deuxième élément
    * Vous pouvez avoir différents niveaux
  * Un autre élément

  - La même liste, mais non ordonnée
  - Un autre élément
    - Utilisez juste une identation pour les sous niveaux
  - Encore un autre élément

Smileys

DokuWiki converts commonly used emoticons to their graphical equivalents. More smileys can be placed in the smiley directory and configured in the conf/smileys.conf file. Here is an overview of Smileys included in DokuWiki.

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

Typographie

DokuWiki peu convertir de simples caractères texte en leur entitées typographique correcte. Voici un exemple de caractères reconnus.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought ‘It’s a man’s world’...”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

Veuillez notez : Ces conversions peuvent être désactivées dans le fichier de configuration.

Citations

Some times you want to mark some text to show it’s a reply or comment. You can use the following syntax:

I think we should do it

> No we shouldn't

>> Well, I say we should

> Réellement ?

>> Oui !

>>> Then lets do it!

I think we should do it

No we shouldn’t
Well, I say we should
Réellement ?
Oui !
Then lets do it!

Tableaux

DokuWiki supporte une syntaxe simple pour créer des tableaux.

En-tête 1 En-tête 2 En-tête 3
Ligne 1 Col 1 Ligne 1 Col 2 Ligne 1 Col 3
Ligne 2 Col 1 some colspan (Remarquez le double pipe)
Ligne 3 Col 1 Ligne 2 Col 2 Ligne 2 Col 3

Table rows have to start and end with a | for normal rows or a ^ for headers.

^ En-tête 1       ^ En-tête 2          ^ En-tête 3            ^
| Ligne 1 Col 1    | Ligne 1 Col 2     | Ligne 1 Col 3        |
| Ligne 2 Col 1    | some colspan (Remarquez le double pipe) ||
| Ligne 3 Col 1    | Ligne 2 Col 2     | Ligne 2 Col 3        |

Pour fusionner les cellules horizontalement, just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators!

Vertical tableheaders are possible, too.

En-tête 1 En-tête 2
En-tête 3 Ligne 1 Col 2 Ligne 1 Col 3
En-tête 4 no colspan this time
En-tête 5 Ligne 2 Col 2 Ligne 2 Col 3

Comme vous pouvez le voir, it’s the cell separator before a cell which decides about the formatting:

|              ^ En-tête1               ^ En-tête 2            ^
^ En-tête 3    | Ligne 1 Col 2          | Ligne 1 Col 3        |
^ En-tête 4    | no colspan this time   |                      |
^ En-tête 5    | Ligne 2 Col 2          | Ligne 2 Col 3        |

Note: Vertical spans (rowspan) are not possible.

You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.

Tableau avec alignement
droit centre gauche
gauche droit centre
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

This is how it looks in the source:

^           Tableau avec alignement        ^^^
|         droit|    centre    |gauche        |
|gauche        |         droit|    centre    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Nonparsed Blocks

You can include non parsed blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags code or file.

This is preformatted code all spaces are preserved: like              <-this
This is pretty much the same, but you could use it to show that you quoted a file.  

To let the parser ignore an area completely (ie. do no formatting on it), enclose the area either with nowiki tags or even simpler, with double percent signs %%.

This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.

See the source of this page to see how to use these blocks.

Coloration syntaxique

DokuWiki peu colorer les codes sources, which makes it easier to read. It uses the GeSHi Generic Syntax Highlighter – so any language supported by GeSHi is supported. The syntax is the same like in the code block in the previous section, but this time the name of the used language is inserted inside the tag. Eg. <code java>.

/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

The following language strings are currently recognized: actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, mpasm, nsis, objc, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml

Embedding HTML and PHP

You can embed raw HTML or PHP code into your documents by using the html or php tags like this:

<html>
This is some <font color="red" size="+1">HTML</font>
</html>
This is some <font color="red" size="+1">HTML</font>
<php>
echo 'Un logo généré par PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Logo PHP !" />';
</php>
echo 'Un logo généré par PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Logo PHP !" />';

Veuillez Noter: HTML et PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed.

1) This is a footnote
 
syntaxfr.txt · Dernière modification: 21/12/2006 21:13 par sechnefer
 
Recent changes RSS feed Creative Commons License Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki