Wrap : syntaxe
Syntaxe de base
<WRAP classe largeur :langage> "gros" contenu </WRAP>
Un <WRAP> majuscule crée un div (balise html) et doit être utilisé pour les “gros” conteneurs, encadrés de paragraphes, listes, tableaux, etc.
<wrap classe largeur :langage>"petit" contenu</wrap>
un <wrap> minuscule crée un span et doit être utilisé pour des “petits” conteneurs, à l'intérieur des paragraphes, listes, tableaux, etc.
Faites attention, certaines choses ne marcheront pas avec des <wrap> minuscules: les alignements et les largeurs si le wrap correspondant n'est pas flottant lui aussi.
Classes
Les classes suivantes sont actuellement disponibles :
| nom de classe | description/notes | |
|---|---|---|
| colonnes | ||
column | left pour les langues qui se lisent de la gauche vers la droite et right pour le reste | |
left | place le conteneur à gauche | |
right | place le conteneur à droite | |
center | place le conteneur au centre de la page | |
| alignements – ne fonctionne pas avec les petits wraps | ||
leftalign | aligne le texte à gauche | |
rightalign | aligne le texte à droite | |
centeralign | centre le texte | |
justify | justifie le texte (met un alinéa) | |
| boites et notes | ||
box | crée une boîte (utilise les couleurs du fichier de configuration du thème, à savoir style.ini) | |
info | crée une boîte bleue avec une icône d'information | |
important | crée une boîte orange avec une icône « important » | |
warning | crée une boîte rouge avec une icône d'avertissement | |
tip | crée une boîte jaune avec une icône d'astuce | |
help | crée une boîte violette avec une icône d'aide | |
todo | crée une boîte couleur cyan avec une icône « todo » (à faire) | |
download | crée une boîte verte avec une icône de téléchargement | |
round | ajoute des coins ronds à n'importe quel conteneur avec un fond spécial ou une bordure (ne marche pas avec le navigateur Internet Explorer, bien connu pour son non-respect des normes) | |
| marques | ||
hi | surligne le texte | |
lo | indique que le texte est moins important | |
em | met le texte en italique | |
| typographie (non recommandé) | ||
sansserif, serif, monospace | change la police utilisée | |
bigger, muchbigger, smaller | change la taille de police | |
fgred, fggreen, fgblue, fgcyan, fgviolet, fgyellow, fggrey, fgwhite, fgblack | change la couleur de police | |
bgred, bggreen, bgblue, bgcyan, bgviolet, bgyellow, bggrey, bgwhite, bgblack | change la couleur de fond | |
| divers | ||
clear | ferme les float, doit être utilisée avec les <WRAP> majuscules | |
hide | cache le texte avec du CSS (le texte apparaîtra dans le code source, dans les très vieux navigateurs, et peut être recherché) | |
pagebreak | force le saut de page lors de l'impression (invisible lors de la navigation) | |
spoiler | affiche du texte blanc sur un fond blanc, qui n'est donc révélé que si on le sélectionne à la souris | |
indent | Indente le texte (4 espaces insécables) | |
outdent | permet de supprimer l'indentation automatique de Dokuwiki | |
Tous les tableaux dans une colonne ou une boîte prendront toujours 100% de la largeur. Cela permet de positionner les tableaux et de choisir leur taille.
Problèmes connus
- Les icônes en PNG qui utilisent une transparence rendront mal sous IE6 (Internet Explorer 6).
- Les coins ronds ne fonctionnent pas avec les navigateurs trop anciens (et avec IE).
- Après l'ouverture d'un <WRAP> une ligne vide est requise avant le contenu, sans quoi il n'y aura pas de paragraphe, ce qui peut donner des résultats indésirables (cette ligne est requise partout, sauf dans
clearethide). - Les titres habituels de Dokuwiki ne fonctionneront pas dans la syntaxe des plugins.
Largeur
Vous pouvez choisir n'importe quel type de largeur sur les <WRAP> majuscule : %, px, em, ex, pt, pc, cm, mm, in. Réglez la largeur avant, après ou pendant le choix des classes de votre conteneur, par exemple
<WRAP uneclasse 50% uneautreclasse>...
Langues et direction du texte
Vous pouvez choisir la langue et la direction du texte dans un conteneur en ajoutant simplement un « : » suivi du code de la langue, comme ceci :
<wrap :en>Ce texte est marqué comme anglais</wrap>
La direction du texte (rtl, right to left en anglais, c'est à dire de la droite vers la gauche, et ltr, l'inverse) sera ajustée automatiquement selon le langage choisi. La liste des langages reconnus par Dokuwiki vient de :
http://meta.wikimedia.org/wiki/Template:List_of_language_names_ordered_by_code
Si vous voulez un texte avec un alignement différent de celui par défaut, vous devez utiliser le <WRAP> majuscule.