Le nouveau site wiki du laboratoire utilise un moteur (dokuwiki) différent de celui de l'ancien site (MoinMoin). Ce changement a été motivé par le fait que Python 2, langage sur lequel repose MoinMoin ne sera plus maintenu à partir du 1er janvier 2020. Il était donc important de mettre à jour notre site pour éviter toute faille de sécurité.
Contrairement à MoinMoin, le moteur dokuwiki dispose d'une grande communauté d'utilisateurs, ce qui implique un grand nombre d'extensions et un développement beaucoup plus actif et régulier. Ses fonctionnalités d'édition sont aussi beaucoup plus avancées et intuitives. Il faut toutefois faire attention que la syntaxe pour l'édition d'une page est différente de celle utilisée pour l'ancien site.
Pour faciliter la migration des pages, j'ai rédigé un script de traduction partielle en langage Python. Pour l'utiliser, il faut:
page.txt
;page.txt
;Cette page wiki contient de nombreuses informations de base sur l'utilisation du site wiki. Également, ce site internet est une mine d'information pour l'utilisation des extensions et fonctionnalités avancées de dokuwiki.
La table des matières apparaît automatiquement en haut à droite d'une page wiki, sauf si la macro:
~~NOTOC~~
est utilisée dans le contenu de la page. La table des matières reste ancrée à la fenêtre du navigateur pour faciliter la lecture du document.
L'éditeur de pages inclut par défaut différentes commandes d'édition (gras, italique, titres…) qui facilitent la rédaction.
Il est aussi possible d'ajouter des fichiers en même temps que vous éditez une page (l'interface utilisée est très similaire à celle de Joomla ou de Moodle pour l'édition de pages html notamment). Comme mentionné plus haut, la syntaxe est globalement différente de celle utilisée pour les pages MoinMoin. Cela implique que vous ne pourrez pas copier/coller directement le contenu de vos pages personnelles vers ce nouveau wiki.
Le nouveau wiki dispose d'un éditeur de tableaux. Il suffit de cliquer sur l'icône insérer un nouveau tableau dans le menu édition !
<m>alpha</m> <m>beta</m> <m>gamma</m>
<m>alpha</m> <m>beta</m> <m>gamma</m>
$ a = 2b + 3c $
donne: $ a = 2b + 3c $
$$ a = 2b + 3c + d $$
donne: $$ a = 2b + 3c + d $$
\begin{equation} a = 2b + 3c \end{equation}
donne:\begin{equation} a = 2b + 3c \end{equation}
Les lignes:
<callout type="tip" icon="true"> Ce texte est mis en évidence dans un bel environnement dédié * Un premier item; * Un deuxième item; * ... </callout>
permettent d'afficher:
Il existe plusieurs types d'environnements de mise en évidence:
chacun pouvant être choisi avec (icon=“true”
) ou sans icône:
<callout type="question" icon="true">[...]</callout>
<callout type="success" icon="true">[...]</callout>
L'icône “B” de la fenêtre d'édition permet d'ajouter à une page une grande quantité de fonctionnalités utiles et permettant de structurer une page wiki:
<carousel> <slide> {{ressources:logos:mint.png?nolink&x275px|}} <caption> == figure 1 == légende de la figure 1 </caption> </slide> <slide> {{ressources:logos:python.png?nolink&x275px|}} <caption> == figure 2 == légende de la figure 2 </caption> </slide> <slide> {{ressources:logos:latex.png?nolink&x475px|}} <caption> == figure 3 == légende de la figure 3 </caption> </slide> </carousel>
<accordion> <panel title="groupe #1"> panneau 1 </panel> <panel title="groupe #2"> panneau 2 </panel> <panel title="groupe #3"> panneau 3 </panel> </accordion>
panneau 1
panneau 2
panneau 3
Quantité d'autres fonctions, dont vous pouvez voir une brève description sur ce site.