Mailman 3 October 2007 - Doc-SIG

Re: [Doc-SIG] [Python-Dev] resurrected modindex
by skip＠pobox.com Oct. 27, 2007

Oct. 27, 2007

>>>>> "Guido" == Guido van Rossum <guido(a)python.org> writes: Guido> Cool! Is it just a matter of checking this in and it will work on Guido> the site? Alas, no. I wrote this awhile ago when the site was built w/ ht2html. My thing is a simple front-end using Myghty. As Georg indicated in his response he has some dynamic stuff in Sphinx which will do this and more. I suspect once he goes fully dynamic my little hack won't be necessary any longer, but I missed it, especially with the new layout where less of the index is visible without paging down. I got tired of my modindex URL doing the work necessary to process the index (and thus being a little slower than just going straight to the index itself) but not seeing the proper anchors in the file which allowed it to insert the table and rewrite URLs to allow counting clicks. Skip

1 0

resurrected modindex
by skip＠pobox.com Oct. 27, 2007

Oct. 27, 2007

A long time ago I wrote a redirector to note and display the most frequently requested modules from the library reference manual's global module index. When Georg Brandl did his massive rewrite of the Python manuals that broke. I finally took the time this evening to resurrect that function. The result is here: http://www.webfast.com/modindex/ I reset all the counters and seeded the cache with a few modules. Click around in the index a few times then reload the above page. You'll get the idea. Skip

1 0

rst2newlatex causes latex errors
by Hrvoje Nikšić Oct. 24, 2007

Oct. 24, 2007

After a system upgrade (Ubuntu feisty->gutsy), LaTeX has problems with files generated by rst2newlatex. For example: $ pdflatex a.tex This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6) [... a lot of verbose output elided ...] )) (/usr/share/texmf-texlive/tex/latex/base/ifthen.sty) (/usr/share/texmf-texlive/tex/latex/hyphenat/hyphenat.sty) ! LaTeX Error: File `picins.sty' not found. Type X to quit or <RETURN> to proceed, or enter new name. (Default extension: sty) Enter file name: The picins.sty file is not part of the regular tex/latex packages, but it does come with a huge "tetex-src" package. If I install tetex-src, I still get the query, but then I can at least enter the full file name at the prompt, which gets me the correct output. However, the tetex-src package claims that it shouldn't be necessary for the proper operation of LaTeX. None of this occurs with rst2latex. Is this rst2newlatex doing something wrong, or is my LaTeX installation malfunctioning? Has anyone else seen this? On a related note, what is the difference between rst2latex and rst2newlatex? I noticed that the latter supports UTF8 text (or simply defaults to UTF8 encoding) and provides nicer headlines, but it's not otherwise obvious if it's production quality or just a test -- I can't find any documentation on it.

1 0

Unindented blocks in reStructuredText
by Hrvoje Nikšić Oct. 22, 2007

Oct. 22, 2007

I'd like my rst documents to include snippets of Python that are pasteable into the interpreter. Something like: This text demonstrates creation of a class:: class Foo(object): pass Unfortunately, rst2html warns about "Literal block expected; none found" and doesn't create a literal block. If I indent the Python block by any amount of spaces, everything works -- but then I can no longer paste the example into Python. Of course, I can generate the HTML, and paste the code from the browser into Python, but that makes it much harder to debug Python examples while writing the documentation. Am I missing an option here? I find it surprising that a tool written in and for Python would make it hard to include valid Python code. To clarify my expectations, I'd expect something (approximately) like this to work: This text demonstrates creation of a class:: class Foo(object): pass .. (The ".." could mark the end of the block.)

6 7