summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/tex-refs/README
blob: 90313b718a6f0c7b812e94de225e0d88d0e68309 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
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   <mw@miwie.in-berlin.de>