author | Alain Leufroy <alain.leufroy@logilab.fr> |
Wed, 06 Apr 2011 12:33:39 +0200 | |
branch | stable |
changeset 7226 | e88c57c10b34 |
parent 7099 | ee9f1e1890e0 |
child 7230 | edd2a575a8e7 |
permissions | -rw-r--r-- |
93
9c919a47e140
[doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff
changeset
|
1 |
.. -*- coding: utf-8 -*- |
9c919a47e140
[doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff
changeset
|
2 |
|
1224
a9da8a8f0b19
[doc] Change id to english.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
221
diff
changeset
|
3 |
.. _SetUpEnv: |
93
9c919a47e140
[doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff
changeset
|
4 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
5 |
Installation of a *CubicWeb* environment |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
6 |
======================================== |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
7 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
8 |
There are different simple ways to install |cubicweb| and its |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
9 |
dependencies depending on your requirements: |
93
9c919a47e140
[doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff
changeset
|
10 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
11 |
* `Distribution-specific installation`. This option shows you how to |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
12 |
easily install |cubicweb| and its requirements on your system: |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
13 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
14 |
- `Installation on Debian/Ubuntu`_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
15 |
- `Installation on Windows`_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
16 |
- `Install in a virtualenv`_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
17 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
18 |
* `Official release installation`. This options is the best approach |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
19 |
for those who want a flexible and up-to-date stable |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
20 |
version. |cubicweb| is published on `PyPI`_: |
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
21 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
22 |
- `Installation with pip`_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
23 |
- `Installation with easy_install`_ |
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
24 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
25 |
* `Lastest development version installation`. This option is |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
26 |
dedicated for power-users who want the very lastest |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
27 |
features (|cubicweb| is an `Agile software <http://en.wikipedia.org/wiki/Agile_software_development>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
28 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
29 |
- `Installation from tarball`_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
30 |
- `Installation from version control`_ |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
31 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
32 |
Once installed, you can have a look to :ref:`ConfigEnv` for better control |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
33 |
and advanced features of |cubicweb|. |
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
34 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
35 |
.. _`Installation on Debian/Ubuntu`: DebianInstallation_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
36 |
.. _`Installation on Windows`: WindowsInstallation_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
37 |
.. _`Install in a virtualenv`: VirtualenvInstallation_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
38 |
.. _`Installation with pip`: PipInstallation_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
39 |
.. _`Installation with easy_install`: EasyInstallInstallation_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
40 |
.. _`Installation from tarball`: TarballInstallation_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
41 |
.. _`Installation from version control`: MercurialInstallation_ |
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
42 |
|
5135
f15286235aef
[doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4747
diff
changeset
|
43 |
|
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
44 |
.. _DebianInstallation: |
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
45 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
46 |
Debian/Ubuntu install |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
47 |
--------------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
48 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
49 |
|cubicweb| is packaged for Debian/Ubuntu (and derived |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
50 |
distributions). Their integrated package-management systems make |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
51 |
installation and upgrading much easier for users since |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
52 |
dependencies/recommends (like databases) are automatically installed. |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
53 |
|
5135
f15286235aef
[doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4747
diff
changeset
|
54 |
Depending on the distribution you are using, add the appropriate line to your |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
55 |
`list of sources` (for example by editing ``/etc/apt/sources.list``). |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
56 |
|
7099
ee9f1e1890e0
[doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6880
diff
changeset
|
57 |
For Debian Squeeze (stable):: |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
58 |
|
7099
ee9f1e1890e0
[doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6880
diff
changeset
|
59 |
deb http://download.logilab.org/production/ squeeze/ |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
60 |
|
7099
ee9f1e1890e0
[doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6880
diff
changeset
|
61 |
For Debian Sid (unstable):: |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
62 |
|
7099
ee9f1e1890e0
[doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6880
diff
changeset
|
63 |
deb http://download.logilab.org/production/ sid/ |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
64 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
65 |
For Ubuntu Lucid (Long Term Support) and newer:: |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
66 |
|
7099
ee9f1e1890e0
[doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6880
diff
changeset
|
67 |
deb http://download.logilab.org/production/ lucid/ |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
68 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
69 |
Note that for Ubuntu Maverick and newer, you shall use the `lucid` |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
70 |
repository and install the ``libgecode19`` package from `lucid |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
71 |
universe <http://packages.ubuntu.com/lucid/libgecode19>`_. |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
72 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
73 |
The repositories are signed with the `Logilab's gnupg key`_. You can download |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
74 |
and register the key to avoid warnings:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
75 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
76 |
wget -q http://download.logilab.org/logilab-dists-key.asc -O- | sudo apt-key add - |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
77 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
78 |
Update your list of packages and perform the installation:: |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
79 |
|
2172
cf8f9180e63e
delete-trailing-whitespace
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
1714
diff
changeset
|
80 |
apt-get update |
6719
3d2b6e6af721
[doc] minor fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6718
diff
changeset
|
81 |
apt-get install cubicweb cubicweb-dev |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
82 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
83 |
``cubicweb`` installs the framework itself, allowing you to create new |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
84 |
instances. ``cubicweb-dev`` installs the development environment |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
85 |
allowing you to develop new cubes. |
5135
f15286235aef
[doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4747
diff
changeset
|
86 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
87 |
There is also a wide variety of :ref:`cubes <AvailableCubes>`. You can acces a |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
88 |
list of availble cubes using ``apt-cache search cubicweb`` or at the |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
89 |
`CubicWeb.org Forge`_. |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
90 |
|
6716
494d4465f032
[doc/book] Add a note about <database>-support virtual package.
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6310
diff
changeset
|
91 |
.. note:: |
494d4465f032
[doc/book] Add a note about <database>-support virtual package.
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6310
diff
changeset
|
92 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
93 |
`cubicweb-dev` will install basic sqlite support. You can easily setup |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
94 |
:ref:`cubicweb with other database <DatabaseInstallation>` using the following virtual packages : |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
95 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
96 |
* `cubicweb-postgresql-support` contains necessary dependency for |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
97 |
using :ref:`cubicweb with postgresql datatabase <PostgresqlConfiguration>` |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
98 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
99 |
* `cubicweb-mysql-support` contains necessary dependency for using |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
100 |
:ref:`cubicweb with mysql database <MySqlConfiguration>`. |
2239
0f12f1ebf27c
add note about logilab key file / apt-get
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2175
diff
changeset
|
101 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
102 |
.. _`list of sources`: http://wiki.debian.org/SourcesList |
7099
ee9f1e1890e0
[doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6880
diff
changeset
|
103 |
.. _`Logilab's gnupg key`: http://download.logilab.org/logilab-dists-key.asc |
5135
f15286235aef
[doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4747
diff
changeset
|
104 |
.. _`CubicWeb.org Forge`: http://www.cubicweb.org/project/ |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
105 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
106 |
.. _WindowsInstallation: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
107 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
108 |
Windows Install |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
109 |
--------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
110 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
111 |
You need to have `python`_ version >= 2.5 and < 3 installed. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
112 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
113 |
Then your best option is probably the :ref:`EasyInstallInstallation`. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
114 |
In fact it is a pure python packages manager which lacks in Windows. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
115 |
It helps users to install python packages along with dependencies, |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
116 |
searching for suitable pre-compiled binaries on the |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
117 |
`The Python Package Index`_. |
5135
f15286235aef
[doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4747
diff
changeset
|
118 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
119 |
Moreover, if you want better control over the process as well as |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
120 |
a suitable development environment or if you are having problems with |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
121 |
`easy_install`, move right away to :ref:`SetUpWindowsEnv`. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
122 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
123 |
.. _python: http://www.python.org/ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
124 |
.. _`The Python Package Index`: http://pypi.python.org |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
125 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
126 |
.. _VirtualenvInstallation: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
127 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
128 |
`Virtualenv` install |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
129 |
-------------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
130 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
131 |
Since version 3.9, |cubicweb| can be safely installed, used and contained inside |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
132 |
a `virtualenv`_. You can use either |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
133 |
:ref:`pip <PipInstallation>` or |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
134 |
:ref:`easy_install <EasyInstallInstallation>` to install |cubicweb| inside an |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
135 |
activated virtual environment. |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
136 |
|
6192
80388edf4e88
[doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
5314
diff
changeset
|
137 |
.. _PipInstallation: |
80388edf4e88
[doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
5314
diff
changeset
|
138 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
139 |
`pip` install |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
140 |
------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
141 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
142 |
Using pip_ is the recommended way to install |cubicweb|. pip_ is a |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
143 |
smart python utility that lets you automatically download, build, |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
144 |
install, and manage python packages and their dependencies. It is full |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
145 |
compatible with `virtualenv`_. |
6192
80388edf4e88
[doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
5314
diff
changeset
|
146 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
147 |
pip_ install the packages from sources published on the |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
148 |
*The Python Package Index* (PyPI_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
149 |
You need a compilation environment because some dependencies have C |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
150 |
extensions. If you definitively wont, installing |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
151 |
`Lxml <http://codespeak.net/lxml/>`_, |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
152 |
`Twisted <http://twistedmatrix.com/trac/>`_ and |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
153 |
`libgecode <http://www.gecode.org/>`_ will help. |
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
154 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
155 |
To install |cubicweb| and all dependencies just use the following command |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
156 |
line:: |
6192
80388edf4e88
[doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
5314
diff
changeset
|
157 |
|
80388edf4e88
[doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
5314
diff
changeset
|
158 |
pip install cubicweb |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
159 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
160 |
There is also a wide variety of :ref:`cubes <AvailableCubes>`. You can acces a |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
161 |
list of availble cubes on |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
162 |
`PyPI <http://pypi.python.org/pypi?%3Aaction=search&term=cubicweb&submit=search>`_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
163 |
or at the `CubicWeb.org Forge`_. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
164 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
165 |
For example, installing the *blog cube* is achieved by:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
166 |
|
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
167 |
pip install cubicweb-blog |
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
168 |
|
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
169 |
.. _`gecode library`: http://www.gecode.org/ |
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
170 |
|
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
171 |
|
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
172 |
.. _EasyInstallInstallation: |
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
173 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
174 |
`easy_install` install |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
175 |
---------------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
176 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
177 |
If you are not a Windows user and you have a compilation environment, |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
178 |
we recommend you to use the PipInstallation_. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
179 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
180 |
Install |cubicweb| version >= 3.9 with:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
181 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
182 |
easy_install cubicweb |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
183 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
184 |
There is also a wide variety of :ref:`cubes <AvailableCubes>`. You can acces a |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
185 |
list of availble cubes on `PyPI |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
186 |
<http://pypi.python.org/pypi?%3Aaction=search&term=cubicweb&submit=search>`_ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
187 |
or at the `CubicWeb.org Forge`_. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
188 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
189 |
For example, installing the *blog cube* is achieved by:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
190 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
191 |
easy_install cubicweb-blog |
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
192 |
|
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
193 |
.. note:: |
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
194 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
195 |
If you encounter problem with :ref:`cubes <AvailableCubes>` installation, |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
196 |
considere using :ref:`PipInstallation` which is more stable |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
197 |
but do not offer binaries installation. |
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
198 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
199 |
.. _`easy_install`: http://packages.python.org/distribute/easy_install.html |
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
200 |
|
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
201 |
|
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
202 |
.. _SourceInstallation: |
6310
554da7585fba
[doc/book] more notes on setup
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6305
diff
changeset
|
203 |
|
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
204 |
Install from source |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
205 |
------------------- |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
206 |
|
6718
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
207 |
.. _TarballInstallation: |
b741578ce7c9
[doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents:
6717
diff
changeset
|
208 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
209 |
You can download the archive containing the sources from our download site at |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
210 |
`http://download.logilab.org/pub/cubicweb/ <http://download.logilab.org/pub/cubicweb/>`_. |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
211 |
|
6212
73565b770559
[doc] fix link to appendix
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6192
diff
changeset
|
212 |
Make sure you also have all the :ref:`InstallDependencies`. |
5135
f15286235aef
[doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4747
diff
changeset
|
213 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
214 |
Once uncompressed, you can install the framework from inside the uncompressed |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
215 |
folder with:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
216 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
217 |
python setup.py install |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
218 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
219 |
Or you can run |cubicweb| directly from the source directory by |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
220 |
setting the :ref:`resource mode <RessourcesConfiguration>` to `user`. This will |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
221 |
ease the development with the framework. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
222 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
223 |
There is also a wide variety of :ref:`cubes <AvailableCubes>`. You can acces a |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
224 |
list of availble cubes at the `CubicWeb.org Forge`_. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
225 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
226 |
|
6192
80388edf4e88
[doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
5314
diff
changeset
|
227 |
.. _MercurialInstallation: |
5135
f15286235aef
[doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4747
diff
changeset
|
228 |
|
3488
ab9e7bcfc764
[doc] add missing dependencies in annexes. explain more precisely source install.
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
3138
diff
changeset
|
229 |
Install from version control system |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
230 |
----------------------------------- |
3488
ab9e7bcfc764
[doc] add missing dependencies in annexes. explain more precisely source install.
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
3138
diff
changeset
|
231 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
232 |
To install the lastest stable development version from our Mercurial |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
233 |
repository, you can use `pip` (you need a compilation devlopment to perform |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
234 |
such install):: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
235 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
236 |
pip install -e "hg+http://www.logilab.org/hg/cubicweb/@stable#egg=cubicweb" |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
237 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
238 |
Or, to develop with the framework you can keep up to date with on-going |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
239 |
development by cloning our :ref:`Mercurial <MercurialPresentation>` |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
240 |
repository:: |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
241 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
242 |
hg clone -u stable http://hg.logilab.org/cubicweb # stable branch |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
243 |
hg clone http://hg.logilab.org/cubicweb # very lastest (development branch) |
3488
ab9e7bcfc764
[doc] add missing dependencies in annexes. explain more precisely source install.
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
3138
diff
changeset
|
244 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
245 |
Then a practical way to get many of CubicWeb's dependencies and a nice set |
6304
228921b064c3
[doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6300
diff
changeset
|
246 |
of base cubes is to run the `clone_deps.py` script located in |
228921b064c3
[doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6300
diff
changeset
|
247 |
`cubicweb/bin/`:: |
228921b064c3
[doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6300
diff
changeset
|
248 |
|
228921b064c3
[doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6300
diff
changeset
|
249 |
python cubicweb/bin/clone_deps.py |
228921b064c3
[doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6300
diff
changeset
|
250 |
|
228921b064c3
[doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6300
diff
changeset
|
251 |
(Windows users should replace slashes with antislashes). |
228921b064c3
[doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6300
diff
changeset
|
252 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
253 |
This script will clone a set of mercurial repositories into the |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
254 |
directory containing the ``cubicweb`` repository, and update them to the |
6304
228921b064c3
[doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6300
diff
changeset
|
255 |
latest published version tag (if any). |
228921b064c3
[doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6300
diff
changeset
|
256 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
257 |
.. note:: |
1460
6520efef1824
[doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1444
diff
changeset
|
258 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
259 |
In every cloned repositories, a `hg tags` will display a list of |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
260 |
tags in reverse chronological order. One reasonnable option is to go to a |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
261 |
taged version: the latest published version or example, as done by |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
262 |
the `clone_deps` script):: |
6310
554da7585fba
[doc/book] more notes on setup
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6305
diff
changeset
|
263 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
264 |
hg update cubicweb-debian-version-3.10.7-1 |
6310
554da7585fba
[doc/book] more notes on setup
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
6305
diff
changeset
|
265 |
|
6212
73565b770559
[doc] fix link to appendix
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6192
diff
changeset
|
266 |
Make sure you also have all the :ref:`InstallDependencies`. |
2393
6190852af97f
[doc] add list of dependencies in appendix
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2239
diff
changeset
|
267 |
|
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
268 |
.. _`pip`: http://pip.openplans.org/ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
7099
diff
changeset
|
269 |
.. _`virtualenv`: http://virtualenv.openplans.org/ |