Hi Stas,
I'm confused about the way docset is generating links.
I see this now:
(for example: docs/1.0/guide/Changes.html#04_17_1999_ver_1_09)
<div class="index-section"> <!-- SwishCommand index --> <h1><a name="Description"></a> <a href="#toc_Description">Description</a></h1>
Where it used to be:
<div class="index-section"> <!-- SwishCommand index --> <h1><a name="Description">Description</a></h1>
The second is a lot easier to parse, of course, with:
$section->look_down( '_tag', 'a', sub { defined($_[0]->attr('name')) } );
because I can grab the link for building the URL fragment from the name attribute, and grab the text to use for the title from the content of that *same* tag.
Nothing has changed in that respect. The <a name="Description"></a> is just as before, no? You want the 'name' attribute for linking. And it didn't change.
There's a [^ Top] widget in every section, so I don't see the need for the titles to be links. I think that's over-linking, frankly. (And it breaks my parsing ;)
I don't think it's that intutitive that if you click on a title you get back to the TOC. Normally people go from the TOC to the content, not the other way around.
This is an experimental new feature. It's not final. Give it a try you may find it useful. And it's not over-linking, because it's doesn't change anything at all on the visual front. Those who discover this feature, may find it very useful. I'm already starting to like it.
I can look for an <h1> tag, then look for the name attribute then look for the next <a> tag. That coding isn't a problem, I'd think. But I really don't see the need for that level of back linking. Sorry if I missed the discussion on that.
Yes, we had a long discussion, see the archives.
__________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
