From: Dave K. <dku...@cu...> - 2003-08-12 22:58:23
|
Here are a couple of "issues": 1. There are non-ASCII characters sequence at the beginning of section titles (or perhaps the section numbers?): =C2=A0=C2=A0=C2=A0 0xc2 0xa0 0xc2 0xa0 0xc2 0xa0=20 Why are they there? And, is a writer supposed to be doing something to clear them? The html4css1.py writer, by the way, passes these non-ASCII characters through to HTML. Does that seem right? It looks like these special characters are uni-code characters that are being added in method SectNum.update_section_numbers which is in module docutils/transforms/parts.py. They are non-breaking space characters I suppose. Could someone explain to me why they are inserted. =20 I'd like to know what my python_latex writer is supposed to do with them. 2. Internal references (or hyperlinks to targets inside the same document) to section titles don't seem to work in html4css1.py. Perhaps I'm using the wrong format for the cross-reference in my text file. Here is what I use: This Is A Section Title =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D =20 o o o =20 And here is a reference to `This Is A Section Title`_. =20 .. _`This Is A Section Title`: But, there seems to be a conflict with section IDs, or am I miss-using internal cross-references. Thanks for help. Dave --=20 Dave Kuhlman dku...@re... http://www.rexx.com/~dkuhlman |
From: Brett g P. <bgp...@ac...> - 2003-08-13 01:17:25
|
Dave Kuhlman wrote: > Here are a couple of "issues": > > > > 2. Internal references (or hyperlinks to targets inside the same > document) to section titles don't seem to work in html4css1.py. > Perhaps I'm using the wrong format for the cross-reference in > my text file. Here is what I use: > > > This Is A Section Title > ======================= > > o > o > o > > And here is a reference to `This Is A Section Title`_. > > .. _`This Is A Section Title`: > When you link to a section title, there's no need for you to create that explicit target. Just include text like `This is a section title`_ and let the docutils code do all of the magic for you. > But, there seems to be a conflict with section IDs, or am I > miss-using internal cross-references. > > Thanks for help. > > Dave > -- // Today's Oblique Strategy (© Brian Eno/Peter Schmidt): // Destroy -nothing -the most important thing // Brett g Porter * BgP...@ac... // http://mywebpages.comcast.net/bgporter/ |
From: David G. <go...@py...> - 2003-08-13 04:41:21
|
Dave Kuhlman wrote: > 1. There are non-ASCII characters sequence at the beginning of > section titles (or perhaps the section numbers?): > > Â Â Â > 0xc2 0xa0 0xc2 0xa0 0xc2 0xa0 That's 3 characters of UTF-8-encoded text. Try Latin-1 output encoding and it may be more intelligible (depending on how you view it). > Why are they there? ... > They are non-breaking space characters I suppose. Correct. They are used to separate the automatically generated section numbers from the section titles. > And, is a writer supposed to be doing something to clear them? No, the writer is supposed to be treating them as it would any other text. > The html4css1.py writer, by the way, passes these non-ASCII > characters through to HTML. Does that seem right? Correct and as intended. > I'd like to know what my python_latex writer is supposed to do > with them. Nothing at all. It should pass them through to the TeX-format output. Perhaps you've got an encoding issue. The default output encoding is UTF-8. What text encodings are appropriate for TeX files? If there is some limitation, the Writer should enforce it. > 2. Internal references (or hyperlinks to targets inside the same > document) to section titles don't seem to work in html4css1.py. > Perhaps I'm using the wrong format for the cross-reference in > my text file. Here is what I use: > > This Is A Section Title > ======================= > > o > o > o > > And here is a reference to `This Is A Section Title`_. > > .. _`This Is A Section Title`: Why is that explicit hyperlink target there? > But, there seems to be a conflict with section IDs, Yes, the unnecessary explicit target is creating a conflict. Try running that through Docutils with the -v/--verbose option, and you'll see why you're it's not working: ref:10: (INFO/1) Duplicate implicit target name: "this is a section title". Normally, INFO (level-1) system messages are not reported. In this case, the explicit target will override the implicit one (the section title itself). After the explicit target overrides the section title, the title cannot be referenced by name; references like "`This Is A Section Title`_" will link to the explicit target. > or am I miss-using internal cross-references. You're misusing internal cross-references: Each section title automatically generates a hyperlink target pointing to the section. The text of the hyperlink target (the "reference name") is the same as that of the section title. See `Implicit Hyperlink Targets`_ for a complete description. -- http://docutils.sf.net/spec/rst/reStructuredText.html#sections -- David Goodger http://starship.python.net/~goodger For hire: http://starship.python.net/~goodger/cv Docutils: http://docutils.sourceforge.net/ (includes reStructuredText: http://docutils.sf.net/rst.html) |
From: Dave K. <dku...@cu...> - 2003-08-13 21:09:45
|
On Wed, Aug 13, 2003 at 12:40:10AM -0400, David Goodger wrote: > Dave Kuhlman wrote: [snip] > That's 3 characters of UTF-8-encoded text. Try Latin-1 output > encoding and it may be more intelligible (depending on how you view > it). Ah, the old output-encoding trick. I knew that. Well, OK, I *did not* know that, but I do now. Thanks. Using latin-1 output-encoding removes those characters. I've also made latin-1 the default output-encoding in the python_latex writer. [snip] > > And here is a reference to `This Is A Section Title`_. > > > > .. _`This Is A Section Title`: > > Why is that explicit hyperlink target there? [snip] > You're misusing internal cross-references: > > Each section title automatically generates a hyperlink target > pointing to the section. The text of the hyperlink target (the > "reference name") is the same as that of the section title. See > `Implicit Hyperlink Targets`_ for a complete description. Now I see. I thought the "unnecessary explicit target" was creating a *link* to a target, not the target itself. I did not know that, nor did I know they were unnecessary. Now, I do. I removed them and all is well. Thanks again. Dave -- Dave Kuhlman dku...@re... http://www.rexx.com/~dkuhlman |