Par défaut les URL de votre blogue ont la forme suivante :
Ce type d'URL fonctionne bien chez tous les hébergeurs. Cependant vous pouvez vouloir des URL plus agréables pour votre site et ne pas faire référence à DotClear, ce qui est une bonne idée.
Vous avez installé DotClear et voulez que votre blogue soit accessible par l'URL http://monsite.com/blog/. Bien sûr, les archives seront aussi accessibles de cette manière, par exemple : http://monsite.com/blog/2003/09/15/1-PremierBillet.
Nous admettons que votre site s'appelle http://monsite.com.
La première chose à faire est d'installer DotClear comme indiqué dans le chapitre installation et vérifier que tout fonctionne correctement.
Votre blogue doit être accessible par l'url http://monsite.com/dotclear/.
Nous allons commencer par déplacer le fichier index.php vers le répertoire raçine de votre site et le renommer en blog.php. Ainsi votre blogue sera accessible depuis http://monsite.com/blog.php ce qui est déjà beaucoup mieux.
Avant que cela ne fonctionne vous devez modifier deux choses. Dans le fichier dotclear/conf/blog_conf.php, vous allez changer la valeur de $cf_blog_url en /blog.php/ (vous pouvez aussi le faire depuis l'outil de configuration). Ensuite, dans votre fichier /blog.php, vous allez changer la valeur de la variable $app_path en /dotclear/. Ceci va permettre au fichier de savoir où se trouve le reste de DotClear. Bien sûr, si vous renommez votre répertoire DotClear, vous changerez cette valeur en conséquence.
Maintenant vous pouvez vérifier si votre blog est bien accessible depuis http://monsite.com/blog.php/ (testez aussi quelques liens). Si quelque chose ne marche pas vérifiez bien la valeur de $cf_blog_url de votre fichier de configuration et celle de $app_path dans /blog.php/.
Il ne reste plus qu'à supprimer cette disgracieuse extension. Pour cela votre serveur doit supporter mod_negociation. Ceci peut ne pas fonctionner.
Pour vérifier, vous allez tout simplement changer la valeur de $cf_blog_url en /blog/ dans le fichier blog_conf.php.
Testez l'URL http://monsite.com/blog/. Si ça fonctionne, testez aussi les liens permanents, postez un commentaire. Si tout marche bien, vous pouvez ouvrir une bouteille de champagne.
Quand ça ne marche pas, vous pouvez essayer de créer un fichier .htaccess à la raçine de votre site et y ajouter les lignes suivantes :
Options MultiViews
Notez que pour l'hébergeur TuxFamily, le fichier .htaccess est le suivant :
Options ExecCGI MultiViews MultiviewsMatch Any
DotClear intègre un système de cache HTTP. Cela signifie que si le navigateur de votre visiteur en est capable, la page ne sera construite que lors de sa première consultation. Par la suite, si rien n'a changé un simple en-tête HTTP lui sera envoyé pour lui dire de servir la page enregistrée précédemment.
Lors de l'affichage de votre blogue, les dates de modifications d'un certain nombre de fichiers sont vérifiées. Ces fichiers sont tous les fichiers inclus pour faire fonctionner la partie publique de DotClear ainsi que le fichier conf/UPDATE. Ce fichier s'il est accessible en écriture par le serveur voit sa date modifiée à chaque modification de la base de données.
Si pour une raison ou une autre, le cache HTTP pose problème, vous pouvez ajuster la valeur de $cf_http_cache à 0 dans blog_conf.php pour le désactiver complètement.