Ceci est une ancienne révision du document !
Description de l'installation et de la configuration de ce Wiki.
Les principaux avantages de dokuwiki sont :
Pour choisir le wiki qui vous convient, allez faire un tour sur http://www.wikimatrix.org.
Cette page décrit l'installation et la personnalisation de DokuWiki, de nombreuses parties sont optionnelles ou réalisables ultérieurement.
Voir Plugins de Dokuwiki
Une fois activé, des nouveaux paramètres spécifiques au template apparaissent dans le gestionnaire de configuration.
Voici les options sélectionnées pour ce wiki :
Afin d'intégrer parfaitement translation dans arctic comme sur ce site, translation a été modifié.
Patch de modification : patch_translation_arctic.patch
update 2008-12-23 : patch_translation_arctic-2008-12-23.patch
Installation du patch :
bender:/opt/dokuwiki/lib/plugins/translation# patch -p 1 < /root/patch_translation_arctic.patch patching file style.css patching file syntax.php bender:/opt/dokuwiki/lib/plugins/translation#
Il faut ensuite modifier arctic avec le patch suivant : patch_arctic_translation.patch
Update 2009-03-25 : patch_arctic_translation_2009-3-25.patch
Installation du patch :
bender:/opt/dokuwiki/lib/tpl/arctic# patch -p 1 < /root/patch_arctic_translation.patch patching file tpl_functions.php bender:/opt/dokuwiki/lib/tpl/arctic#
J'ai réalisé d'autres modifications du template arctic en particulier le bandeau du haut, si vous souhaitez reproduire la même chose :
Installation du patch :
/opt/dokuwiki/lib/tpl/arctic# patch -p 1 < /root/patch_artic_bouthors.patch patching file arctic_design.css patching file arctic_layout.css patching file footer.html patching file layout.css patching file main.php patching file style.ini /opt/dokuwiki/lib/tpl/arctic# /opt/dokuwiki/inc# patch -p 1 < ../patch_youarehere.patch patching file template.php /opt/dokuwiki/inc#
Ce patch permet de masquer complètement les sections inaccessibles, par défaut même si il n'est pas possible de visualiser les pages, il possible de vérifier leur existence et leur titre.
wiki:/opt/wiki# patch -p 1 < /root/doku_hide.patch patching file inc/common.php patching file inc/parser/xhtml.php patching file inc/parserutils.php patching file inc/template.php wiki:/opt/wiki#
Remarque : le contenu des pages est caché par défaut, l'affichage des liens d'une page dépend de la personne qui a déclenché la génération de la page.
Astuce : si les droits de lecture sont appliqués sur le wiki complet, alors l'utilisateur peut savoir si un répertoire existe ou non. Pour éviter cela, il suffit de n'autoriser en lecture que les répertoires autorisés.
Remarque 2 : ne pas oublier d'activer “sneaky_index” pour sécuriser l'index.
Il peut être parfois nécessaire de regénérer l'index de recherche, par exemple après une migration. Pour cela il existe un outils en ligne de commande nommé indexer.php.
Pour l'utiliser il faut avoir php en ligne de commande installé (paquet php5-cli).
/opt/dokuwiki/bin# su www-data /opt/dokuwiki/bin$ php indexer.php Searching pages... 96 pages found. cuisine:caramelbeurresale... done. cuisine:crepes... done. cuisine:start... done. cuisine:tatin... done. ... /opt/dokuwiki/bin$ exit exit /opt/dokuwiki/bin#
Le pieds de page est par défaut dans /usr/share/dokuwiki/lib/tpl/default/footer.html Vous pouvez le modifier, par exemple pour activer l'image “cc” en bas, il faut ajouter :
<a target="_blank" href="http://creativecommons.org/licenses/by-nc-sa/2.0/" rel="license" title="Creative Commons License"><img src="<?=DOKU_TPL?>images/button-cc.gif" width="80" height="15" alt="Creative Commons License" border="0" /></a>
L'index Sitemap permet d'indexer complètement le wiki sous Google.
Pour le créer il faut :
# cd /opt/dokuwiki /opt/dokuwiki# touch sitemap.xml.gz /opt/dokuwiki# chown www-data sitemap.xml.gz /opt/dokuwiki#
$conf['sitemap'] = 1; //Create a google sitemap? How often? In days.
Le fichier http://www.bouthors.fr/wiki/sitemap.xml.gz est ensuite généré par dokuwiki.
Avec le paquet debian
Avec une installation manuelle :