Ceci est une ancienne révision du document !

Table des matières

Dokuwiki

Dokuwiki

À suivre pour la correction de bugs :

Remove extension limitation · Issue #149 · splitbrain/dokuwiki-plugin-gallery

Extensions

drawio permet d'éditer des schémas réalisés avec draw.io directement depuis le wiki.
EditTable ajoute un bouton d'édition sous chaque tableau. Le bouton d'édition permet la modification du tableau à la manière de Excel.
~~fontsize2 permet de gérer la taille de la police.~~ Remplacé par l'extension typography qui supporte plus de modifications ¹⁾.
keyboard permet d'afficher des raccourcis clavier sous forme de touche de clavier.
include permet d'inclure des pages dans d'autres.
Login/Logoff Logging permet d'enregistrer les connexions et déconnexions dans un journal.
Move permet de déplacer des pages en conservant les liens ²⁾.
pdfjs permet d'afficher le contenu de fichiers PDF dans le wiki ³⁾
tabbox permet de créer des boîtes avec onglets.
tokenbucketauth permet de ralentir les attaques en force brute en bannissant les IPs coupables.
typography permet de modifier la typographie localement.
upgrade permet de mettre à jour le wiki directement depuis l'interface d'administration.
Wrap permet de mettre le texte dans des containers. Ces containers peuvent être stylés avec les styles fournis ou ceux de l'utilisateur.

Syntaxe

Voir Écriture

Configuration

Changer la largeur d'affichage

Il faut éditer le fichier lib/tpl/dokuwiki/style.ini et modifier la valeur du paramètre __site_width__. Dans mon cas, j'ai remplacé 75em par 100vw.

Il faut réaliser cette opération à chaque mise à jour du wiki !

Autoriser l'ajout de fichier SVG par le gestionnaire de médias

Il faut ajouter le fichier conf/mime.local.conf avec le contenu suivant :

mime.local.conf

mp4    video/mp4
svg    image/svg+xml

Il est possible de mettre cette configuration dans le fichier conf/mime.conf mais celle-ci ne sera pas conservée lors de la prochaine mise à jour.

Ajouter des icônes

Il faut ajouter le fichier conf/smileys.local.conf avec le contenu suivant :

smileys.local.conf

# PlayStation 1
PS_CIRCLE   playstation.circle.svg
PS_CROSS    playstation.cross.svg
PS_SQUARE   playstation.square.svg
PS_TRIANGLE playstation.triangle.svg
PS_DOWN     playstation.down.svg
PS_LEFT     playstation.left.svg
PS_RIGHT    playstation.right.svg
PS_UP       playstation.up.svg
PS_L1       playstation.l1.svg
PS_L2       playstation.l2.svg
PS_R1       playstation.r1.svg
PS_R2       playstation.r2.svg
PS_SELECT   playstation.select.svg

# Nintendo 64
N64_CDOWN    nintendo64.c.down.svg
N64_CLEFT    nintendo64.c.left.svg
N64_CRIGHT   nintendo64.c.right.svg
N64_CUP      nintendo64.c.up.svg
N64_DDOWN    nintendo64.d.down.svg
N64_DLEFT    nintendo64.d.left.svg
N64_DRIGHT   nintendo64.d.right.svg
N64_DUP      nintendo64.d.up.svg
N64_L        nintendo64.l.svg
N64_R        nintendo64.r.svg

Il est possible de mettre cette configuration dans le fichier conf/smileys.conf mais celle-ci ne sera pas conservée lors de la prochaine mise à jour.

Il faut également mettre à disposition les icônes dans le répertoire lib/images/smileys. Voici les icônes utilisées :

Playstation :
Nintendo 64 :

Comme certaines icônes utilisées sont très grandes, il faut les redimensionner lors de l'utilisation en modifiant le contenu du fichier conf/userall.css avec les règles suivantes :

conf/userall.css

.icon[alt*="PS_"],
.icon[alt*="N64_"],
button.pickerbutton[title*="PS_"] img,
button.pickerbutton[title*="N64_"] img {
  height: 1em;
}

Ajouter des polices

Il faut créer le répertoire fonts à la racine du wiki et y ajouter les polices nécessaires ⁴⁾.

Il faut ensuite les charger en modifiant le contenu du fichier conf/userall.css avec les règles suivantes :

conf/userall.css

@font-face {
  font-family: "Ænigma Scrawl 4 BRK";
  src: url(fonts/aenigmascrawl.ttf) format("truetype");
}
@font-face {
  font-family: "Fira Code";
  src: url(fonts/firacoderegular.ttf) format("truetype");
}
@font-face {
  font-family: "Grudge 2 BRK";
  src: url(fonts/grudge2brk.ttf) format("truetype");
}
@font-face {
  font-family: "Intel One Mono";
  src: url(fonts/intelonemonoregular.ttf) format("truetype");
}
@font-face {
  font-family: "Iosevka";
  src: url(fonts/iosevkaregular.ttf) format("truetype");
}
@font-face {
  font-family: "JetBrains Mono";
  src: url(fonts/jetbrainsmonoregular.ttf) format("truetype");
}
@font-face {
  font-family: "Old Newspaper Types";
  src: url(fonts/oldnewspapertypes.ttf) format("truetype");
}
@font-face {
  font-family: "PT Sans";
  src: url(fonts/ptsanswebregular.ttf) format("truetype");
}
@font-face {
  font-family: "PT Serif";
  src: url(fonts/ptserifwebregular.ttf) format("truetype");
}
@font-face {
  font-family: "Sketch Nothing";
  src: url(fonts/sketchnothing.ttf) format("truetype");
}

¹⁾

J'ai même l'impression que c'est un sous-ensemble de celle-ci.

²⁾

HOWTO: Rename Pages

³⁾

Attention aux règles CSP relatives à l'inclusion des iframes

⁴⁾

Celles-ci sont également présentes dans le gestionnaire de médias