Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révisionLes deux révisions suivantes | ||
floss:dokuwiki [2020/01/09 09:45] – [Extensions] villersd | floss:dokuwiki [2020/01/21 11:57] – [Astuces] villersd | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
====== DokuWiki ====== | ====== DokuWiki ====== | ||
+ | |||
+ | <note warning> | ||
+ | * 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:// | ||
+ | * xmlrpc ? envoi de contributions par email pour des pages,... | ||
+ | </ | ||
+ | |||
* [[wp> | * [[wp> | ||
* [[wp> | * [[wp> | ||
* [[https:// | * [[https:// | ||
* [[https:// | * [[https:// | ||
+ | * [[https:// | ||
===== Introduction ===== | ===== Introduction ===== | ||
A côté d’un blog (tel que WordPress), utile pour créer un site " | A côté d’un blog (tel que WordPress), utile pour créer un site " | ||
- | Il est aussi courant de partager en lecture certains documents de manière limitée, avec des personnes ou des groupes de personnes contrôlés, | + | Il est aussi courant de partager en lecture certains documents de manière limitée, avec des personnes ou des groupes de personnes contrôlés, |
+ | |||
+ | → définir un wiki (cf. aussi Using DokuWiki as a lightweight CMS) | ||
+ | |||
+ | * collaboratif | ||
+ | * rapide, flexible | ||
+ | * syntaxe simple | ||
+ | * historique des versions | ||
+ | * structuration de l' | ||
+ | * 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, | 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, | ||
Ligne 22: | Ligne 44: | ||
* DokuWiki conserve un historique des versions et possède un moteur d' | * DokuWiki conserve un historique des versions et possède un moteur d' | ||
+ | Références : | ||
+ | * [[https:// | ||
+ | ===== Historique du projet ===== | ||
+ | * [[https:// | ||
+ | * Andreas Gohr | ||
+ | * [[https:// | ||
+ | * | ||
===== Installation ===== | ===== Installation ===== | ||
Ligne 44: | Ligne 73: | ||
* fichiers : sudo find . ! -type d -exec chmod 660 {} \; | * fichiers : sudo find . ! -type d -exec chmod 660 {} \; | ||
* répertoires : sudo find . -type d -exec chmod 770 {} \; | * répertoires : sudo find . -type d -exec chmod 770 {} \; | ||
- | |||
- | * < | ||
- | * < | ||
- | |||
* on peut à présent régler la configuration de base de DokuWiki via un navigateur web, en pointant sur [[http:// | * on peut à présent régler la configuration de base de DokuWiki via un navigateur web, en pointant sur [[http:// | ||
* **Wiki Name** | * **Wiki Name** | ||
Ligne 64: | Ligne 89: | ||
* mode de création des répertoires : choisir 02770 (au lieu de 0755) (set gid, cf. [[http:// | * mode de création des répertoires : choisir 02770 (au lieu de 0755) (set gid, cf. [[http:// | ||
* mode de création des fichiers : choisir 0660 (au lieu de 0644) | * mode de création des fichiers : choisir 0660 (au lieu de 0644) | ||
- | * Dans les paramètres d’authentification, | + | * Dans les paramètres d’authentification, |
* pour le délai avant indexation (paramètres anti-spam), vous pouvez vous contenter de 60*5 plutôt que 60*60*24*5, qui contraint à une attente de 24H après édition, avant que l’indexation par un robot de moteur de recherche ne redevienne possible | * pour le délai avant indexation (paramètres anti-spam), vous pouvez vous contenter de 60*5 plutôt que 60*60*24*5, qui contraint à une attente de 24H après édition, avant que l’indexation par un robot de moteur de recherche ne redevienne possible | ||
* Si comme administrateur vous souhaitez être averti à chaque modification effectuée par un autre utilisateur, | * Si comme administrateur vous souhaitez être averti à chaque modification effectuée par un autre utilisateur, | ||
Ligne 72: | Ligne 97: | ||
Plus tard, notamment si vous ajoutez des extensions (plugins) possédant leurs propres paramètres de configuration, | Plus tard, notamment si vous ajoutez des extensions (plugins) possédant leurs propres paramètres de configuration, | ||
- | ==== Quelques améliorations ==== | + | ==== Quelques |
+ | |||
+ | DokuWiki peut être étendu par des extensions (plugins) dont certaines sont particulièrement utiles. Ces extensions sont installées à partir du panneau d' | ||
+ | |||
+ | Le thème graphique de DokuWiki peut aussi être modifié en sélectionnant un des nombreux thèmes listés à la page [[https:// | ||
+ | |||
+ | === Réécriture d'URL (jolis URL) === | ||
+ | * [[https:// | ||
+ | * Sur le serveur : | ||
+ | * sudo a2enmod rewrite | ||
+ | * sudo systemctl restart apache2 | ||
+ | * cd / | ||
+ | * cp .htaccess.dist .htaccess | ||
+ | * sudo nano .htaccess | ||
+ | * décommenter les lignes concernant le rewrite : | ||
+ | |||
+ | < | ||
+ | RewriteEngine on | ||
+ | # | ||
+ | RewriteRule ^_media/ | ||
+ | RewriteRule ^_detail/ | ||
+ | RewriteRule ^_export/ | ||
+ | RewriteRule ^$ doku.php | ||
+ | RewriteCond %{REQUEST_FILENAME} | ||
+ | RewriteCond %{REQUEST_FILENAME} | ||
+ | RewriteRule (.*) doku.php? | ||
+ | RewriteRule ^index.php$ | ||
+ | </ | ||
+ | |||
+ | * sudo chown www-data: | ||
+ | * normalement il n'y a pas de pas de changement nécessaire dans le fichier de configuration d' | ||
+ | * Dans la configuration du wiki (via la page d' | ||
==== Sécurisation, | ==== Sécurisation, | ||
- | <note tip> | + | <note tip> |
+ | |||
+ | Solution : | ||
+ | * sécurisation via apache2 [[https:// | ||
+ | * sudo nano / | ||
+ | * sudo service apache2 restart | ||
+ | |||
+ | </ | ||
* [[https:// | * [[https:// | ||
* [[https:// | * [[https:// | ||
- | sécurisation via apache2 https:// | + | ==== Quelle est la structure du wiki sur le serveur ? ==== |
- | ==== Comment utiliser plusieurs instances de DokuWiki ==== | + | * Structure complète dans le Manuel du développeur : [[https:// |
+ | * Quelques répertoires importants : | ||
+ | * aa | ||
+ | * bb | ||
+ | * Répertoires propres à l' | ||
+ | * data/pages - contient les pages actuelles | ||
+ | * data/meta - contient les méta-informations sur les pages (créateurs, | ||
+ | * data/media - contient les fichiers media actuel (images, PDFs, …) | ||
+ | * data/ | ||
+ | * data/attic - anciennes versions des pages | ||
+ | * data/ | ||
+ | * conf - les réglages de configuration | ||
+ | |||
+ | ==== Comment utiliser plusieurs instances de DokuWiki | ||
* [[https:// | * [[https:// | ||
* [[https:// | * [[https:// | ||
Ligne 90: | Ligne 167: | ||
===== Sauvegardes ===== | ===== 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 / | ||
+ | * 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 / | ||
+ | * 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 / | ||
+ | * À ce stade, les droits et propriétaires ne sont pas correct (vérifier par ls -l) : changer owner & permissions ([[https:// | ||
+ | * sudo chown -R www-data: | ||
+ | * cd / | ||
+ | * fichiers : sudo find . ! -type d -exec chmod 660 {} \; | ||
+ | * répertoires : sudo find . -type d -exec chmod 770 {} \; | ||
+ | * Références : | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
===== Migration ===== | ===== Migration ===== | ||
Ligne 108: | Ligne 204: | ||
===== Extensions ===== | ===== Extensions ===== | ||
* [[https:// | * [[https:// | ||
- | * Calendriers : | + | * Calendriers, agenda |
* [[https:// | * [[https:// | ||
- | * [[https:// | + | |
+ | | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * réseaux sociaux (Facebook, Twitter, Instagram, | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * Forum et inclusion de forum, commentaires, | ||
+ | * édition | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | |||
+ | * LaTeX : [[https:// | ||
+ | * installable via le gestionnaire d' | ||
+ | * librairies additionnelles sur le serveur : | ||
+ | * sudo apt-get install texlive-latex-base imagemagick ghostscrip | ||
+ | * Dans le gestionnaire d' | ||
+ | * L' | ||
+ | * plugin»latex»convert_options initialement à ' | ||
+ | * CSV : [[https:// | ||
+ | * BlockQuote [[https:// | ||
+ | * iframe | ||
+ | * reveal.js | ||
+ | * dw2pdf | ||
+ | * bookcreator | ||
+ | * geophp [[https:// | ||
+ | * openlayersmap [[https:// | ||
+ | * html5video [[https:// | ||
+ | |||
+ | FIXME : | ||
+ | * Enregistrements d' | ||
+ | * Plugins bureaucracy, | ||
+ | * utilitaires : | ||
+ | * plugin getraw [[https:// | ||
+ | * xmlrpc ?? | ||
+ | * plugins Flowchartjs flowcharts | ||
+ | * svgEmbed + edit de mime.local.conf | ||
+ | * definitionlist [[https:// | ||
+ | |||
+ | FIXME Logo & favicon ?? | ||
==== Divers ==== | ==== Divers ==== | ||
* [[http:// | * [[http:// | ||
+ | |||
+ | ===== Thèmes (templates) ===== | ||
+ | * testés (et approuvés) | ||
+ | * bootstrap3 avec united de [[https:// | ||
+ | |||
+ | |||
+ | ===== 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 " | ||
+ | * Les pages peuvent être classées dans une structure arborescente comme pour des fichier habituels d'un système d' | ||
+ | * des outils permettent d' | ||
+ | |||
+ | ===== Utilisateurs, | ||
+ | |||
+ | ===== 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, | ||
+ | |||
+ | Groupes et utilisateurs : inscrits sur le site, membres de l' | ||
+ | |||
+ | ==== Exemple : l' | ||
+ | Sous-parties : l' | ||
+ | |||
+ | Les métiers : l' | ||
+ | |||
+ | Les implantations : administration, | ||
+ | |||
+ | Les bénéficiaires : élèves du fondamental (4500 et leurs parents), élèves du secondaire (3000), élèves | ||
+ | |||
+ | Groupes : parents (fondamental), | ||
+ | |||
+ | ===== Scripts DokuWiki ===== | ||
+ | * vérification du wiki installé : [[http:// | ||
+ | * utilitaire " | ||
+ | * ssh vmuser@ip_adress | ||
+ | * cd / | ||
+ | * sudo wget https:// | ||
+ | * sudo chown www-data: | ||
+ | * sudo chmod 660 grapher.php | ||
+ | * php grapher.php -h | ||
+ | * php grapher.php -d 0 -m none -o g.dot ns1: | ||
+ | * php grapher.php -d 0 -m none -f gexf -o g.gexf ns1: | ||
+ | * 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 ===== | ===== Astuces ===== | ||
Ligne 119: | Ligne 310: | ||
* travail collaboratif | * travail collaboratif | ||
* includes | * includes | ||
+ | * XML-RPC | ||
+ | * [[https:// | ||
+ | |||
+ | ===== Dépannage ===== | ||
+ | Les problèmes sont assez rares ! | ||
+ | * Vérifier régulièrement l' | ||
+ | * Si le site renvoie des pages blanches, par exemple start → ajouter & | ||
+ | |||
+ | ===== Communauté et développement ===== | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * Forum : [[https:// | ||
+ | * Sociétés spécialisées : | ||
+ | * [[https:// | ||
===== Des sites en DokuWiki ===== | ===== Des sites en DokuWiki ===== | ||
- | * https://index.woorank.com/en/ | + | * Logiciels libres |
- | * doc-ubuntu.fr | + | * [[https://www.dokuwiki.org/dokuwiki]] → la documentation de DokuWiki |
+ | * [[https:// | ||
+ | * Communautés Xfce et Xubuntu | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
* https:// | * https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * Education | ||
+ | * [[http:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * Wikis personnels : | ||
+ | * [[http:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[http:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * laboratoires universitaires | ||
+ | * [[http:// | ||
+ | * [[https:// | ||
+ | * [[http:// | ||
+ | |||
+ | Produits incorporant DokuWiki en option : | ||
+ | * [[https:// | ||
+ | |||
+ | ===== Des analyses, comparaisons, | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||