====== Nouveau site wiki ======

Le nouveau site wiki du laboratoire utilise un moteur ([[https://www.dokuwiki.org/dokuwiki|dokuwiki]]) différent de celui de l'ancien site ([[http://moinmo.in/|MoinMoin]]). Ce changement a été motivé par le fait que Python 2, langage sur lequel repose MoinMoin ne sera plus maintenu à partir du [[https://pythonclock.org/|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 [[https://www.dokuwiki.org/plugins|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.

<callout type="success" icon="true">
Le script de traduction est téléchargeable {{administration:site:moinmoin2doku.py|ici}}. Plus d'informations sur la **procédure de migration** [[divers:site:migration|sur cette page wiki]].
</callout>

===== Syntaxe =====
Cette [[divers:site:syntaxe|page wiki]] contient de nombreuses informations de base sur l'utilisation du site wiki. Également, [[https://www.lotar.altervista.org/wiki/wiki/plugin/start|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 ====

<callout type="warning" icon="mdi mdi-alert-decagram-outline">
Il y a plein de nouvelles icônes disponibles sur le wiki ! Dans le menu d'édition d'une page, cliquez sur le bouton **icons** pour avoir accès aux icônes:
  * Font-Awesome: {{fa>address-card}} {{fa>arrow-circle-up}} {{fa>automobile}} {{fa>bathtub}} {{fa>cogs}} {{fa>firefox}} ...
  * Glyphicons: {{glyphicon>check}} {{glyphicon>education}} {{glyphicon>hdd}} {{glyphicon>piggy-bank}} {{glyphicon>sunglasses}} {{glyphicon>star-empty}}
  * Material Design Icons: {{mdi>account-heart-outline}} {{mdi>airballoon}} {{mdi>alpha-l-box-outline}}{{mdi>alpha-a-box}}{{mdi>alpha-v-box}}{{mdi>alpha-a-box-outline}}
</callout>

L'éditeur de pages inclut par défaut différentes commandes d'édition (gras, italique, titres...) qui facilitent la rédaction.

{{wiki:editeur.png}}

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 <code>$ a = 2b + 3c $</code> donne: $ a = 2b + 3c $
  * commande de base (sur une ligne dédiée) <code>$$ a = 2b + 3c + d $$</code> donne: $$ a = 2b + 3c + d $$
  * équation :<code> \begin{equation} a = 2b + 3c \end{equation}</code>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:

<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>
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="question" icon="true">[...]</callout> 

  <callout type="success" 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>

<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>
  
<accordion>
<panel title="groupe #1">
panneau 1
</panel>
<panel title="groupe #2">
panneau 2
</panel>
<panel title="groupe #3">
panneau 3
</panel>
</accordion>

== et plus... ==
**Quantité d'autres fonctions**, dont vous pouvez voir une brève description sur [[http://www.lotar.altervista.org/wiki/wiki/plugin/bootswrapper|ce site]].