From: Evan B. <eva...@fa...> - 2010-04-27 21:07:50
|
Hi, I've been back through the mailing lists, FAQ, etc but I can't find if (a) this is possible and (b) how to accomplish it. Assuming the following rst file: ===== Title ===== Overview First ----- This is the first Sub ~~~ This is the sub Second ------ See the `Sub`_ section The link to the Sub section works fine, but is there any way for me to reference the assigned number? Ie. so I could write: See section X Where X will be transformed into 1.1 Thanks. -E -- Evan Borgstrom - FatBox Inc. http://fatbox.ca/ |
From: Guenter M. <mi...@us...> - 2010-04-28 08:19:15
|
On 2010-04-27, Evan Borgstrom wrote: > I've been back through the mailing lists, FAQ, etc but I can't find if > (a) this is possible and (b) how to accomplish it. ... > First > ----- > This is the first > Sub > ~~~ > This is the sub > Second > ------ > See the `Sub`_ section > The link to the Sub section works fine, but is there any way for me to > reference the assigned number? Ie. so I could write: > See section X > Where X will be transformed into 1.1 AFAIK, this is currently not possible with HTML. Maybe if we implement section numbering by CSS counters (but I don't know how to reference such a counter)... For LaTeX output, you can define a :ref: role. See the example below. Günter .. -*- rst-mode -*- .. sectnum:: How to label and reference a "formal" figure with RST ***************************************************** And now for something completely different. Handcrafted Figure numbering for HTML ===================================== .. _mcicon: .. figure:: mc.png Figure 1: Midnight Commander icon `Figure 1`_ shows an icon for the file manager `Midnight Commander`. The HTML output is OK, in the LaTeX->PDF output, the key ``Figure 1:`` is repeated. Label and Reference via LaTeX and custom roles =============================================== After defining two custom roles and their expansion in LaTeX, its possible to utilise LaTeX's reference mechanism. .. role:: ref .. role:: label .. raw:: latex \newcommand*{\docutilsroleref}{\ref} \newcommand*{\docutilsrolelabel}{\label} .. figure:: mc.png :width: 50 :label:`mc` Midnight Commander icon enlarged Figure :ref:`mc` shows the icon for the file manager `Midnight Commander` enlarged to a width of 50 Pixel. This also works for section numbers, e.g. this is section :ref:`label-and-reference-via-latex-and-custom-roles`. The LaTeX output is OK, the HTML output can be corrected with a custom style sheet: * Add the key ``Figure #:`` with ``:before`` pseudo class and automatic numbering. * Suppress the label with ``span.label{visibility: hidden;}`` * Replacing the reference with the correct number remains unsolved. .. List of figures .. _Figure 1: mcicon_ |
From: Ben F. <ben...@be...> - 2010-04-28 10:34:53
|
Guenter Milde <mi...@us...> writes: > On 2010-04-27, Evan Borgstrom wrote: > > The link to the Sub section works fine, but is there any way for me to > > reference the assigned number? Ie. so I could write: > > > See section X > > > Where X will be transformed into 1.1 > > AFAIK, this is currently not possible with HTML. To clarify, I think Guenter is referring to the fact that the section numbering isn't available at the time the HTML is being rendered. It isn't even available in the resulting HTML document. It's generated dynamically by the HTML client that reads the document. -- \ “Alternative explanations are always welcome in science, if | `\ they are better and explain more. Alternative explanations that | _o__) explain nothing are not welcome.” —Victor J. Stenger, 2001-11-05 | Ben Finney |
From: David G. <go...@py...> - 2010-04-28 12:26:53
|
On Wed, Apr 28, 2010 at 06:34, Ben Finney <ben...@be...> wrote: > Guenter Milde <mi...@us...> writes: > >> On 2010-04-27, Evan Borgstrom wrote: >> > The link to the Sub section works fine, but is there any way for me to >> > reference the assigned number? Ie. so I could write: >> >> > See section X >> >> > Where X will be transformed into 1.1 >> >> AFAIK, this is currently not possible with HTML. > > To clarify, I think Guenter is referring to the fact that the section > numbering isn't available at the time the HTML is being rendered. It > isn't even available in the resulting HTML document. It's generated > dynamically by the HTML client that reads the document. Incorrect (with the html4css1 writer). The numbering is generated by the writer itself, not by the client. The section numbers are not available for reference though. -- David Goodger <http://python.net/~goodger> |