Wiki

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== 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]]