From: Beni C. <cb...@us...> - 2004-02-28 22:33:42
|
I've written a quite comprehensive and very flexible Makefile for driving docutils. I hope it will save others the work. It was availible for some time but I restructured it a little, mergeing its two parts into one file for easier deployment and improving the documentation. I consider it stable now. It's avaliable under: http://docutils.sourceforge.net/sandbox/cben/make/ `<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 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 (cb...@us...) if you miss any functionality or flexibility... -- Beni Cherniavsky <cb...@us...> Note: I can only read email on week-ends... ... that can be fixed at any time. Bugs are written to be squashed. ;-) -- Fred L. Drake, Jr. on python-dev |