Différences

Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.

Lien vers cette vue

linux:dokuwiki [2011/01/05 21:43]
matthieu
linux:dokuwiki [2012/06/23 19:21] (Version actuelle)
matthieu [Recréer l'index de recherche]
Ligne 1: Ligne 1:
 +{{tag>fr fr:linux fr:serveur fr:web fr:wiki}}
 ====== DokuWiki ====== ====== DokuWiki ======
 Description de l'installation et de la configuration de ce Wiki. Description de l'installation et de la configuration de ce Wiki.
Ligne 11: Ligne 12:
  
 Cette page décrit l'installation et la personnalisation de DokuWiki, de nombreuses parties sont optionnelles ou réalisables ultérieurement. Cette page décrit l'installation et la personnalisation de DokuWiki, de nombreuses parties sont optionnelles ou réalisables ultérieurement.
 +
 +:!: Documentation à jour pour la version 2011-05-25 "Rincewind"
  
 ===== Installation ===== ===== Installation =====
-Voir [[linux:dokuwiki:install]]+Pour comprendre comment installer un Dokuwiki tout neuf, voir [[linux:dokuwiki:install]].
  
 ===== Sécurité ===== ===== Sécurité =====
-Voir [[linux:dokuwiki:secu]]+Dokuwiki offre la possibilité de contrôler les droits d'accès aux différentes pages, pour plus de détails voir [[linux:dokuwiki:secu]].
  
 ===== Plugins ===== ===== Plugins =====
-Je vous conseille les plugins suivants : +Les plugins offrent la possibilité d'étendre les fonctions de base de dokuwiki comme la gestion multilingue ou l'édition wysiwyg de tableaux.\\ 
-  * translation pour permettre d'avoir des pages en plusieurs langues +Ceux que j'utilise sont décris ici : [[linux:dokuwiki:plugins]].
-  * editx pour faciliter le déplacement d'une page +
-  * edittable pour l'édition de tableaux wysiwyg +
-  +
  
-==== Translation ==== +===== Templates ===== 
-Url : http://wiki.splitbrain.org/plugin:translation +Le système de template permet de personnaliser l'apparence du wiki, [[linux:dokuwiki:templates]] explique comment obtenir le style de ce wiki.
- +
-Pour l'installer, copier le lien de téléchargement et le copier dans le gestionnaire de plugins (section admin).\\ +
-Il est ensuite possible de modifier les options du plugin dans le Configuration Manager. +
- +
-Options pour www.bouthors.fr : +
-  * plugin»translation»translations : en +
-  * plugin»translation»translateui : oui +
- +
-Pour l'afficher, il faut ensuite ajouter le code suivant dans le template : +
-<code> +
-<?php +
-$translation &plugin_load('helper','translation'); +
-echo $translation->showTranslations(); +
-?> +
-</code> +
- +
-Etant donné que j'utilise un template particulier, vous trouverez plus bas l'activation de translation dans ce template.\\ +
-Pour plus de détails sur l'activation de translation dans le template par défaut, voir le site du plugin. +
- +
-==== Pagemove ==== +
-Url : http://wiki.splitbrain.org/plugin:pagemove +
- +
-Pour l'installercopier le lien de téléchargement et le copier dans le gestionnaire de plugins (section admin). +
- +
-Une fois le plugin installé, une nouvelle section apparaît dans la partie "Admin" nommée "Page Move / Rename". +
- +
- +
-===== Template Arctic ===== +
- +
-Le template Arctic (utilisé sur ce site) remet en forme Dokuwiki pour notamment intégrer des menus sur les côtés. +
- +
-Site officiel : [[http://www.dokuwiki.org/template:arctic]] +
- +
-==== Installation ==== +
-Les templates doivent être installés dans le sous répertoire //lib/tpl// : +
- +
-<code> +
-bender:~# cd /opt/dokuwiki/lib/tpl/ +
-bender:/opt/dokuwiki/lib/tpl# tar -zxvf /root/template-arctic-2008-05-04.tgz +
-arctic/README +
-arctic/COPYING +
-arctic/VERSION +
-... +
-</code> +
- +
-Pour activer le templace, il suffit d'utiliser la liste déroulante dans "Admin >> Config Manager" +
- +
-==== Personnalisation ==== +
-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 +
-  * tpl»arctic»left_sidebar_content : main + user + index +
-  * tpl»arctic»left_sidebar_order : main,namespace,user,group,index +
- +
-==== Intégration de translation dans arctic ==== +
- +
-Afin d'intégrer parfaitement translation dans arctic comme sur ce site, translation a été modifié.\\  Patch de modification : {{linux:patch_translation_arctic.patch?linkonly}}\\  update 2008-12-23 : {{linux:patch_translation_arctic-2008-12-23.patch?linkonly}} +
- +
-Installation du patch : +
- +
-<code> +
-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# +
-</code> +
- +
-Il faut ensuite modifier arctic avec le patch suivant : {{linux:patch_arctic_translation.patch?linkonly}}\\  Update 2009-03-25 : {{:linux:patch_arctic_translation_2009-3-25.patch?linkonly}} +
- +
-Installation du patch : +
- +
-<code> +
-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# +
-</code> +
- +
-=== Détails des patchs === +
- +
-  * translation +
-    * modification du style translation à droite par défaut +
-    * modification du texte généré en titre H1 +
-  * arctic : ajout d'un bloc translation en haut des sidebar +
- +
-==== Autres modifications de 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 : +
-  * version actuelle : +
-    * {{:linux:patch_arctic_bouthors_2009-03-25.patch}} +
-    * {{:linux:patch_youarehere.patch}} +
-  * ancienne version : +
-    * appliquer le patch : {{:linux:patch_arctic_bouthors.patch}} +
-    * remplacer footer.html par celui ci : {{:linux:footer.html.gz|}} +
- +
-Installation du patch : +
-<code> +
-/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# +
-</code>+
  
 ===== Authentification LDAP ===== ===== Authentification LDAP =====
Ligne 140: Ligne 32:
  
 ===== Astuces ===== ===== Astuces =====
- 
-==== Patch de sécurité ==== 
-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. 
- 
-  * Patch pour la version 2008-05-05: {{:linux:doku_hide-2008-05-05.patch}} 
-  * Patch pour la version 2009-02-14: {{:linux:dokuwiki-2009-02-14_security.patch}} 
- 
-<code> 
-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# 
-</code> 
- 
- 
-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.  
- 
- 
-=== Détails des failles corrigées === 
-  * inc/parser/xhtml.php : dans le contenu d'une page, les liens internes révèlent si la page existe à cause du style utilisé 
-  * inc/parserutils.php : lorsque useheading est à 1, les références vers une page interdite révèlent le nom de la page (dans le titre, dans youarehere et dans le contenu des pages) 
-  * inc/template.php : lorsque youarehere est activé, le style des éléments du chemin révèlent si ils existent 
-  * inc/common.php : breadcrumb - n'ajoute pas la page à la liste si l'accès est interdit 
- 
 ==== Recréer l'index de recherche ==== ==== Recréer l'index de recherche ====
 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.\\ 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.\\
Ligne 176: Ligne 38:
 <code> <code>
 /opt/dokuwiki/bin# su www-data /opt/dokuwiki/bin# su www-data
-/opt/dokuwiki/bin$ php indexer.php+/opt/dokuwiki/bin$ php indexer.php -c
 Searching pages... 96 pages found. Searching pages... 96 pages found.
 cuisine:caramelbeurresale... done. cuisine:caramelbeurresale... done.
Ligne 187: Ligne 49:
 /opt/dokuwiki/bin# /opt/dokuwiki/bin#
 </code> </code>
- 
- 
- 
-==== Ajouter la licence Creative Commons en pieds de page ==== 
-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> 
- 
- 
  
 ==== Créer un Index Sitemap ==== ==== Créer un Index Sitemap ====
 L'index Sitemap permet d'indexer complètement le wiki sous Google. L'index Sitemap permet d'indexer complètement le wiki sous Google.
  
-Pour le créer il faut +Pour le créer il faut modifier le paramètre de configuration "sitemap" à 1
-  * créer le fichier sitemap.xml.gz avec des droits d'écriture+
  
-<code> +Le sitemap est accessible avec le chemin /wiki/doku.php?do=sitemap, exemple : http://www.bouthors.fr/wiki/doku.php?do=sitemap. 
-# cd /opt/dokuwiki +===== Backup ===== 
-/opt/dokuwiki# touch sitemap.xml.gz +Liste des fichiers à sauvegarder.
-/opt/dokuwiki# chown www-data sitemap.xml.gz +
-/opt/dokuwiki# +
-</code>+
  
-  * activer la génération du fichier dans ///etc/dokuwiki/local.php// : 
- 
-  $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. 
- 
-===== Backup ===== 
 Avec le paquet debian Avec le paquet debian
   * /etc/dokuwiki/apache.conf   * /etc/dokuwiki/apache.conf
Ligne 227: Ligne 69:
  
 ===== Links ===== ===== Links =====
-  * [[bender]] 
-  * [[serveur_web]] 
-  * [[linux:]] 
   * http://wiki.splitbrain.org/wiki:dokuwiki   * http://wiki.splitbrain.org/wiki:dokuwiki
   * http://wiki.splitbrain.org/wiki:sitemap   * http://wiki.splitbrain.org/wiki:sitemap
linux/dokuwiki.1294260216.txt.gz · Dernière modification: 2011/01/05 21:43 par matthieu
Recent changes RSS feed Debian Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki