--- a/doc/book/en/03-01-installation.en.txt Tue Nov 18 11:51:22 2008 -0800
+++ b/doc/book/en/03-01-installation.en.txt Tue Nov 18 15:06:33 2008 -0800
@@ -3,81 +3,90 @@
Installation
============
-Installation de Cubicweb et de ses dépendances
-----------------------------------------------
+Installation of `Cubicweb` and its dependancies
+-----------------------------------------------
-`CubicWeb` est disponible via un entrepôt Mercurial utilisant l'extension forest.
-Vous devez donc dans un premier temps vous assurer que Mercurial est bien installé
-et que vous avez l'extension forest.
+`CubicWeb` is available as a Mercurial repository using the forest extension.
+First make sure Mercurial is installed and that the forest extension is
+available.
-Installation de Mercurial
-`````````````````````````
-Veuillez vous référer a la documentation en ligne du projet Mercurial_.
+Mercurial installation
+``````````````````````
+Please refer to the project online documentation Mercurial_.
.. _Mercurial: http://www.selenic.com/mercurial/wiki/
-Installation de l'extension forest
-``````````````````````````````````
-Dans un premier temps, récupérez une copie des sources via: http://hg.akoha.org/hgforest/.
-Ensuite, ajoutez a votre ``~/.hgrc`` les lignes suivantes ::
+We also provide in this book a quick guide on how to use
+Mercurial (:ref:`Mercurial`).
+
+
+Installation of the forest extension
+````````````````````````````````````
+
+Set up the forest extension by getting a copy of the sources
+from http://hg.akoha.org/hgforest/ and adding the following
+lines to your ``~/.hgrc``: ::
[extensions]
hgext.forest=
# or, if forest.py is not in the hgext dir:
# forest=/path/to/forest.py
-Récupération des sources
-````````````````````````
-Clonez la foret dans votre répertoire de travail.
+Get `CubicWeb` source code
+``````````````````````````
+
+Clone the forest in you working directory.
::
hg fclone http://www.logilab.org/hg/forests/cubicweb
.. note::
- Nous vous recommandons de créer un lien symbolique vers l'outil ``cubicweb-ctl``
- que vous allez etre amené a utiliser.
+ We recommand you to create a symbolic link to the command ``cubicweb-ctl``
+ as you will use it pretty often.
::
$ ln -s /path/to/forest/cubicweb/bin/cubicweb-ctl ~/bin
-Installation de Postgres
-````````````````````````
-Veuillez vous référer a la documentation en ligne du projet Postgres_.
+Postgres installation
+`````````````````````
+
+Please refer to the project online documentation Postgres_.
.. _Postgres: http://www.postgresql.org/
-Vous allez devoir installer les trois paquets suivants: `postgres-8.3`,
+You need to install the three following packages: `postgres-8.3`,
`postgres-contrib-8.3` and `postgresql-plpython-8.3`.
-On pourra ensuite installer les paquets suivants :
+Then you can install:
-* `pyro` si vous voulez que l'entrepôt soit accessible via Pyro ou si le client
- et le serveur ne sont pas sur la même machine (auquel cas il faut installer ce
- paquet sur les machines clientes et serveur)
+* `pyro` if you wish the repository is accessible through Pyro
+ or if the client and the server are not running on the same machine
+ (in suche case the packages will have to be isntalled on both
+ machines)
-* `python-ldap` si vous voulez utiliser une source ldap sur le serveur
-
+* `python-ldap` if you plan to use a LDAP source on the server
.. _ConfigurationEnv:
-Configuration de l'environnement
---------------------------------
+Environment configuration
+-------------------------
[FIXME]
Ces variables ne sont plus requises pour le bon fonctionnement de `CubicWeb`, non?
A part rajouter la foret dans le PYTHONPATH, rien de plus ne doit etre fait?
-Mettez à jour votre variable d'environemment PYTHONPATH afin d'y ajouter
-le chemin d'acces a votre foret ``cubicweb``.
+Update the environment variable PYTHONPATH to add to it the path to
+the forest ``cubicweb``.
-Ajouter les lignes suivantes à son `.bashrc` ou `.bash_profile` pour configurer
-votre environnement de développement ::
+Add the following lines to either `.bashrc` or `.bash_profile` to configure
+your development environment ::
export PYTHONPATH=/full/path/to/cubicweb-forest
+ //deprecated??
export ERUDI_REGISTRY=~/etc/erudi.d/
export ERUDI_TEMPLATES=~/hg/
export ERUDI_RUNTIME=/tmp/
@@ -88,63 +97,63 @@
.. _ConfigurationPostgres:
-Configuration Postgres
+Postgres configuration
----------------------
-* Tout d'abord vous devez initialiser votre base de données Postgres via la
- commande ``initidb``.
+
+* First you have to initialize the database Postgres with the command ``initdb``.
::
$ initdb -D /path/to/pgsql
- Une fois ces paquets installés vous pouvez lancer votre server de base de
- données Postgres avec la commande suivante: ::
+ Once initialized, you can launch the database server Postgres
+ with the command: ::
$ postgres -D /path/to/psql
- Si vous ne pouvez exécuter cette commande pour des raisons de permissions
- assurez-vous que votre utilisateur a droit d'écriture sur les la base de données.
-
+ If you cannot execute this command due to permission issues, please
+ make sure that your username has write access on the database.
::
$ chown username /path/to/pgsql
-* Création d'un super utilisateur pour la création d'instance (**root**) ::
+* Create a superuser for `CubicWeb` instance (**root**) ::
createuser -s username
- Initialisez le mot de passe de ce superutilisateur ``username`` via
- ``su - postgres`` puis ``psql``.
+ Initialize the password of the superuser you juste created with
+ ``su - postgres`` and ``psql``.
- Un mot de passe de connection pour cet utilisateur vous sera demandé. Il
- faudra utiliser ce login / mot de passe à la création d'instance via
- `cubicweb-ctl`
+ This password will be asked to you later on where you will create an
+ instance with `cubicweb-ctl create`
[XXX]
Est-ce que ces etapes sont vraiment necessaires?
sand : lors de l'installation de ma bdd cela n'a pas ete fait
et il semble que tout aille bien. Doit etre verifie avec les experts.
-* installation des extensions pour l'index plein texte ::
+* installation of plain-text index extension ::
- cat /usr/share/postgresql/8.1/contrib/tsearch2.sql | psql -U pgadmin template1
+ cat /usr/share/postgresql/8.3/contrib/tsearch2.sql | psql -U username template1
-* installation du langage plpythonu par défaut ::
+* installation of plpythonu language by default ::
createlang -U pgadmin plpythonu template1
-Configuration Pyro
+Pyro configuration
------------------
-Si vous utilisez Pyro, il est nécessaire d'avoir un serveur de noms Pyro
-tournant sur votre réseau (par défaut celui-ci est repéré par une requête
-broadcast). Pour cela il faut soit :
+
+If you use Pyro, it is required to have a name server Pyro runing on your
+network (by default it is identified by a broadcast request).
+
+To do so, you need to :
-* le lancer à la main avant le démarrage de erudi avec la commande `pyro-ns`
+* launch the server manually before starting cubicweb with `pyro-ns`
-* le lancer à la main avant le démarrage de erudi sous forme d'un serveur avec
- la commande `pyro-nsd start`
+* launch the server manually before starting cubicweb as a server with
+ `pyro-nsd start`
-* éditer le fichier */etc/default/pyro-nsd* pour que le serveur de nom pyro soit
- lancé automatiquement au démarrage de la machine
+* edit the file ``/etc/default/pyro-nsd`` so that the name server pyro
+ will be launched automatically when the macine fire up