Accueil des "Wiki associés aux listes de diffusion"

Utilisation avancée

Divalign : Alignement de texte

Syntaxe

à gauche :
#;; Ce texte doit être aligné à gauche. #;;

à droite :
;;# Ce texte doit être aligné à droite. ;;#

au centre :
;#; Ce texte est centré ;#;

Résultat

à gauche :

#;; Ce texte doit être aligné à gauche. #;;

à droite :

;;# Ce texte doit être aligné à droite. ;;#

au centre :

;#; Ce texte est centré ;#;

Styler : Alignement de texte, seconde méthode

Syntaxe

à gauche :
<style left>//Ce texte doit être aligné à gauche.//</style>

à droite :
<style right>//Ce texte doit être aligné à droite.//</style>

au centre :
<style center>//Ce texte doit être centré.//</style>

justifié :
<style justify>//Ce texte doit être justifié Ce texte doit être justifié Ce texte doit être justifié Ce texte doit être justifié Ce texte doit être justifié Ce texte doit être justifié .//</style>

pour créer un block à gauche du texte :
<style float-left>//**Ce bloc doit être à gauche.**//</style> Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte 

pour créer un block à droite du texte :
<style float-right>//**Ce bloc doit être à droite.**//</style> Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte

pour créer un block encadré à gauche du texte :
<style float-left box>//**Ce bloc doit être à gauche et encadré.**//</style> Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte 

pour créer un block encadré à droite du texte :
<style float-right box>//**Ce bloc doit être à droite et encadré.**//</style> Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte 

pour créer un block encadré avec un fond à gauche du texte :
<style float-right box background>//**Ce bloc doit être à gauche, encadré avec un fond.**//</style> Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte

pour créer un block encadré avec un fond, à droite du texte :
<style float-left box background>//**Ce bloc doit être à droite, encadré avec un fond.**//</style> Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte

Résultat

à gauche :

Ce texte doit être aligné à gauche.

à droite :

Ce texte doit être aligné à droite.

au centre :

Ce texte doit être centré.

justifié :

Ce texte doit être justifié Ce texte doit être justifié Ce texte doit être justifié Ce texte doit être justifié Ce texte doit être justifié Ce texte doit être justifié .

pour créer un block à gauche du texte :

Ce bloc doit être à gauche.

Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte

pour créer un block à droite du texte :

Ce bloc doit être à droite.

Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte

pour créer un block encadré à gauche du texte :

Ce bloc doit être à gauche et encadré.

Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte

pour créer un block encadré à droite du texte :

Ce bloc doit être à droite et encadré.

Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte

pour créer un block encadré avec un fond à gauche du texte :

Ce bloc doit être à gauche, encadré avec un fond.

Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte

pour créer un block encadré avec un fond, à droite du texte :

Ce bloc doit être à droite, encadré avec un fond.

Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte Bloc de texte

Color : pour mettre du texte en couleur

Permet de mettre du texte en couleur…

Syntaxe

  • <color blue>Du bleu</color> : Du bleu
  • <color red>Du rouge</color> : Du rouge
  • <color green>Du vert</color> : Du vert
  • <color yellow>Du jaune</color> : Du jaune

ou bien avec les codes couleur hexadécimaux :

  • <color #003DF5>Du bleu</color> : Du bleu
  • <color #FF0000>Du rouge</color> : Du rouge
  • <color #75FF47>Du vert</color> : Du vert
  • <color #FFFF00>Du jaune</color> : Du jaune

Highlight : pour surligner du texte

http://wiki.splitbrain.org/plugin:highlight
Permet de surligner du texte en couleur…

Syntaxe

