| 1 | .. index:: pycha installation |
|---|
| 2 | .. _installation: |
|---|
| 3 | |
|---|
| 4 | ************ |
|---|
| 5 | Installation |
|---|
| 6 | ************ |
|---|
| 7 | |
|---|
| 8 | PyCha can be used on any system that supports `Python <http://www.python.org>`_ |
|---|
| 9 | and `Cairo <http://www.cairographics.org/>`_. |
|---|
| 10 | |
|---|
| 11 | .. index:: windows installation |
|---|
| 12 | .. _install-windows: |
|---|
| 13 | |
|---|
| 14 | Windows |
|---|
| 15 | ======= |
|---|
| 16 | |
|---|
| 17 | Pycha needs PyCairo to works since it uses the Cairo graphics library. |
|---|
| 18 | These are the recommended steps for installing PyCairo: |
|---|
| 19 | |
|---|
| 20 | 1. Grab the latest `PyCairo Windows installer |
|---|
| 21 | <http://ftp.gnome.org/pub/GNOME/binaries/win32/pycairo/>`_. You need to use |
|---|
| 22 | the one that matches your Python version so take the one ending in -py2.4.exe |
|---|
| 23 | for Python 2.4 or the one ending in -py2.5.exe for Python 2.5 |
|---|
| 24 | |
|---|
| 25 | 2. Install it in your Python environment (just follow the installation |
|---|
| 26 | program instructions) |
|---|
| 27 | |
|---|
| 28 | 3. Put the Cairo dlls inside the pycairo directory inside your site-packages |
|---|
| 29 | directory or anywhere in your path. You can find the dlls `here |
|---|
| 30 | <http://www.gimp.org/~tml/gimp/win32/downloads.html>`_. |
|---|
| 31 | Download the following packages: |
|---|
| 32 | |
|---|
| 33 | 1. cairo.zip (you just need libcairo-2.dll) |
|---|
| 34 | 2. libpng.zip (you just need libpng13.dll) |
|---|
| 35 | 3. zlib.zip (you just need zlib1.dll) |
|---|
| 36 | |
|---|
| 37 | Pycha is distributed as a Python Egg so it is easy to install. You just need to |
|---|
| 38 | type the following command: |
|---|
| 39 | |
|---|
| 40 | ``easy_install pycha`` |
|---|
| 41 | |
|---|
| 42 | .. index:: linux installation |
|---|
| 43 | .. _install-linux: |
|---|
| 44 | |
|---|
| 45 | Linux |
|---|
| 46 | ===== |
|---|
| 47 | |
|---|
| 48 | There are three ways to install PyCha in Linux: |
|---|
| 49 | |
|---|
| 50 | |
|---|
| 51 | **Option A** (*good for new users*): |
|---|
| 52 | |
|---|
| 53 | Use your distribution package system. |
|---|
| 54 | |
|---|
| 55 | Ubuntu example: |
|---|
| 56 | |
|---|
| 57 | ``sudo apt-get install python-pycha`` |
|---|
| 58 | |
|---|
| 59 | Benefits: |
|---|
| 60 | |
|---|
| 61 | - better integration with your distribution |
|---|
| 62 | |
|---|
| 63 | - it can be uninstalled easily |
|---|
| 64 | |
|---|
| 65 | **Option B** (*good for python veterans*): |
|---|
| 66 | |
|---|
| 67 | Use easy_install to get the latest official version. You need to |
|---|
| 68 | install the setuptools package to use easy_install. |
|---|
| 69 | |
|---|
| 70 | Ubuntu example: |
|---|
| 71 | |
|---|
| 72 | ``apt-get install python-setuptools`` |
|---|
| 73 | |
|---|
| 74 | ``easy_install pycha`` |
|---|
| 75 | |
|---|
| 76 | Fedora example: |
|---|
| 77 | |
|---|
| 78 | ``yum install python-setuptools`` |
|---|
| 79 | |
|---|
| 80 | ``easy_install pycha`` |
|---|
| 81 | |
|---|
| 82 | Benefits: |
|---|
| 83 | |
|---|
| 84 | - you always get the latest stable version of PyCha |
|---|
| 85 | |
|---|
| 86 | **Option C** (*good for PyCha developers*): |
|---|
| 87 | |
|---|
| 88 | Get a checkout of the subversion trunk branch: |
|---|
| 89 | |
|---|
| 90 | ``svn co http://www.lorenzogil.com/svn/pycha/trunk pycha`` |
|---|
| 91 | |
|---|
| 92 | Benefits: |
|---|
| 93 | |
|---|
| 94 | - this is the bleeding edge version of PyCha |
|---|
| 95 | |
|---|
