Syntaxe de mise en page
DokuWiki utilise un langage de balisage simple, qui essaie de rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes possibles que vous pouvez utiliser en éditant les pages. Regardez simplement le code source de cette page en cliquant sur le bouton Éditer cette page en haut ou en bas de cette page. Si vous souhaitez essayer quelque chose, rendez-vous dans la page du bac à sable. Les balises les plus simples sont aussi facilement accessibles depuis les raccourcis.
Mise en forme de texte basique
DokuWiki accepte les textes en gras, italique, souligné et à chasse fixe.
DokuWiki accepte les textes en **gras**, //italique//, __souligné__ et ''à chasse fixe''.
Bien sûr, vous pouvez tous les combiner.
Bien sûr, vous pouvez tous les **__//''combiner''//__**.
Vous pouvez aussi utiliser indice et exposant.
Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>.
De plus, vous pouvez marquer un passage comme supprimé.
De plus, vous pouvez marquer un passage comme <del>supprimé</del>.
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.
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.
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.
Vous ne devriez forcer des sauts de ligne que si c'est vraiment nécessaire.
Liens
DokuWiki propose plusieurs moyens pour créer des liens.
Externes
Les liens externes sont reconnus « automagiquement » : http://www.google.fr ou simplement www.google.fr - Vous pouvez aussi donner des noms aux liens : Ce lien pointe vers Google. Les adresses de courriel comme celle-ci : andi@splitbrain.org sont également reconnues.
Les liens externes sont reconnus « automagiquement » : http://www.google.fr ou simplement www.google.fr - Vous pouvez aussi donner des noms aux liens : [[http://www.google.fr|Ce lien pointe vers Google]]. Les adresses de courriel comme celle-ci : <andi@splitbrain.org> sont également reconnues.
Internes
Les liens internes sont créés en utilisant les crochets. Vous pouvez soit juste donner un nom de page soit utiliser un texte pour le titre. Les noms de pages (pagenames) wiki sont convertis automatiquement en minuscules ; les caractères spéciaux ne sont pas autorisés.
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 (//pagenames//) wiki sont convertis automatiquement en minuscules ; les caractères spéciaux ne sont pas autorisés.
Vous pouvez utiliser des catégories (namespaces) en utilisant les deux points (:) dans le nom de page pagename.
Vous pouvez utiliser des [[catégories]] (//namespaces//) en utilisant les //deux points// ('':'') dans le nom de page //pagename//.
Pour plus de détails sur les catégories (namespaces), voir Catégories.
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 cette section.
Ce lien renvoie vers [[syntax#internes|cette section]].
Notes :
- Les liens vers des pages existantes sont montrés dans un style différent des liens vers des pages inexistantes.
- DokuWiki n'utilise pas la syntaxe CamelCase pour utiliser des liens par défaut, mais ce comportement peut être activé dans le fichier de configuration. Astuce : si le mot DokuWiki apparaît sur cette page comme un lien, alors c'est que la syntaxe CamelCase est activée.
- 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 propose les liens Interwiki. Ce sont des liens rapides vers d'autres Wikis. Par exemple ceci est un lien vers la définition des Wikis dans Wikipedia en français : Wiki.
Les liens sont plus court à écrire et affichent un icône particulier. Des liens RSS et Youtube ont entre autre été ajoutés. Voir la liste des interwiki disponibles.
DokuWiki propose les liens [[doku>fr:interwiki|Interwiki]]. Ce sont des liens rapides vers d'autres Wikis. Par exemple ceci est un lien vers la définition des Wikis dans Wikipedia en français : [[wpfr>Wiki]].
Partages Windows
Les partages Windows tels que ceci sont également reconnus. Veuillez noter qu'ils n'ont un sens que dans un groupe d'utilisateurs homogène tels qu'un Intranet d'entreprise.
Les partages Windows tels que [[\\serveur\partage|ceci]] sont également reconnus.
Notes :
- 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 Firefox, elle peut être mise en place dans l'option de configuration security.checkloaduri mais ceci n'est pas conseillé.
- Je viens de tester en passant la valeur à “false”, mais celà ne change rien !? (même après redémarrage de FF 2.0.0.6 sous Windows)
- Veuillez consulter 151 pour plus d'informations.
Liens images
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 (voir plus bas) comme ceci :
[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
NB : la mise en forme image est la seule syntaxe de mise en forme acceptée comme nom de lien.
Les syntaxes d'image complète et de Liens sont possibles (incluant le redimensionnement d'image, les images internes et externes, les URL et les liens interwikis).
Notes de pied de page
Vous pouvez ajouter des notes de pied de page 1) en utilisant des parenthèses doubles.
Vous pouvez ajouter des notes de pied de page ((Ceci est une note de pied de page)) en utilisant des parenthèses doubles.
Découpage en sections
Vous pouvez utiliser jusqu'à cinq niveaux de titres différents afin de structurer le contenu. Si vous avez plus de trois titres, une table des matières est construite automatiquement – ceci peut être désactivé en incluant la chaîne
~~NOTOC~~ dans le document.
Titre niveau 3
Titre niveau 4
Titre niveau 5
==== Titre niveau 3 ==== === Titre niveau 4 === == Titre niveau 5 ==
En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale :
Images et autres fichiers
Vous pouvez inclure des images externes et internes avec des accolades. Vous pouvez spécifier leur taille (facultatif).
Redimensionnement à une largeur donnée :
Redimensionnement à une largeur et une hauteur données :
Image externe redimensionnée :
Taille réelle : {{wiki:dokuwiki-128.png}}
Redimensionnement à une largeur donnée : {{wiki:dokuwiki-128.png?50}}
Redimensionnement à une largeur et une hauteur données : {{wiki:dokuwiki-128.png?200x50}}
Image externe redimensionnée : {{http://de3.php.net/images/php.gif?200x50}}
En utilisant des espaces à gauche ou à droite, vous pouvez choisir l'alignement.
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
Bien sûr, vous pouvez aussi ajouter un titre (affiché comme une bulle d'aide par la plupart des navigateurs).
{{ wiki:dokuwiki-128.png |Ceci est le titre}}
Si vous spécifiez un nom de fichier (externe ou interne) qui n'est pas une image (gif, jpeg, png), alors il sera affiché comme un lien et non comme une image.
Pour lier une image à une autre page, voir Liens images ci-dessus.
Listes
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 * pour une liste non ordonnée ou un - pour une liste ordonnée.
- Ceci est une liste
- Le second élément
- Vous pouvez avoir plusieurs niveaux
- Un autre élément
- La même liste mais ordonnée
- Un autre élément
- Utilisez simplement l'indentation pour des niveaux plus profonds
- Et voilà
* Ceci est une liste
* Le second élément
* Vous pouvez avoir plusieurs niveaux
* Un autre élément
- La même liste mais ordonnée
- Un autre élément
- Utilisez simplement l'indentation pour des niveaux plus profonds
- Et voilà
Emoticônes (smileys)
DokuWiki transforme les Émoticônes courantes en leurs équivalents graphiques. Plus d'émoticônes (smileys) peuvent être placées dans le répertoire smiley et configurées dans le fichier conf/smileys.conf. Voici une vue d'ensemble des émoticônes incluse dans DokuWiki.
8-)
8-O
:-(
:-)
=)
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
:?:
:!:
LOL
FIXME
DELETEME
Typographie
DokuWiki peut convertir de simples caractères de texte brut en leurs entités typographiques correctes. Voici un exemple des 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'..."
NB : Ces conversions peuvent être désactivées par une option dans le fichier de configuration ou un fichiers de motifs.
Citations
Parfois vous souhaitez marquer du texte afin de montrer que c'est une réponse ou un commentaire. Vous pouvez utiliser la syntaxe suivante :
Je pense que nous devrions le faire > Non nous ne devrions pas >> Eh bien, je pense que si > Vraiment ? >> Oui ! >>> Alors faisons-le !
Je pense que nous devrions le faire
Non nous ne devrions pas
Eh bien, je pense que si
Vraiment ?
Oui !
Alors faisons-le !
Tableaux
DokuWiki propose une syntaxe simple pour créer des tableaux.
| Titre 1 | Titre 2 | Titre 3 |
|---|---|---|
| Ligne 1 Col 1 | Ligne 1 Col 2 | Ligne 1 Col 3 |
| Ligne 2 Col 1 | colonnes fusionnées (notez la double barre verticale) | |
| Ligne 3 Col 1 | Ligne 2 Col 2 | Ligne 2 Col 3 |
Les lignes de tableau doivent commencer et se terminer avec une barre verticale | pour des lignes normales ou avec un ^ pour les titres.
^ Titre 1 ^ Titre 2 ^ Titre 3 ^ | Ligne 1 Col 1 | Ligne 1 Col 2 | Ligne 1 Col 3 | | Ligne 2 Col 1 | colonnes fusionnées (notez la double barre verticale) || | Ligne 3 Col 1 | Ligne 2 Col 2 | Ligne 2 Col 3 |
Pour fusionner des cellules horizontalement, videz simplement complètement la cellule suivante comme il est montré ci-dessus. Assurez-vous d'avoir toujours le même nombre de séparateurs de cellules !
Les titres de tableau verticaux sont également possibles.
| Titre 1 | Titre 2 | |
|---|---|---|
| Titre 3 | Ligne 1 Col 2 | Ligne 1 Col 3 |
| Titre 4 | pas de fusion cette fois | |
| Titre 5 | Ligne 2 Col 2 | Ligne 2 Col 3 |
Comme vous pouvez le constater, c'est le séparateur ('|' ou '^') précédant une cellule qui détermine le format :
| ^ Titre 1 ^ Titre 2 ^ ^ Titre 3 | Ligne 1 Col 2 | Ligne 1 Col 3 | ^ Titre 4 | pas de fusion cette fois | | ^ Titre 5 | Ligne 2 Col 2 | Ligne 2 Col 3 |
NB : les fusions verticales ne sont pas possibles.
Vous pouvez également aligner les contenus du tableau. Ajoutez simplement au moins deux espaces à l'extrémité opposée de votre texte : ajoutez deux espaces sur la gauche pour aligner à droite, deux espaces sur la droite pour aligner à gauche et deux espaces au moins à chaque extrémité pour centrer le texte.
| Tableau avec alignement | ||
|---|---|---|
| droite | centré | gauche |
| gauche | droite | centré |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Voici à quoi ça ressemble dans le code source :
^ Tableau avec alignement ^^^ | droite| centré |gauche | |gauche | droite| centré | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
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 code ou file.
Ceci est du code préformaté, tous les espaces sont préservés : comme <-ceci
Ceci est pratiquement la même chose, mais vous pouvez l'utiliser pour montrer que vous avez cité un fichier.
Pour laisser l'analyseur ignorer complètement un bloc (comme ne pas faire lui appliquer de mise en forme), encadrez ce bloc soit avec des balises nowiki ou, encore plus simple, avec des caractères pourcent doubles %%.
Voici du texte qui contient des adresses comme ceci : http://www.spiltbrain.org et de la **mise en forme**, mais rien ne se passe.
Consultez le code source de cette page pour voir comment utiliser ces blocs.
Coloration syntaxique
DokuWiki peut mettre en forme et en couleur du code source, ce qui facilite sa lecture. Il utilise le Generic Syntax Highlighter GeSHi – donc n'importe quel langage connu de GeSHi est accepté. La syntaxe est la même que dans le bloc de code de la section précédente, mais cette fois le nom du langage utilisé est inséré dans la balise. Par exemple : <code java>.
/** * La classe HelloWorldApp implemente une application qui * affiche simplement "Hello World!" dans la sortie standard. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); //Affiche la chaîne. } }
Les identificateurs de langage suivants sont actuellement reconnus : actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml, xpp, z80
Agrégation de fils RSS/ATOM
DokuWiki peut agréger les données de fils XML externes. Pour l'analyse des fils XML, SimplePie est utilisé. Tous les formats connus de SimplePie peuvent aussi être utilisés dans DokuWiki. Vous pouvez modifier le comportement en ajoutant plusieurs paramètres séparés par des espaces :
| Paramètre | Description |
|---|---|
| tout nombre | sera utilisé comme le nombre maximum d'éléments à montrer, 8 par défaut |
| reverse | affiche les derniers éléments en premier dans le fil |
| author | affiche le nom des auteurs des éléments |
| date | affiche les dates des éléments |
| description | affiche les descriptions des éléments. Si HTML est désactivé, toutes les étiquettes (tags) seront enlevées |
| n[dhm] | durée de rafraîchissement, ou d=days (jours), h=heures, m=minutes. (Par exemple 12h = 12 heures). |
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, cela est inadapté quand la page a un contenu dynamique externe. Le paramètre dit à DokuWiki de réengendrer la page s'il y a plus que la durée de rafraîchissement depuis que la page a été engendrée pour la dernière fois.
Exemple :
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
- UK Music Industry Calls For Truce With Technology par samzenpus (06/09/2010 00:43)
- The New Difficulties In Making a 3D Game par samzenpus (05/09/2010 22:40)
- 4chan Gives 90-Year-Old Vet a Great Birthday par samzenpus (05/09/2010 20:44)
- Transition Metal Catalysts Could be Key To Origin of Life par samzenpus (05/09/2010 19:27)
- Fine-Structure Constant Maybe Not So Constant par samzenpus (05/09/2010 18:56)
Inclure du code HTML ou PHP
Vous pouvez inclure du code HTML ou PHP pur dans vos documents en utilisant les balises html ou php comme ceci :
<html> Ceci est du <font color="red" size="+1">HTML</font> </html>
Ceci est du HTML
<php> echo 'Un logo produit par PHP :'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Logo PHP !" />'; </php>
echo 'Un logo produit par PHP :';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Logo PHP !" />';
NB : L'inclusion de code HTML et PHP est désactivée dans la configuration par défaut. Dans ce cas, le code est affiché au lieu d'être exécuté.
Couleur
Grâce à un plug-in, il est possible d'ajouter de nombreuses couleurs.
Il est aussi possible d'utiliséer différentes densitées.
Ou encore des nuances.
Le principe de la coloration en trois étapes.
- Accorder un attribut à la balise couleur.
- Écrire le texte.
- Refermer la balise
Exemples
Texte avec le nom de couleur “green”.
Texte avec la couleur #aaa555.
Trois Étapes
1. <color NOM> - <color #●●●●●●>
Remplacer NOM par le nom de la couleur (en anglais selon couleurs codées).
ou
Remplacer ●●●●●● par le numéro de la couleur.
2. TEXTE
3. </color>
ATTENTION :
Il faut absolument fermer une balise avant d'en ouvrir une autre.
Exemples
<color green>Texte avec le nom de couleur "green".</color>
<color #aaa555>Texte avec la couleur #aaa555.</color>
Code pour couleurs densitées et nuan ces.
Couleurs <color red>c</color><color orange>o</color> <color yellow>u</color><color green>l</color> <color cyan>e</color><color blue>u</color> <color purple>r</color><color pink>s</color>. Densitées <color #ffe5e5>d</color><color #ffcccc>e</color> <color #ffb2b2>n</color><color #ff9999>s</color> <color #ff8080>i</color><color #ff6666>t</color> <color #ff4c4c>é</color><color #ff3333>e</color> <color #ff1a1a>s</color>. Nuances <color #b0def5>n</color><color #b0c1f5>u</color> <color #bcb0f5>a</color><color #d8b0f5>n</color> <color #f5b0f5>c</color><color #f5b0d8>e</color> <color #f5b0bc>s</color>.
Progress bar plugin
Ce plugin permet d'ajouter une barre de progression
Il faut seulement ajouter <progress=#> dans la page, # doit être remplacé par un nombre de 0 à 100 (sans signe%)n. (seul les multiples de 10 peuvent être utilisés 0%, 10%, 20%, etc.) Exemples
<progress=0>
<progress=70>
Blockquote
<blockquote>Permet d'ajouter un bloc de citation</blockquote>
Permet d'ajouter un bloc de citation
<blockquote>On peut aussi indiquer la source. <cite>Dans la balise "cite"</cite></blockquote>
On peut aussi indiquer la source.
Dans la balise “cite”
Imagebox
L'imagebox fonctionne de la même façon que les images normales. Il suffit d'ajouter des crochets [ ] autour de l'image. Il est possible d'enligner à gauche, droite ou au milieu, de la même façon que pour les images normales.
Le texte peut inclure des mises en forme italique, gras, souligné, liens et autre.
Pour les boites enlignées à gauche et à droite, le texte apparaitra à côté de l'image.
Placer une image enlignée à gauche et une à droite sur la même ligne permet d'avoir une image de chaque côté. Placer deux images à droite (ou à gauche) affichera les deux images du même côté, mais une sous l'autre (et non pas une à côté de l'autre.
[{{:wiki:dokuwiki-128.png|Image box à gauche}}]
[{{ :wiki:dokuwiki-128.png|Image box à droite}}]
[{{ :wiki:dokuwiki-128.png |Image box à centre}}]
Folded
If you want to make additional information available that is hidden by default, you have two options with this plugin:
Inline:
This is example text. And after that the text just continues to flow in the same paragraph.
This is example ++text | with some of it only shown when you unfold it++. And after that the text just continues to flow in the same paragraph.
Block: This is example text.
This is example text. ++++ Title | | This table | is only shown | when you unfold the block | [[:kanji:]] ++++
| . | Inline | Block |
|---|---|---|
| Syntax | ++title| formatted text ++ | ++++title| any content ++++ |
| HTML | <span> tag | <div> tag |
| Can contain formatting | | |
| Can contain block elements2) | — | |
| Can be used within a paragraph, table, list, etc. | | — |
Google Maps
<googlemap parameter="value" parameter="value"> lat,lon,text lat,lon,text </googlemap>
The lines of “lat,lon,text” represent the individual overlay markers. Each marker must have its own line and be the only information on that line. “lat” and “lon” are the latitude and longtitude of the marker. “text” is the text to be displayed in the popup when the marker is clicked. The text can include wiki markup.
Parameters
- width — 999[css length unit*] (e.g. 500px, 50%) width of the Google map, default is “400px”.
- height — 999[css length unit*] (e.g. 500px, 30em) height of the Google map, default is “300px”.
- type — values: map | satellite | hybrid. default map.
- lat — values: -90.0 - 90.0; latitude of map centre, negative values are south.
- lon — values: -180.0 - 180.0; longitude of map centre, negative values are west.
- zoom — integer, zoom level, default value 8. Valid values depend on the map and location.
- controls — values on | off. default on. Whether or not to show controls for zooming and panning on the map.
- kml — values: off | [URL of kml file].
The parameters can be in any order.
(*) For width and height any valid CSS length unit can be used. The common ones are px and em, plus % for widths. In general don't use percents for height as in most cases the value is likely to be undefined. For more details refer to the CSS Specification.
Divalign
#;; This is aligned left. #;;
#;; This is aligned left. #;;
;;# This is aligned right. ;;#
;#; This is aligned center. ;#;
;#; This is aligned center. ;#;
###This texts is justified.###
### This texts is justified. ###
Unlike the original plugin, divalign2 requires that the enter/exit syntax take place at the beginning/end of their lines, respectively. Thus, the following should not work:
;;# This text will not be aligned right. ;;#
Also, if you want to wrap two or more paragraphs inside an aligned section, you must do this by providing a blank line after the entering syntax, like this:
;;# This is a small preamble aligned right. And this is some more text aligned right. This paragraph, and any other following, would follow the right alignment, until a line containing the string ';;#' is found again. ;;#
furigana
Pour afficher un texte en ruby (furigana) il suffit d'inséré les hiragana entre parenthèse après un kanji.
Les kanji suivi de furigana entre parenthèse sont converti en code ruby du html 1.1, ainsi.
漢字(ふり)
est transformé en
<ruby><rb>漢字</rb><rp>(</rp><rt>ふり</rt><rp>)</rp></ruby> Résultat :漢字
Il est aussi possible d'insérer des parenthèses vides, pour forcer le furigana à se placer sur un seul caractère plutôt que sur la série.
駅()前(まえ)
génère donc
駅<ruby><rb>前</rb><rp>(</rp><rt>まえ</rt><rp>)</rp></ruby> Résultat :駅 前
plutôt que
<ruby><rb>駅前</rb><rp>(</rp><rt>まえ</rt><rp>)</rp></ruby> Résultat :駅前
Note: il s'agit d'un “action plugin”, et peut donc etre utilisé partout, même dans les titres.
fontsize
Change the fontsize by clicking a button in the edit toolbar.
To change the fontsize, mark the text that you would like to change the size. Then click on the button fontsize2 and choose one of the predefined sizes.
The result is:
<fs yoursize em> Your own text</fs>
Alternative you can write this by yourself. In this case you have some additional possibilities:
- em - Your own text in 2em / Percent-Value 1em = Normal, 2em = double size
- ex - Your own text in 2ex / Percent-Value 1ex = Normal, 2ex = double size
- % - Your own text in 200% / Percent-Value 100% = Normal, 200% = double size
- px - Your own text in 12px / Not so good! px values may vary on different computers!
- keywords - xx-small , x-small, small, medium, large, x-large, xx-large - Your own text in x-small
Gallery
Syntax
A basic gallery can be added by selecting a namespace like this:
{{gallery>namespace}}
All imagefiles in the selected namespace will be added to the image gallery.
Instead of using a whole namespace of images, you can also specify a single image – this makes most sense when combined with the lightbox mode (see below).
{{gallery>namespace:someimage.jpg}}
The created gallery can be aligned by using whitespace (defaults to centered):
{{gallery> namespace}} (right aligned)
{{gallery>namespace }} (left aligned)
{{gallery> namespace }} (centered)
Parameters
A number of parameters can be set by appending them with ? character to the namespace or image. Each parameter needs to be separated with a & character. Defaults for all parameters can be set in the config manager. If a parameter is enabled by default it can be disabled in the syntax by prefixing it with the syllable no. E.g. the parameter cache is usually enabled and can be disabled using the keyword nocache. Below is a list of all recognized parameters
| Parameter | Default | Description |
|---|---|---|
<number>x<number> | 120x120 | Sets the size for thumbnails. Unless the crop option is set, this is a boundary box into which the thumbnail will be fitted, maintaining the correct aspect ratio. |
<number>X<number> | 800X600 | Sets the size for the linked images in direct mode. This is a boundary box into which the image will be fitted, maintaining the correct aspect ratio. Note the uppercase X. |
<number> | 5 | The number images per row in the gallery table. If you specify a 0 no table is used instead all thumbnails are added in a sequence. |
=<number> | =0 | Limits the output to the given number of images. 0 means all. |
+<number> | +0 | Skip the first number of images. Useful with the option above. |
cache | enabled | Usually the output of the created gallery is cached. When the images in your selected namespace change, you have to manually force an update of the gallery page's cache. To disable the cache for the page showing the gallery, set nocache as option. |
crop | disabled | Make thumbnails the exact given thumbnail size big, cropping when needed. |
direct | disabled | Link thumbnails with the bigger sized images not with their detail page |
lightbox | disabled | Show images in a fancy JavaScript modal browsing window, see below for details. Setting this option automatically implies the direct mode |
reverse | disabled | Reverse the order of the displayed images |
random | disabled | Sort images randomly. You might want to use nocache as well |
modsort | disabled | Sort images by file modification date |
datesort | disabled | Sort images by EXIF date |
titlesort | disabled | Sort images by EXIF title |
showname | disabled | Show filename below thumbnails |
showtitle | disabled | Show EXIF title below thumbnails |
anything containing a * | jpg,gif,png images | This can be used to filter the list of files found in the given namespace. * work as simple wildcard symbol. |
Example:
{{gallery>images:vacation?image_*.jpg&80x80&crop&lightbox}}
This displays all images beginning with image_ and ending in .jpg from the namespace images:vacation. Thumbnails are cropped to 80×80 pixels and images will be opened in lightbox mode.
Extensions de syntaxe
La syntaxe de DokuWiki peut être étendue par des extensions. Comment utiliser les extensions installées est décrit dans leurs pages de description respectives. Les extensions de syntaxe suivantes sont disponibles dans cette installation particulière de DokuWiki :
- fontsize2 Plugin 2009-01-20 par Thorsten Stratmann
With fs you can control the size of your text
Syntax: <fs size>Your Text</fs>
you can use any Value for size (em, ex, px, % , or xx-small , x-small, small, medium, large, x-large, xx-large)
example: <fs 2em>Your Text in 2em, 1em is dokuwiki standard</fs>
<fs 200%>Your Text in 200%, 100% is dokuwiki standard</fs> - Google Maps Plugin 2008-11-11 par Christopher Smith
Add maps to your wiki
Syntax: <googlemap params>overlaypoints</googlemap> - Folded Plugin – Inline 2008-08-13 par Fabian van-de-l_Isle
Enable inline folded text.
Syntax: ++title|folded content++ - Blockquote Plugin (quote component) 2008-05-04 par Gina Haeussge
Provides an environment for quotes in a semantically correct way using the blockquote XHTML tag
