Mercurial > piecrust2

comparison README.rst @ 160:de09d41bae23

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Moved all installation instructions to a new `INSTALL` file.
author Ludovic Chabant <ludovic@chabant.com>
date Thu, 01 Jan 2015 19:35:18 -0800
parents 742009d964ef
children 477dc9a63222
comparison
equal deleted inserted replaced
159:232989a6df36 160:de09d41bae23
34 34
35 35
36 Changes 36 Changes
37 ======= 37 =======
38 38
39 Check out the ``CHANGELOG`` file for new features, bug fixes and breaking changes. 39 Check out the ``CHANGELOG`` file for new features, bug fixes and breaking
40 changes. You can `see it online here <https://bitbucket.org/ludovicchabant/piecrust2/raw/default/CHANGELOG.rst>`__.
40 41
41 42
42 Installation 43 Installation
43 ============ 44 ============
44 45
45 From the package server 46 You can install PieCrust like any other package:
46 -----------------------
47
48 The simplest way to install PieCrust is to install it from PyPi_, the Python
49 package index:
50
51 ::
52
53 easy_install piecrust
54
55 or:
56 47
57 :: 48 ::
58 49
59 pip install piecrust 50 pip install piecrust
60 51
61 .. _Pypi: https://pypi.python.org/pypi 52 For more options to get PieCrust on your machine, see the ``INSTALL`` file. You
53 can `see it online here <https://bitbucket.org/ludovicchabant/piecrust2/raw/default/INSTALL.rst>`__.
62 54
63
64 From a tarball
65 --------------
66
67 You can also install PieCrust using a snapshot of the code. See the `download
68 page`_ where you can either get the `very latest`_, or any of the previous
69 official releases. Then you can point ``pip`` to the tarball (either one you
70 previously downloaded, or directly from BitBucket):
71
72 ::
73
74 pip install https://bitbucket.org/ludovicchabant/piecrust2/get/tip.tar.gz
75
76
77 .. _download page: https://bitbucket.org/ludovicchabant/piecrust2/downloads
78 .. _very latest: https://bitbucket.org/ludovicchabant/piecrust2/get/tip.tar.gz
79
80
81 Using a virtual environment
82 ---------------------------
83
84 This method is not as simple as the previous ones, but is probably the
85 recommended one. All the methods so far will install PieCrust globally on your
86 system, which is fine if you're installing it on your own computer, but may
87 cause problems later. For instance, PieCrust may have some dependencies in
88 common with some other Python programs you have installed, and things may break
89 when you update one of them. Alternatively, you may just want to install
90 PieCrust on a computer you don't fully control, like in a shared hosting
91 environment. Or maybe you just like things to be tidy.
92
93 For this you'll need ``virtualenv``. A virtual environment is simply a folder
94 on your computer that contains a portable, fully functional Python environment
95 -- one that would, in this case, contain a certain version of PieCrust, along
96 with all its dependencies, separate from your global Python installation.
97
98 On Mac/Linux:
99
100 ::
101
102 virtualenv venv
103 . venv/bin/activate
104 pip install piecrust
105
106 On Windows:
107
108 ::
109
110 virtualenv venv
111 venv\Scripts\activate
112 pip install piecrust
113
114
115 If the first command fails, chances are that you don't have ``virtualenv``
116 installed. You should be able to install it with:
117
118 ::
119
120 pip install virtualenv
121
122 Some Linux/UNIX-based systems have it in their package manager, so if that
123 doesn't work you can try:
124
125 ::
126
127 apt-get install virtualenv
128
129 If both fail, you may have to get it "by hand", by `downloading the code from
130 PyPi`_, extracting the archive, and running it from there. For instance, on
131 Linux/UNIX:
132
133 ::
134
135 wget http://pypi.python.org/packages/source/v/virtualenv/virtualenv-1.11.6.tar.gz
136 tar xzf virtualenv-1.11.6.tar.gz
137 python virtualenv-1.11.6/virtualenv.py venv
138
139 From there, you can continue with activating the virtual environment and
140 install PieCrust in it, as shown previously.
141
142
143 .. _downloading the code from PyPi: https://pypi.python.org/pypi/virtualenv#downloads
144