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 16:55] – villersd | floss:dokuwiki [2020/01/24 13:51] – [DokuWiki] 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,... | ||
+ | * rename basedir → [[https:// | ||
+ | </ | ||
+ | |||
* [[wp> | * [[wp> | ||
* [[wp> | * [[wp> | ||
* [[https:// | * [[https:// | ||
* [[https:// | * [[https:// | ||
+ | * [[https:// | ||
===== Introduction ===== | ===== Introduction ===== | ||
Ligne 11: | Ligne 23: | ||
→ définir un wiki (cf. aussi Using DokuWiki as a lightweight CMS) | → 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 26: | Ligne 47: | ||
Références : | Références : | ||
* [[https:// | * [[https:// | ||
+ | |||
+ | ===== Historique du projet ===== | ||
+ | * [[https:// | ||
+ | * Andreas Gohr | ||
+ | * [[https:// | ||
+ | * | ||
===== Installation ===== | ===== Installation ===== | ||
Ligne 71: | Ligne 98: | ||
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, | ||
Ligne 87: | Ligne 146: | ||
* [[https:// | * [[https:// | ||
+ | ==== Quelle est la structure du wiki sur le serveur ? ==== | ||
+ | * 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 ==== | + | ==== Comment utiliser plusieurs instances de DokuWiki |
* [[https:// | * [[https:// | ||
* [[https:// | * [[https:// | ||
Ligne 96: | Ligne 168: | ||
===== 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 ===== | ||
* en cas de migration, effacement de fichiers obsolètes : sudo grep -Ev ' | * en cas de migration, effacement de fichiers obsolètes : sudo grep -Ev ' | ||
- | | + | |
- | * cd /var/www puis effacement de l' | + | * cd /var/www/html puis effacement de l' |
- | * cd /home/dvillersadm | + | * cd /home/vmuser |
- | * extraction par sudo tar -xzvf ./dokuwiki500299_2013-08-28_03: | + | * extraction par tar --force-local |
- | * cd /home/dvillersadm/home/ | + | * 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:// | * owner & permissions https:// | ||
* sudo chown -R www-data: | * sudo chown -R www-data: | ||
Ligne 113: | Ligne 204: | ||
===== Extensions ===== | ===== Extensions ===== | ||
+ | * Forme : | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[http:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[http:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | |||
+ | * Fonctionnalités | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | |||
+ | * Formulaire, automatisation | ||
+ | * [[https:// | ||
+ | |||
* [[https:// | * [[https:// | ||
* Calendriers, | * Calendriers, | ||
Ligne 127: | Ligne 241: | ||
* [[https:// | * [[https:// | ||
* Forum et inclusion de forum, commentaires, | * Forum et inclusion de forum, commentaires, | ||
- | * édition | + | * é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:// | ||
+ | * iframe | ||
+ | * reveal.js | ||
+ | * 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 139: | Ligne 330: | ||
* 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, il est nécessaire de purger le cache des pages correspondantes par exemple start → ajouter & | ||
+ | * Ou réinitialiser via la sauvegarde des paramètres de configuration du wiki dans le gestionnaire d' | ||
+ | |||
+ | ===== 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:// | + | |
- | * [[https:// | + | * [[https:// |
+ | | ||
+ | * Communautés Xfce et Xubuntu | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
* https:// | * https:// | ||
* [[https:// | * [[https:// | ||
Ligne 149: | Ligne 361: | ||
* [[https:// | * [[https:// | ||
* [[https:// | * [[https:// | ||
+ | * [[https:// | ||
* Education | * Education | ||
* [[http:// | * [[http:// | ||
Ligne 154: | Ligne 367: | ||
* [[https:// | * [[https:// | ||
* [[https:// | * [[https:// | ||
- | * [[http:// | + | |
+ | | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
* [[https:// | * [[https:// | ||
+ | * [[http:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * laboratoires universitaires | ||
+ | * [[http:// | ||
+ | * [[https:// | ||
+ | * [[http:// | ||
Produits incorporant DokuWiki en option : | Produits incorporant DokuWiki en option : | ||
Ligne 165: | Ligne 392: | ||
* [[https:// | * [[https:// | ||
* [[https:// | * [[https:// | ||
+ | * [[https:// | ||