mirror of
https://github.com/python/cpython.git
synced 2025-11-26 21:33:10 +00:00
General comments on what's here and how to try it out. Note
dependence on the XML package.
This commit is contained in:
parent
6d26f4b188
commit
86bc7b01b5
1 changed files with 23 additions and 0 deletions
23
Doc/tools/sgmlconv/README
Normal file
23
Doc/tools/sgmlconv/README
Normal file
|
|
@ -0,0 +1,23 @@
|
||||||
|
These scripts and Makefile fragment are used to convert the Python
|
||||||
|
documentation in LaTeX format to SGML. XML is also supported as a
|
||||||
|
target, but is unlikely to be used.
|
||||||
|
|
||||||
|
This material is highly preliminary and incomplete. The XML omnibus
|
||||||
|
package developed by the Python XML-SIG is required. See
|
||||||
|
http://www.python.org/sigs/xml-sig/ for more information on the
|
||||||
|
package.
|
||||||
|
|
||||||
|
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).
|
||||||
|
|
||||||
|
Please send comments and bug reports to python-docs@python.org.
|
||||||
Loading…
Add table
Add a link
Reference in a new issue