Re: [docbook-apps] Can't get olink to generate a working link between books in a set

[Bob Stayton]

Ah, you need to keep your generated data files for HTML and PDF outputs 
separate.  That is, you need to generate target data with the stylesheet 
you are using to generate output.  When you use your HTML stylesheet, it 
generates target data with .html references.  So you need to use your 
PDF stylesheet to generate separate data files for PDF output. Those 
files with different names would be referenced by the PDF version of the 
target database document.


Bob Stayton
Sagehill Enterprises
b...@sagehill.net

On 8/7/2018 12:07 PM, Bob McIlvride wrote:


Hi Bob,

That would make sense.  I’ve tried it, and although it now seems to 
recognize the correct ID, it still comes up within a pointer to an 
html file:


I’ve used the sample xml code that you suggested for my olinkdb.xml 
file, as well as a number of other combinations.  But they all seem to 
yield essentially the same results.


Do you have any further thoughts?

All the best,

Bob

COGENT 



*Bob McIlvride **   Communications Manager*

Cogent Real-Time Systems Inc., a Skkynet company

T   1 905 702 7851 ext 103

cogent.ca 

*From:*Bob Stayton 
*Sent:* Monday, August 06, 2018 11:46 AM
*To:* docbook-apps@lists.oasis-open.org
*Subject:* Re: [docbook-apps] Can't get olink to generate a working 
link between books in a set


Hi Bob,

The problem is the setup of the target database document, with a 
sitemap and separate baseuri attributes for each book. That setup is 
for separate book PDF files trying to link to each other.


If you are processing the books as a single set element, you should 
instead set it up as a sequence of document elements without a sitemap 
and without @baseuri's, which should then form relative links.



   
    
    

    
 etc.

I haven't tested this, but I think it will work.  Let me know if it 
doesn't.


Bob

Bob Stayton
Sagehill Enterprises
b...@sagehill.net 

On 8/2/2018 2:07 PM, Bob McIlvride wrote:

Hi Bob,

Thank you for the quick reply.

> Do you use targetdoc attributes in your olink elements, and are
they different for each book?

Yes, for example, this olink is located in the text of the book
whose xml:id="dos-book”:

… (see DataHub
Scripting), which …

The link renders like this in the PDF document output:

When I took the above screenshot (OlinkOutput.png, attached) the
mouse was hovering over the text “DataHub Scripting”, as
highlighted in yellow.  You can see how the link seems to be
looking for an external file.

> Is your target database document for PDF output set up as a
single document, and do you generate a single target.db file for
the set?

I believe so, but I could be mistaken.  Below is a copy of the
olinkdb.xml file.  It references the target.db of each of the
three books in the set (as I think it is supposed to) and creates
a single target.db file for the set.  The id of the output file is
“test-set”, and the filename is test-set.pdf.  It is located in
the directory shown in the screenshot above.  I don’t know why the
string “oxygen-main.html” has been appended to the filename.









]

> 




Description



































I hope this helps clarify the situation a bit. If you need any
additional information or files, please let me know.

Best wishes,

Bob

COGENT 



*Bob McIlvride **   Communications Manager*

Cogent Real-Time Systems Inc., a Skkynet company

T   1 905 702 7851 ext 103

cogent.ca 

*From:*Bob Stayton  
*Sent:* Wednesday, August 01, 2018 6:29 PM
*To:* docbook-apps@lists.oasis-open.org

*Subject:* Re: [docbook-apps] Can't get olink to generate a
working link between books in a set

Hi Bob,

I would need a little more clarity on your set up.  Do you use
targetdoc attributes in your olink elements, and are they
different for each book?

Is your target database document for PDF output set up as a single
document, and do you generate a single target.db file for the set?

Bob Stayton

Sagehill Enterprises

b...@sagehill.net 

On 8/1/2018 12:25 PM, Bob McIlvride wrote:

Dear friends,

  


After almost two years being moved to other tasks, I now have an 
opportunity

to complete this project.  The HTML output is working fine, but the 
issue

now is PDF (FO) output.  Here's a summary of what we would like to do:

  


We have several books that we can publish individually in HTML (actually

'webhelp' in oXygen) and in PDF outputs.  Using the same source files, 
we

are 

