====== DokuWiki ======
===== Présentation =====

===== Installation =====
Il faut générer un lien via [[https://download.dokuwiki.org/|le site de DokuWiki]] et puis télécharger l'archive directement (ou copier/coller le lien et utiliser wget pour le télécharger directement sur le serveur) : 
<code bash>
$ wget https://download.dokuwiki.org/out/dokuwiki-8b659a33dc8f4c34111e2de010a298c8.tgz
</code>

Décompresser l'archive :
<code bash>
$ tar -xzvf dokuwiki-8b659a33dc8f4c34111e2de010a298c8.tgz
</code>

Droits :
<code bash>
# chown -R www-data:www-data dokuwik
</code>

On crée un dossier dans ''/var/www/'' et on copie tout dedans (attention de ne pas oublier le fichier caché!) : 
<code bash>
# mkdir /var/www/wiki
# mv dokuwiki/* /var/www/wiki/
# mv dokuwiki/.htaccess.dist /var/www/wiki/
</code>

On crée un "VirtualHost" dans [[apache2]] :
<code bash>
# vim /etc/apache2/sites-available/wiki.monsite.com.conf
</code>

On active le site :
<code bash>
# a2ensite wiki.monsite.com.conf
Enabling site wiki.monsite.com.
To activate the new configuration, you need to run:
  systemctl reload apache2
# systemctl reload apache2
</code>

Il faut faire créer un nouveau sous-domaine pour votre domaine et le faire pointer sur le bon serveur.
Ensuite, il faut se rendre à l'adresse ''wiki.monsite.com/install.php'' et suivre les instructions.
{{ ::install-dokuwiki-01.png?400 |}}

J'ai du installer ''libapache2-mod-php'' pour passer outre cette erreur.
<code bash>
# apt install libapache2-mod-php
# service apache2 restart
</code>

{{ ::install-dokuwiki-02.png?400 |}}

Une fois l'installation terminée, on efface le fichier "install.php" :
<code bash>
# rm /var/www/wiki/install.php
</code>
===== Plugins =====
==== yalist ====
Le [[https://www.dokuwiki.org/plugin:yalist|plugin yalist]] permet de gérer plus finement les listes.
  * Liste non-ordonnée
  - Liste ordonnée
  .. Suite de la ligne précédente
  .. Encore la suite
  ? definition list terms
  : definition lists terms
  - test
    - test 2
      - test 3
        - test 4
    -- test5

===== Erreurs et résolution =====
==== Page blanche quand on veut éditer une page ====
Dans les logs ( "/var/log/apache2/error.log" ), j'ai trouvé cette erreur :
<code>
Uncaught Error: Call to undefined function utf8_decode()
</code>

La solution est sur le [[https://www.dokuwiki.org/requirements|wiki de DokuWiki]]. Il fallait installer le package "php-xml".
<code bash>
# apt install php-xml
# service apache2 restart
</code>

==== Indexer les pages manuellement pour la recherche ====
Après une migration vers Yunohost, les pages n'étaient plus indexées et la recherche ne retournait rien ou presque.

La solution est [[https://www.dokuwiki.org/cli#indexerphp|dans la documentation]], il faut indexer manuellement à la main :
<code bash>
root@simonlefort:/var/www/dokuwiki/bin# sudo -u dokuwiki ./indexer.php 
</code>
===== Sources =====