Bug 711348 - Linking to a bridgehead does not work in html formats
Summary: Linking to a bridgehead does not work in html formats
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Publican
Classification: Community
Component: publican
Version: future
Hardware: Unspecified
OS: Unspecified
medium
urgent
Target Milestone: 3.0
Assignee: Jeff Fearn 🐞
QA Contact: Ruediger Landmann
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-06-07 09:37 UTC by Martin Prpič
Modified: 2012-10-31 03:10 UTC (History)
3 users (show)

Fixed In Version: 3.0.0
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-10-31 03:10:54 UTC


Attachments (Terms of Use)

Description Martin Prpič 2011-06-07 09:37:46 UTC
Description of problem:

Assigning a bridgehead an ID, for example:

<bridgehead id="eels">Eels</bridgehead> 

and then linking to it using an xref:

<xref linkend="eels"/> 

produces a correct link in the html, but when clicked, it does not take you to the actual bridgehead.

Comment 1 Jeff Fearn 🐞 2011-06-20 11:12:22 UTC
Modified template anchor to match bridgehead better.

Committed revision 1788.

Comment 2 Jeff Fearn 🐞 2011-11-29 01:38:13 UTC
wow this fix shipped ages ago!

Comment 3 Martin Prpič 2012-01-16 11:52:04 UTC
~]$ rpm -q publican
publican-2.8-1.fc15.noarch

Linking to a bridgehead still doesn't work. Re-opening.

Comment 4 Jeff Fearn 🐞 2012-02-20 06:25:15 UTC
hmm must have been reverted at some time...

Reapplied patch to trunk.

Committed revision 2022.

Comment 5 Martin Prpič 2012-04-24 16:39:30 UTC
The referencing works, but the produced link has the anchor of the format:

Section x.y, "Eels".

where x.y is the section (which has a different title) that contains that particular bridgehead. This may be confusing to users as you are saying it's section x.y and yet the name of that section is not Eels. Hope this makes sense.

I think the produced html link should just says "Eels" and the author will be responsible for ensuring it makes sense grammatically.

Moving back to ASSIGNED.

Thanks!

Comment 6 Jeff Fearn 🐞 2012-05-17 06:39:39 UTC
(In reply to comment #5)
> I think the produced html link should just says "Eels" and the author will be
> responsible for ensuring it makes sense grammatically.

Unfortunately removing the title makes it impossible for translators to make sense grammatically. We've debated this on numerous occasions and we've always come back to having the label in the xref as the default. Brands can override this if they choose to do so.

FWIW the label used 'Section' it set in the DocBook translation XSL, so a bug would need to be lodged upstream if a different label was sought for bridgeheads.

Comment 7 Michael Hideo 2012-06-08 02:01:49 UTC
(In reply to comment #0)
> Description of problem:
> 
> Assigning a bridgehead an ID, for example:
> 
> <bridgehead id="eels">Eels</bridgehead> 
> 
> and then linking to it using an xref:
> 
> <xref linkend="eels"/> 
> 
> produces a correct link in the html, but when clicked, it does not take you
> to the actual bridgehead.

execute the above

Comment 8 Martin Prpič 2012-06-08 08:38:29 UTC
Linking works as expected. Moving to VERIFIED.


Note You need to log in before you can comment on or make changes to this bug.