wiki:fonctions

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.

Pour faciliter la migration des pages, j'ai rédigé un script de traduction partielle en langage Python. Pour l'utiliser, il faut:

  1. placer le script dans un répertoire vide, à côté d'un fichier vierge page.txt;
  2. copier le contenu de votre page wiki dans le fichier page.txt;
  3. exécuter le script.
Le script de traduction est téléchargeable ici. Plus d'informations sur la procédure de migration sur cette page wiki.

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.

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:
  • 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.

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>

  • 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}

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:

Ce texte est mis en évidence dans un bel environnement dédié
  • 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>
<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.

  • wiki/fonctions.txt
  • Dernière modification : 2021/09/23 19:55
  • de davidedecicco