Outils pour utilisateurs

Outils du site


dokuwiki

Ceci est une ancienne révision du document !


Dokuwiki

Le wiki que vous êtes en train de lire fonctionne sous DokuWiki. C'est un wiki sans base de données, très rapide et facile à mettre en place. Voici quelques informations concernant Dokuwiki que je me garde sous le coude.

  • Le gestionnaire de fichiers n'autorise l'upload que des fichiers d'un certain type (png, jpg…). Pour autoriser l'upload d'autres types, il faut créer le fichier /conf/mime.local.conf et y ajouter les types voulus. Exemple:
    exe     application/octet-stream
  • Pour classer les fichiers uploadés, dans le “wikiname”, mettez le nom de la catégorie suivi de deux points avant le nom du fichier:

    Cela va automatiquement créer des dossiers.
  • Supprimer une page: Comme vous l'aurez remarqué, pas de bouton “supprimer cette page”. En fait il faut faire “editer la page”, sélectionner tout le texte, supprimer et faire “Enregistrer”. Enregistrer un texte vide a pour effet de supprimer la page.
  • Déplacer une page: Il n'est pas actuellement possible de déplacer un document d'un namespace à un autre, encore moins en corrigeant automatiquement tous les liens qui pointent dessus. Il faut re-créer la page. C'est un des aspects un peu lourds de DokuWiki (même si c'est pas bien grave).
  • DokuWiki chez free.fr: DokuWiki ne fonctionne tel quel pas chez Free (*.free.fr). Il est nécessaire de le patcher. Les infos devraient se retrouver en googlant.
  • Largeur à l'écran:
    • Solution 1 : Aller dans l'administration > Paramètres de style du thème (template) > Largeur du site complet > mettre 100%.
    • Solution 2 : Patcher DokuWiki
      • Dans /dokuwiki/lib/tpl/dokuwiki/style.ini, changer:
        __site_width__      = "75em"            ; @ini_site_width

        en

        __site_width__      = "100%"            ; @ini_site_width

        puis allez dans l'écran de configuration et re-validez le (Cela va purger le cache). Et voilà !

  • Changer les CSS de votre DokuWiki.
    • Pour cela, pas besoin de toucher au thème: Contentez-vous de créer un fichier /conf/userstyle.css et mettez-y ce que vous voulez, par exemple:
      body {
         font-family: "Droid Sans","Noto Sans","Ascender Uni","Linotype Aroma","FF Kievit","Source Sans","Open Sans","Museo Sans","Myriad","Camphor","Corbel","Frutiger","Vectora","Calibri","Ubuntu","Roboto",sans-serif;
      }
    • Cette feuille de style survivra aux mises à jour DokuWiki.
    • (Je ne suis pas fan d'Arial)
  • Retirer les marges gauche/droite sur les petits écrans:
    • Dans mon userstyle.css, j'ajoute:
      @media screen and (max-width: 700px) { 
          #dokuwiki__site > .site {
              padding-right: 0px;
              padding-left: 0px;
          }
      }
    • Pour voir le résultat, diminuez la largeur de la fenêtre du navigateur: En dessous d'une certaine largeur, ça retirer les marges gauche et droite. C'est plus sympa pour les petits écrans.

Plugins intéressants

  • Discussion: Permet d'ajouter un fil de discussion dans un article de Dokuwiki. Ajoutez juste ~~DISCUSSION~~ dans le corps de l'article.
  • Note: Pour mettre en valeur des notes, warning, etc. Simple et pratique.
    • Exemple:
Ceci est une note.
  • Wrap, pratique pour encadrer des informations (et plus souple que Note).
  • Hidden: collapse une zone qu'on peut agrandir en cliquant dessus (genre “spoiler”). Pratique pour publier de longs texte ou sources dans une page sans avoir à faire une page à côté).
    • Exemple:

Cliquez-moi pour ouvrir et fermer

Cliquez-moi pour ouvrir et fermer

Coucou ! Je suis une note cachée.


  • Draw.io: Permet de dessiner des schémas directement dans vos pages ! Fantastique.
NE PAS UTILISER POUR LE MOMENT Le plugin marche, mais la sécurité n'a pas encore été implémentée, donc n'importe qui peut modifier les schémas ! (sauf si vous patchez manuellement, voir ci-dessous)
  • Démonstration:
  • Après édition, ça génère directement un png.
  • Astuce: Le PNG contient aussi le document Draw.io XML source: Vous pouvez donc re-cliquer sur votre schéma et le modifier.
  • Le site draw.io ne sert qu'à servir une application statique: Elle s'exécute dans votre navigateur, et vos données ne vont que entre votre navigateur et DokuWiki (elles ne passent pas par le site draw.io).
  • (Draw.io est un logiciel libre que vous pouvez même héberger sur votre serveur.)
  • Si vous souhaitez utiliser malgré tout draw.io, voici un patch pour le fichier /lib/plugins/drawio/action.php qui permet d'autoriser la modification des schémas uniquement à l'administrateur (en attendant la version terminée du plugin):
    --- lib/plugins/drawio/action.php.old1	2019-11-06 13:41:31.786165769 +0000
    +++ lib/plugins/drawio/action.php	2019-11-13 07:49:51.964842606 +0000
    @@ -29,6 +29,9 @@
              * handle ajax requests
              */
             function _ajax_call(Doku_Event $event, $param) {
    +
    +           if (!auth_isadmin()) { return; }
    +
                 if ($event->data !== 'plugin_drawio') {
                     return;
                 }
  • Keyboard: permet d'afficher les touches de clavier. Pratique pour les tutoriels.
    • Exemple: Ctrl+C
    • Customiser l'apparence des touches comme ceci K, dans /conf/userstyle.css, ajouter à la fin:
      kbd {
         background-color: #F2F2F2 !important;
         border-style: outset;
         border-width: 3px;
         border-radius: 0.3em;
         padding : 0px 2px 0px 2px !important;
      }
    • Notez que par défaut ce plugin fait des substitutions et met en majuscules. Entourez votre texte de simple quotes pour qu'il ne soit pas modifié. Exemples: C-c-Right donne Ctrl+C+, t donne T, mais 't' donne t.
  • LogLog: Journal des connexions et tentatives de connexion.
  • tokenbucketauth: Banni une adresse IP si elle fait trop de tentatives de connexion sur le formulaire de login.
    • Astuce: Si vous vous êtes vous-même bloqué(e), voici comment réinitialiser le blocage (je me note ça, car j'oublie tout le temps), supprimez les 3 fichiers suivants:
      • /dokuwiki/data/cache/block.pbf
      • /dokuwiki/data/cache/lock.pbf
      • /dokuwiki/data/cache/users.pbf
  • UnusedMedia: Affiche la liste des pages orphelines et des médias non utilisés.
  • langdelete: Permet de supprimer les fichiers de langue inutile de votre wiki (pour l'alléger).
  • Page Redirect, pratique pour rediriger vos anciennes pages vers les nouvelles.
dokuwiki.1573631532.txt.gz · Dernière modification: 2019/11/13 07:52 de sebsauvage