Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
wiki:syntax [18-10-2009 16:09] 127.0.0.1 édition externe |
wiki:syntax [26-02-2012 10:18] edmc73 Links to playground:playground changed to wiki:bacasable |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | ====== | + | ====== |
- | [[doku>DokuWiki]] | + | [[DokuWiki]] |
- | ===== Basic text formatting | + | ===== Mise en forme de texte basique |
- | DokuWiki | + | DokuWiki |
- | DokuWiki | + | DokuWiki |
- | Of course you can **__//'' | + | |
- | You can use < | + | Bien sûr, vous pouvez tous les **__//'' |
- | | + | |
- | You can mark something as <del>deleted</del> as well. | + | Vous pouvez aussi utiliser |
- | | + | |
- | **Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line. | + | De plus, vous pouvez marquer un passage comme < |
- | This is some text with some linebreaks\\ Note that the | + | De plus, vous pouvez marquer un passage comme < |
- | two backslashes are only recognized at the end of a line\\ | + | |
- | or followed by\\ a whitespace \\this happens without it. | + | |
- | This is some text with some linebreaks\\ Note that the | + | **Les paragraphes** sont créés à partir des lignes vides. Si vous souhaitez **forcer un saut de ligne** sans paragraphe, vous pouvez utiliser deux contre-obliques suivies par un espace ou une fin de ligne. |
- | two backslashes are only recognized at the end of a line\\ | + | |
- | or followed by\\ a whitespace \\this happens without it. | + | |
- | You should use forced newlines only if really needed. | + | Voici du texte avec des sauts de ligne\\ remarquez que les |
+ | deux contre-obliques sont reconnues uniquement en fin de ligne\\ | ||
+ | ou suivies par\\ un espace ; \\ceci se produit sinon. | ||
- | ===== Links ===== | + | Voici du texte avec des sauts de ligne\\ remarquez que les |
+ | deux contre-obliques sont reconnues uniquement en fin de ligne\\ | ||
+ | ou suivies par\\ un espace ; \\ceci se produit sinon. | ||
- | DokuWiki supports multiple ways of creating links. | + | Vous ne devriez forcer des sauts de ligne que si c'est vraiment nécessaire. |
- | ==== External | + | ===== Liens ===== |
- | External links are recognized automagically: | + | DokuWiki propose plusieurs moyens pour créer des liens. |
- | DokuWiki supports multiple ways of creating links. External links are recognized | + | ==== Externes ==== |
- | automagically: | + | |
- | link text as well: [[http:// | + | |
- | addresses like this one: < | + | |
- | ==== Internal ==== | + | Les liens externes sont reconnus « automatiquement » : http:// |
- | Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. | + | Les liens externes sont reconnus « automatiquement » : http://www.google.fr |
+ | ou simplement www.google.fr - Vous pouvez aussi donner des noms aux | ||
+ | liens : [[http:// | ||
+ | de courriel comme celle-ci : < | ||
- | Internal links are created by using square brackets. You can either just give | ||
- | a [[pagename]] or use an additional [[pagename|link text]]. | ||
- | [[doku> | ||
- | You can use [[some: | + | ==== Internes ==== |
- | You can use [[some:namespaces]] by using a colon in the pagename. | + | Les liens internes sont créés en utilisant les crochets. Vous pouvez soit juste donner un [[doku>fr:pagename|nom de page]] soit utiliser un [[doku> |
- | For details about namespaces see [[doku> | + | Les liens internes sont créés en utilisant les crochets. Vous pouvez soit |
+ | juste donner un [[nom de page]] soit utiliser un | ||
+ | [[nom de page|texte pour le titre]]. Les noms de pages (// | ||
+ | sont convertis automatiquement en minuscules ; les caractères spéciaux ne | ||
+ | sont pas autorisés. | ||
- | Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax# | + | Vous pouvez utiliser des [[doku> |
- | | + | |
- | Notes: | + | Pour plus de détails sur les catégories (// |
- | * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. | + | Les liens vers une section spécifique sont également possibles. Ajoutez simplement le nom de la section après un caractère dièse (#) comme en HTML. Ce lien renvoie vers [[syntax#internes|cette section]]. |
- | * DokuWiki does not use [[wp> | + | |
- | * When a section' | + | |
- | ==== Interwiki ==== | + | Ce lien renvoie vers [[syntax# |
- | DokuWiki supports | + | Notes : |
+ | |||
+ | * Les liens vers des [[syntax|pages existantes]] sont montrés dans un style différent des liens vers des pages [[inexistantes]]. | ||
+ | * DokuWiki n'utilise pas la syntaxe | ||
+ | * Lorsque le titre d'une section est modifié, alors son lien change aussi. Donc ne comptez pas trop sur les liens de section. | ||
+ | |||
+ | ==== Interwiki ==== | ||
- | | + | DokuWiki |
- | For example this is a link to Wikipedia' | + | |
+ | DokuWiki propose les liens [[doku> | ||
+ | liens rapides vers d' | ||
+ | définition des Wikis dans Wikipedia en français : [[wp> | ||
- | ==== Windows Shares ==== | ||
- | Windows | + | ==== Partages |
- | | + | Les partages |
- | Notes: | + | Les partages Windows tels que [[\\serveur\partage|ceci]] sont également reconnus. |
- | * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone" | + | Notes : |
- | * For Mozilla and Firefox it can be enabled through the config option [[http:// | + | |
- | * See [[dokubug> | + | |
- | ==== Image Links ==== | + | * Pour des raisons de sécurité, la navigation directe sur partages Windows ne fonctionne que dans //Microsoft Internet Explorer// par défaut (et seulement dans la « zone locale »). |
+ | * Pour //Mozilla// et // | ||
+ | * Je viens de tester en passant la valeur à " | ||
+ | * Tiré de l'URL ci-dessus : "This preference only works in Gecko versions before 1.8 (so Firefox 1.0 and Mozilla Suite builds). In Firefox 1.5 and Seamonkey 1.0 this preference no longer has an effect." | ||
+ | * Veuillez consulter [[dokubug> | ||
+ | ==== Liens images | ||
- | You can also use an image to link to another internal or external | + | Vous pouvez aussi utiliser une image afin de créer un lien vers une autre page interne ou externe en combinant les syntaxes des liens et des [[#Images et autres fichiers|images]] (voir plus bas) comme ceci : |
[[http:// | [[http:// | ||
Ligne 96: | Ligne 104: | ||
[[http:// | [[http:// | ||
- | Please note: The image formatting is the only formatting syntax accepted in link names. | + | NB : la mise en forme image est la seule syntaxe de mise en forme acceptée comme nom de lien. |
- | The whole [[#images_and_other_files|image]] | + | Les syntaxes d'[[#Images et autres fichiers|image]] |
- | ===== Footnotes | + | ===== Notes de pied de page ===== |
- | You can add footnotes | + | Vous pouvez ajouter des notes de pied de page ((Ceci est une note de pied de page)) en utilisant des parenthèses doubles. |
- | | + | |
- | ===== 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 ''< | + | ===== Découpage en sections ===== |
- | ==== Headline Level 3 ==== | + | Vous pouvez utiliser jusqu' |
- | === 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: | ||
- | ---- | + | ==== Titre niveau 3 ==== |
+ | === Titre niveau 4 === | ||
+ | == Titre niveau 5 == | ||
- | ===== Images | + | ==== Titre niveau 3 ==== |
+ | === Titre niveau 4 === | ||
+ | == Titre niveau 5 == | ||
+ | |||
+ | En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale : | ||
+ | |||
+ | ---- | ||
+ | \\ | ||
+ | < | ||
+ | ===== Images | ||
- | You can include external and internal | + | Vous pouvez inclure des [[doku>fr:images|images]] |
- | Real size: {{wiki: | + | Taille réelle |
- | Resize to given width: {{wiki: | + | Redimensionnement à une largeur donnée |
- | Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, | + | Redimensionnement à une largeur et une hauteur données((Si les proportions de l' |
- | Resized external image: | + | Image externe redimensionnée |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | By using left or right whitespaces you can choose the alignment. | + | En utilisant des espaces à gauche ou à droite, vous pouvez choisir l' |
{{ wiki: | {{ wiki: | ||
Ligne 152: | Ligne 165: | ||
{{ wiki: | {{ wiki: | ||
- | Of course, you can add a title (displayed as a tooltip by most browsers), too. | + | Bien sûr, vous pouvez aussi ajouter un titre (affiché comme une bulle d'aide par la plupart des navigateurs). |
- | {{ wiki: | + | {{ wiki: |
- | {{ wiki: | + | {{ wiki: |
- | If you specify a filename (external or internal) that is not an image (''gif, jpeg, png'' | + | On peut proposer une image en téléchargement sans l'afficher, en utilisant |
- | For linking an image to another page see [[#Image Links]] above. | + | {{ wiki: |
- | ===== Lists ===== | + | {{ wiki: |
- | Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a '' | + | |
+ | Si vous spécifiez un nom de fichier (externe ou interne) qui n'est pas une image ('' | ||
- | * This is a list | + | Pour lier une image à une autre page, voir [[#Liens images]] ci-dessus. |
- | * The second item | + | |
- | * You may have different levels | + | |
- | * Another item | + | |
- | | + | ===== Listes ===== |
- | | + | |
- | - Just use indention for deeper levels | + | DokuWiki accepte les listes ordonnées et non ordonnées. Pour créer un élément de liste, indentez votre texte par deux espaces et utilisez une '' |
- | - That's it | + | |
+ | | ||
+ | * Le second élément | ||
+ | | ||
+ | * Un autre élément | ||
+ | |||
+ | | ||
+ | - Un autre élément | ||
+ | - Utilisez simplement l'indentation pour des niveaux plus profonds | ||
+ | - Et voilà | ||
< | < | ||
- | * This is a list | + | * Ceci est une liste |
- | * The second | + | * Le second |
- | * You may have different levels | + | * Vous pouvez avoir plusieurs niveaux |
- | * Another item | + | * Un autre élément |
- | - The same list but ordered | + | - La même liste mais ordonnée |
- | - Another item | + | - Un autre élément |
- | - Just use indention for deeper levels | + | - Utilisez simplement l' |
- | - That's it | + | - Et voilà |
</ | </ | ||
- | ===== Smileys ===== | + | Vous pouvez aussi consulter notre [[fr: |
- | DokuWiki | + | ===== Conversions textuelles ===== |
+ | |||
+ | DokuWiki | ||
+ | |||
+ | Les conversions en image sont principalement utilisée pour les émoticônes (// | ||
+ | |||
+ | ==== Emoticônes (smileys) ==== | ||
+ | |||
+ | DokuWiki transforme les [[wpfr>Émoticône]]s courantes en leurs équivalents graphiques. Plus d' | ||
* 8-) %% 8-) %% | * 8-) %% 8-) %% | ||
Ligne 196: | Ligne 224: | ||
* :-( %% :-( %% | * :-( %% :-( %% | ||
* :-) %% :-) %% | * :-) %% :-) %% | ||
- | |||
* =) %% =) %% | * =) %% =) %% | ||
* :-/ %% :-/ %% | * :-/ %% :-/ %% | ||
Ligne 214: | Ligne 241: | ||
* DELETEME %% DELETEME %% | * DELETEME %% DELETEME %% | ||
- | ===== Typography ===== | + | ==== Typographie |
- | [[DokuWiki]] | + | [[DokuWiki]] |
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
Ligne 226: | Ligne 253: | ||
</ | </ | ||
- | Please note: These conversions can be turned off through a [[doku> | + | Il est possible de faire la même chose pour n' |
- | ===== Quoting | + | Il existe trois exceptions à ce mécanisme. le symbole de multiplication (640x480), les %%' |
+ | ===== Citations | ||
- | Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: | + | Parfois vous souhaitez marquer du texte afin de montrer que c'est une réponse ou un commentaire. Vous pouvez utiliser la syntaxe suivante |
- | | + | |
| | ||
- | > No we shouldn' | + | > Non nous ne devrions pas |
| | ||
- | >> | + | >> |
| | ||
- | > Really? | + | > Vraiment |
| | ||
- | >> | + | >> |
| | ||
- | >>> | + | >>> |
- | I think we should do it | + | Je pense que nous devrions le faire |
- | > No we shouldn' | + | > Non nous ne devrions pas |
- | >> | + | >> |
- | > Really? | + | > Vraiment |
- | >> | + | >> |
- | >>> | + | >>> |
- | ===== Tables | + | ===== Tableaux |
- | DokuWiki | + | DokuWiki |
- | ^ Heading | + | ^ Titre 1 |
- | | Row 1 Col 1 | Row 1 Col 2 | + | | Ligne 1 Col 1 |
- | | Row 2 Col 1 | some colspan | + | | Ligne 2 Col 1 |
- | | Row 3 Col 1 | Row 2 Col 2 | + | | Ligne 3 Col 1 |
- | Table rows have to start and end with a '' | + | Les lignes de tableau doivent commencer et se terminer avec une //barre verticale// |
- | ^ Heading | + | ^ Titre 1 |
- | | Row 1 Col 1 | Row 1 Col 2 | + | | Ligne 1 Col 1 |
- | | Row 2 Col 1 | some colspan | + | | Ligne 2 Col 1 |
- | | Row 3 Col 1 | Row 2 Col 2 | + | | Ligne 3 Col 1 |
- | To connect cells horizontally, just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators! | + | Pour fusionner des cellules horizontalement, videz simplement complètement la cellule suivante comme il est montré ci-dessus. Assurez-vous d' |
- | Vertical tableheaders are possible, too. | + | Les titres de tableau verticaux sont également possibles. |
- | | ^ Heading | + | | ^ Titre 1 ^ Titre 2 ^ |
- | ^ Heading | + | ^ Titre 3 | Ligne 1 Col 2 | Ligne 1 Col 3 | |
- | ^ Heading | + | ^ Titre 4 | pas de fusion cette fois | | |
- | ^ Heading | + | ^ Titre 5 | Ligne 2 Col 2 | Ligne 2 Col 3 | |
- | As you can see, it's the cell separator before a cell which decides about the formatting: | + | Comme vous pouvez le constater, c'est le séparateur (' |
- | | ^ Heading | + | | ^ Titre 1 ^ Titre 2 ^ |
- | ^ Heading | + | ^ Titre 3 | Ligne 1 Col 2 | Ligne 1 Col 3 | |
- | ^ Heading | + | ^ Titre 4 | pas de fusion cette fois | | |
- | ^ Heading | + | ^ Titre 5 | Ligne 2 Col 2 | Ligne 2 Col 3 | |
- | Note: Vertical spans (rowspan) are not possible. | + | Vous pouvez fusionner des cellules verticalement en ajoutant |
+ | :!: Cette fonctionnalité n'est disponible que pour les versions supérieures à 2009-02-14b | ||
- | 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. | + | ^ Titre 1 ^ Titre 2 ^ Titre 3 ^ |
+ | | Ligne 1 Col 1 | Cette cellule s' | ||
+ | | Ligne 2 Col 1 | ::: | Ligne 2 Col 3 | | ||
+ | | Ligne 3 Col 1 | ::: | Ligne 3 Col 3 | | ||
- | ^ Table with alignment | + | Ces cellules ne doivent rien contenir d' |
- | | right| | + | |
- | |left | + | |
+ | | Ligne 1 Col 1 | Cette cellule s' | ||
+ | | Ligne 2 Col 1 | ::: | Ligne 2 Col 3 | | ||
+ | | Ligne 3 Col 1 | ::: | Ligne 3 Col 3 | | ||
+ | |||
+ | |||
+ | Vous pouvez également aligner les contenus du tableau (uniquement horizontalement). Ajoutez simplement au moins deux espaces à l' | ||
+ | |||
+ | ^ Tableau avec alignement | ||
+ | | droite| | ||
+ | |gauche | ||
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
- | This is how it looks in the source: | + | Voici à quoi ça ressemble dans le code source : |
- | ^ Table with alignment | + | ^ |
- | | right| | + | | |
- | |left | + | |gauche |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
- | ===== Non-parsed Blocks | + | ===== Blocs non analysés |
+ | |||
+ | Vous pouvez inclure des blocs non analysés dans vos documents soit en les indentant avec au moins deux espaces (comme on peut le voir dans les exemples précédents) soit en utilisant les balises '' | ||
- | 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 '' | ||
< | < | ||
- | This is preformatted | + | Ceci est du code préformaté, |
</ | </ | ||
< | < | ||
- | This is pretty much the same, but you could use it to show that you quoted a file. | + | Ceci est pratiquement la même chose, mais vous pouvez l' |
</ | </ | ||
- | To let the parser ignore an area completely | + | Pour laisser l' |
+ | |||
+ | < | ||
+ | Voici du texte qui contient des adresses comme ceci : http:// | ||
+ | </ | ||
< | < | ||
- | This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. | + | Voici du texte qui contient des adresses comme ceci : http://www.spiltbrain.org et de la **mise en forme**, mais rien ne se passe. |
</ | </ | ||
- | See the source | + | Consultez le code source |
- | ===== Syntax Highlighting ===== | + | ==== Coloration syntaxique |
- | [[wiki:DokuWiki]] | + | [[DokuWiki]] |
<code java> | <code java> | ||
/** | /** | ||
- | | + | |
- | | + | |
*/ | */ | ||
class HelloWorldApp { | class HelloWorldApp { | ||
public static void main(String[] args) { | public static void main(String[] args) { | ||
- | System.out.println(" | + | System.out.println(" |
} | } | ||
} | } | ||
</ | </ | ||
- | The following language strings are currently recognized: //abap, actionscript-french, | + | Les identificateurs de langage suivants sont actuellement reconnus |
+ | ==== Bloc de code téléchargeables ==== | ||
- | ===== RSS/ATOM Feed Aggregation ===== | ||
- | [[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http:// | ||
- | ^ Parameter | + | Quand vous utilisez les balises // |
- | | any number | will be used as maximum number items to show, defaults to 8 | | + | |
- | | reverse | + | |
- | | author | + | |
- | | date | show item dates | | + | |
- | | description| show the item description. If [[doku>config: | + | |
- | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | + | |
- | The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki: | + | <file php monexemple.php> |
+ | <?php echo "hello world!"; | ||
+ | </file> | ||
- | **Example:** | + | <file php monexemple.php> |
+ | <?php echo "hello world!"; | ||
+ | </ | ||
+ | |||
+ | Si vous ne voulez pas de coloration syntaxique, il suffit de fournir un tiret (-) en guise de code de langage: | ||
+ | | ||
+ | |||
+ | ===== Agrégation de fils RSS/ATOM ===== | ||
+ | [[DokuWiki]] peut agréger les données de fils XML externes. Pour l' | ||
+ | |||
+ | ^ Paramètre | ||
+ | | tout nombre | sera utilisé comme le nombre maximum d' | ||
+ | | reverse | ||
+ | | author | ||
+ | | date | affiche les dates des éléments | | ||
+ | | description | affiche les descriptions des éléments. Si [[doku> | ||
+ | | // | ||
+ | |||
+ | La durée de rafraîchissement est par défaut de 4 heures. Toute valeur inférieure à 10 minutes sera traitée comme 10 minutes. [[DokuWiki]] essaiera en général de fournir une version de la page à partir du cache, évidemment, | ||
+ | |||
+ | **Exemple | ||
{{rss> | {{rss> | ||
Ligne 362: | Ligne 424: | ||
{{rss> | {{rss> | ||
+ | ===== Inclure du code HTML ou PHP ===== | ||
- | ===== Embedding | + | Vous pouvez inclure du code HTML ou PHP pur dans vos documents |
- | + | ||
- | You can embed raw HTML or PHP code into your documents | + | |
< | < | ||
< | < | ||
- | This is some <span style="color:red;font-size:150%;">inline | + | Ceci est du <font color="red" |
</ | </ | ||
- | < | ||
- | <p style=" | ||
- | </ | ||
</ | </ | ||
< | < | ||
- | This is some <span style="color:red;font-size:150%;">inline | + | Ceci est du <font color="red" |
</ | </ | ||
- | < | ||
- | <p style=" | ||
- | </ | ||
< | < | ||
<php> | <php> | ||
- | echo 'A logo generated by PHP:'; | + | echo 'Un logo produit par PHP :'; |
- | echo '< | + | echo '< |
- | echo ' | + | |
</ | </ | ||
- | <PHP> | ||
- | echo '< | ||
- | echo '< | ||
- | echo '</ | ||
- | </ | ||
</ | </ | ||
<php> | <php> | ||
- | echo 'A logo generated by PHP:'; | + | echo 'Un logo produit par PHP :'; |
- | echo '< | + | echo '< |
- | echo ' | + | |
</ | </ | ||
- | <PHP> | ||
- | echo '< | ||
- | echo '< | ||
- | echo '</ | ||
- | </ | ||
- | **Please Note**: HTML and PHP embedding is disabled by default in the configuration. | + | **NB** : L' |
- | ===== Control | + | ===== Macros ===== |
- | Some syntax influences how DokuWiki | + | Certains mot-clef modifient la manière dont DokuWiki |
^ Macro ^ Description | | ^ Macro ^ Description | | ||
- | | %%~~NOTOC~~%% | + | | %%~~NOTOC~~%% |
- | | %%~~NOCACHE~~%% | DokuWiki | + | | %%~~NOCACHE~~%% | Par défaut, |
- | ===== Syntax Plugins | + | ===== Extensions de syntaxe |
- | DokuWiki's syntax can be extended by [[doku> | + | La syntaxe de DokuWiki |
~~INFO: | ~~INFO: | ||
- |