Changes between Version 2 and Version 3 of InstallationGuide

Timestamp:

21/07/10 22:11:01 (3 years ago)

Author:

nicoechaniz

Comment:

added django-registration install step and known PIL problems/solutions

InstallationGuide

@@ -46 +46 @@
 }}}
 
+And install django-registration too
+{{{
+ # pip install -e hg+http://bitbucket.org/ubernostrum/django-registration#egg=django-registration
+}}}
+
 Then install Cyclope. All other python dependencies will be pulled in automatically
 {{{
   # pip install -e hg+http://bitbucket.org/nicoechaniz/django-cyclope#egg=cyclope
 }}}
-
-If the PIL installation stops  with an error saying: "expected ‘{’ at end of input",
-then you are missnig the python-dev (or your distro equivalent) package. Install it and repeat the previous step.
 
 You may get warnings during the dependencies installation, but they are not relevant to our purposes.
@@ -98 +100 @@
 
 ----
+
+== Frequent problems and workarounds ==
+
+=== PIL / image processing  ===
+
+If the PIL installation stops  with an error saying: "expected ‘{’ at end of input",
+then you are missnig the python-dev (or your distro equivalent) package. Install it and repeat the previous step.
+
+When installing PIL you should look at the first lines of the compilation output. It should read something like:
+
+{{{
+--- JPEG support available
+--- ZLIB (PNG/ZIP) support available
+--- FREETYPE2 support available
+}}}
+
+If support for jpeg, png or freetype are not available PIL will install all the same but Cyclope will fail to process images properly.
+
+If you are getting errors when displaying captchas or thumbnails this is probably your problem. You need to install the missing libraries for PIL to work properly.
+After installing the libraries (for jpeg, zlib and freetype2) you will need to uninstall PIL:
+{{{
+ # pip uninstall PIL 
+}}}
+
+And re-install again. Don't forget to check for the correct compilation output.
+
+{{{
+ # pip install PIL 
+}}}
+
+
+----
   If you find any problems following these instructions please [mailto:nicoechaniz@codigosur.org drop us an email] so we can make the proper fixes.