Nouveau site wiki
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.
de MoinMoin vers dokuwiki
Pour faciliter la migration des pages, j'ai rédigé un script de traduction partielle en langage Python. Pour l'utiliser, il faut:
- placer le script dans un répertoire vide, à côté d'un fichier vierge
page.txt
; - copier le contenu de votre page wiki dans le fichier
page.txt
; - exécuter le script.
Syntaxe
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.
Table des matières
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éments de base
- Font-Awesome: …
- Glyphicons:
- Material Design Icons:
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.
Éditeur de tableaux
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 !
Alphabet grec
<m>alpha</m> <m>beta</m> <m>gamma</m>
<m>alpha</m> <m>beta</m> <m>gamma</m>
LaTeX
- commande de base
$ a = 2b + 3c $
donne: $ a = 2b + 3c $
- commande de base (sur une ligne dédiée)
$$ a = 2b + 3c + d $$
donne: $$ a = 2b + 3c + d $$
- équation :
\begin{equation} a = 2b + 3c \end{equation}
donne:\begin{equation} a = 2b + 3c \end{equation}
Liste de commandes utiles
Texte mis en évidence
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:
- Un premier item;
- Un deuxième item;
- …
Il existe plusieurs types d'environnements de mise en évidence:
- primary
- success
- info
- warning
- danger
- tip
- question
chacun pouvant être choisi avec (icon=“true”
) ou sans icône:
<callout type="question" icon="true">[...]</callout>
<callout type="success" icon="true">[...]</callout>
Bootstrap wrapper
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
<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>
accordéon
<accordion> <panel title="groupe #1"> panneau 1 </panel> <panel title="groupe #2"> panneau 2 </panel> <panel title="groupe #3"> panneau 3 </panel> </accordion>
groupe #1
panneau 1
groupe #2
panneau 2
groupe #3
panneau 3
et plus...
Quantité d'autres fonctions, dont vous pouvez voir une brève description sur ce site.