From: Peter M. <pe...@mc...> - 2008-04-20 21:50:20
|
In a document, I declare a table of contents like this: .. contents:: :backlinks: none From a python script, I read this document into "raw_content" and call publish_parts() like this: from docutils import core parts = core.publish_parts(source=raw_content,writer_name='html') When I go to use the html output, stored in "parts['body']", backlinks exist. I thought I turned them off? Is there something else I need to do to disable the backlinks? Thanks for any help, Peter |
From: David G. <go...@py...> - 2008-04-20 22:15:11
Attachments:
signature.asc
|
[Peter McNabb - 2008-04-20 17:50] > In a document, I declare a table of contents like this: > > .. contents:: > :backlinks: none > > From a python script, I read this document into "raw_content" and > call publish_parts() like this: > > from docutils import core > parts = core.publish_parts(source=raw_content,writer_name='html') > > When I go to use the html output, stored in "parts['body']", backlinks > exist. I thought I turned them off? Is there something else I need to > do to disable the backlinks? It works for me: >>> source=""" ... .. contents:: :backlinks: none ... ... one ... === ... ... para ... ... two ... === ... ... para ... """ >>> from docutils import core >>> parts = core.publish_parts(source=source, writer_name='html') >>> print parts['body'] <div class="contents topic" id="contents"> <p class="topic-title first">Contents</p> <ul class="simple"> <li><a class="reference internal" href="#one" id="id1">one</a></li> <li><a class="reference internal" href="#two" id="id2">two</a></li> </ul> </div> <div class="section" id="one"> <h1>one</h1> <p>para</p> </div> <div class="section" id="two"> <h1>two</h1> <p>para</p> </div> No backlinks (links from the <h1>s back to the table of contents). What do you see, or expect? -- David Goodger <http://python.net/~goodger> |
From: Peter M. <pe...@mc...> - 2008-04-20 23:39:33
|
On Apr 20, 2008, at 4:14 PM, David Goodger wrote: > [Peter McNabb - 2008-04-20 17:50] >> When I go to use the html output, stored in "parts['body']", >> backlinks exist. I thought I turned them off? Is there something >> else I need to do to disable the backlinks? > > It works for me: > > <div class="contents topic" id="contents"> > <p class="topic-title first">Contents</p> > <ul class="simple"> > <li><a class="reference internal" href="#one" id="id1">one</a></li> > <li><a class="reference internal" href="#two" id="id2">two</a></li> > </ul> > </div> > <div class="section" id="one"> > <h1>one</h1> > <p>para</p> > </div> > <div class="section" id="two"> > <h1>two</h1> > <p>para</p> > </div> > > No backlinks (links from the <h1>s back to the table of contents). > What do you see, or expect? >>> source=""" ... .. contents:: :backlinks: none ... ... one ... === ... ... para ... ... two ... === ... ... para ... """ >>> from docutils import core >>> parts = core.publish_parts(source=source, writer_name='html') >>> print parts['body'] <div class="contents topic"> <p class="topic-title first"><a id="contents" name="contents">Contents</a></p> <ul class="simple"> <li><a class="reference" href="#one" id="id1" name="id1">one</a></li> <li><a class="reference" href="#two" id="id2" name="id2">two</a></li> </ul> </div> <div class="section"> <h1><a id="one" name="one">one</a></h1> <p>para</p> </div> <div class="section"> <h1><a id="two" name="two">two</a></h1> <p>para</p> </div> It looks like the difference is yours places the id within the div tag and mine makes an anchor tag. Even though it doesn't actually link back to the TOC, the <a> is interpreted (properly) by browsers as a link. I would expect to have output similar to yours. I'm using docutils-py25 0.4-7, installed with fink for OS X 10.5. Is there a global setting for docutils I should change to put the id in the div instead of an <a>? Thanks, peter |
From: David G. <go...@py...> - 2008-04-21 00:47:16
Attachments:
signature.asc
|
[Peter McNabb - 2008-04-20 19:39] > <h1><a id="two" name="two">two</a></h1> ... > It looks like the difference is yours places the id within the div tag > and mine makes an anchor tag. Even though it doesn't actually link > back to the TOC, the <a> is interpreted (properly) by browsers as a > link. Here <a> is a target, not a reference. I wouldn't expect it to be link-highlighted. I tried your output in both Firefox & Safari on OS X 10.5, and didn't see link highlighting in either. Are you seeing link highlighting in the titles? What happens when you click one? What URL show up in the status bar when you hover over it? What browser & OS are you using? Are you using a custom stylesheet? > I would expect to have output similar to yours. > > I'm using docutils-py25 0.4-7, installed with fink for OS X 10.5. Is > there a global setting for docutils I should change to put the id in > the div instead of an <a>? There's no setting. The output difference is due to different versions of Docutils. Try uninstalling the version from Fink, and install a current snapshot (<http://docutils.sourceforge.net/docutils-snapshot.tgz>, which redirects to <ftp://ftp.berlios.de/pub/docutils/docutils-snapshot.tgz>). -- David Goodger <http://python.net/~goodger> |
From: Peter M. <pe...@mc...> - 2008-04-21 03:43:03
|
On Apr 20, 2008, at 6:47 PM, David Goodger wrote: > [Peter McNabb - 2008-04-20 19:39] >> <h1><a id="two" name="two">two</a></h1> > ... >> It looks like the difference is yours places the id within the div >> tag and mine makes an anchor tag. Even though it doesn't actually >> link back to the TOC, the <a> is interpreted (properly) by >> browsers as a link. > > Here <a> is a target, not a reference. I wouldn't expect it to be > link-highlighted. I tried your output in both Firefox & Safari on > OS X 10.5, and didn't see link highlighting in either. > > Are you seeing link highlighting in the titles? What happens when > you click one? What URL show up in the status bar when you hover > over it? What browser & OS are you using? > > Are you using a custom stylesheet? It must be related to custom stylesheets. The "links" don't have hover or click events (checked with Firefox and Safari). I'll work with the css author to see what can be done. I bet a lot of people make the mistake of assuming all <a> tags are hrefs and styling with that in mind? >> The output difference is due to different versions of Docutils. >> Try uninstalling the version from Fink, and install a current >> snapshot (<http://docutils.sourceforge.net/docutils-snapshot.tgz>, >> which redirects to <ftp://ftp.berlios.de/pub/docutils/docutils-snapshot.tgz >> >). The snapshot looks like another option to check in to. Thanks for helping me figure out what was going on, David. I really appreciate it. -peter |