Vous encadrez le texte que vous souhaitez surligner avec les balises and . Le type de valeur pour les couleurs peut être :

  1. Une valeur de couleur hexadécimale à 3 ou 6 caractères [ eg. #E8E ou #7fffd4 ]
  2. Un nom de couleur standard [ eg. white, black, aqua ]
  3. Une valeur de couleur RGB décimale ou en pourcentage [ eg. rgb(55%, 35%, 25%), rgb(255, 0, 255) ]

Si la couleur n'est pas spécifiée, Le jaune est utilisé par défaut (#FF0)

Exemples

  • <hi cyan>Cyan highlight</hi> : Cyan highlight
  • <hi>highlight par défaut avec **du texte en gras** </hi> : highlight par défaut avec du texte en gras
  • <hi #e0e>3-hex magenta highlight</hi> : 3-hex magenta highlight

Numbered headings : pour numéroter les titres

Syntaxe

Il suffit juste de rajouter un - devant le titre :

====== - Titre niveau 1 ======
===== - Titre niveau 2 =====
==== - Titre niveau 3 ====
==== - Titre niveau 3 ====
===== - Titre niveau 2 =====
==== - Titre niveau 3 ====

Ce qui donne (ici sans la mise en forme) :

1 Titre niveau 1
  1.1 Titre niveau 2
    1.1.1 Titre niveau 3
    1.1.2 Titre niveau 3
  1.2 Titre niveau 2
    1.2.1 Titre niveau 3

box : pour faire de jolies boites ! :o)

http://wiki.splitbrain.org/plugin:boxes
Permet de faire des “boites”, tout ce que vous pouvez faire est en dessous :

Syntaxe

++++ Voir le code |

<box>[[services:wiki:the_most_basic_box]]</box>

<box red|Boxed & //titled// > this is
also 
boxed
</box>

<box green> this is
also 
boxed
</box|boxed & captioned>

<box round orange>as is this</box>

<box round 75% | title **with //fo''rma''tt//ing**, a [[services:wiki:link]] and rounded corners :-) >boxes can also contain markup...
  * a list
  * of several 
  * items

<html>
<div class='box'>
  <b class='xtop'><b class='xb1'></b><b class='xb2'></b><b class='xb3'></b><b class='xb4'></b></b>
  <div class='xbox'>
    <p class='box_title'>Title text would go here</p>
    <div class='box_content'>
      <p>Including this html snippet of a box</p>
      <p>All those &lt;b&gt; tags handle the rounded corners</p>
    </div>
  </div>
  <b class='xbottom'><b class='xb4'></b><b class='xb3'></b><b class='xb2'></b><b class='xb1'></b></b>
</div>
</html>

=== headings aren't allowed in boxes ===

| but | tables | are |

and plugins ... 
  ; definition : list : list : list

and a [[services:wiki:link]] </box>

<box |title>a box to match 
the default dokuwiki colour scheme</box>

<box |Example box>
to test what is possible:
**NICE PLUGIN:**
You can 
  * make Lists
  * other markup
  * set the color of the box
  * ...

looks good?

</box>

<box 80% red round| title>red box, 80% wide, with a title</box>

<box blue left> this is
a blue box
</box>

<box 80% blue round| title>blue box with a title</box>

<box 80% green round| title>a wide green box</box>

<box orange>and an orange box
</box>

<box 30% orange round>orange box with a title</box| caption>

++++

Boxed & titled

this is also boxed
this is also boxed

boxed & captioned

as is this

title with formatting, a link and rounded corners :-)

boxes can also contain markup…
  • a list
  • of several
  • items
<div class='box'>
  <b class='xtop'><b class='xb1'></b><b class='xb2'></b><b class='xb3'></b><b class='xb4'></b></b>
  <div class='xbox'>
    <p class='box_title'>Title text would go here</p>
    <div class='box_content'>
      <p>Including this html snippet of a box</p>
      <p>All those &lt;b&gt; tags handle the rounded corners</p>
    </div>
  </div>
  <b class='xbottom'><b class='xb4'></b><b class='xb3'></b><b class='xb2'></b><b class='xb1'></b></b>
</div>

=== headings aren't allowed in boxes ===

but tables are

and plugins … ; definition : list : list : list

and a link

title

a box to match the default dokuwiki colour scheme

Example box

to test what is possible: NICE PLUGIN: You can
  • make Lists
  • other markup
  • set the color of the box

