
Page à supprimer (voir le Guide d édition Wiki)
Avant-propos : alors voilà vous avez édité votre première page en suivant ces quelques premiers conseils. À présent, vous aimeriez bien aller plus loin dans la mise en page, ou pouvoir contrôler l'affichage d'une image ou que sais-je encore. Vous trouverez ici un ensemble de commandes TikiWiki qui vous permettront de faire de l'édition avancée.
Table des matières
Organisation la page
Table des matières
La table des matières peut possèder des arguments, par exemple son nom :code:
{maketoc title="Le nom que je veux pour la table des matières"}
rendu:


Les listes et leurs puces
Pour les puces, il faut utiliser la balise*
(étoile) et elle se comporte exactement de la même manière que la balise !
de titre. Ainsi :
*puce de niveau 1 |
|
Il est important de noter que tout retour à la ligne arrête la tabulation de la puce. Il est possible de forcer l'indentation de la ligne suivant la puce en ajoutant la balise
+
(plus) en début de ligne. Il faut autant de balises +
que de balises *
. Ainsi :
**puce 2 ++du texte bien tabulé **puce 2 +du texte mal tabulé *puce 1 du texte non tabulé *puce 1 +du texte tabulé **puce 2 +du texte tabulé de niveau 1 +du texte non tabulé |
+du texte non tabulé |
Les listes numérotées et leurs puces
Il est possible de créer des puces numérotées en utilisant la balise#
(dièse) au lieu de la balise *
.Exemple :
#Première puce numérotée |
|
Pour tabuler les lignes comme les puces, on peut ici aussi utiliser la balise
+
.Masquer le contenu
Il peut être intéressant de masquer le texte contenu sous un titre ou derrière une puce parce qu'il est très long (Très utile pour les logs dans les forums par exemple).Dans ce cas il faut associer aux balises "!" (titre), "*" (puce) ou "#" (puce numérotée) un "+" (plus) ou un "-" (moins) juste après.
Le masque sera actif jusqu'au titre suivant ou sur toute la tabulation de la puce. La balise "+" affichera le contenu par défaut mais permet de le masquer. La balise "-" masque le contenu par défaut mais permet de l'afficher. Ainsi :
code :
!!!-Titre 3 masqué par défaut *+puce affichée par défaut. +Ce texte est aussi affiché par défaut. !!!+Titre 3 affiché par défaut #-puce masquée par défaut. +Ce texte est aussi masqué par défaut.
rendu :
Titre 3 masqué par défaut
[+]Titre 3 affiché par défaut
[-]Les balises CODE
Afin de mettre en avant les commandes ou les logs, on utilise les balises{CODE()}
et {CODE}
.
{CODE()}Un peu de code{CODE} |
Un peu de code |
Les balises QUOTE
Pour insister sur une citation, on utilise les balises{QUOTE()}
et {QUOTE}
.
{QUOTE()}Citation{QUOTE} |
Citation : Citation |
Les BOX
Il est possible de créer des boites de couleurs dans lesquelles on peut mettre du texte afin d'attirer l'attention du lecteur. Ceci se fait à l'aide des balisesBOX
.
{BOX(align=center, bg=>#ffce89, width=>80%)} Le texte à mettre en valeur dans une boite sans titre.{BOX} |
<br />
Le texte à mettre en valeur dans une boite sans titre. |
{BOX(title=>Une boite, : align=center, bg=>#ffce89, width=>80%)} Le texte à mettre en valeur dans une boite avec titre.{BOX} |
Une boite : <br />
Le texte à mettre en valeur dans une boite avec titre. |
Il existe plusieurs attributs qui permettent de régler la
BOX
. Les voici :-
title
: permet d'indiquer le titre, -
align
: règle l'alignement à droite (right
), à gauche (left
), au centre (center
), -
bg
: règle la couleur de laBOX
; il faut utiliser son code HTML ou des valeurs sûres (green, blue,...
), -
width
: règle sa largeur par rapport à la largeur de la page (en pourcentage ou en pixels).
Pour forcer un passage à la ligne dans une box, il faut utiliser la balise %%%. Voir l'exemple :
{BOX(align=center, bg=>#ffce89, width=>80%)} Attention %%%au retour à la ligne.{BOX} |
<br />
Attention au retour à la ligne. |
On a vu la boite qui s'étire ou s rétracte en fonction de l'afichage de la résolution de l'écran
{BOX(align=center, width= auto)}On a vu la boite qui s'étire ou s rétracte en fonction de l'afichage de la résolution de l'écran{{BOX}
Autre variante: boite gauche
Autre variante: boite droite
{DIV(width=49%, float=right)} {BOX(align=center, width= auto)} Autre variante: boite gauche {BOX}{DIV} {DIV(width=49%, float=left)} {BOX(align=center, width= auto)}Autre variante: boite droite {BOX} {DIV}
Les boites gigognes tu connais ?

Plus complexe...


Aide toi du surligneur de syntaxe 

{BOX(align=center, width= auto)}::{BOX(align=center, bg=#F6FAFB, width=150px)}Les boites gigognes tu connais ?{BOX}:: {DIV(width=49%, float=right)}{BOX(align=center, bg=#F6FAFB, width= auto)}{attention message="Plus complexe..."}{BOX}{DIV} {DIV(width=49%, float=left)}{BOX(align=center, bg=#F6FAFB, width= auto)}{ASTUCE(close=y)}Aide toi du surligneur de syntaxe (:wink:){ASTUCE} {BOX} {DIV}{BOX}
Mise en forme
Barré, exposant, indice,... - TAG
On a déjà vu les bases du formatage de texte ici. Vous trouverez donc dans cette rubrique toutes les techniques plus complexes pour des mises en forme de texte plus raffinées.
Vous trouverez ci-dessous quelques exemples qui utilisent la balise TAG :
1{TAG(tag=>sup)}ère{TAG} fois que je vois ca ! |
1ère fois que je vois ca ! |
En {TAG(tag=>sub)}dessous{TAG} de la ligne |
En dessous de la ligne |
on peut aussi ajouter un style html comme argument : {TAG(tag=sup, style=color:#FF0000)}exposant rouge{TAG} |
exposant rouge |
Voir la doc sur TikiWiki.org

Espaces insécables
Recommandés en typographie, on utilise des espaces insécables entre du texte et certaines ponctuations comme :, ?, !, ; par exemple. Cela signifie que lors d'un renvoi à la ligne, il est impossible de séparer le texte de cette ponctuation et vous permettront donc d'éviter que ces signes ne se retrouvent en début de ligne. Il faut utiliser la balise~hs~
.
On passe à la ligne tranquillement sans séparer ce~hs~:~hs~du texte autour de lui. |
On passe à la ligne tranquillement sans séparer ce : du texte autour de lui. |
Caractères spéciaux
lorsque pour une raison ou pour une autre (à cause d'un code tiki trop compliqué), votre mise en forme ne s'affiche pas correctement, vous pouvez souvent remplacer certains caractères critiques par leur code tikiwiki.Remplacez simplement ce caractère par son numéro entouré de "~".
exemple de code :
donnez des ~128~ à LinuxMAO !
résultat :
donnez des à LinuxMAO !
[+]
Créer des tableaux
Pour créer des tableaux on utilise la balise|
(barre verticale, Alt Gr+6 sur un clavier AZERTY). Deux balises |
marquent le début et la fin du tableau. Ensuite pour chaque case on utilise une seule balise. La balise %%%
permet de passer à la ligne.
|| Une belle table Ligne 1 | case | case Ligne 2 | case%%%à la ligne | case Ligne 3 | case || |
|
Notez que les cases partielles qui occupent l'espace de plusieurs colonnes comme à la ligne 3 ne peuvent qu'apparaître qu'à droite du tableau.
Créer un tableau type listing
{FANCYTABLE(head="liste|catégorie|lien|et/ou |tout ce que|tu veux|y voir", sortable=y)} liste|catégorie|lien|et/ou |tout ce que|tu veux|y voir liste|catégorie|lien|et/ou |tout ce que|tu veux|y voir {FANCYTABLE}
liste | catégorie | lien | et | tout ce que | tu veux | support |
---|---|---|---|---|---|---|
liste | catégorie | lien | et/ou | tout ce que | tu veux | y voir |
liste | catégorie | lien | et/ou | tout ce que | tu veux | y voir |
{FANCYTABLE(head="la|même|en|tableau|simple", sortable=n)} lien|et/ou |tout ce que|tu veux|y voir lien|et/ou |tout ce que|tu veux|y voir {FANCYTABLE}
la | même | en | tableau | simple |
---|---|---|---|---|
lien | et/ou | tout ce que | tu veux | y voir |
lien | et/ou | tout ce que | tu veux | y voir |
Créer des colonnes de texte - SPLIT
Très pratique pour écrire plusieurs colonnes de texte. On utilise la balise {SPLIT}. On peut définir la largeur des colonnes en pixels en utilisant l'attributcolsize
. L'exemple ci-dessous propose de créer 2 colonnes de 150 et 50 pixels de large.
{SPLIT(colsize=>150|50)}Ce texte est dans la première colonne de taille 150. --- Ce texte est dans la deuxième colonne de taille 50.{SPLIT} |
|
Définitions
Il existe de la syntaxe pour les définitions. Tiki nous offre 2 manières de procéder. Une rapide et simple et une un peu plus complexe.La simple :
;Terme 1 à définir:Définition du terme 1 ;Terme 2 à définir:Définition du terme 2 |
|
Si le même terme possède plusieurs définitions utilisez alors plutôt :
La complexe :
Elle s'écrit et s'affiche comme suit : (DL = definition list)
|
|
Images
Une fois que vous aurez fait une belle image, il vous faudra l'envoyer sur le site et l'intégrer dans votre page, voici des consignes et explications.Charger une image
Pour charger une image, les principes de base sont expliqués sur cette page. Il est simplement rappelé qu'il faut utiliser le bouton "image" dans la barre d'édition, qui créera une balise de la forme {IMG(fileId="ID de votre image")}{IMG} avec un certains nombre d'autres arguments/options.
Quelques options a considérer :
- vignette (thumb)
- popup : possibilité de cliquer sur l'image la voir dans un nouvel onglet en plein écran (thumb="popup")
- largeur de l'image (width)
Il est préférable, dans le cas de grosses images, de limiter leur largeur dans la page, quitte à devoir recourir à l'option "vignette" en complément pour un zoom plus détaillé.
400 (pixels) est une valeur encouragée, 600 une limite maximum. (width="400") - caption (desc)
Description/légende affichée en dessous de l'image (desc="ma photo de studio")
{IMG(fileId="XXX","thumb="popup",width="400",desc="ma photo de studio")}{IMG}
Liens
Liens internes
On en a déjà parlé ici mais maintenant place aux subtilités. On rappelle qu'un lien est dit interne si il pointe vers une page qui fait partie de linuxMao.org. D'ailleurs lorsque le lien est interne, il s'affiche en orange.Pour comprendre le fonctionnement des liens internes, il faut observer l'URL de la page que l'on souhaite linker. Prenons pour exemple cette page :
http://www.linuxmao.org/tikiwiki/tiki-index.php?page=GlossaireA
l'adresse se décompose en trois parties importantes :
http://www.linuxmao.org/tikiwiki/tiki-index.php?page=GlossaireA
- La partie en vert correspond à l'adresse du site
- Celle en bleu à la partie du site concernée, cela peut être un wiki, un forum, une FAQ...
- La dernière partie en rouge correspond ici au nom de la page wiki
Lien sur la page elle même
Il est très facile de faire un lien rapide sur une page wiki, il suffit de mettre son nom entre des doubles parenthèses comme ceci :((GlossaireA))
résultat : GlossaireA
Pour le rendre plus joli à la lecture, on peut rajouter une barre verticale et changer le nom affiché par le lien comme ceci :
((GlossaireA|Page A du glossaire))
résultat : Page A du glossaire
On peut aussi linker de manière équivalente une page du wiki en utilisant les deux dernières parties de l'url, mais cette fois-ci on utilisera les crochets.
Par exemple
[tiki-index.php?page=GlossaireA]
donne tiki-index.php?page=GlossaireA.En changeant le nom visible du lien :
[tiki-index.php?page=GlossaireA|Page A du glossaire]
donne Page A du glossaire.Cette technique n'est pas très intéressante pour linker sur des pages du wiki, mais elle peut être utilisée pour autre chose, comme le forum par exemple.
Ainsi le fil de forum a l'adresse
http://www.linuxmao.org/tikiwiki/tiki-view_forum_thread.php?comments_parentId=17549&forumId=28
se linkera ainsi :
[tiki-view_forum_thread.php?comments_parentId=17549&forumId=28]
ou ainsi :
[tiki-view_forum_thread.php?comments_parentId=17549&forumId=28|mon fil de forum]
ce qui donne :
mon fil de forum
Lien sur un paragraphe
Vous souhaitez peut être que votre lien n'envoie pas au début d'une page, mais sur un endroit/paragraphe en particulier ? Pas de problème, vous l'aurez constaté, TikiWiki est très complet, c'est possible !Cet endroit particulier sur lequel vous voulez renvoyer votre lien s'appelle un point d'ancrage. Pour pouvoir arriver à vos fins, il vous faut d'abord le définir et connaitre son nom, il existe pour cela deux alternatives :
- les titres
Vous avez déjà appris comment créer un titre dans une page, avec le caractère ! en début de ligne. Chaque titre crée automatiquement un point d'ancrage dont le nom est le titre du paragraphe lui-même. Par exemple, vous êtes en ce moment en train de lire le sous-sous-paragraphe "Lien sur un paragraphe" - la balise "ANAME"
Vous pouvez aussi définir un point d'ancrage partout ailleurs dans une page. Pour cela, insérez dans le code de la page à l'endroit voulu une balise du typeANAME
. La syntaxe a utiliser est la suivante{ANAME()}mon point d'ancrage{ANAME}
. Cette balise est invisible à la lecture de la page, et à pour nom "mon point d'ancrage"
Maintenant, comment créer un lien renvoyant à votre point d'ancrage ? Rien de plus facile ! Vous venez d'apprendre qu'un lien sur une page wiki a la forme
((ma page))
ou même ((ma page|nom affiché))
.Un lien sur un point d'ancrage a une forme similaire :
((ma page|#mon point d'ancrage))
ou alors ((ma page|#mon point d'ancrage|nom affiché))
(notez le # avant le nom du point d'ancrage).
Exemple :
Le lien suivant va renvoyer sur la page "SITE_fonctionnement_wiki_editer_expert" (la page que vous lisez en ce moment même), au point d'ancrage "Lien sur un paragraphe" (la section qui porte ce titre est celle que vous lisez en ce moment même).
Ce code
((SITE_fonctionnement_wiki_editer_expert|#Lien sur un paragraphe))
donnera
SITE_fonctionnement_wiki_editer_expert.
En modifiant le nom visible du lien, ce code
((SITE_fonctionnement_wiki_editer_expert|#Lien sur un paragraphe|mon paragraphe))
donnera
mon paragraphe.
Il existe une deuxième manière de créer un lien sur un point d'ancrage. On peut pour cela utiliser la balise
{ALINK()}
(généralement utilisée avec la balise "ANAME" dont je vient de parler).Elle s'utilise de la manière suivante :
{ALINK(aname=nom du point d'ancrage,pagename=nom de la page)}nom visible du lien{ALINK}
Pour cet exemple, j'ai créé en bas de page un point d'ancrage dont le code est
{ANAME()}bas de page{ANAME}
.La balise {ALINK()} correspondante sera donc
{ALINK(aname=bas de page,pagename=SITE_fonctionnement_wiki_editer_expert)}cliquez pour essayer{ALINK}
qui donne cliquez pour essayer.
Dans le cas où le lien et le point d'ancrage sont sur la même page, vous pouvez même omettre le nom de page :
{ALINK(aname=bas de page)}cliquez pour essayer{ALINK}
.Méthode alternative :
Dans le cas ou le paragraphe à linker est dans la même page que le lien, on peut écrire :
[#Lien_sur_un_paragraphe|Lien sur un paragraphe] ? Lien sur un paragraphe
Liens spéciaux :
[#tiki-top|retour en haut de page] (barre de menu incluse) ? retour en haut de page
[#top|retour en haut de page] (barre de menu non-incluse) ? retour en haut de page
[#toc|retour au sommaire] ? retour au sommaire
Liens externes
Pour les liens externes, ce n'est pas beaucoup plus compliqué. Il faut mettre l'adresse du lien entre crochets, soit[http://www.ubuntu-fr.org]
donne http://www.ubuntu-fr.org
ATTENTION : il y a une petite subtilité. Si l'adresse du lien commence par
http://
alors TikiWiki comprend qu'il s'agit d'un lien externe et l'interprète comme tel. En revanche si l'adresse ne commence pas par http://
alors TikiWiki peut l'interpréter de trois manières :- comme du texte, si l'adresse n'est pas entourée de crochets,
- comme un lien interne si l'adresse est entourée de crochets,
- comme un lien externe si l'adresse commence par
www
.
Quelques exemples :
http://jamin.sourceforge.net/en/about.html |
http://jamin.sourceforge.net/en/about.html![]() |
[http://jamin.sourceforge.net/en/about.html] |
http://jamin.sourceforge.net/en/about.html![]() |
jamin.sourceforge.net/en/about.html | jamin.sourceforge.net/en/about.html : texte brut |
[jamin.sourceforge.net/en/about.html] | jamin.sourceforge.net/en/about.html : lien interne |
www.ubuntu-fr.org |
www.ubuntu-fr.org![]() |
[www.ubuntu-fr.org] | www.ubuntu-fr.org : lien interne |
Les liens externes s'affichent en bleu et les liens internes s'affichent en orange. Vous pouvez constater qu'il y a parfois des confusions dans l'interprétation par TikiWiki. En fait, on peut carrément dire que c'est le bordel !

Les conseils de LinuxMao.org :
Pour faire un lien externe et éviter tout problème, nous vous conseillons fortement : d'utiliser l'adresse complète du lien et de l'encadrer par des crochets comme :
[http://www.monsite.org/le_lien.html]
Ainsi vous éviterez les confusions d'interprétation lien interne / lien externe, les problèmes de lien cassé ou qui ne fonctionnent pas. Et en plus ça vous permet de renommer le lien. Voir ci-dessous.
Renommer les liens
Il est parfois intéressant de renommer un lien surtout s'il est long. On peut alors créer un alias. Cela fonctionne avec les liens internes et les liens externes. Il faut pour cela utiliser la balise | (barre verticale). Entre les doubles parenthèses ou les crochets, on écritadresse_du_lien|alias
.Donc :
- avec les crochets :
[http://www.ubuntu-fr.org|notre site préféré après linuxMao]
donnera le lien vers notre site préféré après linuxMao.
- ou avec les double-parenthèses :
((jack|notre serveur son préféré))
donnera le lien vers notre serveur son préféré.
À noter : si l'adresse vers laquelle le lien doit pointer contient le caractère | (barre verticale), alors vous allez avoir un problème ! Pour le contourner, vous devez remplacer ce caractère par son code html qui est %7C. Par exemple l'adresse
http://fr.audiofanzine.com/carte-son-externe/alesis/iO|2
contient une barre verticale (avant-dernier caractère). Voici son comportement :- sans remplacer la barre verticale :
[http://fr.audiofanzine.com/carte-son-externe/alesis/iO|2]
donne 2 - en remplaçant la barre verticale :
[http://fr.audiofanzine.com/carte-son-externe/alesis/iO%7C2]
donne http://fr.audiofanzine.com/carte-son-externe/alesis/iO%7C2
De la même manière, certains liens comportant des accents et autres caractères spéciaux ne fonctionnent pas correctement avec certains modules (vu avec les images en page d'accueil), il faut alors encoder les caractères litigieux.
On peut trouver un encodeur d'url sur la page http://www.blooberry.com/indexdot/html/topics/urlencoding.htm

Divers
Pour aller encore plus loin
Pour d'autres astuces d'édition, vous pouvez aller voir sur la documentation officielle de TikiWiki
Et de manière plus générale, la documentation des fonctionnalités

Mais normalement avec ce que vous venez de lire, vous devriez pouvoir écrire intégralement ce petit tutoriel. En effet tout ce que vous y avez lu y est mis en œuvre !

Si vous vous posez une question à propos de ceci, rendez-vous dans le forum : "Le site : philosophie, organisation, problèmes, ..." afin de discuter ensemble.

D'autre part, cette page est verrouillée à l'écriture et est modifiable uniquement par les administrateurs de LinuxMAO. Si vous pensez que quelque chose devrait y figurer ou bien, si quelque chose n'est pas clair et que ça mérite ré-écriture ou alors, si vous voyez une faute, ou que-sais-je-encore, ... etc, vous pouvez laisser un commentaire en bas de la page.
Bienvenue en bas de page ! Ce bas de page sert d'exemple pour la description des liens internes. Si vous souhaitez remonter au paragraphe sur les liens interne, cliquez ICI.