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
  13    except wkhtml2pdf, which is available in Squeeze (testing), and
  14    openoffice 3, which is in Squeeze and in lenny-backports.
  15
  16 lxml
  17 pdfedit          (4.1+)
  18 xvfb             (unnecessary if you're just testing under another X server)
  19 fontconfig
  20 ttf-???          (you'll need some fonts)
  21 pdftk
  22 psutils
  23 pdfedit
  24 poppler-utils or xpdf-utils
  25 httpd            (apache2 is easiest because a config file is included)
  26
  27 wkhtmltopdf     (download from http://code.google.com/p/wkhtmltopdf/ - you
  28                  can choose whether to compile or use the existing binary)
  29
  30 To make ODF documents, you need a whole lot of openoffice 3.  The
  31 following packages and their dependencies might be sufficient, though
  32 you might also need to install a java runtime.
  33
  34 openoffice.org-common     (1:3 +)
  35 openoffice.org-core
  36 openoffice.org-filter-binfilter
  37 openoffice.org-gcj        (not certain about this)
  38 openoffice.org-writer
  39 python-uno
  40
  41
  42 2. Make sure the following three files are executable (and no others):
  43
  44 htdocs/*.cgi
  45 htdocs/font-list.cgi.pdf
  46 bin/html2odt
  47
  48
  49 3. Make sure the following directories exist and are writable by
  50    www-data (or whoever is your webserver user):
  51
  52 books
  53 cache
  54 tmp
  55
  56 The file ./setup.sh shows a way of doing this.
  57
  58
  59 4. Configure your webserver.  For apache 2.2 you can use the following steps:
  60
  61   4.1 edit the file apache-config-objavi2 and replace each occurrence
  62       of '/home/douglas/objavi2' with the name of your objavi
  63       directory.  Adjust other parameters as you see fit.
  64
  65   4.2 Copy apache-config-objavi2 to /etc/apache2/sites-available/objavi2
  66
  67   4.3 sudo a2ensite objavi2
  68
  69   4.4 Turn off http compression (mod_deflate, etc) for objavi.py -- it
  70       breaks the progress reporting.  (Apologies for this).
  71
  72 5. Restart or reload the webserver.
  73