looks good?

title

red box, 80% wide, with a title
this is a blue box


title

blue box with a title

title

a wide green box
and an orange box
orange box with a title

caption


  • D'autres exemples ici

Note : pour afficher des notes bien repérables dans les pages

http://wiki.splitbrain.org/plugin:note :

Permet de créer des «notes» visuellement sympathiques dans vos pages Dokuwiki :

Syntaxe :

<note warning> un warning</note>
<note tip> tip</note>
<note classic> classique</note>
<note important> important </note>

un warning

tip

classique

important

En français, vous pouvez utiliser les types de notes «importante», «tuyau», «bloquante» pour changer la couleur et l'icone de la note.

Columns : mettre en page avec plusieurs colonnes

Permet de créer de faire plusieurs colonnes dans la page, pour voir toutes les possibilités en détails, allez voir ici : http://www.dokuwiki.org/plugin:columns#columns3

Syntaxe :

<columns 100% first column attributes 50%>

Contenu de la première colonne.

<newcolumn second column *-* attributes>

Contenu de la seconde colonne.

</columns>

Contenu de la première colonne.

Contenu de la seconde colonne.

Titres dans les colonnes

  • Les titres sont supportés dans les colonnes :
<columns 100% 50% ->

===== Titre 1 =====

Contenu de la première colonne.

<newcolumn>

===== Titre 2 =====

Contenu de la seconde colonne.

</columns>

Titre 1

Contenu de la première colonne.

Titre 2

Contenu de la seconde colonne.

Alignement

  • Les alignements verticaux et horizontaux sont possibles.
  • Il y a 4 attributs d'alignement horizontal (left, center, right and justify) et 3 d'alignement vertical (top, middle and bottom).
  • Il peut y avoir plusieurs attibuts d'alignement par colonne :
<columns 100% left 50% right bottom ->

Alignement sur la gauche.

<newcolumn>

Alignement dans coin en bas à droite.

</columns>

Alignement sur la gauche.

Alignement dans coin en bas à droite.

  • Tous les attributs peuvent être abrégés par leur 1ère lettre (left : l, bottom : b etc…), et on peut fusionner plusieurs attributs ensemble :
<columns 100% l 50%>

Alignement sur la gauche.

<newcolumn rb>

Alignement dans coin en bas à droite.

</columns>

Alignement sur la gauche.

Alignement dans coin en bas à droite.

Code : pour afficher du texte non interprété

http://wiki.splitbrain.org/plugin:code

Permet d'afficher du texte non interprété, entre autres du code de programmation dans une forme “reconnaissable” mais aussi pour ne pas appliquer la mise en forme dokuwiki…

(voir aussi les blocs non interprétés )

Syntaxe

<code lang |titre> some code </code>
<file |titre> some text </file>

La saisie du titre est optionnelle. \ Voir la page en action ici

Exemples

  • <code>Du texte basique en format "Code"</code> donne :
Du texte basique en format "Code"
  • Les differents langages sont aussi reconnus, <code php | Un titre>votre code</code> donne :
| Un exemple avec du php
<?php
/**
 * Code Plugin: replaces Dokuwiki's own code syntax
 *
 * Syntax:     <code lang |title>
 *   lang      (optional) programming language name, is passed to geshi for code highlighting
 *             if not provided, the plugin will attempt to derive a value from the file name
 *             (refer $extensions in render() method)
 *   title     (optional) all text after '|' will be rendered above the main code text with a
 *             different style.
 *
 */
 
if(!defined('DOKU_INC')) define('DOKU_INC',realpath(dirname(__FILE__).'/../../').'/');
if(!defined('DOKU_PLUGIN')) define('DOKU_PLUGIN',DOKU_INC.'lib/plugins/');
require_once(DOKU_PLUGIN.'syntax.php');
 
/**
 * All DokuWiki plugins to extend the parser/rendering mechanism
 * need to inherit from this class
 */
class syntax_plugin_code_code extends DokuWiki_Syntax_Plugin {
 
