| |
| logiciel:internet:dokuwiki:start [2022/08/25 22:25] – [Utilisation] admin | logiciel:internet:dokuwiki:start [2022/10/01 23:26] (Version actuelle) – modification externe 127.0.0.1 |
|---|
| | {{tag>Logiciel}} |
| |
| | ====== Dokuwiki : un wiki opensource sans base de données ====== |
| | |
| | ===== Pré-requis ===== |
| | |
| | - **Avoir installé [[apt>php,php-gd,php-xml]]** ou <cli prompt='$ '>...@...:~$ sudo apt install {php,php-{gd,xml}}</cli>__**Remarque pour PHP 7**__ :\\ Pour les plugins qui donnent des erreurs, éditez le fichier **lib/plugins/<plugin>/syntax.php** pour le modifier comme indiqué dans les messages d'erreur : |
| | * remplacez tous les **&$renderer** par **Doku_Renderer $renderer** |
| | * remplacez tous les **&$handler** par **Doku_Handler $handler** |
| | - **Avoir installé Java**, voir [[logiciel:programmation:java:start]] |
| | - **Avoir mis en place les liens interwiki**, en particulier les liens //apt:// (cf. [[#Configuration]]) |
| | - **Avoir désactivé le redimensionnement des icônes** (cf. [[#Désactiver le redimensionnement des icônes]]) |
| | ===== Installation ===== |
| | |
| | - **[[tutoriel:internet:dokuwiki:install:downloader:start|]]** |
| | - **[[logiciel:internet:dokuwiki:upgrade:start|]]** |
| | |
| | Méthode toujours valable : |
| | <WRAP list-deep> |
| | <subnumberlist> |
| | - **Allez sur la page [[https://download.dokuwiki.org/]]** |
| | - **Cliquez sur <key>Download</key>** ou personnalisez le téléchargement en cochant les options voulues puis cliquez sur <key>Start Download</key> en bas. |
| | - **Enregistrez** le fichier .tgz où vous voulez (par ex. dans le répertoire Téléchargements) |
| | - **Décompressez** l'archive de distribution -> répertoire dokuwiki-xxxxxxxxxxxxxx/ |
| | - **Lancez Filezilla** |
| | - Ouvrez votre serveur |
| | - Localement, ouvrez le répertoire dokuwiki-xxxxxxxxxxxxxx/ |
| | - et envoyez tout le répertoire dokuwiki sur votre espace Web. |
| | - **Ouvrez la page de votre futur site** [[https://monsite.tld/install.php]] |
| | - **Choisissez votre langue:** : fr, puis <key>Mettre à jour</key> |
| | - **Nom du wiki** : Donnez le titre de votre Wiki |
| | - Cochez **Activer le contrôle d'accès (recommandé)** |
| | - **Super-utilisateur** : son nom d'user |
| | - **Nom** : Son nom véritable |
| | - **Adresse de courriel** : Son courriel |
| | - **Mot de passe** : Son mot de passe, et confirmez-le |
| | - **Politique de contrôle d'accès initiale** : choisissez le degré de fermeture du wiki |
| | - Ne cochez pas **Permettre aux utilisateurs de s'enregistrer eux-mêmes.** (sauf si vous le voulez...) |
| | - **Veuillez choisir la licence sous laquelle vous souhaitez placer votre contenu :** : Cochez la licence désirée<WRAP formalbox center 60%> |
| | **Si le message d'erreur suivant apparaît** :{{ logiciel:internet:dokuwiki:dokuwiki_installer_permissions_001.png?600 |erreur de l'installateur au démarrage}}, voir la page [[http://www.dokuwiki.org/install:permissions]]. Les réglages à appliquer sont, en se plaçant dans le répertoire web (**/var/www**) :<cli prompt='$ '>...@...:~ $ cd /var/www |
| | $ sudo chgrp -R www-data doc/ |
| | $ sudo chmod -R g+w doc/</cli> |
| | **groupe www-data** pour tout le wiki\\ |
| | **en écriture pour le groupe** |
| | </WRAP> |
| | </subnumberlist> |
| | </WRAP> |
| | |
| | <WRAP list-deep> |
| | - **Sécurisation** : |
| | - **sous Apache 2, activez les .htaccess** : **Créez avec les droits d'administration le fichier /etc/apache2/sites-available/monsite.conf** pour y écrire :<code - /etc/apache2/sites-available/monsite.conf> |
| | <Directory /var/www/> |
| | Options Indexes FollowSymLinks MultiViews |
| | AllowOverride All |
| | </Directory> |
| | </code> |
| | - **Autre méthode** : éditez avec les droits d'administration le fichier **default** pour le modifier comme ceci : |
| | * dans la définition **VirtualHost**, utiliser la directive **LocationMatch** en ajoutant juste en dessous de la directive Directory :<code - ><Directory /var/www/dokuwiki> |
| | order deny,allow |
| | allow from all |
| | </Directory> |
| | |
| | <LocationMatch "/dokuwiki/(data|conf|bin|inc)/"> |
| | order allow,deny |
| | deny from all |
| | satisfy all |
| | </LocationMatch> |
| | </code> |
| | - **Mise à jour** : |
| | - **Le mieux est d'utiliser le plugin** |
| | - **Méthode manuelle, en local sur le serveur** : |
| | - **Faites une sauvegarde complète du wiki** :<cli prompt='$ '>...@...:~ $ cp -a /path/to/wiki/ /path/to/wikibackup</cli> |
| | - **Téléchargez dans le répertoire de dokuwiki la nouvelle version trouvée sur [[http://splitbrain.org/go/dokuwiki]]** :<cli prompt='$ '>...@...:~ $ cd /path/to/wiki/ |
| | ...@...:~ $ wget http://.../dokuwiki-xxxx-xx-xx.tgz</cli> |
| | - **Extrayez-le à la racine de dokuwiki en écrasant les fichiers existants** :<cli prompt='$ '>...@...:~ $ tar -xzvf dokuwiki-xxxx-xx-xx.tgz --strip-components=1</cli> |
| | - **Effacez l'archive téléchargée** :<cli prompt='$ '>...@...:~ $ rm dokuwiki-xxxx-xx-xx.tgz</cli> |
| | - **Effacez install.php** :<cli prompt='$ '>...@...:~ $ rm /path/to/wiki/install.php</cli> |
| | - **Effacez les anciens fichiers qui ne sont plus utilisés** (Liste de ces fichiers sur [[http://www.dokuwiki.org/install:upgrade]]) : |
| | - **copiez/collez la liste dans un fichier texte sur le système** (par exemple **/tmp/removeold.txt**) |
| | - **puis lancez** :<cli prompt='$ '>...@...:~ $ grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -fd</cli>Seuls les fichiers existants sont effacés. |
| | - **Réglez les permissions**, sans oublier les éventuels nouveaux répertoires sous data/ |
| | - **Comparez votre .htaccess avec le .htaccess.dist fourni** pour les changements nécessaires |
| | - **Mettez à jour** les plugins et les templates |
| | - **Effacez le cache** en faisant un touch de conf/local.php pour sauver la configuration |
| | - **Mettre à jour l'index si besoin** |
| | - Ces étapes sont sans danger tant qu'on ne change 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 ===== |
| | |
| | <WRAP list-deep> |
| | - **[[logiciel:internet:dokuwiki:parametres:start]]** |
| | - **[[logiciel:internet:dokuwiki:interwiki:start]]** |
| | - **Thèmes** : |
| | - **[[logiciel:internet:dokuwiki:themes:monobook:start]]** |
| | - **[[logiciel:internet:dokuwiki:themes:vector:start]]** |
| | - **[[tutoriel:internet:dokuwiki:toolbarbutton]]** |
| | </WRAP> |
| | |
| | ===== Utilisation ===== |
| | |
| | <subnumberlist> |
| | - **Greffons intéressants** : Copiez l'adresse du lien (clic droit dessus), collez-la dans la case URL du gestionnaire de plugins et cliquez sur Télécharger |
| | - **[[logiciel:internet:dokuwiki:plugins:a2s:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:addnewpage:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:alphalist2:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:backup:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:bookcreator:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:captcha:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:charpicker:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:cli:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:cloud:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:color:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:confmanager:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:copypage:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:custombuttons:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:definitionlist:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:diagram:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:diffpreview:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:ditaa:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:dropfiles:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:dw2pdf:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:edittable:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:folded:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:gallery:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:hidden:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:keyboard:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:loglog:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:mathpublish:start]]** : Voir [[https://www.dokuwiki.org/plugin:mathpublish]] |
| | - **[[logiciel:internet:dokuwiki:plugins:move:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:multiorphan:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:nbsp:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:stale:start|]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:odt:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:pagelist:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:qna:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:sortablejs:start]]** |
| | - **subnumberlist** |
| | - **[[logiciel:internet:dokuwiki:plugins:sync:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:tab:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:tablecalc:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:templatepagename:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:tag:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:toolbox:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:translate:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:translation:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:typography:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:upgrade:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:vshare:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:wrap:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:wrapadd:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:yalist:start]]** |
| | </subnumberlist> |
| | |
| | <subnumberlist> |
| | - **[[logiciel:internet:dokuwiki:plugins:siteexport:start]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:text:start]]** |
| | - **[[tutoriel:internet:dokuwiki:titres:number:start|]]** |
| | * **[[logiciel:internet:dokuwiki:plugins:numberedheadings:start|]]** |
| | * **[[logiciel:internet:dokuwiki:plugins:headingnumbers:start|]]** |
| | - **[[logiciel:internet:dokuwiki:plugins:cacherevisionseraser:start]]** |
| | - **bureaucracy** : Voir [[https://www.dokuwiki.org/plugin:bureaucracy]] |
| | - **doodle2** : Voir [[https://www.dokuwiki.org/plugin:doodle2]] |
| | - **French Typography** : Voir [[https://www.dokuwiki.org/plugin:french_typography]] |
| | - **odt2dw** : Voir [[https://www.dokuwiki.org/plugin:odt2dw]] |
| | - **translation** : Voir [[https://www.dokuwiki.org/plugin:translation]] ; se configure dans les paramètres de configuration (administration) |
| | </subnumberlist> |
| | |
| | - **[[logiciel:internet:dokuwiki:plugins:extlist:start|]]** FIXME : modifie les réglages des listes !!! |
| | |
| | <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 ! |
| | |
| | Greffons qui ne marchent plus et font disparaître l'affichage |
| | * **uparrow** |
| | * **codebutton2** |
| | * **jcapture** : Voir [[logiciel:internet:dokuwiki:plugins:jcapture]] |
| | |
| | **__Note avec PHP 7__** : |
| | |
| | Pour les plugins qui donnent des erreurs, éditez le fichier **lib/plugins/<plugin>/syntax.php** pour le modifier comme indiqué dans les messages d'erreur : |
| | * remplacez tous les **&$renderer** par **Doku_Renderer $renderer** |
| | * remplacez tous les **&$handler** par **Doku_Handler $handler** |
| | </WRAP> |
| | |
| | <WRAP list-deep> |
| | 2. **Tutoriels** : |
| | - **[[tutoriel:internet:dokuwiki:Dokuwiki:icones:start|]]** |
| | - **[[tutoriel:internet:dokuwiki:pgtelechargement]]** |
| | - **Créer une ferme de dokuwikis : **[[http://doc.nfrappe.fr/doku.php?id=logiciel:internet:dokuwiki:start1#installation|Installez un dokuwiki]] sur votre serveur en le nommant fermier |
| | </WRAP> |
| | |
| | ===== Désinstallation ===== |
| | |
| | Sur le serveur, effacez le répertoire racine du Dokuwiki. |
| | ===== Voir aussi ===== |
| | |
| | * **(fr)** [[https://doc.ubuntu-fr.org/dokuwiki]] |
| | |
| | ---- |
| | //Basé sur << [[https://doc.ubuntu-fr.org/dokuwiki|Dokuwiki - C'est mieux quand c'est simple]] >> par doc.ubuntu-fr.org.// |
