[Python-Dev] Symbol page for Language Reference Manual Index (original) (raw)

engelbert.gruber at ssg.co.at engelbert.gruber at ssg.co.at
Thu Jun 8 14:52:07 CEST 2006

On Thu, 8 Jun 2006, A.M. Kuchling wrote:

On Thu, Jun 08, 2006 at 12🔞23AM -0400, Terry Reedy wrote:

I am willing to do perhaps half the work needed to produce such in time for the 2.5 release. In particular, I am willing to write a plain text file listing symbols (in ascii sort order) and section numbers, in an agreed-on format, if the idea is approved and someone else agrees to convert section numbers to page links and do the necessary latex/html formatting (with a Python script?).

There's a pool of volunteers for LaTeX formatting, so someone will certainly handle that step.

would rst2docpy be of any help (see http://docutils.sourceforge.net/sandbox/docpy-writer/)

although the text below doesnt sound like it could do it.

[I just realized that some links need to be within-page rather than to the_ _top of the page and that I can cut and paste additional info if I find the_ _appropriate regular index entry, such as_ _http://docs.python.org/ref/parenthesized.html#l2h-342 for 5.2.3. But I will work this sort of thing out with whoever formats.] It's probably easiest to make a list of symbols and the corresponding section names and optionally a snippet of the paragraph that should be the target of the link. Section numbers like 5.2.3 and link anchors like #l2h-342 are generated by LaTeX2HTML and not visible when you're editing the source text.

More information about the Python-Dev mailing list