From: David A. <da...@bo...> - 2002-12-06 23:20:28
|
I'm just getting started with ReST, and finding it to be natural and a lot of fun to use. I did find one behavior that violated my expectations, using the html.py standalone processor. I was writing along and somewhere in the middle of my text I decided to turn a parenthesized section into a footnote: Here's the main sentence I was writing [#]_. .. [#] And here's the remark that used to parenthesized. Here's some more text in the article When I processed this into HTML, I was surprised to find that the footnote appeared exactly where I had placed it, instead of near the bottom of the page. In an output medium like HTML, with hyperlinks, I expect to jump around to see the footnote. Or if it's a "paged medium", like PDF, I expect to see the footnote at the bottom of the physical page or the end of the chapter, depending on some preference. However, the ReST text file has none of these properties, and I find it natural and convenient to locate the footnote very close to its reference. I also note that TeX works the way I expect, for what that's worth (I generally hate using TeX, but this is one thing I do like about it). -Dave -- David Abrahams da...@bo... * http://www.boost-consulting.com Boost support, enhancements, training, and commercial distribution |
From: David G. <go...@py...> - 2002-12-07 00:43:44
|
David Abrahams wrote: > I'm just getting started with ReST, and finding it to be natural > and a lot of fun to use. Glad to hear it! > I did find one behavior that violated my > expectations, using the html.py standalone processor. > > I was writing along and somewhere in the middle of my text I decided > to turn a parenthesized section into a footnote: ... > When I processed this into HTML, I was surprised to find that the > footnote appeared exactly where I had placed it, instead of near the > bottom of the page. Docutils doesn't guess where you want the footnotes to be. Look at PEPs, for example; footnotes are in a section called "References" or "References & Footnotes". The author might want to add a transition (horizontal rule in HTML) before the footnotes, or some other decoration. There are directives planned for gathering footnotes & citations at an author-specified point in the document, perhaps "footnotes" and "citations" to keep things simple. They haven't been implemented yet though. If you'd like to try, see http://docutils.sf.net/spec/howto/rst-directives.html for instructions. -- David Goodger <go...@py...> Open-source projects: - Python Docutils: http://docutils.sourceforge.net/ (includes reStructuredText: http://docutils.sf.net/rst.html) - The Go Tools Project: http://gotools.sourceforge.net/ |