README file for tex-refs ======================== $Id: README 146 2005-05-14 15:34:22Z mw $ This file contains very brief instructions on how to build the various output formats (in case you want to do this yourself for some reason or just want to see how we handle all the 'magic'). Where to find ------------- You'll find the latest version of 'tex-refs' at http://www.miwie.org/tex-refs/ Requirements ------------ - DocBook XML V4.3 Your Linux distribution should provide an up-to-date package for this. - DocBook XSL Stylesheets (V1.68.1 as of this writing) Your Linux distribution should provide a package for this. If you only find an older version, try it or get the tarball from »http://sourceforge.net/projects/docbook/«, install it at some place and adjust some pathnames in Makefile.cfg.in - XSLT processor At least »xsltproc« from libxslt/libxml2, and »Saxon« should work. - make Should already be installed on your system - db2latex (http://db2latex.sourceforge.net) If you want to generate PDF output you'll need this Usage ----- - Use the "catalog.xml" file as a hint how to setup your own XML catalog or edit the XSL files to use absolute pathnames. - Run 'make targets' This lists the most important targets of the Makefile - Run 'make' This will generate all currently supported output files - Read over 'Makefile' if you want to know more details Contact ------- Contact the authors if you have any suggestions, enhancements, corrections, etc. Your contribution is very welcome. -- Michael Wiedmann