Différences

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

--- all:bibles:linux:serveur:dokuwiki [2024/09/15 19:50] – [Installation] omeylhoc
+++ all:bibles:linux:serveur:dokuwiki [2024/12/31 10:50] (Version actuelle) – [Identification] omeylhoc
@@ Ligne 1: / Ligne 1: @@
+====== Dokuwiki ======
+----
+===== Installation =====
+==== Packages prérequis ====
+=== Ubuntu à partir de 18.04 ===
+<code bash>
+sudo apt-get install apache2 php mysql-server libapache2-mod-php php-mysql php-ldap php-zip php-mbstring php-xml
+</code>
+==== Dokuwiki ====
+<code bash>
+cd /var/www/html
+sudo wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
+sudo tar xvf dokuwiki-stable.tgz
+sudo mv dokuwiki-*/ dokuwiki
+sudo chown -R www-data:www-data dokuwiki
+</code>
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]
+===== Configuration apache =====
+==== Configuration du site ====
+=== Fichier de configuration ===
+<file apache dokuwiki.conf>
+<IfModule mod_ssl.c>
+        <VirtualHost *:443>
+                ServerName it.wiki.acs.altran.com
+                DocumentRoot "/var/www/html/it.wiki"
+                ErrorLog ${APACHE_LOG_DIR}/it.wiki.error.log
+                CustomLog ${APACHE_LOG_DIR}/it.wiki.access.log combined
+                Include "sites-available/security.conf"
+                SSLEngine on
+                SSLCertificateFile    /etc/ssl/certs/ssl-cert-snakeoil.pem
+                SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key
+                AliasMatch ^/dokuwiki/sites/[^/]+$      /var/www/html/it.wiki/
+                AliasMatch ^/dokuwiki/sites/[^/]+/(.*)$ /var/www/html/it.wiki/$1
+                Alias      /dokuwiki                    /var/www/html/it.wiki/
+                <Directory /var/www/html/it.wiki/>
+                        Options +FollowSymLinks
+                        AllowOverride All
+                        order allow,deny
+                        Allow from all
+                        <IfModule mod_rewrite.c>
+                                # Uncomment to implement server-side URL rewriting
+                                # (cf. <http://www.dokuwiki.org/config:userewrite>).
+                                        # Do *not* mix that with multisite!
+                                #RewriteEngine on
+                                #RewriteBase /dokuwiki
+                                #RewriteRule ^lib                      - [L]
+                                #RewriteRule ^doku.php                 - [L]
+                                #RewriteRule ^feed.php                 - [L]
+                                #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]
+                                #RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
+                        </IfModule>
+                </Directory>
+                <Directory /var/www/html/it.wiki/bin>
+                        Require all denied
+                </Directory>
+                <Directory /var/www/html/it.wiki/data>
+                        Require all denied
+                </Directory>
+         </VirtualHost>
+</IfModule>
+</file>
+=== Prise en compte ===
+<code bash>
+sudo a2enmod ssl
+sudo a2ensite dokuwiki
+sudo systemctl reload apache2
+</code>
+==== Sécurisation ====
+=== Activation ssl ===
+<code bash>
+sudo a2enmod ssl
+sudo systemctl reload apache2
+</code>
+<note tip>Eventuellement générer un certificat pour le nom de domaine.</note>
+=== Sécurisation des entêtes http ===
+<code bash>
+sudo a2enmod headers
+sudo systemctl reload apache2
+</code>
+Ajouter les lignes suivantes à la configuration apache :
+<code apache>
+Header always set Strict-Transport-Security "max-age=15552001; includeSubDomains;"
+Header always append X-Frame-Options DENY
+Header set X-Content-Type-Options nosniff
+Header set X-XSS-Protection "1; mode=block"
+Header set Content-Security-Policy "default-src 'self' ; script-src 'self' 'unsafe-inline'; img-src 'self' data: *.openstreetmap.org; style-src 'self' 'unsafe-inline'"
+Header set X-Permitted-Cross-Domain-Policies "none"
+Header set Referrer-Policy "no-referrer"
+Header set Expect-CT 'enforce, max-age=43200'
+</code>
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]
+===== Configuration =====
+==== Configuration post installation ====
+La configuration se fait en lancant l'url [[http://<url-wiki>/install.php]]
+==== Gestion des droits ====
+Aller dans le menu « Administrer » puis « Gestion de la liste des contrôles d'accès (ACL) ».
+Sélectionner la racine choisir le groupe @ALL et mettre autorisation « Aucune ».
+Choisir le groupe @user et mettre autorisation « Envoyer ».
+==== Largeur écran ====
+Pour afficher les pages sur toute la largeur de l'écran :
+  * Cliquer sur « Administrer ».
+  * Puis choisir « Paramètres de style du thème (template) »
+  * Modifier le paramètre « Largeur du site complet » avec 100%
+==== Affichage titres ====
+Pour afficher le titre des pages dans les menus plutôt que le nom des pages :
+  * Cliquer sur « Administrer ».
+  * Puis choisir « Paramètres de configuration »
+  * Aller à la partie « Paramètre d'affichage » en cliquant sur le menu correspondant sur la droite.
+  * Changer le paramètre « Utiliser le titre de premier niveau pour le nom de la page » par « Toujours » ou « Navigation seulement »
+==== Ouverture des liens ====
+  - Aller dans le menu « Administrer » puis « Paramètres de configuration ».
+  - Chercher target dans la partie « Paramètres des liens ».
+  - Définir la cible désirée en fonction du type de lien
+  * _blank : ouvre un lien dans une nouvelle fenêtre
+  * _tab : ouvre un lien dans un nouvel onglet.
+  * _self ou vide : ouvre un lien dans la même fenêtre
+Les autres valeurs possibles comme _parent ou _top ne sont utiles que si votre thème utilise les frames. Dans ce cas, vos devriez savoir à quoi ils servent.
+==== Changement signature ====
+Il est possible de modifier la signature insérée avec le bouton prévu à cet effet.
+=== Paramètre ===
+  - Aller dans le menu « Administrer » puis « Paramètres de configuration ».
+  - Chercher signature dans la partie « Paramètres d'affichage».
+Il est possible de modifier l'interprétation par exemple pour ajouter un lien en haut de page on mettra en paramètre :
+<code>
+[[@NAMESPACE@|Haut de page]]
+</code>
+et on modifiera le script comme indiqué ci-dessous
+=== Modification script php ===
+Possibilité de modifier la fonction <color #00a2e8>toolbar_signature</color> dans le script <color #00a2e8>inc/toolbar.php</color>. Ajouter la ligne suivante pour interpréter un paramètre @NAMESPACE@ correspondant au namespace de la page courante par exemple :
+<code php>
+ $sig = str_replace('@NAMESPACE@',$INFO['id'],$sig);
+</code>
+==== Identification ====
+=== Passage en LDAPS ===
+  * Certificat
+Positionnement du certificat <color #00a2e8>EUROPE-Root-CA-B64.cer</color> dans le répertoire <color #00a2e8>/etc/ldap/certs</color>
+  * Prise en compte
+Modification du fichier <color #00a2e8>conf/local.protected.php</color> :
+<code php>
+$conf['plugin']['authldap']['server'] = 'ldaps://server1 ldaps://server2  ...';
+$conf['plugin']['authldap']['port'] = 636;
+</code>
+<note tip>La précision du port n'est pas indispensable étant donné que l'on utilise le port par défaut pour le protocole ldaps.</note>
+=== Retour en identification locale ===
+Editer le fichier <color #00a2e8>conf/local.protected.php</color> et modifier la ligne :
+<code php>
+$conf['authtype'] = 'authldap';
+</code>
+par
+<code php>
+$conf['authtype'] = 'authplain';
+</code>
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]
+===== Plugins =====
+==== Installation ====
+=== Manuelle  ===
+En cas de problème il est possible de procéder à une installation manuelle (ou mise à jour). Il suffit de télécharger le paquet, d'extraire le fichier <color #00a2e8>plugin.info.txt</color> qui contient le répertoire de destination avec la variable **base**. Il suffit ensuite d'extraire l'archive dans le répertoire <color #00a2e8>lib/plugins/<base></color>
+=== Liste ===
+^ Fonction  ^ Page du plugin  ^
+| Couleur  | [[https://www.dokuwiki.org/plugin:color|Color]]  |
+| Export au format pdf  | [[https://www.dokuwiki.org/plugin:dw2pdf|Dw2Pdf]]  |
+| Edition de tableau  | [[http://www.dokuwiki.org/plugin:edittable|Edittable]]  |
+| Gallerie d'images  | [[http://www.dokuwiki.org/plugin:gallery|Gallery]]  |
+| Inclusion de section/page  | [[https://www.dokuwiki.org/plugin:include|Include]]  |
+| Menu index des pages du wiki  | [[https://www.dokuwiki.org/plugin:indexmenu|Indexmenu]]  |
+| Touches clavier  | [[https://www.dokuwiki.org/plugin:keyboard|Keyboard]]|
+| Renommage de page  | [[http://www.dokuwiki.org/plugin:move|Move]]  |
+| Ajout de notes colorées  | [[https://www.dokuwiki.org/plugin:note|Note]]  |
+| Export openoffice  | [[https://www.dokuwiki.org/plugin:odt|ODT (export OpenOffice)]]  |
+| Cartographie  | [[https://www.dokuwiki.org/plugin:openlayersmap|Openlayersmap]]  |
+| Export du site en html ou pdf  | [[https://www.dokuwiki.org/plugin:siteexport|Site Export]]  |
+| Syntaxe de typographie  | [[https://www.dokuwiki.org/plugin:typography|Typography]]  |
+| Mise à jour Wiki  | [[http://www.dokuwiki.org/plugin:upgrade|Upgrade]]  |
+| Page d'accueil personnalisée  | [[https://www.dokuwiki.org/plugin:userhomepage|User homepage]]  |
+=== Répertoire d'installation ===
+Les plugins sont installés dans le sous répertoire <color #00a2e8>lib/plugins</color>.
+==== Mise à jour ====
+En cas d'erreur lié à un dépassement de tempo, modifier la variable **max_execution_time** dans le fichier <color #00a2e8>/etc/php/8.1/apache2/php.ini</color> (30s par défaut)
+<code bash>
+max_execution_time = 180
+</code>
+Puis redémarrer apache
+<code bash>
+sudo systemctl restart apache2
+</code>
+==== Openlayers map ====
+=== Installation ===
+  * Installer le package php-gd
+<code bash>
+sudo apt-get install php-gd
+</code>
+  * Installer le plugin [[https://www.dokuwiki.org/plugin:geophp|geophp]]. Egalement disponible sur [[https://sourceforge.net/projects/dokuwikispatial/files/geophp/|Sourceforge]].
+  * Installer le plugin [[https://www.dokuwiki.org/plugin:openlayersmap|OpenLayersMap]] par le gestionnaire ou manuellement.
+<note warning>
+En cas d'installation manuelle, penser à activer le plugin ensuite.
+</note>
+=== Ajout du type mime gpx ===
+Ajouter la ligne suivante dans le fichier <color #00a2e8>conf/mime.local.conf</color> (Créer le fichier si nécessaire).
+<code>
+gpx      !application/gpx+xml
+</code>
+Ajouter une icône pour le type gpx sous <color #00a2e8>lib/images/fileicons</color>.
+<note important>A partir de la version 2022-07-31 Igor, il faut mettre un fichier svg sous le répertoire <color #00a2e8>lib/images/fileicons/svg</color>
+</note>
+=== Utilisation ===
+**Uploader trace GPX**
+Ajouter la trace GPX à l'aide du gestionnaire de média « Ajouter des images ou autres fichiers ».
+**Insérer le code pour la carte**
+A l'aide du bouton spécifique ou en ajoutant directement le code :
+<code>
+<olmap id="cartex" width="600px" height="400px" zoom="15" lat="45.13" lon="2.42" baselyr="OpenStreetMap" gpxfile=":chemin:vers:le:fichier:gpx ">
+</olmap>
+</code>
+  * **id**      : identifiant de la carte, unique sur la page.
+  * **width**   : facultatif (valeur par défaut 550px).
+  * **height**  : facultatif (valeur par défaut 450px).
+  * **zoom**    : facultatif (autozoom par défaut).
+  * **lat**     : facultatif. Permet de centrer correctement la carte.
+  * **lon**     : facultatif. Permet de centrer correctement la carte.
+  * **baselyr** : facultatif. OpenStreetMap par défaut.
+  * **gpxfile** : facultatif. Permet d'afficher une trace GPX sur la carte.
+<note>
+Valeurs par défaut dans le fichier de conf <color #00a2e8>lib/plugins/openlayersmap/conf/default.php</color>
+</note>
+<note warning>
+Il faut un espace derrière le nom du fichier gpx sinon la carte ne s'affiche pas.
+</note>
+==== Note ====
+Pour ajouter des boutons à l'édition pour ajouter les 4 types de notes, ajouter le fichier scripts.js dans le répertoire <color #00a2e8>lib/plugins/note</color>
+<file javascript script.js>
+if(toolbar){
+    toolbar[toolbar.length] = {"type":"format", "title":"note", "key":"",
+                               "icon":"../../plugins/note/images/tb_note.png",
+                               "open":"<note>", "close":"</note>"
+                              };
+    toolbar[toolbar.length] = {"type":"format", "title":"tip", "key":"",
+                               "icon":"../../plugins/note/images/tb_tip.png",
+                               "open":"<note tip>", "close":"</note>"
+                              };
+    toolbar[toolbar.length] = {"type":"format", "title":"important", "key":"",
+                               "icon":"../../plugins/note/images/tb_important.png",
+                               "open":"<note important>", "close":"</note>"
+                              };
+    toolbar[toolbar.length] = {"type":"format", "title":"warning", "key":"",
+                               "icon":"../../plugins/note/images/tb_warning.png",
+                               "open":"<note warning>", "close":"</note>"
+                              };
+}
+</file>
+==== Boutons ====
+Pour ajouter des boutons pour les sections de code ou les touches clavier, se rendre dans le « Gestionnaire d'extension », faire une « installation manuelle » en sélectionnant le fichier zip suivant :
+{{ :all:bibles:linux:serveur:boutons.zip |}}
+==== User homepage ====
+=== Activation ===
+  * Aller dans les paramètres de configuration du plugin Userhomepage
+  * Cocher la case « Créer les espaces privés des utilisateurs »
+  * Remplacer le contenu de la page start.txt à la racine par
+<code>
+{{page>user:@USER@:start}}
+</code>
+  * Créer le contenu désiré sous user:<login>:start. Par exemple :
+<code>
+====== Contenu du site ======
+==== Bibles ====
+{{indexmenu>all:bibles.#1|context skipfile=/sidebar/}}
+</code>
+<note important>Attention de donner l'accès à tout le monde au fichier start.txt à la racine</note>
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]
+===== Répertoires =====
+==== Liste ====
+=== conf ===
+Fichiers de configuration.
+=== data/pages ===
+Pages du wiki au format texte.
+=== data/attic ===
+Historique des pages du Wiki.
+=== data/media ===
+Fichiers téléchargés (Images, documents, ...).
+==== Nettoyage ====
+Il est possible de faire un peu de ménage de temps en temps. Script automatique ci-dessous à adapter, il permet :
+  * Suppression des fichiers historiques de plus de 30 jours (à voir si l'on souhaite garder l'historique des pages ... ou pas).
+  * Suppression des fichiers de verrouillage de plus de 1 jour.
+  * Suppression des fichiers du cache de plus de 30 jours.
+  * Suppression des répertoires vides.
+<file bash cleanup-wiki.sh>
+#!/bin/bash
+cleanup()
+{
+        local data_path="$1"        # full path to data directory of wiki
+        local retention_days="$2"   # number of days after which old files are to be removed
+        # purge files older than ${retention_days} days from attic and media_attic (old revisions)
+        find "${data_path}"/{media_,}attic/ -type f -not -name _dummy -mtime +${retention_days} -delete
+        # remove stale lock files (files which are 1-2 days old)
+        find "${data_path}"/locks/ -name '*.lock' -type f -mtime +1 -delete
+        # remove files older than ${retention_days} days from the cache
+        find "${data_path}"/cache/?/ -type f -not -name _dummy -mtime +${retention_days} -delete
+        # remove empty directories
+        find "${data_path}"/{attic,cache,index,locks,media,media_attic,media_meta,meta,pages,tmp}/ -mindepth 1 -type d -empty -delete
+}
+# cleanup DokuWiki installations (path to datadir, number of days)
+# some examples:
+if [ $# -eq 1 ]; then
+        REP_WIKI="$1/data"
+        if [ -d ${REP_WIKI} ]; then
+                cleanup ${REP_WIKI} 30
+        else
+                printf "\n\t>>> Répertoire ${REP_WIKI} inexistant\n\n"
+                exit 1
+        fi
+else
+        printf "\n\t>>> Passer le répertoire du Dokuwiki en paramètre\n\n"
+        exit 1
+fi
+</file>
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]
+===== Stylesheet =====
+Les nouveaux styles doivent être définis dans le fichier <color #00a2e8>conf/userstyle.css</color>
+==== Encadrer les titres de niveau 2 ====
+<file css userstyle.css>
+h2 {
+  margin: 2px;
+  padding: 2em;
+  border: 2px solid __text_alt__;
+}
+</file>
+==== Réduire la marge sous les titres de niveau 3 ====
+<file css userstyle.css>
+h3 {
+  margin-bottom: 4px;
+}
+</file>
+==== Définir la couleur des titres de niveau 2 ====
+<file css userstyle.css>
+h2 {
+  background-color: #74992e;
+  color:#ff7f27;
+}
+</file>
+==== Couleurs : color ====
+^ Couleur  ^ Code  ^
+| Blanc  | #ffffff  |
+| <color #ffaec9>Rose</color>  | #ffaec9  |
+| <color #ed1c24>Rouge</color>  | #ed1c24  |
+| <color #ff7f27>Orange</color>  | #ff7f27  |
+| <color #ffc90e>Or</color>  | #ffc90e  |
+| <color #fff200>Jaune</color>  | #fff200  |
+| <color #22b14c>Vert</color>  | #22b14c  |
+| <color #b5e61d>Vert clair</color>  | #b5e61d  |
+| <color #00a2e8>Turquoise</color>  | #00a2e8  |
+| <color #99d9ea>Bleu ciel</color>  | #99d9ea  |
+| <color #a44340>Marron</color>  | #a44340  |
+| Noir  | #000000  |
+==== Taille : font-size ====
+^ Valeur  ^
+| medium  |
+| xx-small  |
+| x-small  |
+| small  |
+| large  |
+| x-large  |
+| xx-large  |
+==== Style de caractères ====
+<file css>
+font-style:normal;
+font-style:italic;                              /* texte en italique                                */
+font-weight: normal;
+font-weight: bold;                              /* texte gras                                       */
+font-weight: 100;                               /* normal=400 bold 700                              */
+font-weight: 900;
+text-decoration: normal;
+text-decoration: underline;                     /* texte souligné                                   */
+text-decoration: line-through;                  /* texte barré                                      */
+text-decoration: underline dotted;              /* texte souligné de pointillés                     */
+text-decoration: underline dotted red;          /* texte souligné de pointillés rouges              */
+text-decoration: green wavy underline;          /* texte souligné d'une vague de couleur verte      */
+text-decoration: underline overline #FF3028;    /* texte souligné et surligné avec la couleur codée */
+</file>
+==== Exemple de fichier ====
+<file css userstyle.css>
+h2 {
+  margin: 2px;
+  padding: 2em;
+  border: 2px solid __text_alt__;
+}
+h3 {
+  color:#ff7f27;
+  font-style:normal;
+  font-weight: bold;
+  text-decoration: underline;
+  font-size: large;
+}
+</file>
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]
+===== Syntaxe =====
+==== Syntax Highlighting ====
+  * apache
+  * awk
+  * bash
+  * basic4gl
+  * batch
+  * cmake
+  * cobol
+  * c
+  * cpp
+  * csharp
+  * css
+  * delphi
+  * dos
+  * fortran
+  * html
+  * html5
+  * ini
+  * inno
+  * java5
+  * java
+  * javascript
+  * lisp
+  * make
+  * mysql
+  * nagios
+  * nginx
+  * oracle11
+  * oracle8
+  * pascal
+  * perl6
+  * perl
+  * php
+  * postgresql
+  * postscript
+  * powershell
+  * prolog
+  * properties
+  * python
+  * qbasic
+  * reg
+  * rexx
+  * rpmspec
+  * ruby
+  * sql
+  * sshconfig
+  * tcl
+  * teraterm
+  * text
+  * vb
+  * vbscript
+  * vim
+  * xml
+  * yaml
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]
+===== Trucs & Astuces =====
+==== Debug ====
+=== Mise en place ===
+Ajouter à la fin de l'url de la page <color #00a2e8>?do=debug</color> ou <color #00a2e8>&do=debug</color>.
+=== Résultat ===
+Les traces se trouvent dans le fichier <color #00a2e8>data/cache/debug.log</color>.
+==== Vider le cache ====
+=== Pour toutes les pages ===
+Enregistrer de nouveau les paramètres de configuration à partir du menu « <color #00a2e8>Administrer / Paramètres de configuration</color> » ou bien simplement en modifiant la date du fichier par la commande touch :
+<code bash>
+touch conf/local.php
+</code>
+=== Pour une page particulière ===
+Ajouter simplement <color #00a2e8>?purge=true</color> à l'url de la page ou bien <color #00a2e8>&purge=true</color> si l'url a déjà un paramètre.
+==== Mailto ====
+Pour pouvoir utiliser la syntaxe complète de mailto dans un lien (pour ajouter quelqu'un en copie, remplir le sujet par exemple) :
+  * Créer le fichier <color #00a2e8>conf/interwiki.local.conf</color> avec le contenu suivant :
+  mailto    mailto://{NAME}
+  * Dans le wiki ajouter un lien du type :
+  [[mailto>toto@free.fr?cc=truc@machin.com&subject=Sujet du mail&body=contenu du mail]]
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]
+===== Dépannage =====
+==== IndexMenu plugin ====
+=== Message d'erreur ===
+Indexmenu Plugin: If you use the 'js'-option of the indexmenu plugin, you have to disable the 'defer_js'-setting. This setting is temporary, in the future the indexmenu plugin will be improved.
+=== Solution ===
+  * Cliquer sur « Administrer ».
+  * Puis choisir « Paramètres de configuration »
+  * Aller à la partie « Fonctionnalités expérimentales » en cliquant sur le menu correspondant sur la droite.
+  * Décocher la ligne correspondant à defer_js « Attendre que le code HTML des pages soit analysé avant d'exécuter le javascript. Améliore la vitesse de chargement perçue, mais pourrait casser un petit nombre de greffons. »
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]
+===== Sources =====
+  * [[https://sebsauvage.net/wiki/doku.php?id=dokuwiki|Astuces]]
+  * [[https://www.dokuwiki.org/devel:debugging|Debugging]]
+----
+[[all:bibles:linux:serveur:dokuwiki|Haut de page]]