Added README.
authorSteinar H. Gunderson <sesse@samfundet.no>
Sat, 6 Aug 2005 23:30:41 +0000 (23:30 +0000)
committerSteinar H. Gunderson <sesse@samfundet.no>
Sat, 6 Aug 2005 23:30:41 +0000 (23:30 +0000)
README [new file with mode: 0644]

diff --git a/README b/README
new file mode 100644 (file)
index 0000000..f8c1f93
--- /dev/null
+++ b/README
@@ -0,0 +1,48 @@
+Very preliminary documentation; sorry about that. :-)
+
+You'll need:
+
+  - A web server (I use Apache 2, with mpm-itk[1] to separate the ugliness
+    from the rest of the server installation).
+  - ImageMagick (http://www.imagemagick.org/).
+  - Perl (http://www.perl.org/), with the CGI module.
+  - OpenOffice.org (http://www.openoffice.org/ -- doh), tested with v1.1
+    only. See below for special configuration needed.
+  - GhostScript, probably almost any halfway recent version; newer ones
+    have better font support etc., though. (For some odd PostScript font
+    stuff, you might even need the latest AFPL version from CVS, if you
+    can live with its license.) http://www.ghostscript.com/ has it all.
+  - vim (http://www.vim.org/).
+
+[1]: http://home.samfundet.no/~sesse/mpm-itk/
+
+
+Configuration
+
+mkdir output/
+$EDITOR config.pm
+$EDITOR index.html, so your site doesn't look like mine :-)
+
+
+Special OpenOffice.org configuration
+
+First of all, you'll need an X server (since OO.o needs one to do even -help).
+Xvfb will do nicely:
+
+  nohup Xvfb :25 &
+
+Then, you'll need to log in as the CGI user (yes, yuck :-) ), run
+OpenOffice.org for the first time, accept the license etc. Then you'll have
+to add a new printer -- use spadmin (in the same directory as soffice), add
+a new printer by the name of “pdf” (probably slightly misnamed, as it will
+output PostScript, but OK). It's going to be a “PDF converter”, using
+
+  /whatever/path/you/have/cat-into "(OUTPUT)"
+
+as command line, and your output directory as appropriate. Also remember to
+set the page size if you don't happen to prefer Letter already.
+
+Happy hacking :-)
+
+  -- Steinar H. Gunderson <sgunderson@bigfoot.com>, http://www.sesse.net/
+     (and of course, http://pdf.sesse.net/)