Bug 726575

Summary: Cannot <xref> between books in a <set>
Product: [Community] Publican Reporter: Rebecca Newton <rnewton>
Component: publicanAssignee: Ruediger Landmann <rlandman+disabled>
Status: CLOSED NOTABUG QA Contact: Jeff Fearn 🐞 <jfearn>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: futureCC: mmcallis, publican-list
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-08-25 02:05:07 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 Rebecca Newton 2011-07-29 04:47:40 UTC
Description of problem: 

<xi:include>s work fine between books in a set but <xref>s don't. Just doing the <xref> normally, like this:

<xref linkend="sect-your-mother-was-a-hamster-"/>

Publican just can't see it, the same as normal when there's no corresponding section in your book.

If you specify the direct path, like when <xi:include>ing, like this:

<xref linkend="../../The_Holy_Grail/en-US/sect-your-mother-was-a-hamster"/>

You get validation errors, AND the usual I Can't See It error.

I've also tried specifying the chapter.xml as well, and the path without escaping two dirs.

Version-Release number of selected component (if applicable):


How reproducible:
Create two books in a standalone set and try to <xref> to a section in the other book.

Steps to Reproduce:
1. 
2.
3.
  
Actual results:
Errors described above.

Expected results:
<xref> are valid between books.

Additional info:

Comment 1 Jeff Fearn 🐞 2011-07-29 05:06:08 UTC
At a guess I think you are hitting the forced run of clean_ids that publican does to avoid id clashes when building sets.

To confirm, try running:

$ grep -r 'id-that-you-want' tmp/en-US/xml/*

If that's it then you could try running clean_ids before you build to see if that works.

Comment 2 Jeff Fearn 🐞 2011-08-23 22:53:19 UTC
Can you supply the repo location for this set? It'll make testing easier.

Comment 3 Rebecca Newton 2011-08-23 23:26:42 UTC
Hey Jeff, the source is here: https://svn.devel.redhat.com/repos/ecs/JBoss_Web_Framework_Kit/trunk/2.0/RichFaces_Developer_Guide/ I discovered that <xi:include>s won't work either, not sure why I thought they did. I don't know if this is related. 

I did try running publican clean for the <xref> stuff but it took a few hours so I kept having to give up.

Comment 4 Rebecca Newton 2011-08-25 02:05:07 UTC
Turns out, if you follow the instructions in the Publican UG properly ... stuff works ;) I fixed the format of the set so that it wasn't books inside the set, and that has fixed both the <xi:include> and <xref> issues. Thanks for your time, Jeff.