Ce document décrit la Syntaxe Wiki utilisée dans le projet Wikidot.com.
N'importe quelle page de n'importe quel site existe dans deux formes différentes: le code source et le code compilé.
Le code source est celui que vous pouvez éditer et qui décrit le contenu de la page. Le code source est compilé en code (XHTML) qui est envoyé à votre navigateur lorsque vous visualisez la page. La syntaxe Wiki est utilisée pour créer le contenu des pages en éditant le code source.
Helpful is: [http://doc.wikidot.com/] (build by Community-Admins ) with the translate-button right side!
Si vous recherchez le code wiki snippets (gadgets) prêt à être copié/collé/modifié, veuillez visiter notre Site dédié aux Codes Snippets.
Table of Contents
|
Formatage en ligne
ce que vous tapez | ce que vous obtenez |
---|---|
//texte italique// | texte italique |
**texte en gras** | texte en gras |
//**italique et gras**// | italique et gras |
__texte souligné__ | texte souligné |
--texte barré-- | texte barré |
{{texte teletype (monospaced)}} | texte teletype (monospaced) |
normal^^superscript^^ | normalsuperscript |
normal,,subscript,, | normalsubscript |
[!-- commentaire invisible --] | |
[[style="color:red"]]élément personnalisé avec //span// [[/span]] | élément personnalisé avec span |
##blue|predefined## or ##44FF88|custom-code## color | predefined or custom-code color |
Taille du Texte
ce qu'on écrit | ce qu'on obtient |
---|---|
[[size 80%]]80% de la taille Normale[[/size]] | 80% de la taille Normale |
[[size 100%]]100% de la taille Normale[[/size]] | 100% de la taille Normale |
[[size 200%]]200% de la taille Normale[[/size]] | 200% de la taille Normale |
[[size xx-small]]xx-petit texte[[/size]] | xx-petit texte |
[[size x-small]]x-petit texte[[/size]] | x-petit texte |
[[size small]]petit texte[[/size]] | petit texte |
[[size smaller]]plus petit texte[[/size]] | plus petit texte |
Texte normal | Text normal |
[[size larger]]larger text[[/size]] | larger text |
[[size large]]large text[[/size]] | large text |
[[size x-large]]x-large text[[/size]] | x-large text |
[[size xx-large]]xx-large text[[/size]] | xx-large text |
Paragraphes et retours à la ligne
Les paragraphes sont séparés par deux retours à la ligne. Une nouvelle ligne produit … une nouvelle ligne.
Premier paragraphe. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Second paragraphe. Aenean a libero. Vestibulum adipiscing, felis ac faucibus imperdiet, erat lacus accumsan neque, vitae nonummy lorem pede ac elit.
Juste une nouvelle ligne.
Une autre nouvelle ligne.
Premier paragraphe. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Second paragraphe. Aenean a libero. Vestibulum adipiscing, felis ac faucibus imperdiet, erat lacus accumsan neque, vitae nonummy lorem pede ac elit.
Juste une nouvelle ligne.
Une autre nouvelle ligne.
Typographie
Si vous prenez soin de la typographie, il y a plusieurs façons d'améliorer votre texte:
vous tapez | vous obtenez |
---|---|
``double guillemets'' | “double guillemets” |
`guillemets' | ‘guillemets’ |
,,double guillemets'' | „double guillemets” |
points... | points… |
trait -- d'union | trait — d'union |
Texte litéral
Si vous voulez éviter que le texte soit interprété (compilé) mais plutôt produire un texte brut, encadrez-le de deux arobases (pas les simples apostrophes).
Ce //texte// est **interprété**.
@@Ce //texte// n'est pas **interprété**.@@
Ce texte est interprété.
Ce //texte// n'est pas **interprété**.
Commentaires
Un commentaire est un bloc de code source qui n'est pas compilé et n'apparaît pas. Pour ajouter un commentaire, utiliser [!-- ... --] , e.g.:
[!--
Ce texte est un commentaire qui n'apparaîtra pas à l'écran.
--]
Titres
Commencer la ligne par un "plus" pour créer un titre. Ajouter autant de "plus" que de niveaux de titres.
+ Titre de niveau 1
++ Titre de niveau 2
+++ Titre de niveau 3
++++ Titre de niveau 4
+++++ Titre de niveau 5
++++++ Titre de niveau 6
Table des matières
Pour créer une liste des titres, avec un lien vers ces titres, tapez la balise table des matières dans sa ligne propre.
[[toc]]
[[f>toc]] - table des matières flottant à droite
[[f<toc]] - table des matières flottant à gauche
Lignes horizontales
Utilisez 4 tirets ou plus (----) pour créer une ligne horizontale pleine.
Listes
Listes à puces
On crée un élément de liste en commençant la ligne avec un astérisque (*). Pour indenter, ajouter des blancs devant l'astérisque.
* Puce 1
* Puce 2
* Puce 2.1
- Puce 1
- Puce 2
- Puce 2.1
Listes numérotées
Vous pouvez créer des listes numérotées en commençant un paragraphe par un ou plusieurs #.
# Item 1
# Item 2
# Item 2.1
- Item 1
- Item 2
- Item 2.1
Vous pouvez mélanger listes à puces et puces numérotées.
Liste de définitions
Vous pouvez créer une liste de définitions avec la syntaxe suivante:
: Item 1 : Truc
: Item 2 : Machin
- Item 1
- Truc
- Item 2
- Machin
Citations
Vous pouvez créer une citation en commençant la ligne par un ou plusieurs '>', suivis par un espace et le texte de la citation.
Ici un peu de texte normal.
> Indentez-moi! Maître Corbeau, sur un arbre perché,\
tenait dans son bec un énorme fromage. \
Notez comment on maintient la citation \
dans le même paragraphe en utilisant la barre \
oblique inversée en fin \
de ligne .
>
> Un autre bloc, etc...
>> Second niveau d'indentation. Ce second paragraphe est indenté un peu \
plus que le précédent.
Retour au texte normal.
Ici un peu de texte normal.
Indentez-moi! Maître Corbeau, sur un arbre perché,tenait en son bec un fromage. Notez comment on maintient la citation dans le même paragraphe en utilisant la barre oblique inversée en fin de ligne .
Un autre bloc, etc…Second niveau d'indentation. Ce second paragraphe est indenté un peu plus que le précédent.
Retour au texte normal.
Liens
Liens internes
Contrairement à certains moteurs de wiki, wikidot.com ne traite pas les mots en |CasseDeChameau comme des liens vers des pages.
Au contraire, un lien vers une autre page est entouré par 3 parenthèses droites [[[ page ]]].
Si un nom de page contient des caractères interdits par le Unix, l'adresse sera convertie en caractères valides. Le nom de la page sera pourtant affiché dans sa forme originale.
ce que vous tapez | ce que vous obtenez | commentaires |
---|---|---|
[[[lien-vers-une-page]]] | lien-vers-une-page | le nom de page original |
[[[lien "VERS" une pagE]]] | lien "VERS" une pagE | le nom de la page devient "lien-vers-une-page" |
[[[categorie: autre page]]] | autre page | lien vers une page à l'intérieur d'une catégorie |
[[[ page4| texte personalisé]]] | texte personalisé | utilise un texte personalisé |
[[[fr:start|Accueil]]] | Accueil | lien vers une page qui existe (s'affiche dans une autre couleur) |
URLs
ce que vous tapez | ce que vous obtenez | commentaires |
---|---|---|
http://www.wikidot.com | http://www.wikidot.com | utilisation simple du lien |
[http://www.wikidot.com wikidot] | wikidot | lien personnalisé |
[*http://www.wikidot.com wikidot] | wikidot | ouvre une nouvelle fenêtre |
[# lien vide] | lien vide | utile pour construire des menus déroulants |
Ancres
ce que vous tapez | ce que vous obtenez | commentaires |
---|---|---|
[#socbm Marque] | Marque | va à la fin de cette page où se trouve l'ancre socbm |
[#toc6 Titres] | Titres | va à la 6eme rubrique de cette page |
[[[fr:site-map#toc23|Plan S23]]] | Plan S23 | va à la section 23 du plan du site |
Pour définir une ancre utilisez la syntaxe [[# anchor-name]].
Emails
ce que vous tapez | ce que vous obtenez | commentaires |
---|---|---|
support@example.com | moc.elpmaxe|troppus#moc.elpmaxe|troppus | email tel quel |
[support@example.com écrivez-moi!] | moc.elpmaxe|troppus#!iom-zevirc�� | texte personnalisé |
Si nous décourageons chacun de poster son adresse email sur le web, WikiDot prévoit un mécanisme pour empêcher les robots de capturer automatiquement les adresses email. Chaque adresse email est encryptée et décodée via le navigateur client. Même si ce n'est pas sûr à 100%, c'est bien plus sûr qu'une méthode affichant les emails en simple format texte.
InterWiki
Pour lier directement un article de Wikipedia, utilisez la syntaxe suivante:
ce que vous tapez | ce que vous obtenez |
---|---|
[wikipedia:Albert_Einstein] | Albert_Einstein |
[wikipedia:Albert_Einstein Albert] | Albert |
[wikipedia:fr:Albert_Einstein Einstein(fr)] | Einstein (fr) |
Autre liens par l'exemple:
- [google:free+wiki] - rechercher le terme "free wiki" via Google
- [dictionary:wiki] - rechercher les définitions du mot wiki via dictionary.reference.com
Images
Images simples
Pour insérer une image dans une page, utilisez la syntaxe suivante:
[[image image-source attribut1="value1" attribut2="value2" ...]]
Et voici la liste des attributs:
attribut | valeurs permises | exemple de valeur | description |
---|---|---|---|
link | nom de page wiki ou URL | "wiki-page" "http://www.example.com" |
lie l'image à une autre page ou une adresse web; ceci est ignoré quand on utilise Flickr comme source; préfixer le lien par '*' pour forcer l'ouverture d'une nouvelle fenêtre |
alt | chaine de caractères | "une photo de moi" | texte de substitution quand l' image n'est pas disponible |
width | nombre de pixels | "200px" | force la largeur d'affichage d'une image |
height | nombre de pixels | "200px" | force la hauteur d'affichage d'une image |
style | définition valide de style CSS | "border: 1px solid red; padding: 2em;" | ajoute un style CSS style à une image |
class | classe CSS | "mystyle" | force une classe d'image CSS - à n'utiliser qu'avec des thèmes personnalisés |
size | "square" - 75x75 pixels "thumbnail" - 100 sur le plus long côté "small" - 240 sur le plus long côté "medium" - 500 sur le plus long côté "large" - 1024 sur le plus long côté (seulement avec des images larges de Flickr) "original" - taille originale (seulement Flickr) |
taille permise ;-) | affiche une image redimensionnée; très bien pour les vignettes si Flickr est la source, la taille est déterminée depuis un serveur Flickr; cette option n'a d'effet que sur des images locales ou des images Flickr |
L'attribut size marche très bien avec les fichiers locaux (attachés à la page) que ce soit des images, des fichiers PDF, ou PostScript. Voir cette page pour plus de details.
La source d'image peut prendre les formes suivantes:
type de source | format | example | description |
---|---|---|---|
URL | une URL valide | http://www.example.com/image.jpg | affiche l'image à partir d'un emplacement sur le net |
fichier lié à la page courante | fichier | image.jpg | affiche l'image attachée à la page courante |
fichier lié à une autre page | nom-de-l'autre-page/fichier | une-autre-page/image.jpg | Affiche l'image attachée à une autre page |
flickr image | flickr:photoid | flickr:83001279 | Affiche l'image provenant de Flickr et établit un lien sur la page source de Flickr |
flickr image (privé) | flickr:photoid_secret | flickr:149666562_debab08866 | Affiche l'image provenant de Flickr et établit un lien sur la page source de Flickr; si secret est fournis l'image est affichée même si déclarée comme n'étant pas publique |
Pour que le document lié s'ouvre dans une nouvelle fenêtre vous pouvez, soit faire précéder link par une étoile '*' (e.g. link="*http://www.example.com") ou faire précéder l'élément src par une étoile '*' (e.g. *flickr:149666562_debab08866, *fichier-image etc.) pour les images qui générent un lien automatiquement.
Pour choisir l'alignement horizontal:
- [[=image… - image centrée
- [[<image… - image à gauche
- [[>image… - image à droite
- [[f<image… - image flottante à gauche (entourée de texte)
- [[f>image… - image flottante à droite (entourée de texte)
Galerie d' images
Pour afficher une série d'images dans une page de contenu, utilisez l'élément [[gallery]] :
[[gallery size="image-size"]]
or
[[gallery size="image-size"]]
: image-source1 attribute1="value1" attribute2="value2" ...
: image-source2 attribute1="value1" attribute2="value2" ...
...
[[/gallery]]
Le seul attribut autorisé dans la balise [[gallery]] et size avec les valeurs: "square", "thumbnail", "small", "medium".
Si la balise [[gallery]] est appelée sans une liste d'images, elle affiche automatiquement des images redimensionnées de tous les fichiers pouvant être transformés en image et attachés à la page courante.
Si la balise [[gallery]] est utilisée avec une liste d'images, seulement ces images sont affichées. Dans ce cas la source d'images ne doit pas être un URL. Les attributs autorises "par image" sont :
- link - URL ou nom de page wiki (ne marche pas avec les images de Flickr en accord avec leur termes).
- alt - texte alternatif utilisé quand l'image ne peut être affichée
Les mêmes règles que pour une image unique s'appliquent aussi ici pour que le document s'ouvre dans une nouvelle fenetre.
Si vous souhaitez utiliser des images provenant de Flickr voir aussi le module FlickrGallery
Segments de Code
Créez un segment de code en utilisant les balises [[code]]…[[/code]] (chaque balise sur sa propre ligne).
Un segment de code permet uniquement d'afficher le texte avec une coloration syntaxique et sans l'interpréter. Le code n'est pas actif, c'est seulement du texte !
Ceci est un exemple de segment de code !
Pour que la coloration syntaxique corresponde à celle du PHP encadrez votre code avec les balises en [[code type="php"]]…[[/code]]. ainsi que par les marques <?php et ?>.
WikiDot.com utilise PEAR::Text_Highlighter qui prend en charge de nombreuses configurations de coloration. Voici les types autorisés:
php, html, cpp, css, diff, dtd, java, javascript, perl, python, ruby, xml.
[[code type="php"]]
<?php
/* comment */
for($i=0; $i<100; $i++){
echo "number".$i."\n";
}
?>
[[/code]]
/* comment */ for($i=0; $i<100; $i++){ echo "number".$i."\n"; }
Tables
Vous pouvez créer des tables simples en utilisant une paire de barre verticale pour délimiter les cellules:
||~ head 1 ||~ head 2 ||~ head 3 ||
|| cell 1 || cell 2 || cell 3 ||
|||| long cell 4 || cell 5 ||
||cell 6 |||| long cell 7 ||
|||||| looong cell 8||
head 1 | head 2 | head 3 |
---|---|---|
cell 1 | cell 2 | cell 3 |
long cell 4 | cell 5 | |
cell 6 | long cell 7 | |
looong cell 8 |
|| les lignes doivent commencer et finir || avec deux barres verticales || néant||
|| les cellules sont séparées par || deux barres verticales || néant ||
|||| fusionner des cellules en débutant || chaque cellule ||
|| avec des séparateurs |||| supplémentaires||
|||||| mais peut-être un exemple est _
le meilleur moyen de voir||
les lignes doivent commencer et finir | avec deux barres verticales | néant |
les cellules sont séparées par | deux barres verticales | néant |
fusionner des cellules en débutant | chaque cellule | |
avec des séparateurs | supplémentaires | |
mais peut-être un exemple est le meilleur moyen de voir |
Pour un saut de ligne à l'intérieur d'une cellule utiliser le caractère de soulignement (_) à la fin de la ligne.(comme ci-dessus).
Alignement de Blocks
gauche, droite, centré et justifié
Pour aligner les blocs de texte selon votre choix utilisez :
[[<]] ... [[/<]] | aligner à gauche |
[[>]] ... [[/>]] | aligner à droite |
[[=]] ... [[/=]] | centrer |
[[==]] ... [[/==]] | justifier |
Ex.
[[=]]
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.\
Aenean a libero. Vestibulum adipiscing, felis ac faucibus \
imperdiet, erat lacus accumsan neque, vitae nonummy lorem \
pede ac elit.
Maecenas in urna. Curabitur hendrerit risus vitae ligula.
[[/=]]
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean a libero. Vestibulum adipiscing, felis ac faucibus imperdiet, erat lacus accumsan neque, vitae nonummy lorem pede ac elit.
Maecenas in urna. Curabitur hendrerit risus vitae ligula.
Pour centrer une seule ligne utilisez = en début de ligne :
= texte centré
texte centré
Blocks div personnalisés
Vous pouvez utiliser les balises [[div]] ... [[/div]] pour améliorer la mise en forme de vos pages. Elles sont équivalentes aux balises @div> ... </div@ utilisées en HTML.
Les seuls attributs autorisés sont: class et style néanmoins cela est largement suffisant pour obtenir la mise en page souhaitée.
Les blocs [[div]] peuvent être imbriqués.
Voici un exemple qui montre comment obtenir une mise en page en deux colonnes à l'aide des blocs [[div]] :
[[div style="float:left; width: 45%; padding: 0 2%"]]
colonne de gauche colonne de gauche colonne de gauche
colonne de gauche colonne de gauche colonne de gauche
[[/div]]
[[div style="float:left; width: 45%; padding: 0 2%"]]
colonne de droite colonne de droite colonne de droite
colonne de droite colonne de droite colonne de droite
[[/div]]
~~~~~
colonne de gauche colonne de gauche colonne de gauche colonne de gauche colonne de gauche colonne de gauche
colonne de droite colonne de droite colonne de droite colonne de droite colonne de droite colonne de droite
L'élément ~~~~ est utilisé pour annuler l'alignement et peut être interprété comme <div style="clear:both"></div>).
Les blocs [[div]] personnalisés peuvent être utilisés pour obtenir des mises en page très sophistiquées.
Math
WikiDot.com utilise LaTeX pour obtenir un beau rendu pour les équations. Ceux qui connaissent LaTeX trouveront la syntaxe utilisée par wikidot évidente.
Equations
Mettez tout simplement votre équation entre les balises [[math étiquette]] … [[/math]] (l'étiquette est optionnelle). Le rendu de l'équation sera fait par l'environnement \begin{equation} ... \end{equation} de LaTeX. Vous devez vous rapporter au manuel de LaTeX pour plus de détails sur la syntaxe.
[[math label1]]
\rho _{\rm GJ} = -\sigma (r) \left[ (1 - \eta _{\ast }^2 {\kappa \over {\eta ^3}}) \cos \chi \right.
+ \left. {3\over 2} \theta (\eta) H(\eta)
\xi \sin \chi \cos \phi \right]
[[/math]]
Pour se référer à une equation qui a une étiquette utilisez [[eref étiquette]] pour obtenir un numéro brut ou Eq. ([[eref label1]]) qui donne Eq. (1).
Des math dans la ligne
Pour mettre des expressions mathématiques à l'intérieur d'une phrase utilisez les balises [[$ ... $]].
[[$ E = mc^2 $]] est bien plus connu que
[[$ G_{\mu\nu} - \Lambda g_{\mu\nu} = \kappa T_{\mu\nu} $]]
$E = mc^2$ est bien plus connu que $G_{\mu\nu} - \Lambda g_{\mu\nu} = \kappa T_{\mu\nu}$
Notes de bas de page
Pour inclure des notes de bas de page dans votre texte, vous devez utiliser le bloc [[footnote]]. Pour faire apparaître les notes à un emplacement autre que le bas de page, utilisez le bloc [[footnoteblock]] à l'endroit désiré.
Un peu de texte[[footnote]]et la petite note qui apparaîtra dans le bloc.[[/footnote]]. Et on continue avec une deuxième note[[footnote]]contenu de la deuxième note.[[/footnote]].
[[footnoteblock]]
Un peu de texte1. Et on continue avec une deuxième note2.
Si le titre par défaut ("Footnotes") ne vous convent pas, vous pouvez en inclure un de votre cru en utilisant [[footnoteblock title="Titre personnalisé"]] ou si vous ne voulez pas utiliser de titre (title="").
Bibliography
The bibliography block is defined by [[bibliography]]...[[/bibliography]]. Each bibliography item has the form:
label : full reference
To cite a bibliography entry use ((bibcite label)).
The first pulsar was observed by J. Bell and A. Hewish [((bibcite bell))]. Another reference [see ((bibcite guy))].
[[bibliography]]
: bell : Bell, J.; Hewish, A.; Pilkington, J. D. H.; Scott, P. F.; and Collins, R. A. //Observation of a Rapidly Pulsating Radio Source.// Nature 217, 709, 1968.
: guy : Guy, R. K. //Modular Difference Sets and Error Correcting Codes.// §C10 in Unsolved Problems in Number Theory, 2nd ed. New York: Springer-Verlag, pp. 118-121, 1994.
[[/bibliography]]
The first pulsar was observed by J. Bell and A. Hewish [1]. Another reference [see 2].
If you are not satisfied with the default title ("Bibliography") you can force your own title by using [[bibliography title="Custom title"]] or even do not use title at all (title="").
Include other pages
If you want to include contents of another page use:
[[include pagename]]
The include tag should start and end with a newline.
The [[include]] tag can also take parameters and substitute variables in the included source. To denote variables in the included page use:
{$var1}, {$number_books}, {$title}, {$variable_name}, {$variableName}
and in the including page use:
[[include pagename var1=value1 | number_books = 43 | title=Best Wiki Ever
| variable_name = just a variable
| varibaleName = another variable
]]
As you can see you can splid variable definitions over several lines for cleaner code.
Embedding media
Video
To embed video directly into the page use [[embedvideo]] ... [[/embedvideo]] block.
Between the the "embedding html code" should be placed from any of the following video online galleries:
E.g.
[[embedvideo]]
<embed style="width:400px; height:326px;" id="VideoPlayback" align="middle"
type="application/x-shockwave-flash"
src="http://video.google.com/googleplayer.swf?docId=263244138622602613"
allowScriptAccess="sameDomain" quality="best" bgcolor="#ffffff" scale="noScale" salign="TL"
FlashVars="playerMode=embedded"> </embed>
[[/embedvideo]]
Audio
To embed audio use [[embedaudio]] ... [[/embedaudio]] and the html embedding code found on the audio hosting website.
Currently supported are:
E.g.
[[embedaudio]]
<embed src="http://www.odeo.com/flash/audio_player_standard_gray.swf"
quality="high" width="300" height="52" name="audio_player_standard_gray"
align="middle" allowScriptAccess="always" wmode="transparent"
type="application/x-shockwave-flash" flashvars="audio_id=99133&audio_duration=282.0&valid_sample_rate=true&external_url=http://www.vitalpodcasts.com/FileSystem/podcasts/89/opensource_episode1.mp3" pluginspage="http://www.macromedia.com/go/getflashplayer" />
</embed><br /><a style="font-size: 9px; padding-left: 110px; color: #f39;
letter-spacing: -1px; text-decoration: none" href="http://odeo.com/audio/99133/view">
powered by <strong>ODEO</strong></a>
[[/embedaudio]]
Embedding code from other sites
Sometimes web sites (mainly social-oriented ones) allow you to paste a code block directly into other pages in order to increase your site functionality or embed some contet from the original site.
The [[embed]] block tag allows you to do the same with your wiki pages. E.g. to display del.icio.us tag cloud as generated from http://del.icio.us/help/tagrolls simply wrap the html code:
[[embed]]
<script type="text/javascript" src="http://del.icio.us/feeds/js/tags/michal_frackowiak?icon;size=12-35;color=87ceeb-0000ff;title=my%20del.icio.us%20tags"></script>
[[/embed]]
For the list of supported services please see the page: Embedding code from other services.
Please note that if the code contains <script type="text/javascript"… i.e. just JavaScript, the content will not be fully rendered when you click preview while editing the page. It should be there however when you view the page afterwards.
Iftags
Tags are kind of special labels for a page, manually added in by editors by clicking on the tags link at the page options buttons on bottom of a page. Every tag can be max 64 characters long, tags are "space" separated and there is no limit of tags per page. Tags are very useful to label pages and then it's easy to create Tag Cloud, which allow to find interesting pages or topics much faster.
Special tags start with an underline: they are not automatically shown in tag clouds, but they can be used as special limitations in [[iftag]] conditions. Tags can be used in ListPages Module with generic conditions ( +, - ) too.
Iftag is a special condition question. You can use it on every page to "react" on tags and set up on the particular page used .
Syntax:
[[iftags +tag1 -tag2 tag3]] ... [[/iftags]]
where the +/-"tag#" stands for the requested tag-indexes.
- + before a tagname means - this tag must exist, (tag without a modifier works in a same way)
- - before a tagname means - this tag must not exist.
Example:
[[iftags +science]]
This page is labeled as: science.
Click here to view more science articles >
[[/iftags]]
[[iftags +bug -fixed]]
This is a bug, but it's not fixed yet.
[[/iftags]]
Modules
Modules are independent widgets that can be placed in the pages. The general syntax is:
[[module ModuleName param1="value1" param2="value2" ...]]
To read more about modules see the doc:modules section of the documentation.
Attached files
what you type | what it means |
---|---|
[[file filename]] | produces a link to a file attached to this page |
[[file /another-page/filename]] | produces a link to a file attached to another-page |
The destination file must be first attached to the page — by clicking "files" and "upload file" from the options at the bottom of any page.
Users
what you type | what you get | comments |
---|---|---|
[[user user-name]] e.g. [[user michal frackowiak]] |
michal-frackowiak | user info (no buddy icon) |
[[*user user-name]] e.g. [[*user michal frackowiak]] |
michal-frackowiak | user info (with buddy icon) |
Social bookmarking
It is easy to add "social bookmarking" buttons to your pages — just write [[social]] (without any parameters) and get:
This is equivalent to:
[[social blinkbits,blinklist,blogmarks,co.mments,connotea,del.icio.us,de.lirio.us,digg,fark,feedmelinks,furl,linkagogo,ma.gnolia,newsvine,netvouz,rawsugar,reddit,scuttle,shadows,simpy,smarking,spurl,tailrank,wists,yahoomyweb]]
You can also choose only selected services, e.g. to choose digg, furl and del.icio.us use:
[[social digg,furl,del.icio.us]]
and get:
Tip: use social bookmarking! It is always a good idea to put social shortcuts under an article or inside your side bar.