DotClear 1.0rc2
===============

Installation
------------

* Pr-requis

DotClear fonctionne chez les hbergeurs supportant PHP 4.1 minimum et MySQL.
Aucun module particulier n'est ncessaire. Les fonctions utf8_encode et
utf8_decode doivent tre prsentes.

* Installation

Tlchargez DotClear et dcompressez l'archive o bon vous semble.

* Configuration gnrale

Ouvrez le fichier conf/config.php et renseignez les paramtres de connexion 
MySQL :

    * $dbuser : nom de l'utilisateur se connectant  MySQL (gnralement votre
      login).
    * $dbpass : votre mot de passe pour se connecter  la base.
    * $dbhost : nom de la machine hbergeant la base MySQL (consultez votre
      hbergeur).
    * $dbbase : nom de la base de donnes o sera install DotClear.
    * $dbprefix : prfixe ajout devant le nom de chaque table.

Vous pouvez galement modifier le paramtre $max_upload_size qui permet de
limiter la taille maximum des fichiers envoys depuis l'interface
d'administration. Notez que vous ne pourrez dpasser la valeur maximum
autorise par votre hbergeur.

* Mise en route

Chargez les fichiers sur votre espace Web si ce n'est dj fait.
Lancez ensuite le script ecrire/install.php.

Si aucune erreur ne s'est produite, il ne vous reste plus qu' vous connecter
sur votre interface d'administration pour commencer votre blogue. Sinon vous
pouvez crier et ventuellement chercher ce qui ne va pas dans votre
configuration.

* Configuration post-installation

Une fois votre blogue prt  fonctionner, vous pouvez commencer par le
configurer de manire plus fine. Deux options s'offrent  vous. Si vous tes 
l'aise avec l'dition de fichiers de configuration, vous pouvez directement
diter le fichier conf/blog_conf.php. Sinon, vous pouvez utiliser l'outil de
configuration disponible depuis l'onglet outils. Cliquez simplement sur
Configuration de DotClear pour accder  cet outil.

Le fichier conf/blog_conf.php doit tre accessible en criture par votre
serveur pour utiliser la configuration par l'interface d'administration. Un
avertissement vous sera donn le cas chant.
Dans les deux cas, voici ce  quoi correspond chaque option :

  Nom du blogue
      Le nom de votre blogue. Celui-ci sera utilis dans le fil RSS, sur la
      page d'accueil et lors des communications automatiques avec d'autres
      sites (trackbacks ou pings).

  URL vers le blogue
      L'URL pour accder  la page d'accueil de votre blogue depuis la raine
      de votre site. Par exemple, si votre site est http://www.foo.tld et que
      votre blogue se trouve  http://www.foo.tld/index.php, vous donnerez /
      index.php/. Notez que les slash (/) sont importants au dbut comme  la
      fin.

  Emplacement des images
      Dfinit l'emplacement de vos images. Comme pour l'URL vers le blogue,
      cette valeur s'exprime depuis la raine de votre site. Par exemple /
      dotclear/images si vos images sont dans http://www.foo.tld/dotclear/
      images/.

  Thme
      Une liste de thmes vous est propose. Par dfaut vous n'en avez qu'un
      mais pouvez en tlcharger depuis le site de DotClear.

  Nombre de billets par page
      Indique le nombre de billets sur la premire page du blogue et chaque
      premire page de catgorie.

  Permettre les commentaires
      Permettre ou non les commentaires. Notez que le simple fait de supprimer
      les commentaires du template ne les dsactive pas, un petit malin
      pourrait en poster quand mme. Cette option  non rendra impossible
      l'envoi de commentaire.

  Permettre les trackbacks
      Mmes remarques que pour les commentaires.

  Commentaires au format Wiki
      Si cette option est active, les commentaires entrs seront au format
      Wiki. Notez que l'aide n'est pas affiche dans le template par dfaut.
  
  Notification des commentaires par email
    Cette option permet d'activer l'envoi d'un email pour chaque commentaire
    ajout sur votre blogue. Il est ncessaire d'indiquer une adresse email
    dans les prfrences de l'utilisateur pour que cette fonctionnalit soit
    acive. Notez enfin que certains hbergeurs bloquent l'envoi d'email.
  
  Afficher des moticones
      Afficher ou non des moticones (images expressives) dans les billets et
      les commentaires.

  Format de la date
      Format de la date des billets et du calendrier selon les masques de la
      fonction PHP strftime.

  Format de l'heure
      Format de l'heure des billets selon les masques de la fonction PHP
      strftime.

	 
Mise  jour
-----------

Pour mettre  jour DotClear de la version 1.0rc1  la version 1.0rc2 voici ce
qui est conseill :

- Installer DotClear 1.0rc2 dans un rpertoire  part, n'effacez pas votre
ancienne version
- Configurez le pour qu'il accde  votre base existante, vrifiez que a
fonctionne
- Adaptez le fichier template.php pour qu'il reprenne votre ancien template
- Lancez le script ecrire/upgrade.php
- Supprimez le script
- Dplacer/renommez vos rpertoires et supprimez votre ancien DotClear (ou
sauvegardez le ;-)


Licence
-------

DotClear est un logiciel libre soumis  la license MPL (Mozilla Public License).
Voir le fichier COPYING pour plus de dtails.
