Bug 711348

Summary: Linking to a bridgehead does not work in html formats
Product: [Community] Publican Reporter: Martin Prpič <mprpic>
Component: publicanAssignee: Jeff Fearn 🐞 <jfearn>
Status: CLOSED CURRENTRELEASE QA Contact: Ruediger Landmann <rlandman+disabled>
Severity: urgent Docs Contact:
Priority: medium    
Version: futureCC: mhideo, mmcallis, publican-list
Target Milestone: 3.0Keywords: Reopened
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: 3.0.0 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-10-31 03:10:54 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

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.