diff -r 4ac19f288149 -r 3c9dfc6e820b doc/book/en/admin/setup-windows.rst --- a/doc/book/en/admin/setup-windows.rst Thu Jul 07 17:06:50 2011 +0200 +++ b/doc/book/en/admin/setup-windows.rst Thu Jul 07 18:20:23 2011 +0200 @@ -24,9 +24,9 @@ |cubicweb| requires some base elements that must be installed to run correctly. So, first of all, you must install them : -* python >= 2.5 and < 3 - (`Download Python `_). - You can also consider the Python(x,y) distribution +* python >= 2.5 and < 3 + (`Download Python `_). + You can also consider the Python(x,y) distribution (`Download Python(x,y) `_) as it makes things easier for Windows user by wrapping in a single installer python 2.5 plus numerous useful third-party modules and @@ -34,24 +34,24 @@ IDE for Python under Windows). * `Twisted `_ is an event-driven - networking engine + networking engine (`Download Twisted `_) * `lxml `_ library - (version >=2.2.1) allows working with XML and HTML + (version >=2.2.1) allows working with XML and HTML (`Download lxml `_) -* `Postgresql 8.4 `_, - an object-relational database system - (`Download Postgresql `_) - and its python drivers +* `Postgresql 8.4 `_, + an object-relational database system + (`Download Postgresql `_) + and its python drivers (`Download psycopg `_) -* A recent version of `gettext` +* A recent version of `gettext` (`Download gettext `_). -* `rql `_, - the recent version of the Relationship Query Language parser +* `rql `_, + the recent version of the Relationship Query Language parser (`Download rql `_). Install optional elements @@ -60,22 +60,22 @@ We recommend you to install the following elements. They are not mandatory but they activate very interesting features in |cubicweb|: -* `Simplejson `_ - must be installed if you have python <= 2.5 +* `Simplejson `_ + must be installed if you have python <= 2.5 (`Download simplejson `_). It is included in the Standard library from Python >= 2.6. -* `Pyro `_ +* `Pyro `_ enables remote access to cubicweb repository instances. It also allows the client and the server not running on the same machine (`Download Pyro `_). -* `python-ldap `_ +* `python-ldap `_ provides access to LDAP/Active directory directories (`Download python-ldap `_). -* `graphviz `_ - which allow schema drawings. +* `graphviz `_ + which allow schema drawings. (`Download graphviz `_). It is quite recommended (albeit not mandatory). @@ -88,18 +88,17 @@ Some additional tools could be useful to develop :ref:`cubes ` with the framework. -* `mercurial `_ and its standard - windows GUI (`TortoiseHG `_) - allow you to get the source code of |cubicweb| from control version - repositories. So you will be able to get the latest development - version in an easy way +* `mercurial `_ and its standard windows GUI + (`TortoiseHG `_) allow you to get the source + code of |cubicweb| from control version repositories. So you will be able to + get the latest development version and pre-release bugfixes in an easy way (`Download mercurial `_). * You can also consider the ssh client `Putty` in order to peruse mercurial over ssh (`Download `_). * If you are an Eclipse user, mercurial can be integrated using the - `MercurialEclipse` plugin + `MercurialEclipse` plugin (`Home page `_). Getting the sources @@ -108,8 +107,8 @@ There are tow ways to get the sources of |cubicweb| and its :ref:`cubes `: -* download the latest release (:ref:`SourceInstallation`) -* get the development version using Mercurial +* download the latest release (:ref:`SourceInstallation`) +* get the development version using Mercurial (:ref:`MercurialInstallation`) Environment variables @@ -123,8 +122,8 @@ it. That opens a small window allowing edition of user-related and system-wide variables. -We will consider only user variables. First, the ``PATH`` variable. Assuming -you are logged as user *Jane*, add the following paths, separated by +We will consider only user variables. First, the ``PATH`` variable. Assuming +you are logged as user *Jane*, add the following paths, separated by semi-colons:: C:\Documents and Settings\Jane\My Documents\Python\cubicweb\cubicweb\bin