    var $syntax = "";
 
    /**
     * return some info
     */
    function getInfo(){
      return array(
        'author' => 'Christopher Smith',
        'email'  => 'chris@jalakai.co.uk',
        'date'   => '2005-08-18',
        'name'   => 'Code Replacement Plugin',
        'desc'   => 'Replacement for Dokuwiki\'s own <code> handler, adds a title to the box. 
                     Syntax: <code lang|title>, lang and title are optional. title does not support any dokuwiki markup.',
        'url'    => 'http://wiki.splitbrain.org/plugin:code',
      );
    }
...

TODO : lister des tâches à effectuer

Syntaxe

  • Chaque tag <todo> créera une case à cocher.
  • Pour avoir une case cochée par défaut, utilisez la syntaxe suivante :<todo #>Title of todo Action</todo>
  • Utilisez des puces ou n° (* ou - ) ou des retours à la ligne (\\) pour mettre le TODO sous forme de liste.
  • La mise en forme (gras, italique etc…) ne fonctionne pas à l'intérieur des balises <todo></todo>. Pour appliquer un style, ilfaut mettre les balises de formattage autour des balises <todo></todo>.

Exemple

  * **<todo>à faire n°0</todo>**
  *<todo #>à faire n°1</todo>
  *<todo>à faire n°2</todo>
  *<todo#>à faire n°3</todo>
  *<todo>à faire n°4</todo>
  *<todo>à faire n°5</todo>
  • <todo>à faire n°0</todo>
  • <todo #>à faire n°1</todo>
  • <todo>à faire n°2</todo>
  • <todo#>à faire n°3</todo>
  • <todo>à faire n°4</todo>
  • <todo>à faire n°5</todo>

Doodle : pour planifier des réunions par exemple

http://wiki.splitbrain.org/plugin:doodle

  • Permet de planifier des réunions par exemple mais aussi d'autres décisions…

Syntaxe

<doodle [identifiant]>
^ [choix1] ^ [choix2] ^ ... ^
</doodle>

del.icio.us

del.icio.us est un réseau sociel de partage de bookmark. Le plugin pour dokuwiki permet d'afficher dans le wiki dynamiquement des bookmarks issus de ce service.

Nous invitons les utilisateurs de cette facilité à consulter les conditions d'utilisation du service et de protection des données personnelles. Voir aussi le site de référence de ce plugin.

Exemple

Source :

{{delicious>a?dokuwiki reference}}

Effet :

delicious_a

GOTO : pour rediriger une page vers une autre

http://wiki.splitbrain.org/plugin:goto

Permet de faire une redirection de page du wiki vers une autre.

Syntaxe

You can put the GOTO string anywhere in the document, but it probably makes the most sense to put it at the top.

  ~~GOTO>wiki:syntax~~

The above will force the document to redirect to the syntax page after the default amount of seconds. You can change the default number of seconds by editing the plugin (by default, this is 10 seconds).

You can change the number of seconds on the fly like so:

  ~~GOTO>wiki:syntax?15~~

This will redirect the page after a 15 second pause.

By default, users can't set the pause length be faster than three seconds, but this can be changed by editing the plugin. The reason for the minimum pause length is that if itòùs too fast, it becomes difficult to hit the òøEdit Pageòù button before the redirect happens. If you canòùt edit the page, then it becomes tricky to remove the redirect. Issues

  • When editing a page with the GOTO tag, be careful of hitting the Preview button. The preview will redirect just the same as the saved page.
  • The viewer's web browser must have javascript enabled in order to automatically redirect.
  • Currently, the plugin only works correctly for internal links.

include : pour insérer une page de wiki dans une autre

http://wiki.splitbrain.org/plugin:include
Permet d'insérer une page du wiki dans une autre page (vérification faite : ce principe ne permet pas de contourner les droits affectés à la page incluse)

Syntaxe :

{{page>pagename}}
{{page>pagename#sectionname}}

exemple inclusion de :start

{{page>:start}}