Différences

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

--- dokuwiki [Le 24/07/2010, 09:59] – correction @ doc GNU-max
+++ dokuwiki [Le 13/09/2026, 17:16] (Version actuelle) – suppr install.php | détails krodelabestiole
@@ Ligne 1: / Ligne 1: @@
 {{tag>travail_collaboratif wiki cms}}
-----
-====== Dokuwiki : ======
+{{ https://upload.wikimedia.org/wikipedia/commons/e/e4/Dokuwiki_logo.png}}
-{{http://upload.wikimedia.org/wikipedia/commons/e/e4/Dokuwiki_logo.png }}
+====== DokuWiki ======
-DokuWiki est un moteur de 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.
-Contrairement a [[Mediawiki]], il n'utilise pas de sql((pas besoin de serveur sql)) pour sauver les pages, mais du 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 rendre des 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.
-Site officiel : http://www.dokuwiki.org/dokuwiki
+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))
+<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]]).
+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 =====
-==== Par dépôt ubuntu ====
+<note>
-Dokuwiki est présent dans les dépôts 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]].
+**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>
-   * [[apt://dokuwiki|Cliquez ici pour installer]].
+<note important>
-   * [[http://www.dokuwiki.org/install:ubuntu|Documentation de l'installation sur www.dokuwiki.org]]
+**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.
+**DokuWiki** est disponible dans les dépôts officiels d'Ubuntu, mais la version ainsi proposée n'est presque jamais la dernière.
+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]]//.
-====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 sur le site officiel]]
+==== Prérequis ====
-   * [[apt://php5|Cliquez ici pour installer apache+php5]]
-   * [[http://www.dokuwiki.org/install:ubuntu|EN cas de problème voir sur la doc officiel]]
-====Autres installations====
-   * [[http://bitnami.org/stack/dokuwiki|Télécharger sur bitNami]]
+Pour installer **DokuWiki** vous aurez besoin d'un [[:web#serveurs|serveur HTTP]] et de [[:PHP]].
+<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.
-=====Utilisation=====
+N'hésitez pas à contacter le support de l'hébergeur si ce n'est pas le cas.</note>
-====Extensions====
+[[:apache2|Apache]] est le serveur HTTP le plus couramment utilisé, c'est celui que nous choisirons ici.
-   * Il vous suffit de copier l'adresse du package de plugin à installer et de le copier dans la page des extensions, puis valider pour l'installer.
-   * [[http://www.dokuwiki.org/plugins?pluginsort=c|Voir la page des plugins]] : qui répondra a tous vos besoins
-   * [[http://fr.wikipedia.org/wiki/OpenID|OpenID]] : les utilisateurs pourront se loguer simplement avec leur email , [[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.
+Pour installer Apache et PHP :
-   * Multi language : [[http://www.dokuwiki.org/plugin:translation|Translation]]
+<code>sudo apt install apache2 php libapache2-mod-php</code>
-   * Video : [[http://www.dokuwiki.org/plugin:vshare|vshare]]
-   * Tableau Csv : [[http://www.dokuwiki.org/plugin:csv|csv]]
+**DokuWiki** requiert ensuite l'activation de certains modules PHP qui ne sont pas installés par défaut sous Ubuntu :
-   * Compatible avec un trieur de tableau coté client : [[http://www.dokuwiki.org/plugin:sortablejs|sortablejs]]
+<code>sudo apt install php-curl php-gd php-intl php-json php-mbstring php-xml php-zip</code>
-   * Boite graphique : [[http://www.dokuwiki.org/plugin:note|note]], [[http://www.dokuwiki.org/plugin:blockquote|blockquote]]
-   * Export en format openoffice : [[http://www.dokuwiki.org/plugin:odt|odt]]
+**DokuWiki** a aussi besoin du module [[:apache2#mod_rewrite]] :
-   * Export en format pdf : [[http://www.dokuwiki.org/plugin:html2pdf|html2pdf]]
+<code>sudo a2enmod rewrite</code>
-   * Présentation en ligne : [[http://www.dokuwiki.org/plugin:s5|S5]]
-   * Gestion des taches ( compatible avec outil calendrier ) : [[http://www.dokuwiki.org/plugin:task|task]]
+Nous allons ensuite créer un [[:apache2#hotes_virtuels|hôte virtuel]] pour **DokuWiki**, dont la racine sera ''/var/www/dokuwiki'' :
-   * WYSIWYG : [[http://www.dokuwiki.org/plugin:fckglite|fckglite]]
+<code>sudo nano /etc/apache2/sites-available/dokuwiki.conf</code>
-   * Gestion avancée des droits ACL : [[http://www.dokuwiki.org/plugin:superacl|superacl]]
+Ce qui ouvre un fichier dans lequel nous allons coller :
-   * Minimizer des partie des pages : [[http://www.dokuwiki.org/plugin:folded|folded]]
+<file - dokuwiki.conf><VirtualHost *:80>
-   * Latex : [[http://www.dokuwiki.org/plugin:math|math]]
+        ServerName dokuwiki.localhost
-   * Exporter le wiki pour une version hors ligne : [[http://www.dokuwiki.org/plugin:siteexport|siteexport]]
+        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)
+Finalement, on active l'hôte virtuel et on recharge la configuration d'Apache :
+<code>sudo a2ensite dokuwiki
+sudo systemctl reload apache2</code>
+<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>
+==== Installation de DokuWiki ====
+Tout d'abord téléchargeons la dernière version de **DokuWiki** depuis le [[https://download.dokuwiki.org/|site officiel]] :
+<code>wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz</code>
+Ensuite nous allons extraire le contenu de l'archive à la racine de notre hôte virtuel (''/var/www/dokuwiki'' pour l'exemple) :
+<code>sudo tar -xvzf dokuwiki-stable.tgz -C /var/www
+sudo mv /var/www/dokuwiki-* /var/www/dokuwiki</code>
+Attribuons des [[:apache2#permissions|permissions correctes]] au fichiers et répertoires. **DokuWiki** a besoin de droits permissifs afin de faciliter les mises à jours :
+<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.
+Seuls les répertoires ''/data'' et ''/conf'' doivent être modifiables par ''www-data'' :
+  chmod -R a-rwx,u+rwX,g+rX /var/www/dokuwiki
+  chmod -R g+w /var/www/dokuwiki/data /var/www/dokuwiki/conf
+</note>
+**DokuWiki** devrait alors être accessible à l'adresse ''[[http://dokuwiki.localhost/]]''.
+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]]''.\\
+Un sélecteur est disponible en haut à droite de la page pour choisir sa langue.
+Une fois l'installation terminée, on peut supprimer le fichier ''install.php'' :
+  rm /var/www/dokuwiki/install.php
+===== Utilisation =====
+Le site est visible sur ''[[http://dokuwiki.localhost/]]'', l'interface d'administration est accessible sur ''[[http://dokuwiki.localhost/?do=admin]]''.
+==== Plugins ====
+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]].
+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]]
 Dans une vision de page au même niveau et tagué :
-   * [[http://www.dokuwiki.org/plugin:tag|Tag]]
+   * [[https://www.dokuwiki.org/plugin:tag|Tag]]
-Dans une vision hiérarchisé des pages :
+Dans une vision hiérarchisée des pages :
-   * Menu : [[http://www.dokuwiki.org/plugin:indexmenu|indexmenu]]
+   * Menu : [[https://www.dokuwiki.org/plugin:indexmenu|indexmenu]]
-   * Inclure des pages ou morceau de page , dans une autres : [[http://www.dokuwiki.org/plugin:include|include]]
+   * Inclure des pages ou morceau de page , dans une autres : [[https://www.dokuwiki.org/plugin:include|include]]
-Dans une vision [[http://www.dokuwiki.org/tips:blogging|site/blog/cms]] :
+Dans une vision [[https://www.dokuwiki.org/tips:blogging|site/blog/cms]] :
-   * 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]]
+   * 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 : [[http://www.dokuwiki.org/plugin:discussion|discussion]]
+   * Discussion : [[https://www.dokuwiki.org/plugin:discussion|discussion]]
-   * Antispam : [[http://www.dokuwiki.org/plugin:badbehaviour|badbehaviour]]
+   * Antispam : [[https://www.dokuwiki.org/plugin:badbehaviour|badbehaviour]]
-   * Captcha : [[http://www.dokuwiki.org/plugin:captcha|captcha]]
+   * Captcha : [[https://www.dokuwiki.org/plugin:captcha|captcha]]
-   * Gallerie : [[http://www.dokuwiki.org/plugin:gallery|gallery]]
+   * Album-photo : [[https://www.dokuwiki.org/plugin:gallery|gallery]]
-   * Avatar : [[http://www.dokuwiki.org/plugin:avatar|avatar]]
+   * Avatar : [[https://www.dokuwiki.org/plugin:avatar|avatar]]
-   * Formulaire de contact : [[http://www.dokuwiki.org/plugin:contact|contact]]
+   * Formulaire de contact : [[https://www.dokuwiki.org/plugin:contact|contact]]
-====Thèmes====
+Mesure anti-spam possible :
-   * 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).
+   * [[https://www.dokuwiki.org/plugin:badbehaviour|badbehaviour]] (bloque les spambots), [[https://www.dokuwiki.org/plugin:captcha|Captcha]],
-   * Sélectionnez ensuite le template depuis le Gestionnaire de configuration en ajustant le paramètre template.
+   * 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]]
-   * [[http://www.dokuwiki.org/fr:template|VOir la page des templates]]
+==== Thèmes ====
-     * [[http://www.dokuwiki.org/template:monobook|Dont le template monobook]]
-====Langage Markup====
-   * [[http://www.dokuwiki.org/fr%3Asyntax|Syntax]]
-====Maintenance====
+   * 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/'').
-  * [[http://www.dokuwiki.org/tips:maintenance|TIps maintenance]]
+   * Sélectionnez ensuite le //template// depuis le gestionnaire de configuration en ajustant le paramètre //template//.
-====Convertisseur====
-  * 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====
+   * [[https://www.dokuwiki.org/fr:template|Voir la page des templates]]
-  * [[http://www.dokuwiki.org/tips|Page tips]]
+     * [[https://www.dokuwiki.org/template:monobook|Dont le template monobook]]
-  * Comme par exemple intégrer dokuwiki avec d'autres solutions libres.
-=====Liens externes=====
+==== La syntaxe de mise en page ====
-  * [[http://www.wikimatrix.org/show/DokuWiki|Dokuwiki sur wikimatrix]]
+   * [[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]]
-Contributeurs : [[:utilisateurs:psychederic|Psychederic]], .../
+===== 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