Différences

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

--- dokuwiki [Le 02/08/2017, 16:25] – [Installation] 90.107.135.25
+++ dokuwiki [Le 13/09/2026, 17:16] (Version actuelle) – suppr install.php | détails krodelabestiole
@@ Ligne 1: / Ligne 1: @@
 {{tag>travail_collaboratif wiki cms}}
-----
-{{ http://upload.wikimedia.org/wikipedia/commons/e/e4/Dokuwiki_logo.png}}
-====== Dokuwiki - C'est mieux quand c'est simple ======
-**DokuWiki** est un moteur de [[wpfr>wiki]] libre sous licence GNU GPL conforme aux standards, simple à utiliser, dont le but principal est de créer des documentations de toute sorte. Ce logiciel est développé en PHP par Andreas Gohr.
+{{ https://upload.wikimedia.org/wikipedia/commons/e/e4/Dokuwiki_logo.png}}
+====== DokuWiki ======
-Contrairement à [[Mediawiki]], il n'utilise pas de base de données((donc pas besoin de serveur SQL)) pour sauvegarder les pages, mais des fichiers texte, avec de l'indexation.
+**[[wpfr>DokuWiki]]** est un moteur de [[wpfr>wiki]] libre et relativement simple.
-De cette manière Dokuwiki est plus rapide que Mediawiki pour présenter les pages au visiteur.((http://meta.wikimedia.org/wiki/DokuWiki_vs_MediaWiki_benchmarks))((http://forum.dokuwiki.org/thread/621))
+Il permet de créer des documentations de toute sorte. Cette [[:web#application web]] est développée en [[:PHP]] par Andreas Gohr.
-===== Pré-requis =====
+Il s'agit techniquement d'un [[:CMS]] //flat file//. On entend par là qu'il n'utilise pas de base de données. Le contenu dynamique est stocké sous forme de fichiers ''.txt'' avec de l'indexation. :-P\\
+Ceci permet à **DokuWiki** d'être plus rapide que **[[:MediaWiki]]** pour présenter les pages aux visiteurs.((https://meta.wikimedia.org/wiki/DokuWiki_vs_MediaWiki_benchmarks))((https://forum.dokuwiki.org/thread/621))
-  * Disposer des [[:sudo|droits d'administration]].
+<note important>
-  * Disposer d'une connexion à Internet configurée et activée.
+**DokuWiki** est toujours activement maintenu, mais il s'agit d'un projet ancien.\\
+Il existe aujourd'hui des solutions plus modernes, rapides, sécurisées et simples d'utilisation, permettant de mettre en place des documentations participatives (en particulier des [[:cms#générateurs de sites statiques]]).
+Voir [[https://forum.ubuntu-fr.org/viewtopic.php?pid=22712575#p22712575|ce message]] sur le forum. On peut citer par ex. :
+  * [[https://docusaurus.io/fr/|Docusaurus]](([[https://github.com/facebook/docusaurus|GitHub]]))
+  * [[https://www.bookstackapp.com/|BookStack]](([[https://github.com/BookStackApp/BookStack|GitHub]]))
+  * [[https://docsify.js.org/|docsify]](([[https://github.com/docsifyjs/docsify/|GitHub]]))
+  * [[https://www.docsy.dev/|Docsy]] pour [[https://gohugo.io/|Hugo]]
+  * [[https://js.wiki/|Wiki.js]](([[https://github.com/Requarks/wiki|GitHub]]))
+</note>
+<note>**DokuWiki** est la solution utilisée pour notre [[:wiki]], et donc cette documentation.</note>
 ===== Installation =====
-sssss
-==== Par les dépôts ====
-Dokuwiki est présent dans les dépôts officiels d'Ubuntu. Utiliser le paquet officiel est simple et rapide et a l'avantage de respecter les [[http://people.canonical.com/~cjwatson/ubuntu-policy/policy.html/|standards Ubuntu]].
+<note>
+**DokuWiki** étant une solution destinée à être déployée sur un serveur, toutes les manipulations dont nous traiterons ici se feront en ligne de commande.
+</note>
-Il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt://dokuwiki|dokuwiki]]**.
+<note important>
+**DokuWiki** est une [[:web#applications_web|application]] accessible directement en ligne. Pour des raisons importantes de sécurité, il est //impératif// de toujours utiliser la dernière version et de la maintenir à jour.
-<note important>Le site officiel de Dokuwiki recommande d'installer la dernière version disponible sur leur site, qui dispose de correctifs de sécurité.</note>
+**DokuWiki** est disponible dans les dépôts officiels d'Ubuntu, mais la version ainsi proposée n'est presque jamais la dernière.
-====Version du site officiel ====
+D'une manière générale [[:APT]] et les [[:dépôts]] d'[[:Ubuntu]] et [[:distributions#Debian]] (format [[:deb]]) ne sont pas pensés pour fournir des versions particulièrement récentes des logiciels. Par conséquent ils ne conviennent généralement pas au déploiement d'[[:web#applications_web|applications]] ou services //[[:web]]//.
-   - [[http://www.splitbrain.org/projects/dokuwiki|Téléchargez l'archive de la dernière version stable sur le site officiel]].
+C'est pourquoi nous documentons ici une installation //manuelle//, qui peut se mettre à jour elle-même.
-   - Installez un serveur [[Apache]] ainsi que le paquet **[[apt://php5|php5]]**.
+</note>
-   - Décompressez l'archive dans votre Dossier personnel, puis renommez le dossier extrait en **dokuwiki**.
-   - Copiez le dossier **dokuwiki** sous **/var/www** (sur **/var/www/html** à partir d'Ubuntu 14.04) avec les droits administrateur avec cette [[:commande_shell|commande]] dans un [[terminal]] :<code>sudo cp -R dokuwiki /var/www</code> ou à partir d'Ubuntu 14.04 : <code>sudo cp -R dokuwiki /var/www/html</code>
-   - Modifiez le propriétaire et le groupe du dossier dokuwiki et de ses fichiers :<code>sudo chown -R www-data:www-data /var/www/dokuwiki</code> ou à partir d'Ubuntu 14.04 : <code>sudo chown -R www-data:www-data /var/www/html/dokuwiki</code>
-   - Assurez-vous que vous faites partie du groupe **www-data** via l'outil [[:users-admin|Utilisateurs et groupes]].
-   - Lancez l'installation en collant ce lien dans la barre d'adresse de votre navigateur : [[http://localhost/dokuwiki/install.php]]
-//basé sur [[http://www.dokuwiki.org/install:ubuntu|Alternative Easier Custom Installation]].//
+==== Prérequis ====
-**Nota:** //une variante// consiste à copier le dossier dokuwiki, non pas dans /var/www/, mais dans /media/www-dev/private ou dans /media/www-dev/public, après avoir créé ces deux répertoires **en suivant pas à pas** le [[:tutoriel:lamp_repertoires_de_travail#donner_les_droits_utilisateur_aux_repertoires_de_travail|tutoriel LAMP]]. Cela permettrait notamment de diminuer les problèmes liés à la sécurité.
+Pour installer **DokuWiki** vous aurez besoin d'un [[:web#serveurs|serveur HTTP]] et de [[:PHP]].
-====Autres installations====
-   * [[http://bitnami.org/stack/dokuwiki|Télécharger sur bitNami]]
+<note>Sur un [[:hébergement]] web géré par l'hébergeur, ces prérequis devraient déjà être en place, donc toutes ces étapes devraient être inutiles.
+N'hésitez pas à contacter le support de l'hébergeur si ce n'est pas le cas.</note>
-=====Utilisation=====
+[[:apache2|Apache]] est le serveur HTTP le plus couramment utilisé, c'est celui que nous choisirons ici.
-====Plugins====
+Pour installer Apache et PHP :
+<code>sudo apt install apache2 php libapache2-mod-php</code>
-Il vous suffit de copier l'adresse du paquet de plugin à installer et de le copier dans la page des plugins, puis valider pour l'installer.
+**DokuWiki** requiert ensuite l'activation de certains modules PHP qui ne sont pas installés par défaut sous Ubuntu :
-[[http://www.dokuwiki.org/fr:plugins?pluginsort=c|Voir la page listant les plugins disponibles]].
+<code>sudo apt install php-curl php-gd php-intl php-json php-mbstring php-xml php-zip</code>
-Des plugins intéressants :
+**DokuWiki** a aussi besoin du module [[:apache2#mod_rewrite]] :
-   * [[http://fr.wikipedia.org/wiki/OpenID|OpenID]] : les utilisateurs pourront se connecter simplement avec leur adresse de courriel, [[http://openid.net/get-an-openid|Gmail, Yahoo et d'autres comptes sont compatibles]] (c'est un protocole libre, contrairement au Facebook login) : [[http://www.dokuwiki.org/plugin:openid|openid]] : la gestion des ACL ne change pas.
+<code>sudo a2enmod rewrite</code>
-   * Multilingue : [[http://www.dokuwiki.org/plugin:translation|Translation]]
-   * Vidéo : [[http://www.dokuwiki.org/plugin:vshare|vshare]]
-   * Tableau Csv : [[http://www.dokuwiki.org/plugin:csv|csv]]
-   * Compatible avec un trieur de tableau côté client : [[http://www.dokuwiki.org/plugin:sortablejs|sortablejs]]
-   * Boite graphique : [[http://www.dokuwiki.org/plugin:note|note]], [[http://www.dokuwiki.org/plugin:blockquote|blockquote]]
-   * [[OpenstreetMap]] : [[http://www.dokuwiki.org/plugin:openlayersmap|openlayersmap]]
-   * Export au format OpenOffice.org : [[http://www.dokuwiki.org/plugin:odt|odt]]
-   * Export au format PDF : [[http://www.dokuwiki.org/plugin:html2pdf|html2pdf]]
-   * Présentation en ligne : [[http://www.dokuwiki.org/plugin:s5|S5]]
-   * Gestion des tâches ( compatible avec outil calendrier ) : [[http://www.dokuwiki.org/plugin:task|task]]
-   * Éditeur tel-tel (WYSIWYG) : [[http://www.dokuwiki.org/plugin:fckglite|fckglite]]
-   * Gestion avancée des droits ACL : [[http://www.dokuwiki.org/plugin:superacl|superacl]]
-   * Minimiser des partie des pages : [[http://www.dokuwiki.org/plugin:folded|folded]]
-   * Latex : [[http://www.dokuwiki.org/plugin:math|math]]
-   * Exporter le wiki pour une version hors ligne : [[http://www.dokuwiki.org/plugin:siteexport|siteexport]]
-Dans une vision de page au même niveau et tagué :
+Nous allons ensuite créer un [[:apache2#hotes_virtuels|hôte virtuel]] pour **DokuWiki**, dont la racine sera ''/var/www/dokuwiki'' :
-   * [[http://www.dokuwiki.org/plugin:tag|Tag]]
+<code>sudo nano /etc/apache2/sites-available/dokuwiki.conf</code>
+Ce qui ouvre un fichier dans lequel nous allons coller :
+<file - dokuwiki.conf><VirtualHost *:80>
+        ServerName dokuwiki.localhost
+        DocumentRoot /var/www/dokuwiki
+        <Directory /var/www/dokuwiki>
+                AllowOverride all
+                Require all granted
+        </Directory>
+        ErrorLog /var/log/apache2/error.dokuwiki.log
+        CustomLog /var/log/apache2/access.dokuwiki.log combined
+</VirtualHost></file>
+Si un nom de domaine pointe sur le serveur, on l'indique à la place de ''dokuwiki.localhost'' pour la directive ''ServerName''.\\
+(''Ctrl+X'' puis ''O'' pour quitter en sauvegardant)
-Dans une vision hiérarchisée des pages :
+Finalement, on active l'hôte virtuel et on recharge la configuration d'Apache :
-   * Menu : [[http://www.dokuwiki.org/plugin:indexmenu|indexmenu]]
+<code>sudo a2ensite dokuwiki
-   * Inclure des pages ou morceau de page , dans une autres : [[http://www.dokuwiki.org/plugin:include|include]]
+sudo systemctl reload apache2</code>
-Dans une vision [[http://www.dokuwiki.org/tips:blogging|site/blog/cms]] :
+<note important>Si votre serveur est sur le [[:Web]], pensez à [[:apache2#securite|sécuriser]] l'accès au site en particulier en forçant [[:apache2#HTTPS]].</note>
-   * Blog : [[http://www.dokuwiki.org/plugin:blog|blog]], [[http://www.dokuwiki.org/plugin:blogmeta|blogmeta]], [[http://www.dokuwiki.org/plugin:bloglinks|bloglinks]], [[http://www.dokuwiki.org/tips:weblog_bookmarklet|weblog bookmarlet]]
-   * Discussion : [[http://www.dokuwiki.org/plugin:discussion|discussion]]
-   * Antispam : [[http://www.dokuwiki.org/plugin:badbehaviour|badbehaviour]]
-   * Captcha : [[http://www.dokuwiki.org/plugin:captcha|captcha]]
-   * Album-photo : [[http://www.dokuwiki.org/plugin:gallery|gallery]]
-   * Avatar : [[http://www.dokuwiki.org/plugin:avatar|avatar]]
-   * Formulaire de contact : [[http://www.dokuwiki.org/plugin:contact|contact]]
-Mesure anti-spam possible :
+==== Installation de DokuWiki ====
-   * [[http://www.dokuwiki.org/plugin:badbehaviour|badbehaviour]] (bloque les spambots), [[http://www.dokuwiki.org/plugin:captcha|Captcha]],
-   * Changer les droits ACL pour que l'édition / écriture de page ne se fasse que pour des utilisateurs connectés, et simplifier l'accès avec [[http://fr.wikipedia.org/wiki/OpenID|OpenID]]
-====Thèmes====
+Tout d'abord téléchargeons la dernière version de **DokuWiki** depuis le [[https://download.dokuwiki.org/|site officiel]] :
-   * Il est facile d'installer des templates : il suffit d'extraire l'archive du template (habituellement un fichier .zip ou .tgz) dans le répertoire lib/tpl/1).
+<code>wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz</code>
-   * Sélectionnez ensuite le template depuis le Gestionnaire de configuration en ajustant le paramètre template.
-   * [[http://www.dokuwiki.org/fr:template|Voir la page des templates]]
+Ensuite nous allons extraire le contenu de l'archive à la racine de notre hôte virtuel (''/var/www/dokuwiki'' pour l'exemple) :
-     * [[http://www.dokuwiki.org/template:monobook|Dont le template monobook]]
+<code>sudo tar -xvzf dokuwiki-stable.tgz -C /var/www
+sudo mv /var/www/dokuwiki-* /var/www/dokuwiki</code>
-==== La syntaxe de mise en page ====
+Attribuons des [[:apache2#permissions|permissions correctes]] au fichiers et répertoires. **DokuWiki** a besoin de droits permissifs afin de faciliter les mises à jours :
-   * [[http://www.dokuwiki.org/fr%3Asyntax|Syntaxe]]
+<code>sudo chown -R $USER:www-data /var/www/dokuwiki
+chmod -R -rwx,u+rwX,g+rwX /var/www/dokuwiki</code>
+<note warning>
+En production, il est important d'améliorer la sécurité en utilisant des [[:apache2#permissions]] plus strictes.
-====Maintenance====
+Seuls les répertoires ''/data'' et ''/conf'' doivent être modifiables par ''www-data'' :
-  * [[http://www.dokuwiki.org/tips:maintenance|Tips maintenance]]
+  chmod -R a-rwx,u+rwX,g+rX /var/www/dokuwiki
+  chmod -R g+w /var/www/dokuwiki/data /var/www/dokuwiki/conf
+</note>
-====Convertisseur====
+**DokuWiki** devrait alors être accessible à l'adresse ''[[http://dokuwiki.localhost/]]''.
-  * paquet txt2tags
-  * [[http://www.dokuwiki.org/tips:mediawiki_to_dokuwiki_converter|mediawiki_to_dokuwiki_converter]]
-  * [[http://johbuc6.coconia.net/mediawiki2dokuwiki.php|Mediawiki / dokuwiki convertisseur]]
-====Trucs et astuces====
+Il reste maintenant à ajuster la configuration, en commençant par renseigner le nom du wiki, ainsi qu'un nom d'utilisateur, un //email// et un mot de passe pour l'administrateur du site : ''[[http://dokuwiki.localhost/install.php]]''.\\
-  * [[http://www.dokuwiki.org/tips|Page tips]]
+Un sélecteur est disponible en haut à droite de la page pour choisir sa langue.
-===== Désinstallation =====
+Une fois l'installation terminée, on peut supprimer le fichier ''install.php'' :
+  rm /var/www/dokuwiki/install.php
-==== Désinstallation de la version des dépôts ====
+===== Utilisation =====
-Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
+Le site est visible sur ''[[http://dokuwiki.localhost/]]'', l'interface d'administration est accessible sur ''[[http://dokuwiki.localhost/?do=admin]]''.
-==== Désinstallation de la version du site officiel ====
+==== Plugins ====
-Il suffit de supprimer le dossier **/var/www/dokuwiki** avec les [[:sudo|droits administrateur]]. On pourra ensuite si on le désire [[:tutoriel:comment_supprimer_un_paquet|supprimer les paquets]] **apache2** et **php5**.
+Il suffit de copier l'adresse du paquet de //plugin// à installer et de le copier dans la page des //plugins//, puis valider pour l'installer.
+[[https://www.dokuwiki.org/fr:plugins?pluginsort=c|Voir la page listant les plugins disponibles]].
-===== Voir aussi =====
+Des //plugins// intéressants :
+   * [[https://fr.wikipedia.org/wiki/OpenID|OpenID]] : les utilisateurs pourront se connecter simplement avec leur adresse de courriel, [[https://openid.net/get-an-openid|Gmail, Yahoo et d'autres comptes sont compatibles]] (c'est un protocole libre, contrairement au Facebook login) : [[https://www.dokuwiki.org/plugin:openid|openid]] : la gestion des ACL ne change pas.
+   * Multilingue : [[https://www.dokuwiki.org/plugin:translation|Translation]]
+   * Vidéo : [[https://www.dokuwiki.org/plugin:vshare|vshare]]
+   * Tableau Csv : [[https://www.dokuwiki.org/plugin:csv|csv]]
+   * Compatible avec un trieur de tableau côté client : [[https://www.dokuwiki.org/plugin:sortablejs|sortablejs]]
+   * Boite graphique : [[https://www.dokuwiki.org/plugin:note|note]], [[https://www.dokuwiki.org/plugin:blockquote|blockquote]]
+   * [[OpenstreetMap]] : [[https://www.dokuwiki.org/plugin:openlayersmap|openlayersmap]]
+   * Export au format OpenOffice.org : [[https://www.dokuwiki.org/plugin:odt|odt]]
+   * Export au format PDF : [[https://www.dokuwiki.org/plugin:html2pdf|html2pdf]]
+   * Présentation en ligne : [[https://www.dokuwiki.org/plugin:s5|S5]]
+   * Gestion des tâches ( compatible avec outil calendrier ) : [[https://www.dokuwiki.org/plugin:task|task]]
+   * Éditeur tel-tel (WYSIWYG) : [[https://www.dokuwiki.org/plugin:fckglite|fckglite]]
+   * Gestion avancée des droits ACL : [[https://www.dokuwiki.org/plugin:superacl|superacl]]
+   * Minimiser des partie des pages : [[https://www.dokuwiki.org/plugin:folded|folded]]
+   * Latex : [[https://www.dokuwiki.org/plugin:math|math]]
+   * Exporter le wiki pour une version hors ligne : [[https://www.dokuwiki.org/plugin:siteexport|siteexport]]
-  * **(en)** [[http://www.dokuwiki.org/dokuwiki|Site officiel]]
+Dans une vision de page au même niveau et tagué :
-  * **(fr)** [[http://www.dokuwiki.org/fr:manual|Manuel Dokuwiki]]
+   * [[https://www.dokuwiki.org/plugin:tag|Tag]]
-  * **(en)** [[http://www.dokuwiki.org/install:ubuntu|Documentation de l'installation sur www.dokuwiki.org]]
-  * **(en)** [[http://www.wikimatrix.org/show/DokuWiki|Dokuwiki sur wikimatrix]]
+Dans une vision hiérarchisée des pages :
+   * Menu : [[https://www.dokuwiki.org/plugin:indexmenu|indexmenu]]
+   * Inclure des pages ou morceau de page , dans une autres : [[https://www.dokuwiki.org/plugin:include|include]]
+Dans une vision [[https://www.dokuwiki.org/tips:blogging|site/blog/cms]] :
+   * Blog : [[https://www.dokuwiki.org/plugin:blog|blog]], [[https://www.dokuwiki.org/plugin:blogmeta|blogmeta]], [[https://www.dokuwiki.org/plugin:bloglinks|bloglinks]], [[https://www.dokuwiki.org/tips:weblog_bookmarklet|weblog bookmarlet]]
+   * Discussion : [[https://www.dokuwiki.org/plugin:discussion|discussion]]
+   * Antispam : [[https://www.dokuwiki.org/plugin:badbehaviour|badbehaviour]]
+   * Captcha : [[https://www.dokuwiki.org/plugin:captcha|captcha]]
+   * Album-photo : [[https://www.dokuwiki.org/plugin:gallery|gallery]]
+   * Avatar : [[https://www.dokuwiki.org/plugin:avatar|avatar]]
+   * Formulaire de contact : [[https://www.dokuwiki.org/plugin:contact|contact]]
-----
+Mesure anti-spam possible :
+   * [[https://www.dokuwiki.org/plugin:badbehaviour|badbehaviour]] (bloque les spambots), [[https://www.dokuwiki.org/plugin:captcha|Captcha]],
+   * Changer les droits ACL pour que l'édition / écriture de page ne se fasse que pour des utilisateurs connectés, et simplifier l'accès avec [[https://fr.wikipedia.org/wiki/OpenID|OpenID]]
-//Contributeur principal : [[:utilisateurs:psychederic|Psychederic]], ...//
+==== Thèmes ====
+   * Il est facile d'installer des //templates// : il suffit d'extraire l'archive du //template// (habituellement un fichier ''.zip'' ou ''.tgz'') dans le répertoire ''/lib/tpl/'').
+   * Sélectionnez ensuite le //template// depuis le gestionnaire de configuration en ajustant le paramètre //template//.
+   * [[https://www.dokuwiki.org/fr:template|Voir la page des templates]]
+     * [[https://www.dokuwiki.org/template:monobook|Dont le template monobook]]
+==== La syntaxe de mise en page ====
+   * [[https://www.dokuwiki.org/fr%3Asyntax|Syntaxe]]
+==== Maintenance ====
+  * [[https://www.dokuwiki.org/tips:maintenance|Tips maintenance]]
+==== Convertisseur ====
+  * paquet txt2tags
+  * [[https://www.dokuwiki.org/tips:mediawiki_to_dokuwiki_converter|mediawiki_to_dokuwiki_converter]]
+==== Trucs et astuces ====
+  * [[https://www.dokuwiki.org/tips|Page tips]]
+===== Voir aussi =====
+  * **(//en//)** [[https://www.dokuwiki.org/dokuwiki|Site officiel]]
+  * **(fr)** [[https://www.dokuwiki.org/fr:manual|Manuel Dokuwiki]]
+  * **(//en//)** [[https://www.dokuwiki.org/install:ubuntu|Documentation de l'installation sur www.dokuwiki.org]] (obsolète)
+  * **(//en//)** [[https://www.wikimatrix.org/show/DokuWiki|Dokuwiki sur wikimatrix]]
+  * **(fr)** [[https://sebsauvage.net/wiki/doku.php?id=dokuwiki|DokuWiki de sebsauvage.net]]
+----
+//[[:Contributeurs]] : [[:utilisateurs:Psychederic]], [[:utilisateurs:krodelabestiole]].//

Différences

Outils de la page

Outils du site

Divers