RE: [docbook-apps] Can't get olink to generate a working link between books in a set

[Bob McIlvride]

Hi Bob,

 

That would make sense.  I’ve tried it, and although it now seems to recognize 
the correct ID, it still comes up within a pointer to an html file:

 



 

I’ve used the sample xml code that you suggested for my olinkdb.xml file, as 
well as a number of other combinations.  But they all seem to yield essentially 
the same results.  

 

Do you have any further thoughts?

 

All the best,

 

Bob

 

 


  

Bob McIlvrideCommunications Manager

Cogent Real-Time Systems Inc., a Skkynet company

T   1 905 702 7851 ext 103

  cogent.ca

 

From: Bob Stayton  
Sent: Monday, August 06, 2018 11:46 AM
To: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Can't get olink to generate a working link between 
books in a set

 

Hi Bob,

The problem is the setup of the target database document, with a sitemap and 
separate baseuri attributes for each book.  That setup is for separate book PDF 
files trying to link to each other.

If you are processing the books as a single set element, you should instead set 
it up as a sequence of document elements without a sitemap and without 
@baseuri's, which should then form relative links.


   




 etc.

I haven't tested this, but I think it will work.  Let me know if it doesn't.

Bob

 

Bob Stayton
Sagehill Enterprises
b...@sagehill.net  

On 8/2/2018 2:07 PM, Bob McIlvride wrote:

Hi Bob,

 

Thank you for the quick reply.

> Do you use targetdoc attributes in your olink elements, and are they 
> different for each book?  

Yes, for example, this olink is located in the text of the book whose 
xml:id="dos-book”:

… (see DataHub 
Scripting), which …

The link renders like this in the PDF document output:



When I took the above screenshot (OlinkOutput.png, attached) the mouse was 
hovering over the text “DataHub Scripting”, as highlighted in yellow.  You can 
see how the link seems to be looking for an external file.

> Is your target database document for PDF output set up as a single document, 
> and do you generate a single target.db file for the set?

I believe so, but I could be mistaken.  Below is a copy of the olinkdb.xml 
file.  It references the target.db of each of the three books in the set (as I 
think it is supposed to) and creates a single target.db file for the set.  The 
id of the output file is “test-set”, and the filename is test-set.pdf.  It is 
located in the directory shown in the screenshot above.  I don’t know why the 
string “oxygen-main.html” has been appended to the filename.

 









]

> 

 



Description



































 

I hope this helps clarify the situation a bit. If you need any additional 
information or files, please let me know.

 

Best wishes,

 

Bob

 


  

Bob McIlvrideCommunications Manager

Cogent Real-Time Systems Inc., a Skkynet company

T   1 905 702 7851 ext 103

  cogent.ca

 

From: Bob Stayton    
Sent: Wednesday, August 01, 2018 6:29 PM
To: docbook-apps@lists.oasis-open.org 
 
Subject: Re: [docbook-apps] Can't get olink to generate a working link between 
books in a set

 

Hi Bob,

I would need a little more clarity on your set up.  Do you use targetdoc 
attributes in your olink elements, and are they different for each book?  

Is your target database document for PDF output set up as a single document, 
and do you generate a single target.db file for the set?

Bob Stayton
Sagehill Enterprises
b...@sagehill.net  

On 8/1/2018 12:25 PM, Bob McIlvride wrote:

Dear friends,
 
After almost two years being moved to other tasks, I now have an opportunity
to complete this project.  The HTML output is working fine, but the issue
now is PDF (FO) output.  Here's a summary of what we would like to do:
 
We have several books that we can publish individually in HTML (actually
'webhelp' in oXygen) and in PDF outputs.  Using the same source files, we
are publishing those same books in sets--HTML and PDF output.
 
The challenge is that we would like to have active links between the books
when they are in a set, which become plain text references when the books
are published separately.  We are using olinks to achieve this goal, and
they work fine for HTML output.  
 
However, when we generate PDF output, it seems that the olinks are looking
for external documents, not for books within the set.  Is there any way to
point the olinks back into the set document and have them work in the PDF
output as well?
 
Any suggestions would be much appreciated.
 
Best regards,
 
Bob
 
 
Bob McIlvrideCommunications Manager
Cogent Real-Time Systems Inc., a Skkynet