Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

logiciel:internet:dokuwiki:start [2019/08/07 13:38]
admin créée
logiciel:internet:dokuwiki:start [2019/08/08 13:04] (Version actuelle)
admin
Ligne 25: Ligne 25:
  
 ====== - Installation ====== ====== - Installation ======
 +
 +===== - Téléversement sur le serveur =====
  
 Vous pouvez télécharger Dokuwiki sur la page [[http://​www.splitbrain.org/​go/​dokuwiki]],​ puis le téléverser via FTP sur votre serveur et lancer [[http://​monsite.tld/​install.php]] Vous pouvez télécharger Dokuwiki sur la page [[http://​www.splitbrain.org/​go/​dokuwiki]],​ puis le téléverser via FTP sur votre serveur et lancer [[http://​monsite.tld/​install.php]]
Ligne 30: Ligne 32:
 Mais il est plus simple d'​utiliser un script. Mais il est plus simple d'​utiliser un script.
   * Téléchargez le script [[https://​www.dokuwiki.org/​lib/​exe/​fetch.php?​tok=96db48&​media=https%3A%2F%2Fgithub.com%2Fsplitbrain%2Fdokuwiki-downloader%2Fraw%2Fmaster%2Fdokuwiki-downloader.php]]   * Téléchargez le script [[https://​www.dokuwiki.org/​lib/​exe/​fetch.php?​tok=96db48&​media=https%3A%2F%2Fgithub.com%2Fsplitbrain%2Fdokuwiki-downloader%2Fraw%2Fmaster%2Fdokuwiki-downloader.php]]
-  * Via FTP, déposez-le sur le serveur, dans le répertoire où vous voulez installer votre wiki +  * Via FTP, déposez-le sur le serveur, dans le répertoire où vous voulez installer votre wiki, par exemple **/​var/​www/​html/​essai** pour le mettre en [[http://​monsite.tld/​essai]] 
-  * Lancez le script : [[http://votrewiki.com/​dokuwiki-downloader.php]]{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-downloader-01.png?​600 |}}+  * Lancez le script : [[http://monsite.tld/essai/​dokuwiki-downloader.php]]{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-downloader-01.png?​600 |}}
   * Cliquez sur <​key>​Step 1: Download the TGZ -></​key>​ :{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-downloader-02.png?​600 |}}   * Cliquez sur <​key>​Step 1: Download the TGZ -></​key>​ :{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-downloader-02.png?​600 |}}
   * Cliquez sur <​key>​Step 2: Extract the TGZ -></​key>​ :{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-downloader-03.png?​600 |}}   * Cliquez sur <​key>​Step 2: Extract the TGZ -></​key>​ :{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-downloader-03.png?​600 |}}
   * Cliquez sur <​key>​Step 3: Clean Up -></​key>​ :{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-downloader-04.png?​600 |}}   * Cliquez sur <​key>​Step 3: Clean Up -></​key>​ :{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-downloader-04.png?​600 |}}
-  * Cliquez sur <​key>​Take me to the Dokuwiki Setup -></​key> ​; vous vous retrouvez dans l'​installateur :{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-installer-01.png?​600 |}}+  * Cliquez sur <​key>​Take me to the Dokuwiki Setup -></​key>​ 
 + 
 +===== - Installation ===== 
 + 
 +Vous vous retrouvez dans l'​installateur :{{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-installer-01.png?​600 |}}
   * Choisissez la langue <​key>​fr</​key>​ puis <​key>​Mettre à jour</​key>​ : {{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-installer-02.png?​600 |}}   * Choisissez la langue <​key>​fr</​key>​ puis <​key>​Mettre à jour</​key>​ : {{ :​logiciel:​internet:​cms:​dokuwiki:​dokuwiki-installer-02.png?​600 |}}
   * Vérifiez que tous les pré-requis sont OK ; sinon, corrigez-les   * Vérifiez que tous les pré-requis sont OK ; sinon, corrigez-les
Ligne 48: Ligne 54:
     - Enfin, <​key>​Enregistrer</​key>​     - Enfin, <​key>​Enregistrer</​key>​
  
-===== - Installation sur un serveur local =====+===== - Cas d'un serveur local =====
  
-Un serveur HTTP est supposé installé (LLMP, LAMP, LEMP, Wamp, etc). Nous supposerons que sa racine est en **/​var/​www/​html**.+Installer comme plus haut.
  
-  * Créez un répertoire sur la racine du serveur, par exemple **/​var/​www/​html/​doc** +<WRAP center round important ​60%> 
-  * Via FTP, déposez-y le script +Si le message d'​erreur suivant apparaît :
-  * Lancez le script +
- +
-Quand l'​installateur Dokuwiki s'​ouvre,​ tout renseigner. +
- +
-Dans firefox, ouvrir [[http://​localhost/​doc]]. Il s'​affiche : +
- +
-{{internet:​dokuwiki_premier_demarrage.001.png|}} +
- +
-Pour compléter l'​installation initiale, Lancer, comme demandé, **install.php** en cliquant sur le lien proposé. On peut aussi ouvrir la page [[http://​localhost/​doc/​install.php]]. Pour des explications,​ voir la page [[http://​www.dokuwiki.org/​installer]] (en anglais) +
- +
-<note important>​Si le message d'​erreur suivant apparaît :+
  
 {{internet:​dokuwiki_installer_permissions_001.png?​600|erreur de l'​installateur au démarrage}} {{internet:​dokuwiki_installer_permissions_001.png?​600|erreur de l'​installateur au démarrage}}
Ligne 78: Ligne 73:
 <​cli>​$ cd /var/www <​cli>​$ cd /var/www
 $ sudo chgrp -R www-data doc/ $ sudo chgrp -R www-data doc/
-$ sudo chmod -R g+w doc/</​cli></​code> +$ sudo chmod -R g+w doc/</​cli>​ 
- +</WRAP>
-L'​installateur s'​ouvre. +
- +
-Choisir la langue **fr** (en haut à droite) +
- +
-{{internet:​installer_-_choix_de_la_langue.png|}} +
- +
-Remplir les rubriques +
- +
-{{internet:​dokuwiki_installer.png|}} +
- +
-et créer la page de sommaire.+
  
 ==== - Sécurisation sous Apache 2 ==== ==== - Sécurisation sous Apache 2 ====
Ligne 115: Ligne 99:
  
 ===== - Mise à jour ===== ===== - Mise à jour =====
 +
 +Le mieux est d'​utiliser le plugin ​
  
 Elle se fait en local sur la machine. Elle se fait en local sur la machine.
Ligne 123: Ligne 109:
  
 Faire une sauvegarde complète du wiki : Faire une sauvegarde complète du wiki :
- +<cli>cp -a /​path/​to/​wiki/​ /​path/​to/​wikibackup</​cli>
-  * <code>cp -a /​path/​to/​wiki/​ /​path/​to/​wikibackup</​code>+
  
 Télécharger directement dans le répertoire de dokuwiki la nouvelle version trouvée sur http://​splitbrain.org/​go/​dokuwiki : Télécharger directement dans le répertoire de dokuwiki la nouvelle version trouvée sur http://​splitbrain.org/​go/​dokuwiki :
- +<cli>cd /​path/​to/​wiki/​ 
-  * <code>cd /​path/​to/​wiki/​ +wget http://​.../​dokuwiki-xxxx-xx-xx.tgz</​cli>
-wget http://​.../​dokuwiki-xxxx-xx-xx.tgz</​code>+
  
 L'​extraire à la racine de dokuwiki en écrasant les fichiers existants : L'​extraire à la racine de dokuwiki en écrasant les fichiers existants :
- +<cli>tar -xzvf dokuwiki-xxxx-xx-xx.tgz --strip-components=1</​cli>
-  * <code>tar -xzvf dokuwiki-xxxx-xx-xx.tgz --strip-components=1</​code>+
  
 Effacer l'​archive téléchargée : Effacer l'​archive téléchargée :
- +<cli>rm dokuwiki-xxxx-xx-xx.tgz</​cli>
-  * <code>rm dokuwiki-xxxx-xx-xx.tgz</​code>+
  
 Consulter le Changelog Consulter le Changelog
  
 Effacer install.php : Effacer install.php :
- +<cli>rm /​path/​to/​wiki/​install.php</​cli>
-  * <code>rm /​path/​to/​wiki/​install.php</​code>+
  
 Effacer les anciens fichiers qui ne sont plus utilisés (Liste de ces fichiers sur [[http://​www.dokuwiki.org/​install:​upgrade]] ). Pour effacer les fichiers inutiles,on peut copier/​coller la liste dans un fichier texte sur le système (par exemple **/​tmp/​removeold.txt**),​ puis lancer les commandes suivantes pour tester et effacer tous ces fichiers et répertoires. Seuls les fichiers existants sont effacés. Effacer les anciens fichiers qui ne sont plus utilisés (Liste de ces fichiers sur [[http://​www.dokuwiki.org/​install:​upgrade]] ). Pour effacer les fichiers inutiles,on peut copier/​coller la liste dans un fichier texte sur le système (par exemple **/​tmp/​removeold.txt**),​ puis lancer les commandes suivantes pour tester et effacer tous ces fichiers et répertoires. Seuls les fichiers existants sont effacés.
- +<cli>grep -Ev "​^($|#​)"​ /​tmp/​removeold.txt | xargs -n 1 rm -fd</cli>
-  * <code>grep -Ev "​^($|#​)"​ /​tmp/​removeold.txt | xargs -n 1 rm -fd</code>+
  
 Régler les permissions si nécessaire ; sans oublier les éventuels nouveaux répertoires sous data/ Régler les permissions si nécessaire ; sans oublier les éventuels nouveaux répertoires sous data/
Ligne 159: Ligne 139:
 Mettre à jour l'​index si besoin ; voir les outils en ligne de commande Mettre à jour l'​index si besoin ; voir les outils en ligne de commande
  
-<note>Ces étapes sont sans danger tant qu'on respecte la précaution de ne changer que les versions locales des fichiers de configuration (comme conf/​local.php au lieu de conf/​dokuwiki.php). DokuWiki ne remplacera pas ces fichiers locaux. Si on utilise toujours le config manager, on est en sécurité car il sauve toujours dans local.php. De même, les données utilisateur et l'​information ACL ne seront jamais remplacées car DokuWiki ne fournit que des exemples (avec une extension .dist).</​note>+<WRAP center round info 60%> 
 +Ces étapes sont sans danger tant qu'on respecte la précaution de ne changer que les versions locales des fichiers de configuration (comme conf/​local.php au lieu de conf/​dokuwiki.php). DokuWiki ne remplacera pas ces fichiers locaux. Si on utilise toujours le config manager, on est en sécurité car il sauve toujours dans local.php. De même, les données utilisateur et l'​information ACL ne seront jamais remplacées car DokuWiki ne fournit que des exemples (avec une extension .dist). 
 +</WRAP>
  
 ====== - Configuration ====== ====== - Configuration ======
Ligne 661: Ligne 643:
 ====== - Greffons intéressants ====== ====== - Greffons intéressants ======
  
-La page qui en parle est : [[http://www.dokuwiki.org/plugins]]+Voir [[logiciel:​internet:dokuwiki:plugins:start|]]
  
-Copier l'​adresse du lien (clic droit dessus) et la coller dans la case URL du gestionnaire de plugins et cliquer sur Télécharger 
  
-<WRAP center round important 60%> 
-Le greffon **jquery** est maintenant intégré à Dokuwiki. 
  
-Il ne faut surtout pas l'​installer car cela provoque des problèmes comme la disparition des boutons de l'​éditeur ! 
-</​WRAP>​ 
  
-===== - codebutton2 ===== 
  
-  * Voir la page : [[https://​www.dokuwiki.org/​plugin:​codebutton2]] 
-  * penser à renommer le répertoire **lib/​plugins/​dokuwiki-plugin-codebutton2 -> lib/​plugins/​codebutton2** 
-  * si les icônes sont trop petites, voir [[#​Désactiver le redimensionnement des icônes]] 
  
-===== - definitions ===== 
  
-  * voir la page : [[https://​www.dokuwiki.org/​plugin:​definitions]] 
  
-===== - jcapture ===== 
  
-Voir la page [[logiciel:​internet:​dokuwiki:​plugins:​jcapture|]] 
  
-===== - backup ===== 
  
-  * voir la page : [[https://​www.dokuwiki.org/​plugin:​backup]] 
  
-===== - bureaucracy ===== 
  
-  * voir la page : [[https://​www.dokuwiki.org/​plugin:​bureaucracy]] 
  
-===== - captcha ===== 
  
-  * voir la page : [[https://​www.dokuwiki.org/​plugin:​captcha]] 
- 
-===== - doodle2 ===== 
- 
-Voir la page : [[https://​www.dokuwiki.org/​plugin:​doodle2]] 
- 
-===== - French Typography ===== 
- 
-Voir la page : [[https://​www.dokuwiki.org/​plugin:​french_typography]] 
- 
-===== - Numbered headings ===== 
- 
-Voir [[https://​www.dokuwiki.org/​plugin:​numberedheadings]] 
- 
-===== - keyboard ===== 
- 
-Voir [[https://​www.dokuwiki.org/​plugin:​keyboard]] (plus maintenu) 
- 
-===== - mathpublish ===== 
- 
-Voir [[https://​www.dokuwiki.org/​plugin:​mathpublish]] 
- 
-===== - wrap ===== 
- 
-Remplace avantageusement note. 
- 
-===== - odt ===== 
- 
-Voir [[https://​www.dokuwiki.org/​plugin:​odt]] 
- 
-===== - odt2dw ===== 
- 
-Voir [[https://​www.dokuwiki.org/​plugin:​odt2dw]] 
- 
-===== - pagemove ===== 
- 
-Voir [[https://​www.dokuwiki.org/​plugin:​pagemove]] 
- 
-===== - sync ===== 
- 
-Voir [[https://​www.dokuwiki.org/​plugin:​sync]] 
-  * Pour qu'il fonctionne, il faut : 
-    * sur le site distant, activer l'​interface XML-RPC 
-    * sur le site local, déclarer l'​utilisateur admin dans le profil sync 
- 
-<WRAP center round important 60%> 
-En cas de problème de timeout, si le plugin **sync** donne le message <​code><<​Failed to fetch remote file list. transport error - Timeout while reading response (15.855s)>></​code>​ 
- 
-Le client XMLRPC hérite du client HTTP DokuWiki mais vous pouvez fixer directement le délai d'​attente après l'​initialisation en [[tutoriel:​ficedit#​Modifier un fichier avec les droits d'​administration|ouvrant avec les droits d'​administration]] le fichier **...lib/​plugins/​sync/​admin.php** pour le modifier comme ceci : 
- 
-Dans la fonction **_connect()**,​ cherchez la ligne<​code>​$this->​client->​timeout = $timeout;</​code>​ juste après un if, dupliquez-la,​ commentez-en une et donnez la valeur voulue du timeout comme ceci : 
- 
-<code - .../​lib/​plugins/​sync/​admin.php>​ 
-(...) 
-        if ( isset($this->​profiles[$this->​profno]['​timeout'​]) ){ 
-          $timeout = (int) $this->​profiles[$this->​profno]['​timeout'​];​ 
-        } else { 
-          $timeout = $this->​defaultTimeout;​ 
-        } 
-        //​$this->​client->​timeout = $timeout; 
-        $this->​client->​timeout = 60; 
-(...) 
-</​code>​ 
-</​WRAP>​ 
- 
-===== - Tags ===== 
- 
-Permet d'​assigner des tags aux pages 
- 
-Voir [[https://​www.dokuwiki.org/​plugin:​tag]] 
- 
-<WRAP center round tip 60%> 
-Mauvais affichage des tags en haut de la page 
- 
-Lorsque vous insérez la syntaxe en haut d'une page de wiki, la sortie du plugin sera affichée en dessous de la table des matières. 
- 
-Pour améliorer l'​aspect visuel, changez votre **lib/​plugins/​tag/​style.css** comme suit : 
- 
-<code - lib/​plugins/​tag/​style.css>​ 
-div.dokuwiki div.tags { 
-  border-top: 2px dotted __border__; 
-  font-size: 95%; 
-  text-align: right; 
-  /​*text-align:​ left;*/ 
-  /*clear: both;*/ 
-  margin-bottom:​ 1.4em; 
-} 
-</​code>​ 
-</​WRAP>​ 
  
-===== - translation ===== 
  
-Voir [[https://​www.dokuwiki.org/​plugin:​translation]] 
-  * se configure dans les paramètres de configuration (administration) 
  
 ====== - Trucs et astuces ====== ====== - Trucs et astuces ======

Navigation