Différences

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

--- floss:dokuwiki [2020/01/09 16:55] – villersd
+++ floss:dokuwiki [2020/01/24 13:22] – villersd
@@ Ligne 1: / Ligne 1: @@
 ====== DokuWiki ======
+<note warning>À intégrer :
+  * dokuwiki sur raspberry ?
+  * passage en https
+  * verrouillage de pages si accès concurrents
+  * abonnement RSS aux dernières mises à jour du site ou d'un espace de noms ?
+  * [[https://www.cosmocode.de/en/open-source/top-ten-dokuwiki-plugins/]]
+  * xmlrpc ? envoi de contributions par email pour des pages,...
+  * rename basedir → [[https://forum.dokuwiki.org/thread/4026]] (tester)
+</note>
   * [[wp>fr:DokuWiki]]
   * [[wp>DokuWiki]]
   * [[https://www.dokuwiki.org/dokuwiki]] : site web officiel
   * [[https://github.com/splitbrain/dokuwiki]] gitHub repository
+  * [[https://www.dokuwiki.org/fr:manual]] Manuel de DokuWiki
 ===== Introduction =====
@@ Ligne 11: / Ligne 23: @@
 → définir un wiki (cf. aussi Using DokuWiki as a lightweight CMS)
+  * collaboratif
+  * rapide, flexible
+  * syntaxe simple
+  * historique des versions
+  * structuration de l'information
+  * navigation hypertextuelle
+  * indexation
+  * présentation uniforme (le contenu a priorité sur sa présentation)
 Si à cela vous ajoutez les souhaits d’une présentation uniforme, d’un langage de formatage simplifié mais puissant, la nécessité de conserver les versions successives d’un travail, de les organiser dans une arborescence, alors le logiciel à installer est un wiki, et le logiciel DokuWiki est particulièrement indiqué, pour les raisons suivantes :
@@ Ligne 26: / Ligne 47: @@
 Références :
   * [[https://www.dokuwiki.org/start?id=fr:dokuwiki]] : DokuWiki présenté par DokuWiki !
+===== Historique du projet =====
+  * [[https://fr.wikipedia.org/wiki/DokuWiki#Historique]]
+  * Andreas Gohr
+    * [[https://www.splitbrain.org/personal]]
+    *
 ===== Installation =====
@@ Ligne 71: / Ligne 98: @@
 Plus tard, notamment si vous ajoutez des extensions (plugins) possédant leurs propres paramètres de configuration, vous pourrez revenir sur ce menu d’administration !
-==== Quelques améliorations ====
+==== Quelques premières améliorations (extensions,...) ====
+DokuWiki peut être étendu par des extensions (plugins) dont certaines sont particulièrement utiles. Ces extensions sont installées à partir du panneau d'administration. Sélectionner la page "Gestionnaire d'extensions", qui permet de lister les plugins installés. Il est facile d'en installer d'autres, via l'onglet "Rechercher et installer" : taper "upgrade" pour obtenir la liste des extensions correspondant à ce critère. Le plugin "Upgrade plugin" apparaît normalement en tête, et il suffit de cliquer sur le bouton "installer". En retournant sur le panneau d'administration, on dispose à présent de la fonctionnalité "Mise à jour du wiki" qui sera utile lors de la sortie d'une mise à jour du logiciel, pour lesquelles des messages d'avertissement seront affichés.
+Le thème graphique de DokuWiki peut aussi être modifié en sélectionnant un des nombreux thèmes listés à la page [[https://www.dokuwiki.org/template]]. Les thèmes s'installent comme les extensions, mais un seul thème à la fois peut être activé, via le gestionnaire de configuration. Bootstrap3 est un exemple de thème fréquemment utilisé.
+=== Réécriture d'URL (jolis URL) ===
+  * [[https://www.dokuwiki.org/fr:rewrite]] explique (option 1) comment remplacer l'URL "http://servername/wiki/doku.php?id=wiki:syntax" par un URL plus beau, et aussi mieux indexé par certains moteurs de recherche : "http://servername/wiki/wiki:syntax"
+  * Sur le serveur :
+    * sudo a2enmod rewrite
+    * sudo systemctl restart apache2
+    * cd /var/www/html/wiki
+    * cp .htaccess.dist .htaccess
+    * sudo nano .htaccess
+    * décommenter les lignes concernant le rewrite :
+<code>
+RewriteEngine on
+#
+RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
+RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
+RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
+RewriteRule ^$                        doku.php  [L]
+RewriteCond %{REQUEST_FILENAME}       !-f
+RewriteCond %{REQUEST_FILENAME}       !-d
+RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
+RewriteRule ^index.php$               doku.php
+</code>
+    * sudo chown www-data:www-data .htaccess
+    * normalement il n'y a pas de pas de changement nécessaire dans le fichier de configuration d'Apache2
+  * Dans la configuration du wiki (via la page d'administration et les paramètres de configuration), aller dans les paramètres avancés, et pour userewrite (Utiliser des URL esthétiques), sélectionner l'option "Fichier .htaccess"
 ==== Sécurisation, configuration ====
@@ Ligne 87: / Ligne 146: @@
   * [[https://www.dokuwiki.org/install:php|PHP Configuration for DokuWiki]]
+==== Quelle est la structure du wiki sur le serveur ? ====
+  * Structure complète dans le Manuel du développeur : [[https://www.dokuwiki.org/devel:dirlayout]]
+  * Quelques répertoires importants :
+    * aa
+    * bb
+  * Répertoires propres à l'installation (importants à sauvegarder) :
+    * data/pages - contient les pages actuelles
+    * data/meta - contient les méta-informations sur les pages (créateurs, abonnés,...)
+    * data/media - contient les fichiers media actuel (images, PDFs, …)
+    * data/media_meta - contient les métadonnées des media
+    * data/attic - anciennes versions des pages
+    * data/media_attic - anciennes versions des media
+    * conf - les réglages de configuration
-==== Comment utiliser plusieurs instances de DokuWiki ====
+==== Comment utiliser plusieurs instances de DokuWiki ? ====
   * [[https://www.dokuwiki.org/farms]]
   * [[https://forum.dokuwiki.org/thread/12062]]
@@ Ligne 96: / Ligne 168: @@
 ===== Sauvegardes =====
+==== En mode manuel, avec création d'une copie sous un autre nom ====
+  * Se connecter en ssh au serveur : ssh vmuser@ip_address
+  * tar zcpfv dokuwiki-backup.tar.gz /var/www/html/wiki00
+  * Le fichier de sauvegarde se trouve dans le répertoire home de vmuser
+  * Pour créer (immédiatement ou ultérieurement) une copie sous un autre nom, se placer dans le répertoire web : cd /var/www/html
+  * créer un répertoire pour le wiki : sudo mkdir wiki01
+  * s’y placer : cd wiki01
+  * décompresser l’archive en omettant le chemin sauvegardé (\var\www\html\wiki00) :
+    * sudo tar -xzvf /home/vmuser/dokuwiki-backup.tar.gz --strip-components=4
+    * À ce stade, les droits et propriétaires ne sont pas correct (vérifier par ls -l) : changer owner & permissions ([[https://www.dokuwiki.org/install:permissions#unix]])
+    * sudo chown -R www-data:www-data /var/www/html/wiki01
+    * cd /var/www/html/wiki01 (si on n'y était pas)
+    * fichiers : sudo find . ! -type d -exec chmod 660 {} \;
+    * répertoires : sudo find . -type d -exec chmod 770 {} \;
+  * Références :
+    * [[https://www.dokuwiki.org/install:upgrade]]
+    * [[https://unix.stackexchange.com/questions/535772/understanding-strip-components-c|Understanding --strip-components -C]]
 ===== Migration =====
   * en cas de migration, effacement de fichiers obsolètes : sudo grep -Ev '^($|#)' data/deleted.files | xargs -n 1 rm -vf
- réinstallation
+ réinstallation (à vérifier en 2020 !)
-  * cd /var/www puis effacement de l'éventuelle version antérieure : sudo rm -rf wiki
+  * cd /var/www/html puis effacement de l'éventuelle version antérieure : sudo rm -rf wiki
-  * cd /home/dvillersadm copie d'une archive dokuwiki à réinstaller à cet emplacement
+  * cd /home/vmuser copie d'une archive dokuwiki à réinstaller à cet emplacement
-  * extraction par sudo tar -xzvf ./dokuwiki500299_2013-08-28_03:17:01.tar.gz
+  * extraction par tar --force-local -xzvf ./saved_dokuwiki_2013-08-28_03:17:01.tar.gz
-  * cd /home/dvillersadm/home/500299/public_html
+  * cd /home/vmuser/path_a_verifier
-  * sudo mv wiki /var/www puis cd /var/www
+  * sudo mv wiki /var/www/html puis cd /var/www/html
   * owner & permissions https://www.dokuwiki.org/install:permissions#unix
   * sudo chown -R www-data:www-data /var/www/wiki
@@ Ligne 113: / Ligne 204: @@
 ===== Extensions =====
+  * Forme :
+    * [[https://www.dokuwiki.org/plugin:blockquote|BlockQuote]] : mise en forme de citations
+    * [[https://www.dokuwiki.org/plugin:catlist|catlist]] : rend une liste en arborescence de pages d'un namespace
+    * [[http://www.dokuwiki.org/plugin:chem|Chem]], formatage de formules de substances chimiques
+    * [[https://www.dokuwiki.org/plugin:cloud|Cloud]], nuage de mots utilisés
+    * [[https://www.dokuwiki.org/plugin:color]], couleur du texte
+    * [[https://www.dokuwiki.org/plugin:definitionlist|Definition List]], par exemple pour un glossaire
+    * [[http://nikita.melnichenko.name/projects/dokuwiki-diagram/index.php|Diagram]], construction de diagrammes
+    * [[https://www.dokuwiki.org/plugin:edittable]], facilite l'édition de tableaux
+    * [[https://www.dokuwiki.org/plugin:flowchartjs]] diagrammes basés sur [[http://flowchart.js.org/|flowchart.js]]
+    * [[https://www.dokuwiki.org/plugin:flowcharts]] diagrammes et graphes basés sur la librairie [[https://mermaid-js.github.io/mermaid/#/|mermaid.js]]
+  * Fonctionnalités
+    * [[https://www.dokuwiki.org/plugin:bookcreator|BookCreator]]
+      * [[https://www.dokuwiki.org/plugin:dw2pdf|DW2PDF]]
+    * [[https://www.dokuwiki.org/plugin:captcha|CAPTCHA]] : vérification pour lutter contre les robots spammeurs
+    * [[https://github.com/fykosak/dokuwiki-plugin-cookielaw|CookieLaw]], affiche un texte sur l'existence de cookies
+    * [[https://www.dokuwiki.org/plugin:dataplot|Dataplot Plugin]], graphique élémentaire
+    * [[https://www.dokuwiki.org/plugin:fastwiki]] édition rapide de sections
+  * Formulaire, automatisation
+    * [[https://www.dokuwiki.org/plugin:bureaucracy|Bureaucracy]]
   * [[https://www.dokuwiki.org/plugin:doodle4]] planification de réunions, votes,...
   * Calendriers, agenda :
@@ Ligne 127: / Ligne 241: @@
     * [[https://www.dokuwiki.org/plugin:twitter]] → Show tweets or searches from Twitter
   * Forum et inclusion de forum, commentaires,...
-  * édition
+  * édition avancée
     * [[https://www.dokuwiki.org/plugin:batchedit]]
+  * LaTeX : [[https://www.dokuwiki.org/plugin:latex]]
+    * installable via le gestionnaire d'extensions
+    * librairies additionnelles sur le serveur :
+      *  sudo apt-get install texlive-latex-base imagemagick ghostscrip
+    * Dans le gestionnaire d'administration, une rubrique complémentaire "LaTeX plugin tasks" est présente dans la partie "Extensions"
+    * L'**erreur "LaTeX render failed" peut être causée par un problème de permissions avec ImageMagick** (cf. [[https://github.com/marklundeberg/dokuwiki-plugin-latex/issues/9]]. Éditer le fichier /etc/ImageMagick-6/policy.xml et modifier la ligne <policy domain="coder" rights="none" pattern="PS" /> en <policy domain="coder" rights="read" pattern="PS" /> !
+    * plugin»latex»convert_options initialement à '-density 120 -trim -transparent "#FFFFFF"', utilisation de '-density 180 -trim -transparent "#FFFFFF"' pour des rendus un peu plus grand
+  * CSV : [[https://www.dokuwiki.org/plugin:csv]] : permet de présenter en table le contenu d'un fichier csv.  Modification des types mime (autoriser csv) via un fichier conf/mime.local.conf à créer. Cf. documentation : [[https://www.dokuwiki.org/mime]]
+  * iframe
+  * reveal.js
+  * geophp [[https://www.dokuwiki.org/plugin:geophp]] (+ installation de librairies ?)
+  * openlayersmap [[https://www.dokuwiki.org/plugin:openlayersmap]]
+  * html5video [[https://www.dokuwiki.org/plugin:html5video]] → Add video mime types to DokuWiki configuration
+FIXME :
+  * Enregistrements d'inscriptions (mailing, newsletter,...) via des plugins dokuwiki :
+    * Plugins bureaucracy, pagemod ;  En option : sqlite, (data, remplacé par...) struct, CAPTCHA ? attention au GDPR ! → Cookielaw (affichage d'une bannière avertissant le stockage de cookies)
+  * utilitaires :
+    * plugin getraw [[https://www.dokuwiki.org/plugin:getraw]] → copier
+    * xmlrpc ??
+  * plugins Flowchartjs flowcharts
+  * svgEmbed + edit de mime.local.conf
+  * definitionlist [[https://www.dokuwiki.org/plugin:definitionlist]] → glossaire
+FIXME Logo & favicon ??
 ==== Divers ====
   * [[http://www.msc.univ-paris-diderot.fr/~cgay/doku4latex/doku.php]]
+===== Thèmes (templates) =====
+  * testés (et approuvés)
+    * bootstrap3 avec united de [[https://bootswatch.com/]]
+===== Pages et structure en namespaces  =====
+  * Les documents individuels sont des pages
+  * Pour créer une page, il suffit de créer un lien vers une page inexistante
+  * Pour supprimer une page, il faut "Modifier cette page", sélectionner l'ensemble du code du texte (<key>Ctrl</key> + <key>'A'</key>), le supprimer et effectuer "Enregistrer". La page vide est alors automatiquement supprimée
+  * Les pages peuvent être classées dans une structure arborescente comme pour des fichier habituels d'un système d'exploitation. Ces répertoires successifs sont appelés des "namespaces" et le séparateur utilisé est ":", analogue au "/" et "\" sous GNU/Linux et MS Windows. Les liens peuvent faire référence au namespace parent par ".." et les liens peuvent être relatifs, ou absolus. Le nom de page est toujours le nom qui est à droite du dernier caractère ":".
+  * des outils permettent d'afficher l'arborescence ou une sélection, et de renommer ou déplacer des pages, des namespaces, en actualisant les liens
+===== Utilisateurs, groupes et ACL (Access Control List) =====
+===== Le gestionnaire Multimédia =====
+===== La conception : namespaces, groupes et droits =====
+==== Exemple : une ASBL consacrée aux logiciels libres ====
+Activités : ateliers mensuels, activités extérieures, activités récréatives, documentation, répertoire de logiciels, fonctionnement de l'ASBL (AG, réunions du CA, secrétariat, trésorerie, inventaire matériel...)
+Groupes et utilisateurs : inscrits sur le site, membres de l'ASBL, membres du CA, administrateurs systèmes, groupes de travail thématiques, éditeurs/rédacteurs,...
+==== Exemple : l'enseignement communal à Gnuville ====
+Sous-parties : l'échevinat, l'enseignement fondamental (maternel et primaire), l'enseignement secondaire (général, technique de transition, technique de qualification et professionnel), l'enseignement de promotion sociale (niveaux secondaire et supérieur), l'académie de Musique (enseignement artistique), l'enseignement spécialisé, le CPMS
+Les métiers : l'administration (direction générale, directions, comptabilité), les infrastructures (bâtiments, techniques générales, informatique), l'enseignement (y compris éducation artistique et culturelle, disciplines scientifiques et techniques, gymnastique et sport, langues) le psycho-médical, le soutien pédagogique,...
+Les implantations : administration, écoles (maternelles, primaires, fondamentales), centre PMS, Régie des bâtiments,...
+Les bénéficiaires : élèves du fondamental (4500 et leurs parents), élèves du secondaire (3000), élèves
+Groupes : parents (fondamental), élèves secondaires
+===== Scripts DokuWiki =====
+  * vérification du wiki installé : [[http://servername/wikipathname/doku.php?do=check]]
+  * utilitaire "grapher" de dokuwiki : [[https://www.dokuwiki.org/tips:grapher]] (représentation en graphe des pages et media
+    * ssh vmuser@ip_adress
+    * cd /var/www/html/wiki/bin
+    * sudo wget https://github.com/splitbrain/dokuwiki-grapher/raw/master/grapher.php
+    * sudo chown www-data:www-data grapher.php
+    * sudo chmod 660 grapher.php
+    * php grapher.php -h
+    * php grapher.php -d 0 -m none -o g.dot ns1:pagename
+    * php grapher.php -d 0 -m none -f gexf -o g.gexf ns1:pagename
+    * reprendre le fichier g.dot à traiter sur un autre PC où est installé graphviz (sudo apt-get install graphviz graphviz-doc)
+    * ou reprendre le fichier .gexf avec gephi
 ===== Astuces =====
@@ Ligne 139: / Ligne 330: @@
   * travail collaboratif
     * includes
+  * XML-RPC
+    * [[https://python-dokuwiki.readthedocs.io/en/latest/]]
+===== Dépannage =====
+Les problèmes sont assez rares !
+  * Vérifier régulièrement l'espace disque disponible, éventuellement réduit dans une VM, et parfois encombré de fichiers de sauvegarde
+  * Si le site renvoie des pages blanches, il est nécessaire de purger le cache des pages correspondantes par exemple start → ajouter &purge=true : [[http://dns_site/wikiname/start&purge=true]] (ref : [[https://www.dokuwiki.org/faq:blankpage]])
+    * Ou réinitialiser via la sauvegarde des paramètres de configuration du wiki dans le gestionnaire d'administration. Cf. [[https://www.dokuwiki.org/caching]]
+===== Communauté et développement =====
+  * [[https://www.dokuwiki.org/teams:getting_involved]]
+  * [[https://www.dokuwiki.org/teams:community]]
+  * [[https://forum.dokuwiki.org/]]
+  * Forum : [[https://forum.dokuwiki.org/]]
+  * Sociétés spécialisées :
+    * [[https://www.cosmocode.de/en/]]
 ===== Des sites en DokuWiki =====
-  * [[https://doc.ubuntu-fr.org/]]
+  * Logiciels libres
-  * [[https://openwrt.org]]
+    * [[https://www.dokuwiki.org/dokuwiki]] → la documentation de DokuWiki est elle-même un des meilleurs exemples de DokuWiki
+    * [[https://doc.ubuntu-fr.org/]] documentation Ubuntu en français
+    * Communautés Xfce et Xubuntu
+      * [[https://wiki.bluesabre.org/start]] Xubuntu Project Docs & Staging Wiki
+      * [[https://docs.xfce.org/start]] & [[https://wiki.xfce.org]]
+    * [[https://openwrt.org]] (wireless freedom)
   * https://mycitizen.net/en:start
   * [[https://fsl56.org/]] * *
@@ Ligne 149: / Ligne 361: @@
   * [[https://www.dokuwiki.org/tips:cms]] → Using DokuWiki as a lightweight CMS
   * [[https://www.dokuwiki.org/dokuinstall]]
+  * [[https://wiki.cartocite.fr/doku.php?id=accueil]]
   * Education
     * [[http://encyclopedia-magnetica.com/doku.php/start]]
@@ Ligne 154: / Ligne 367: @@
     * [[https://physicstravelguide.com/start]]
     * [[https://www.psychdb.com/home]] (psychomedical)
-  * [[http://lotar.altervista.org/wiki/]]
+  * Wikis personnels :
+    * [[http://lotar.altervista.org/wiki/]] blog personnel utilisant DokuWiki et le thème Bootstrap3
+    * [[https://sebsauvage.net/wiki/doku.php|Wiki de sebsauvage.net]]
+    * [[https://radeff.red/dokuwiki/homepage|homepage - Radeff’s Wiki]]
   * [[https://www.soscisurvey.de/help/doku.php/:en:start]] (corporate)
+  * [[http://www.mosaic-industries.com/embedded-systems/microcontroller]]
+  * [[https://lemonldap-ng.org/start]]
+  * [[https://oar.imag.fr/start]]
+  * [[https://www.sympa.org/index]]
+  * [[https://faq.o2switch.fr/start]]
+  * [[https://www.kamailio.org/wiki/start]]
+  * [[https://wiki.monitoring-fr.org/]]
+  * laboratoires universitaires
+    * [[http://www.math-evry.cnrs.fr/doku.php|Laboratoire de Mathématiques et Modélisation d’Évry  - LaMME]]
+    * [[https://www.lpsm.paris/semoa/index|Structures et Modèles Aléatoires - LPSM-Structures et Modèles Aléatoires]]
+    * [[http://www.cbp.ens-lyon.fr/doku.php?id=accueil|accueil - CBP]]
 Produits incorporant DokuWiki en option :
@@ Ligne 165: / Ligne 392: @@
   * [[https://index.woorank.com/en/reviews?technologies=dokuwiki]] → Top 2,060 websites using DokuWiki...
   * [[https://w3techs.com/technologies/details/cm-dokuwiki]]
+  * [[https://www.inmotionhosting.com/support/edu/dokuwiki]] quelques documents d'aide sur DokuWiki