July 30th, 2008 @ 11:49am | njames | Categories DokuWiki |
No Comments »
Liste de plugins DokuWiki
- BibTeX: ce plugin basé sur le plugin BibtexRef de PmWiki et autre plugin bibtex de DokuWiki, permet d'afficher des références bibliographiques et leurs bibtex associés.
Ce plugin est très pratique, et le seul que j'ai trouvé pour DokuWiki. Cependant, le plugin a été développé comme un hack, il faut faire quelques modifications du code pour l'utiliser: la racine du wiki est la racine du serveur et il est codé pour être utilisé avec le thème Artic. Il est très facile de changer l'un comme l'autre en regardant un brin le code.
Notes: De même les liens hypertextes générés ont des attributs
hrefdont la valeur n'est pas mise entre double quote (ni simple quote). Là encore, en regardant le code desyntax/bibtex.phpetsyntax/bibcite.phpon rajoute facilement les double-quote manquantes. Notes: Une extension possible du code de ce plugin qui serait bien pratique serait de proposer également une insertion de uniquement la référence (genre Faloutsos & al., 2006), avec un tiptext en JavaScript (pour la référence complète) qui s'afficherait sur un event overOn de la souris, et clickable pour afficher le bibtex complet en dur dans la page en cours de lecture. - Cloud plugin: apporte une balise spéciale pour afficher un cloud des termes utilisés dans les pages du wiki, voir la démo.
On peut spécifier une stopwords liste dans
~dokuwiki/conf/stopwords.txtou~dokuwiki/inc/lang/[lang-code]/stopwords.txt. Ce plugin permet aussi de faire des nuages de tag si le plugins Tag est installé. - pagemove: permet de renommer et déplacer des pages du wiki.
- un autre plugin intéressant qui permet de faire des présentations S5 avec DokuWiki.
- blockquote: pour la gestion des tag HTML blockquote.
- linebreak: pour prendre en compte les linebreak dans l'affichage des pages.
- indexmenu: un index du wiki en javascript.
- baselink: pour faire en sorte que les URL commençant par
/soit des URL relatives auDocumentRootdu serveur et non un lien interne au wiki (comportement par défaut). - Math2: pour l'inclusion de formules mathématiques dans DokuWiki. Ce plugin fonctionne stand-alone, pas besoin d'installer un renderer comme pour le plugin Math (ce dernier supporte cependant MathML et LaTeX).
- Latex: se base directement sur une installation Latex (texlive sous Ubuntu), fonctionne bien malgré quelques bugs inexplicables, impossible de rendre ceci par exemple:
Cependant, en découpant l'équation en deux, ça passe:
<latex> C^{SSD}_{u,v} (d) = \sum_{du=-n}^{du=+n} \sum_{dv=-n}^{dv=+n} ( I_{2} (u_{2} + du , v_{2} + dv) - I_{1} (u_{1} + du , v_{1} + dv ) )</latex><latex> C^{SSD}_{u,v} (d) = \sum_{du=-n}^{du=+n} \sum_{dv=-n}^{dv=+n} ( I_{2} (u_{2} + du , v_{2} + dv) - I_{1} (u_{1} + du , v_{1}</latex><latex> + dv ) )</latex> - mllist: pour faire des paragraphes multiligne dans un item de list (dans la configuration par défaut de DokuWiki ce n'est pas possible, un item de liste ne peut pas contenir de retour à la ligne).
Pour ajouter des types MIME pour les types de media autorisés dans le gestionnaire de media de DokuWiki
Voir le fichier ~dokuwiki/conf/mime.conf, par défaut:
# You should enable HTML and Text uploads only for restricted Wikis. # Spammers are known to upload spam pages through unprotected Wikis. # Note: Enabling HTML opens Cross Site Scripting vulnerabilities # through JavaScript. Only enable this with trusted users. You # need to disable the iexssprotect option additionally to # adding the mime type here #html text/html #htm text/html #txt text/plain #conf text/plain #xml text/xml #xsd text/xsd
fetch.php.
Apparemment, le seul moyen pour contourner cela dans DokuWiki est d'activer le module rewrite d'apache, puis de l'activer dans DokuWiki, i.e. dans le fichier ~dokuwiki/conf/dokuwiki.php:
$conf['userewrite'] = 2; //this makes nice URLs: 0: off 1: .htaccess 2: internal
~dokuwiki si vous utilisez the mode 1:
RewriteEngine on RewriteBase / RewriteRule ^_media/(.*) lib/exe/fetch.php?media=$1 [QSA,L]
Pour faire du texte multiligne autour d'une image
il faut mettre l'image en float, par exemple:
{{:screenshot-spectral_sorcery.png?128 |}} Java application. It's a remake of the game of ? ?L'ajout d'un espace après le nom de l'image et les paramètres de dimension met l'image en float.
"Sorry, username or password was wrong." indiqué dans le html_msgarea() quand pas authentifier (ni tenté de s'authentifier)
un bug report sur splitbrain indique que se sont les lignes:
if(empty($_REQUEST['u']) && empty($_COOKIE[DOKU_COOKIE]) && !empty($_SERVER['PHP_AUTH_USER'])){ $_REQUEST['u'] = $_SERVER['PHP_AUTH_USER']; $_REQUEST['p'] = $_SERVER['PHP_AUTH_PW']; }
~DOKUWIKI/inc/auth.php.
Syndication
Comme j'utilise DokuWiki comme feedback pour mes élèves, il est pratique d'utiliser les flux de syndication du wiki.
L'URL du flux http://njames.trevize.net/wiki/feed.php accepte des paramètres en GET u=username et p=password pour une authentification ACL et obtenir ainsi le flux pour toute les pages que l'utilisateur username est en droit de lire.
Taille des icônes juxtaposant les liens
Sur les liens sur un documents PDF, ou PS, dokuwiki juxtapose une icône. Ces images sont dans ~dokuwiki/lib/images/fileicons.
Quand on veut redimensionner la hauteur des lignes via CSS dans la page wiki (modifier la propriété dokuwiki), il se trouve que les icônes sont de taille 16x16, donc si on positionne la taille de la font à 12px, l'icône s'affichera mal (il manquera des pixels en bas). L'astuce la plus simple, avoir dans ses sauvegardes une version de dokuwiki avec le répertoire ~dokuwiki/lib/images et deux répertoires fileicons-16x16 et fileicons-12x12.
Via un coup d'ImageMagick: for i in *; do convert -resize 12x12 $i $i.
Et copier le contenu du répertoire qui convient. C'est une solution à la barbarian mais c'est rapide et ça fonctionne bien.
Customizer les icônes des liens sur fichier (via mime type)
Le code CSS pour les icônes mime des fichiers est situé dans ~dokuwiki/lib/exe/css.php.
