75 if you do not intend to develop the framework itself. |
75 if you do not intend to develop the framework itself. |
76 |
76 |
77 In both cases, make sure you have installed the dependencies (see appendixes for |
77 In both cases, make sure you have installed the dependencies (see appendixes for |
78 the list). |
78 the list). |
79 |
79 |
|
80 Windows installation |
|
81 ```````````````````` |
|
82 |
|
83 Base elements |
|
84 _____________ |
|
85 |
|
86 Setting up a windows development environment is not too complicated |
|
87 but requires a series of small steps. What is proposed there is only |
|
88 an example of what can be done. We assume everything goes into C:\ in |
|
89 this document. Adjusting the installation drive should be |
|
90 straightforward. |
|
91 |
|
92 You should start by downloading and installing the Python(x,y) |
|
93 distribution. It contains python 2.5 plus numerous useful third-party |
|
94 modules and applications:: |
|
95 |
|
96 http://www.pythonxy.com/download_fr.php |
|
97 |
|
98 At the time of this writting, one gets version 2.1.15. Among the many |
|
99 things provided, one finds Eclipse + pydev (an arguably good IDE for |
|
100 python under windows). |
|
101 |
|
102 Then you must grab Twisted. There is a windows installer directly |
|
103 available from this page:: |
|
104 |
|
105 http://twistedmatrix.com/trac/ |
|
106 |
|
107 A windows installer for lxml will be found there:: |
|
108 |
|
109 http://pypi.python.org/pypi/lxml/2.2.1 |
|
110 |
|
111 Check out the lxml-2.2.1-win32-py2.5.exe file. More recent bugfix |
|
112 releases should probably work, too. |
|
113 |
|
114 You should find postgresql 8.4 there:: |
|
115 |
|
116 http://www.enterprisedb.com/products/pgdownload.do#windows |
|
117 |
|
118 The python drivers for posgtresql are to be found there:: |
|
119 |
|
120 http://www.stickpeople.com/projects/python/win-psycopg/#Version2 |
|
121 |
|
122 Please be careful to select the right python (2.5) and postgres (8.4) |
|
123 versions. |
|
124 |
|
125 Having graphviz will allow schema drawings, which is quite recommended |
|
126 (albeit not mandatory). You should get an msi installer there:: |
|
127 |
|
128 http://www.graphviz.org/Download_windows.php |
|
129 |
|
130 Tools |
|
131 _____ |
|
132 |
|
133 Get mercurial + its standard windows GUI (TortoiseHG) there (the |
|
134 latest is the greatest):: |
|
135 |
|
136 http://bitbucket.org/tortoisehg/stable/wiki/download |
|
137 |
|
138 If you need to peruse mercurial over ssh, it can be helpful to get an |
|
139 ssh client like Putty:: |
|
140 |
|
141 http://www.putty.org/ |
|
142 |
|
143 Integration of mercurial and Eclipse is convenient enough that we want |
|
144 it. Instructions are set there, in the `Download & Install` section:: |
|
145 |
|
146 http://www.vectrace.com/mercurialeclipse/ |
|
147 |
|
148 Setting up the sources |
|
149 ______________________ |
|
150 |
|
151 You need to enable the mercurial forest extension. To do this, edit |
|
152 the file:: |
|
153 |
|
154 C:\Program Files\TortoiseHg\Mercurial.ini |
|
155 |
|
156 In the [extensions] section, add the following line:: |
|
157 |
|
158 forest=C:\Program Files\TortoiseHg\ext\forest\forest.py |
|
159 |
|
160 Now, you need to clone the cubicweb repository. We assume that you use |
|
161 Eclipse. From the IDE, choose File -> Import. In the box, select |
|
162 `Mercurial/Clone repository using MercurialEclipse`. |
|
163 |
|
164 In the import main panel you just have to: |
|
165 |
|
166 * fill the URL field with http://www.logilab.org/hg/forests/cubicwin32 |
|
167 |
|
168 * check the 'Repository is a forest' box. |
|
169 |
|
170 Then, click on 'Finish'. It might take some time to get it all. Note |
|
171 that the `cubicwin32` forest contains additional python packages such |
|
172 as yapps, vobject, simplejson and twisted-web2 which are not provided |
|
173 with Python(x,y). This is provided for convenience, as we do not |
|
174 ensure the up-to-dateness of these packages, especially with respect |
|
175 to security fixes. |
|
176 |
|
177 Environment variables |
|
178 _____________________ |
|
179 |
|
180 You will need some convenience environment variables once all is set |
|
181 up. These variables are settable through the GUI by getting at the |
|
182 'System properties' window (by righ-clicking on 'My Computer' -> |
|
183 properties). |
|
184 |
|
185 In the 'advanced' tab, there is an 'Environment variables' |
|
186 button. Click on it. That opens a small window allowing edition of |
|
187 user-related and system-wide variables. |
|
188 |
|
189 We will consider only user variables. First, the PATH variable. You |
|
190 should ensure it contains, separated by semi-colons, and assuming you |
|
191 are logged in as user Jane:: |
|
192 |
|
193 C:\Documents and Settings\Jane\My Documents\Python\cubicweb\cubicweb\bin |
|
194 C:\Program Files\Graphviz2.24\bin |
|
195 |
|
196 The PYTHONPATH variable should also contain:: |
|
197 |
|
198 C:\Documents and Settings\Jane\My Documents\Python\cubicweb\ |
|
199 |
|
200 From now, on a fresh `cmd` shell, you should be able to type:: |
|
201 |
|
202 cubicweb-ctl list |
|
203 |
|
204 ... and get a meaningful output. |
|
205 |
|
206 |
80 PostgreSQL installation |
207 PostgreSQL installation |
81 ``````````````````````` |
208 ``````````````````````` |
82 |
209 |
83 Please refer to the `PostgreSQL project online documentation`_. |
210 Please refer to the `PostgreSQL project online documentation`_. |
84 |
211 |