{{tag>tutoriel}}

====== Installation de dokuwiki ======

===== Pré-requis =====

<subnumberlist>
  - Un serveur Web
  - avec support PHP
    - [[apt>php,php-gd,php-xml]] <cli prompt='$ '>USER@MACHINE:~$ sudo apt install php{,-{gd,xml}}</cli>
</subnumberlist>
===== Première étape =====

<subnumberlist>
  - **Téléchargez la dernière version** depuis la [[https://download.dokuwiki.org/|page de téléchargement]], bouton <key>Download</key> -> fichier dokuwiki-xx...xx.tgz
    - Lisez bien la [[https://www.dokuwiki.org/fr:security|page sur la sécurité]] avant de commencer l'installation.
    - **Décompactez l'archive**
    - **Dans le répertoire** dokuwiki-xx...xx créé se trouve le répertoire **dokuwiki**
  - **Thème vector** :
    - **Téléchargez le thème vector** depuis la [[https://www.dokuwiki.org/template:vector|page de téléchargement]] -> fichier aaa-mm-jj_vector.tar.gz
    - **Décompactez l'archive**
    - **Dans le répertoire aaaa-mm-jj_vector créé**, copiez le répertoire **vector** vers **dokuwiki-xx...xx/dokuwiki/lib/tpl/**
  - **Logo, user.js et fichiers css** : copiez-les dans **dokuwiki-xx...xx/dokuwiki/lib/tpl/vector/user/** vers ../dw2/lib/tpl/vector/user/logo.jpg
</subnumberlist>
===== Autres étapes =====

<subnumberlist>
  - **téléverser le répertoire dokuwiki-xx…xx/dokuwiki/** sur votre espace web
  - **Le renommer** : dokuwiki -> monsite
  - **Lancer la page install.php** dans le navigateur ; voici les champs à remplir :
    - **Nom du wiki** : Configure le titre du wiki, qui sera affiché en haut à gauche en utilisant le thème de base.
    - **contrôle d'accès** : activer ; si cette case est cochée, la suite devient active.
    - **Super-utilisateur** : nom d'utilisateur de l'administrateur du site (minuscules en ASCII, les espaces ne sont pas autorisés)
    - **Nom** : Le véritable nom (= nom et prénom) du super-utilisateur.
    - **Adresse de courriel** : mail du super-utilisateur (un courriel valide)
    - **Mot de passe** : mot de passe du super-utilisateur.
    - **Répétez le mot de passe** : confirmation du mot de passe
    - **Politique de contrôle d'accès initiale** : le choix dépend de l'utilisation principale du wiki. Ce n'est qu'une première configuration, que vous pourrez corriger et affiner ensuite grâce aux ACL.
    - **Permettre aux utilisateurs de s'enregistrer eux-mêmes** : Si cette case reste non cochée, les futurs utilisateurs ne pourront s'inscrire eux-mêmes. (Cf l'option de configuration disableactions)
  - **S'identifier avec un compte admin**
  - **Aller dans le gestionnaire de configuration**
    - Changer le template pour vector
    - Choisir nice URL > .htaccess
    - Choisir '/' comme séparateur de catégories (namespaces)
  -  Configurer la ré-écriture d'URL : éditer monsite/.htaccess.dist et enlever les '#' (commentaires) de la section concernant l'URL rewrite. Enregistrer le fichier sous le nom monsite/.htaccess
</subnumberlist>
===== Conclusion =====

===== Problèmes connus =====

===== Voir aussi =====

  * **(en)** [[http://]]
  * **(fr)** [[http://]]

----
//Basé sur << [[http://|ARTICLE]] >> par AUTEUR.//