INSTALL

   1 Installing Objavi2 on a Debian machine.
   2
   3
   4 0. Fetch the tarball or clone the git repositiory with
   5
   6    git clone git://repo.or.cz/objavi2.git
   7
   8 (hint: this has probably already been done because that's how you
   9 found this file).
  10
  11
  12 1. Install dependencies.  Everything is apt-gettable in Debian Lenny except wkhtml2pdf,
  13    which is available in Squeeze (testing).
  14
  15 lxml
  16 pdfedit          (4.1+)
  17 xvfb             (unnecessary if you're just testing under another X server)
  18 fontconfig
  19 ttf-???          (you'll need some fonts)
  20 pdftk
  21 pdfedit
  22 poppler-utils or xpdf-utils
  23 httpd            (apache2 is easiest because a config file is included)
  24
  25 wkhtmltopdf     (download from http://code.google.com/p/wkhtmltopdf/ - you
  26                  can choose whether to compile or use the existing binary)
  27
  28 2. Make sure the following two files are executable (and no others):
  29
  30 ./objavi2.py
  31 ./font-list.cgi.pdf
  32
  33
  34 3. Make sure the following directories exist and are writable by
  35    www-data (or whoever is you webserver user):
  36
  37 books
  38 cache
  39 tmp
  40
  41 The file ./setup.sh shows a way of doing this.
  42
  43
  44 4. Configure your webserver.  For apache 2.2 you can use the following steps:
  45
  46   4.1 edit the file apache-config-objavi2 and replace each occurrence
  47       of '/home/douglas/objavi2' with the name of your objavi
  48       directory.  Adjust other parameters as you see fit.
  49
  50   4.2 Copy apache-config-objavi2 to /etc/apache2/sites-available/objavi2
  51
  52   4.3 sudo a2ensite objavi2
  53
  54
  55 5. Restart or reload the webserver.
  56