Zine 0.1 Installation Instructions

For a working Zine instance you need to have the following libraries installed:

Python 2.4 or higher
Werkzeug*
Jinja2*
A database (MySQL, SQLite or PostgreSQL and others are supported)
SQLAlchemy 0.5
simplejson* [included in Python 2.6 and higher]
html5lib*
pytz*
Babel*
lxml* [2.0 or higher]

Libraries marked with * are installable from the cheeseshop via easy_install / pip or might be available in Debian already.

If you might use easy_install:

$ easy_install Werkzeug Jinja2 MySQL-python SQLAlchemy simplejson pytz Babel lxml html5lib

To install lxml you may need the development packages of libxml2 and libxslt

Installation

Currently the installation of Zine is only possible on (mostly) posix systems like OS X, Solaris, BSD or Linux. Development of Zine works on other operating systems as well and future release may provide a deployment plan for Windows as well.

To install Zine on your system you have to configure and "make install" it:

$ ./configure --prefix=/usr && make install

Zine installs itself into /usr/lib/zine and /usr/share/zine. Please note that this does not install the dependencies.

Note to package maintainers: for staged installs use DESTDIR variable

The following example shows how to set up Zine for mod_wsgi.

Create a new folder /var/zine/yourblog where yourblog is a name that make sense for you.
Copy the zine.wsgi file from /usr/share/zine/servers into the newly created folder and open it with an editor.
Modify the INSTANCE_FOLDER variable to point to the yourblog folder.
Open your Apache vhost config or your Apache config, whatever you use and add the following lines:
```
WSGIScriptAlias /yourblog /var/lib/zine/yourblog/zine.wsgi
```
This tells Apache that it should hook your blog into the webserver at /yourblog. You can also move it to a different vhost and mount it in the root or ask Apache to spawn as different user. More details about that are available in the mod_wsgi documentation.
Make sure the user your Apache (or application if you configured a different user for mod_wsgi) has read and write access to the yourblog folder.
Reload your apache and go to the URL of your blog and follow the installation instructions.

Development Quickstart

For a quickstart with the development server do this:

$ mkdir instance
$ ./scripts/server -I instance

After the first start you will find yourself in an installation wizard that helps you to create the database tables and an administrator account.

To get access to a python console with the zine instance context do this:

$ ./scripts/shell

Note that if your instance folder is not named "instance" or is not stored in this directory or if you are not below the instance folder you have to provide the path to it as argument to the scripts using the "-I" parameter.