Index of /sandbox/cben/make

[ICO]NameLast modifiedSizeDescription

[PARENTDIR]Parent Directory   -  
[   ]Makefile 2018-06-17 08:52 246  
[   ]Makefile.docutils 2018-06-17 08:52 18K 
[TXT]Makefile.docutils.html 2021-07-07 11:49 43K 
[TXT]Makefile.docutils.txt 2018-06-17 08:52 18K 
[TXT]make2rst.py 2018-06-17 08:52 1.5K 

README.txt

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 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...