La documentation de Dotclear propose deux méthodes d'installation, une méthode automatique, et une méthode " classique ", qui installent l'ensemble des fichiers de dotclear dans le répertoire /var/www. Par contre, le paquetage dotclear inclus dans les dépôts Debian installe ses fichiers d'une manière plus conforme à l'organisation du système de fichiers de Debian, principalement dans /usr/share/dotclear/ et /var/lib/dotclear/web.

C'est la méthode du paquetage Debian que je présente ici, car c'est la plus automatisée, et car la mise à jour de Dotclear se fera tout naturellement avec les autres mises à jour du système :

On suppose qu'un serveur complet avec apache2, mysql, php et autres est correctement installé, et qu'on on a vérifié que sa page d'accueil (« It works») s'affiche bien.

Création de la base de données

Il faut tout d'abord créer la base de données : - dans le navigateur, lancez phpmyadmin en root avec le mot de passe précédemment défini pour MySQL ; - dans le panneau de gauche de la zone principale, cliquez sur le titre « créer une base de données » ; - dans le panneau droit, entrez le nom de la nouvelle base (par exemple dotclear), puis choisissez l’interclassement utf8_unicode_ci ; - enfin, cliquez sur le bouton « créer ». La base de données est créée.

Installation de Dotclear

L'installation par le paquetage Debian se fait ainsi :

# apt-get-install dotclear

Une interface en mode texte apparaît pour la configuration ; les choix donnés ici permettent une configuration simple ; je donne entre crochets le nom des paramètres correspondant dans le fichier de configuration /etc/dotclear/config.php

- configurer automatiquement : OUI - configurer la base de données de dotclear avec db-config-common : OUI - serveur à utiliser avec dotclear : mysql DC_DBDRIVER - mot de passe de l'administrateur de la base de donnée : (celui de l'administrateur de mysql) - mot de passe de connexion mysql pour dotclear : (accès à la base dotclear) DC_DBPASSWORD - nom utilisateur de l'administrateur dotclear : (identifiant de l'administrateur de dotclear) - mot de passe de l'administrateur dotclear : (accès à l'administration de dotclear) - adresse e-mail de l'administrateur : (celle que vous voulez) - serveur web à reconfigurer automatiquement : apache2 - database user (DC_DBUSER) : dotclear - database name (DC_DBNAME) : dotclear - admin URL DC_ADMIN_URL : http://localhost/dotclear/admin/ DC_ADMIN_URL - version du fichier de configuration : installer la version du responsable du paquetage : OUI

Après la fin de l'installation : - URL de l'administration de dotclear par http://mon-site.mon-domaine.fr/dotclear/admin/ - URL du blog par http://mon-site.mon-domaine.fr/blog - URL de la base de données http:/mon-site.mon-domaine.fr/phpmyadmin/

Emplacement des fichiers de Dotclear

Notez qu'avec cette installation : - les fichiers de dotclear se trouvent alors dans /usr/share/dotclear/ - la structure de la base de données (par ex. les thèmes, les plugins) se trouve dans /usr/share/dotclear/web/, qui contient des liens symboliques vers /var/lib/dotclear/web/ - le contenu de la base de données (par ex. les billets) se trouve dans /var/lib/mysql/dotclear/

On peut alors se connecter comme administrateur, créer un utilisateur standard et, une fois connecté comme utilisateur standard, commencer à écrire des billets...