Différences

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

--- dokuwiki [Le 15/02/2014, 14:50] – [Dokuwiki] 81.220.127.62
+++ 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 ======
-**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.
+Il permet de créer des documentations de toute sorte. Cette [[:web#application web]] est développée en [[:PHP]] par Andreas Gohr.
-De cette manière Dokuwiki est plus rapide que Mediawiki pour rendre des pages au visiteur.((http://meta.wikimedia.org/wiki/DokuWiki_vs_MediaWiki_benchmarks))((http://forum.dokuwiki.org/thread/621))
+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))
-===== Pré-requis =====
+<note important>
+**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]]).
-  * Disposer des [[:sudo|droits d'administration]].
+Voir [[https://forum.ubuntu-fr.org/viewtopic.php?pid=22712575#p22712575|ce message]] sur le forum. On peut citer par ex. :
-  * Disposer d'une connexion à Internet configurée et activée.
+  * [[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 =====
-==== Par les dépôts ====
+<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>
-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 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.
-Il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt://dokuwiki|dokuwiki]]**.
+**DokuWiki** est disponible dans les dépôts officiels d'Ubuntu, mais la version ainsi proposée n'est presque jamais la dernière.
-<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>
+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]]//.
-====Version du site officiel ====
+C'est pourquoi nous documentons ici une installation //manuelle//, qui peut se mettre à jour elle-même.
+</note>
-   - [[http://www.splitbrain.org/projects/dokuwiki|Téléchargez l'archive de la dernière version stable sur le site officiel]].
+==== Prérequis ====
-   - Installez un serveur [[Apache]] ainsi que le paquet **[[apt://php5|php5]]**.
-   - Décompressez l'archive dans votre Dossier personnel, puis renommez le dossier extrait en **dokuwiki**.
-   - Copiez le dossier **dokuwiki** sous **/var/www** avec les droits administrateur avec cette [[:commande_shell|commande]] dans un [[terminal]] :<code>sudo cp -R dokuwiki /var/www</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>
-   - 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]].//
+Pour installer **DokuWiki** vous aurez besoin d'un [[:web#serveurs|serveur HTTP]] et de [[:PHP]].
-**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 [[http://doc.ubuntu-fr.org/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é.
+<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.
-====Autres installations====
-   * [[http://bitnami.org/stack/dokuwiki|Télécharger sur bitNami]]
+N'hésitez pas à contacter le support de l'hébergeur si ce n'est pas le cas.</note>
+[[:apache2|Apache]] est le serveur HTTP le plus couramment utilisé, c'est celui que nous choisirons ici.
-=====Utilisation=====
+Pour installer Apache et PHP :
+<code>sudo apt install apache2 php libapache2-mod-php</code>
-====Plugins====
+**DokuWiki** requiert ensuite l'activation de certains modules PHP qui ne sont pas installés par défaut sous Ubuntu :
+<code>sudo apt install php-curl php-gd php-intl php-json php-mbstring php-xml php-zip</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** a aussi besoin du module [[:apache2#mod_rewrite]] :
-[[http://www.dokuwiki.org/fr:plugins?pluginsort=c|Voir la page listant les plugins disponibles]].
+<code>sudo a2enmod rewrite</code>
-Des plugins intéressants :
+Nous allons ensuite créer un [[:apache2#hotes_virtuels|hôte virtuel]] pour **DokuWiki**, dont la racine sera ''/var/www/dokuwiki'' :
-   * [[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 nano /etc/apache2/sites-available/dokuwiki.conf</code>
-   * Multilingue : [[http://www.dokuwiki.org/plugin:translation|Translation]]
+Ce qui ouvre un fichier dans lequel nous allons coller :
-   * Vidéo : [[http://www.dokuwiki.org/plugin:vshare|vshare]]
+<file - dokuwiki.conf><VirtualHost *:80>
-   * Tableau Csv : [[http://www.dokuwiki.org/plugin:csv|csv]]
+        ServerName dokuwiki.localhost
-   * Compatible avec un trieur de tableau côté client : [[http://www.dokuwiki.org/plugin:sortablejs|sortablejs]]
+        DocumentRoot /var/www/dokuwiki
-   * Boite graphique : [[http://www.dokuwiki.org/plugin:note|note]], [[http://www.dokuwiki.org/plugin:blockquote|blockquote]]
+        <Directory /var/www/dokuwiki>
-   * [[OpenstreetMap]] : [[http://www.dokuwiki.org/plugin:openlayersmap|openlayersmap]]
+                AllowOverride all
-   * Export au format OpenOffice.org : [[http://www.dokuwiki.org/plugin:odt|odt]]
+                Require all granted
-   * Export au format PDF : [[http://www.dokuwiki.org/plugin:html2pdf|html2pdf]]
+        </Directory>
-   * Présentation en ligne : [[http://www.dokuwiki.org/plugin:s5|S5]]
+        ErrorLog /var/log/apache2/error.dokuwiki.log
-   * Gestion des tâches ( compatible avec outil calendrier ) : [[http://www.dokuwiki.org/plugin:task|task]]
+        CustomLog /var/log/apache2/access.dokuwiki.log combined
-   * Éditeur tel-tel (WYSIWYG) : [[http://www.dokuwiki.org/plugin:fckglite|fckglite]]
+</VirtualHost></file>
-   * Gestion avancée des droits ACL : [[http://www.dokuwiki.org/plugin:superacl|superacl]]
+Si un nom de domaine pointe sur le serveur, on l'indique à la place de ''dokuwiki.localhost'' pour la directive ''ServerName''.\\
-   * Minimiser des partie des pages : [[http://www.dokuwiki.org/plugin:folded|folded]]
+(''Ctrl+X'' puis ''O'' pour quitter en sauvegardant)
-   * 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é :
+Finalement, on active l'hôte virtuel et on recharge la configuration d'Apache :
-   * [[http://www.dokuwiki.org/plugin:tag|Tag]]
+<code>sudo a2ensite dokuwiki
+sudo systemctl reload apache2</code>
-Dans une vision hiérarchisée des pages :
+<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>
-   * Menu : [[http://www.dokuwiki.org/plugin:indexmenu|indexmenu]]
-   * Inclure des pages ou morceau de page , dans une autres : [[http://www.dokuwiki.org/plugin:include|include]]
-Dans une vision [[http://www.dokuwiki.org/tips:blogging|site/blog/cms]] :
+==== Installation de DokuWiki ====
-   * 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 :
+Tout d'abord téléchargeons la dernière version de **DokuWiki** depuis le [[https://download.dokuwiki.org/|site officiel]] :
-   * [[http://www.dokuwiki.org/plugin:badbehaviour|badbehaviour]] (bloque les spambots), [[http://www.dokuwiki.org/plugin:captcha|Captcha]],
+<code>wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz</code>
-   * 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====
+Ensuite nous allons extraire le contenu de l'archive à la racine de notre hôte virtuel (''/var/www/dokuwiki'' pour l'exemple) :
-   * 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>sudo tar -xvzf dokuwiki-stable.tgz -C /var/www
-   * Sélectionnez ensuite le template depuis le Gestionnaire de configuration en ajustant le paramètre template.
+sudo mv /var/www/dokuwiki-* /var/www/dokuwiki</code>
-   * [[http://www.dokuwiki.org/fr:template|Voir la page des templates]]
+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/template:monobook|Dont le template monobook]]
+<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.
-==== La syntaxe de mise en page ====
+Seuls les répertoires ''/data'' et ''/conf'' doivent être modifiables par ''www-data'' :
-   * [[http://www.dokuwiki.org/fr%3Asyntax|Syntaxe]]
+  chmod -R a-rwx,u+rwX,g+rX /var/www/dokuwiki
+  chmod -R g+w /var/www/dokuwiki/data /var/www/dokuwiki/conf
+</note>
-====Maintenance====
+**DokuWiki** devrait alors être accessible à l'adresse ''[[http://dokuwiki.localhost/]]''.
-  * [[http://www.dokuwiki.org/tips:maintenance|Tips maintenance]]
-====Convertisseur====
+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]]''.\\
-  * paquet txt2tags
+Un sélecteur est disponible en haut à droite de la page pour choisir sa langue.
-  * [[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====
+Une fois l'installation terminée, on peut supprimer le fichier ''install.php'' :
-  * [[http://www.dokuwiki.org/tips|Page tips]]
+  rm /var/www/dokuwiki/install.php
-===== Désinstallation =====
+===== Utilisation =====
-==== Désinstallation de la version des dépôts ====
+Le site est visible sur ''[[http://dokuwiki.localhost/]]'', l'interface d'administration est accessible sur ''[[http://dokuwiki.localhost/?do=admin]]''.
-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.
+==== Plugins ====
-==== Désinstallation de la version du site officiel ====
+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]].
-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**.
+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]]
-===== Voir aussi =====
+Dans une vision de page au même niveau et tagué :
+   * [[https://www.dokuwiki.org/plugin:tag|Tag]]
-  * **(en)** [[http://www.dokuwiki.org/dokuwiki|Site officiel]]
+Dans une vision hiérarchisée des pages :
-  * **(fr)** [[http://www.dokuwiki.org/fr:manual|Manuel Dokuwiki]]
+   * Menu : [[https://www.dokuwiki.org/plugin:indexmenu|indexmenu]]
-  * **(en)** [[http://www.dokuwiki.org/install:ubuntu|Documentation de l'installation sur www.dokuwiki.org]]
+   * Inclure des pages ou morceau de page , dans une autres : [[https://www.dokuwiki.org/plugin:include|include]]
-  * **(en)** [[http://www.wikimatrix.org/show/DokuWiki|Dokuwiki sur wikimatrix]]
+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]]
-----
+==== Thèmes ====
-//Contributeur principal : [[:utilisateurs:psychederic|Psychederic]], ...//
+   * 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