blob: 6447967cb047f7e7890978ac54ac49279f7d68a5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
`<Makefile.docutils>`_ is a makefile that handles most things one would want
to do with docutils. For minimal applications it can be used directly;
typically you would include it in your makefiles, e.g.::
DOCS = foo.txt bar.txt
include Makefile.docutils
For quick jobs ``make DOCS=foo.txt\ bar.txt`` or just ``make`` (taking all
``*.txt`` files) will also work.
This makefile is very flexible and can be configured by setting many
variables. It also supports pre/postprocessing, currently with
`sandbox/cben/rolehack <../rolehack>`_ scripts and rudimentary
output-format-dependant adaptation of ``.*`` names with sed scripts.
The makefile is heavily commented and the comments themeselves are in reST
(sort of literate programming). A script (`<make2rst.py>`_) is provided that
can convert the whole file to legal reST - run ``make`` in this directory to
build the docs (``make ps pdf`` would give you more formats).
Enjoy and tell me (cben@users.sf.net) if you miss any functionality or
flexibility...
|
