mirror of https://github.com/python/cpython.git
82ebc27357
engine in latex2esis.py can do, so discard it. paragraph detection & markup: Handle some of the list-like environments properly, picking up paragraphs inside list items. (Only changed a few element-sets used for recognition.) fixup_refmodindexes_chunk(): Use the right attribute to determine the module a <ref*modindex/> element is referring to. convert(): Don't call remap_element_names(); it was removed. |
||
---|---|---|
.. | ||
Makefile | ||
README | ||
conversion.xml | ||
docfixer.py | ||
esis2sgml.py | ||
esistools.py | ||
fixgenents.sh | ||
latex2esis.py | ||
make.rules |
README
These scripts and Makefile fragment are used to convert the Python documentation in LaTeX format to SGML or XML. Though I originally thought that the XML was unlikely to be used, tool support for XML is increasing quickly enough that it may well be the final format. (It is the default output format when using the makefiles included here.) This material is preliminary and incomplete. The XML omnibus package developed by the Python XML-SIG is required; specifically, the version available in the public CVS repository. See http://www.python.org/sigs/xml-sig/ for more information on the package. To convert all documents to SGML: cd Doc/ make -f tools/sgmlconv/Makefile sgml To convert a document to SGML: cd Doc/<document-dir> make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools To generate XML instead, use: cd Doc/<document-dir> make -f ../tools/sgmlconv/make.rules TOOLSDIR=../tools xml Note that building the second target format is fast because both conversions use the same intermediate format (an ESIS event stream). This is true regardless of whether you build SGML or XML first. Please send comments and bug reports to python-docs@python.org.