git.sesse.net Git - webpdf/blob - README

   1 Very preliminary documentation; sorry about that. :-)
   2
   3 You'll need:
   4
   5   - A web server (I use Apache 2, with mpm-itk[1] to separate the ugliness
   6     from the rest of the server installation).
   7   - ImageMagick (http://www.imagemagick.org/).
   8   - Perl (http://www.perl.org/), with the CGI module.
   9   - OpenOffice.org (http://www.openoffice.org/ -- doh), tested with v1.1
  10     only. See below for special configuration needed.
  11   - GhostScript, probably almost any halfway recent version; newer ones
  12     have better font support etc., though. (For some odd PostScript font
  13     stuff, you might even need the latest AFPL version from CVS, if you
  14     can live with its license.) http://www.ghostscript.com/ has it all.
  15   - vim (http://www.vim.org/).
  16
  17 [1]: http://home.samfundet.no/~sesse/mpm-itk/
  18
  19
  20 Configuration
  21
  22 mkdir output/
  23 $EDITOR config.pm
  24 $EDITOR index.html, so your site doesn't look like mine :-)
  25
  26
  27 Special OpenOffice.org configuration
  28
  29 First of all, you'll need an X server (since OO.o needs one to do even -help).
  30 Xvfb will do nicely:
  31
  32   nohup Xvfb :25 &
  33
  34 Then, you'll need to log in as the CGI user (yes, yuck :-) ), run
  35 OpenOffice.org for the first time, accept the license etc. Then you'll have
  36 to add a new printer -- use spadmin (in the same directory as soffice), add
  37 a new printer by the name of “pdf” (probably slightly misnamed, as it will
  38 output PostScript, but OK). It's going to be a “PDF converter”, using
  39
  40   /whatever/path/you/have/cat-into "(OUTPUT)"
  41
  42 as command line, and your output directory as appropriate. Also remember to
  43 set the page size if you don't happen to prefer Letter already.
  44
  45 Happy hacking :-)
  46
  47   -- Steinar H. Gunderson <sgunderson@bigfoot.com>, http://www.sesse.net/
  48      (and of course, http://pdf.sesse.net/)