From: Scott M. <sm...@ar...> - 2008-12-02 20:15:52
|
David Goodger wrote: >In HTML terms, <p class="whatever"> triggers the "whatever" class of >the stylesheet you use. There is a LaTeX equivalent being worked on >(maybe complete?), and I don't know how it works (I don't do LaTeX). Okay, maybe there's a disconnect here. HTML is not an important output format for me, PDF is. So presumably I have to find a way to get reST to tell whatever generates the PDF -- LaTeX? -- to do its centering thing in the places where I want things centered. reST itself has no concept of centering. Is that correct? >The syntax and purpose of directives are described here: ><http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#directives>http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#directives > >The "class" directive is described here: ><http://docutils.sourceforge.net/docs/ref/rst/directives.html#class>http://docutils.sourceforge.net/docs/ref/rst/directives.html#class I've seen these documents. The problem is that they are not terribly meaningful to me at this point. Consider this definition of "class": >The "class" directive sets the "classes" attribute value on its content or on the first immediately following non-comment element To make sense of this, I need to know what a directive, an attribute, an attribute value, and an element are. The definition of a directive isn't too difficult to understand, but the notions of attribute, attribute value, and element are rather vague. It seems that docutils assumes that there is some processor that translates reST source, including display information in the form of classes (and maybe attributes and elements) embedded in the reST, into some viewable output, e.g., HTML or PDF (via LaTeX?). Presumably what I need is an overview of how the reST-to-XYZ translator passes display information to XYZ. For HTML, it sounds like the mechanism is CSS classes. It also sounds like there is already a reST-to-LaTeX translator, and I'd need to understand how that translator communicates display information to LaTeX. Is that correct? If so, can you tell me where I'd find a description of how this is done? Am I correct in assuming that there is no direct reST-to-PDF translator? If there is, where can I find out about it? Thanks, Scott |