Re: [docbook-apps] filename prefix feature is not working?

["Tracy Huang Gmail" <tracyyellow@gmail.com>]

Hi Eduard,

Thank you for the information. I think I will temporarily settle down with 
the solution of using xml:id as the file name.

Regards
Tracy

----- Original Message ----- 
From: "Eduard Tibet" <eduard.tibet@i-free.com>
To: <docbook-apps@lists.oasis-open.org>
Sent: Tuesday, December 28, 2010 8:04 PM
Subject: [docbook-apps] filename prefix feature is not working?


Tracy,

It is a bug. Originally posted to this list in: 
http://www.mail-archive.com/docbook-apps@lists.oasis-open.org/msg15056.html 
. Details also are here: 
http://sourceforge.net/tracker/?func=detail&aid=3087359&group_id=21935&atid=373747

As Bob mentioned:

"This is apparently a long-standing issue, just now brought to light. 
Fixing it may
require touching several templates, so I would recommend not introducing 
that risk at
this stage of the 1.76 release.  We'll fix it for the release after that"

[ 
http://www.mail-archive.com/docbook-apps@lists.oasis-open.org/msg15085.html  
]

--
Best regards,
 Eduard Tibet


-----Original Message-----
From: Tracy Huang Gmail [mailto:tracyyellow@gmail.com]
Sent: Tuesday, December 28, 2010 5:50 AM
To: Bob Stayton; docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] filename prefix feature is not working?

Hi All,



I tried to follow instructions on 
http://www.sagehill.net/docbookxsl/Chunking.html 
<http://www.sagehill.net/docbookxsl/Chunking.html> , to add prefix to the 
html file names. Here is what I did.



I have the following test.xml file:

<?xml version="1.0" encoding="utf-8"?>

<chapter version="5.0" xml:id="About_This_Book" 
xmlns="http://docbook.org/ns/docbook";

         xmlns:ns5="http://www.w3.org/1998/Math/MathML";

         xmlns:ns4="http://www.w3.org/2000/svg";

         xmlns:ns3="http://www.w3.org/1999/xhtml";

         xmlns:ns2="http://www.w3.org/1999/xlink";

         xmlns:ns="http://docbook.org/ns/docbook";>

  <title>About This Book</title>



  <sect1 xml:id="Loading_heavy_window">

    <title>Loading &#147;heavy&#148; window</title>

    <para>An example of using quotation marks in title.</para>

  </sect1>



  <sect1 xml:id="Loading_heavy_tab">

   <title>Loading &#147;heavy&#148; tab</title>

   <para>Another example of using quotation marks in title.</para>

  </sect1>



</chapter>



I complied the xml file using either of the following two commands (both 
generate the same error):

xsltproc --stringparam base.dir windows- 
D:\unix\usr\share\sgml\docbook\docbook-xsl-1.75.2\htmlhelp\htmlhelp.xsl 
test.xml

xsltproc --stringparam base.dir windows- 
D:\unix\usr\share\sgml\docbook\docbook-xsl-1.75.2\html\chunk.xsl test.xml



I got the following html files generated (the file name is added with the 
prefix "windows-" correctly):

windows-index.html

windows-ch01s02.html



But when I opened the html file and searched for "href", I found in both 
files: all "href" point to the file name without the prefix "windows-", so 
all previous/next/toc links go wrong.

href="index.html"

href="ch01s02.html"



Is this a bug or have I missed something?

The filename prefix feature would be a great feature for me, as our product 
is working on many different platforms, for each platform, we created an 
installation guide, but when all these installation guides (as well as the 
other guides) are merged into one CHM file, the CHM Back and Forward buttons 
cannot always jump to the correct html topic, to be exact, it can find the 
correct file name, but as these installation guides (as well as the other 
guides) have identical html file names, such as ch01s02.html, ch03s01.html 
etc., the Back and Forward buttons find the file in all CHM files merged 
(starting from the currect page to the end, CHM by CHM) , not by finding 
within the CHM file I am reading now (I think this is a bug in CHM), so it 
may direct me to the html topic for the wrong CHM file, for example, when I 
am reading the install guide for Windows platform, after several Back 
clicks, I am reading the install guide for Unix platform now. So I tried to 
use the filename prefix feature to add prefix to the html file name to 
distinguish file names from CHM to CHM, such as windows-ch01s02.html, 
unix-ch01s02.html, linux-ch01s02.html etc.



Regards

Tracy Huang

Technical Writer

China


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org