Re: DOCBOOK-APPS: Problems in Docbook TOC from Xalan
Thanks Jirka. If you think that the problem cannot be resolved with Xalan, I'll try Saxon instead. Vincent - Original Message - From: Jirka Kosek [EMAIL PROTECTED] To: Vincent Hikida [EMAIL PROTECTED] Cc: Docbook-apps MailingList [EMAIL PROTECTED] Sent: Monday, October 28, 2002 1:28 AM Subject: Re: DOCBOOK-APPS: Problems in Docbook TOC from Xalan Vincent Hikida wrote: I remember having a similar problem six months ago. At that time the the previous and next links had a similar problem. At that time Norm fixed the problem and said that the bug was due to a workaround he did for a xalan bug. I am hoping that there can be a similar fix this time. If you can, switch to Saxon. There are no such problems with this XSLT processor. Jirka -- - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
DOCBOOK-APPS: Problems in Docbook TOC from Xalan
I sent this message to the docbook mailing list. Since I didn't get any response there, I thought that perhaps docbook-apps may be more appropriate. Basically my problemwas that when using Xalan, java 1.4.0and Docbook-xsl-1.51.1/html/chunk.xsl, I did not get any TOC in my html file. When I replaced the xsl with docbook-xsl-1.57.0 I now get a nice looking TOC but the links that were created are all wrong. In the html I am getting a href="ch01.htmlch01.html" instead of a href="ch01.html" I remember having a similar problem six months ago. At that time the the previous and next links had a similar problem. At that time Norm fixed the problem and said that the bug was due to a workaround he did for a xalan bug. I am hoping that there can be a similar fix this time. Vincent Hikida
Re: DOCBOOK-APPS: Creating A TOC automatically
Bob,
Thanks a lot for your help. I'm getting this problem when I run xalan from
ant but outside of ant the TOC is being generated fine.
I downloaded instant saxon and ran it with the following command and the toc
came out fine.
saxon. tdocbook.xml chunk.xsl
I then tried to use xalan outside of ant and did the following command. I
now get a toc in my html file. However, this produced several error messages
starting with a IncrementalSAXSource_Xerces class not found message.
java org.apache.xalan.xslt.Process -in tdocbook.xml -xsl chunk.xsl
The ant code that I am using now is roughly as follows:
target name=development depends=preparedevelopment description=XSL
The Development Docs
copy todir=${builddevelopment}
fileset dir=${css} includes=${bmscss}/
/copy
java classname=org.apache.xalan.xslt.Process fork=yes
jvmarg
value=-Xbootclasspath/a:${basedir}/lib/xalan.jar:${basedir}/lib/xercesImpl.
jar:${basedir}/lib/xml-apis.jar/
arg value=-HTML/
arg line=-IN ${docsdevelopment}/development.xml/
arg line=-XSL ${docbookhtmlxsl}/
arg line=-PARAM base.dir ${builddevelopment}//
arg line=-PARAM html.stylesheet ${bmscss}/
classpath
pathelement location=lib/xalan.jar/
/classpath
/java
/target
If I remember correctly, the bootclass path was changed a while ago (by
someone else) because there is some problem with Xalan under java 1.4
because Xerces is now part of java 1.4. This must be causing the error
messages I see when I run Xalan directly from the command line. This must
have in turn caused problems for ant. I'm afraid I don't understand any of
this. However, this workaround must somehow be related to the TOC not
showing up when Xalan is run under ant.
If anyone knows what is going on I would be interested in finding out how I
can run ant and java 1.4 and still get a TOC also. However, I think I will
go to the person who originally changed the ant build file. Perhaps he will
know how to resolve the problems in the ant build file without causing a
problem with the TOC.
Vincent
- Original Message -
From: Bob Stayton [EMAIL PROTECTED]
To: [EMAIL PROTECTED]; [EMAIL PROTECTED]
Sent: Wednesday, October 09, 2002 3:54 PM
Subject: Re: DOCBOOK-APPS: Creating A TOC automatically
Well, you do not have to do a customization
layer to get a TOC. It is the default behavior
of the stylesheets to generate a TOC for a book,
which is what your example was. The presense or
absense of an empty toc element will make no
difference unless you are using some of the fancy
manual TOC features, which I doubt.
Like I said, when I process your sample file
with the stock 1.55.0 chunk stylesheet (with or without
that empty toc element included), I get a TOC in
the output.
Something is going on in your processing environment, but
it is hard to tell what. Exactly what command are you
using? You might try processing it with Saxon instead of
Xalan. I also wonder if that embedded stylesheet reference
at the beginning is somehow having an effect on Xalan?
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
Caldera International, Inc. fax: (831) 429-1887
email: [EMAIL PROTECTED]
On Wed, Oct 09, 2002 at 03:27:55PM -0700, [EMAIL PROTECTED] wrote:
Thanks, I looked at the site.
What I think I need to do is to create a customization layer as follows:
?xml version=1.0?
xsl:stylesheet xmlns:xsl=http://www.w3.org/1999/XSL/Transform;
xmlns:doc=http://nwalsh.com/xsl/documentation/1.0;
version=1.0
exclude-result-prefixes=doc
!--xsl:param name=generate.toc
book toc
/xsl:param--
xsl:param name=toc.list.typedl
/xsl:param
xsl:include href=../docs/docbook-xsl-1.51.1/html/chunk.xsl/
/xsl:stylesheet
I now use this xsl instead of chunk.xsl. However, I'm having the same
problem. I did this both with and without the toc/toc tags.
Vincent
Forget about a TOC element in docbook if you want a
automatic TOC. The TOC element in docbook is used if
you define your own manual TOC (not very useful,
really).
For automatic TOC, if you're using the XSL
stylesheets, you have to overwrite in your custom
layer some parameters of param.xsl in order to obtain
the desired result. I recomemd you to read the
documentation of the XSLT stylesheets, especially this
one:
http://docbook.sourceforge.net/release/xsl/current/doc/html/rn04.html
hope it helps.
--- Vincent Hikida [EMAIL PROTECTED] escribis:
I get an index.html either way. There is no
difference between having an
empty toc and not having one.
Vincent
- Original Message -
From: Bob Stayton [EMAIL
Re: DOCBOOK-APPS: Creating A TOC automatically
I get an index.html either way. There is no difference between having an empty toc and not having one. Vincent - Original Message - From: Bob Stayton [EMAIL PROTECTED] To: [EMAIL PROTECTED]; [EMAIL PROTECTED] Sent: Tuesday, October 08, 2002 4:58 PM Subject: Re: DOCBOOK-APPS: Creating A TOC automatically On Tue, Oct 08, 2002 at 01:40:33PM -0700, [EMAIL PROTECTED] wrote: I'm afraid I'm still a novice at Docbook and related technologies. I am under the impression that using toc /toc will automatically cause a toc to be created. I tried the following docbook xml file. ?xml version='1.0' encoding='UTF-8'? ?xml-stylesheet type=text/css href=http://docs.boostmyscore.com/dtd/docbook.css;? !DOCTYPE book PUBLIC -//OASIS//DTD DocBook XML V4.2//EN http://docs.boostmyscore.com/dtd/docbook/docbookx.dtd; book bookinfo titleDocbook Test/title dateOctober 1, 2002/date /bookinfo toc/toc chapter id=chapter1 titleChapter 1/title para This is Chapter 1 of Docbook test. /para /chapter chapter id=chapter2 titleChapter 2/title para This is Chapter 2 of Docbook test. /para /chapter /book I am using Xalan and chunk.xsl. No TOC is created in the html files that are produced. Am I doing something wrong? Interesting. The empty toc element should not make any difference unless you have some parameters set to process it. What happens when you remove the empty toc? Do you get an index.html file either way? I'm able to process your file with both Saxon and xsltproc and the 1.55.0 chunk stylesheet, and I get a TOC in index.html. I don't currently have Xalan set up to test it. -- Bob Stayton 400 Encinal Street Publications Architect Santa Cruz, CA 95060 Technical Publications voice: (831) 427-7796 Caldera International, Inc. fax: (831) 429-1887 email: [EMAIL PROTECTED]
RE: DOCBOOK-APPS: Re: Problem with Next/Prev links when usinghtml/chunk.xml
/ Vincent Hikida [EMAIL PROTECTED] was heard to say: | I'm having a problem in the html created using chunk.xml. | | Basically, the next and prev links are often wrong. An example is that | the next link may be ch03s02.htmlch04.htmlch04s02.html when it should be | ch03s02.html | I've documented my problem at http://www.vhikida.com/docbook/docbook.html | Can anyone tell me what I am doing wrong? This turned out to be a bug in 1.50.0. It's fixed in 1.51.x. (I introduced the bug trying to work around the Xalan problem. Grr) Be seeing you, norm vincent Oops my previous reply only went to Norm and not the rest of the list. Using 1.51.1 fixed the problem. /vincent
DOCBOOK-APPS: Problem with Next/Prev links when using html/chunk.xml
I'm having a problem in the html created using chunk.xml. Basically, the next and prev links are often wrong. An example is that the next link may be ch03s02.htmlch04.htmlch04s02.html when it should be ch03s02.html I've documented my problem at http://www.vhikida.com/docbook/docbook.html Can anyone tell me what I am doing wrong? Vincent
RE: DOCBOOK-APPS: javahelp.xsl questions
-Original Message- From: Jirka Kosek [SMTP:[EMAIL PROTECTED]] Sent: Wednesday, May 15, 2002 2:05 PM To: [EMAIL PROTECTED] Cc: Docbook-apps MailingList (E-mail) Subject:Re: DOCBOOK-APPS: javahelp.xsl questions Vincent Hikida wrote: I have a few questions on using javahelp.xsl. 1) Right after each chapter heading in the javahelp html, I get the text Table of Contents. I realize that in a regular docbook html, that a table of contents goes after the chapter heading, however this seems pretty meaningless in javahelp. Am I doing something wrong and how do I get rid of it? You can control ToC creation by parameter generate.toc. To get rid off all ToCs, you can use something like: xsl:param name=generate.toc appendix nop article nop book nop chapter nop ... /xsl:param in your customization layer. 2) The labels in the map file that is generated seems random alphanumeric text. I need to reference these labels in java code in order to get context sensitive help. a) Is there a tag in the docbook xml that I can use to set these labels? I think that setting id attribute on component container (chapter, section, ...) will help. Content of ID should be used then instead of autogenerated value. b) Will these labels stay constant accross each iteration of an XLS transform? Usually yes, but XSLT specifications says that they can be different in each transformation. I am a complete newbie at all this XML related technology. I hope I am posting to the right mailing list. Your hope is right. ;-) Jirka -- - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
RE: DOCBOOK-APPS: javahelp.xsl questions
jirka Vincent Hikida wrote: I have a few questions on using javahelp.xsl. 1) Right after each chapter heading in the javahelp html, I get the text Table of Contents. I realize that in a regular docbook html, that a table of contents goes after the chapter heading, however this seems pretty meaningless in javahelp. Am I doing something wrong and how do I get rid of it? You can control ToC creation by parameter generate.toc. To get rid off all ToCs, you can use something like: xsl:param name=generate.toc appendix nop article nop book nop chapter nop ... /xsl:param in your customization layer. /jirka vincent Sorry. I am afraid I'm a little slow. I've been perusing online docbook and xsl references today and I am having some problems figuring out how to create an XSL customization layer. Is there some on-line documentation that you can point to to get me started in creating an XSL customization layer? I am rather new at using XML. In fact, I have only been using HTML and XML for a couple of months to create documentation in JavaHelp and Docbook XML. /vincent
RE: DOCBOOK-APPS: Re: javahelp.xsl questions
Norm, Thank you for your responses. I've cut down on my test documents and I posted my latest test on the web. It is at http://www.vhikida.com/docbook/docbook.html. Let me know if you need anything more. Vincent :) -Original Message- From: Norman Walsh [SMTP:[EMAIL PROTECTED]] Sent: Thursday, May 16, 2002 3:55 AM To: [EMAIL PROTECTED] Cc: 'Jirka Kosek'; Docbook-apps MailingList (E-mail) Subject:DOCBOOK-APPS: Re: javahelp.xsl questions / Vincent Hikida [EMAIL PROTECTED] was heard to say: | Actually I forgot that I actually do use id=x in the sections. I | think that after being processed through javahelp.xls. I think that the | resulting html should specify target=x but instead I get something | like target=N40025F. Is there a way that I can control the target label? It's been a while (a long while) since I looked at the JavaHelp stuff. Can you send a small sample document that demonstrates the problem? And to save bandwidth, the base.dir problem sounds like a bug. I'll look into that too. Be seeing you, norm -- Norman Walsh [EMAIL PROTECTED] | Someone has changed your life. http://www.oasis-open.org/docbook/ | Save? (y/n) Chair, DocBook Technical Committee |
RE: DOCBOOK-APPS: javahelp.xsl questions
I'm somewhat in a rush now to go to an all day Oracle Users Group meeting but I just want to say what a great list this is As for the version of javahelp.xsl I found this in it. !-- $Id: javahelp.xsl,v 1.1 2002/05/02 23:30:12 thuss Exp $ However, I was confused because I was looking on the web and found other javahelp.xsl with a different text than this. I believe the version on the web was the latest as it seemed to be the latest cvs version on the web. When doing a diff they matched except for this portion. For any other questions I'll have to answer tonight. Vincent -Original Message- From: Jirka Kosek [SMTP:[EMAIL PROTECTED]] Sent: Thursday, May 16, 2002 4:07 AM To: [EMAIL PROTECTED] Cc: Docbook-apps MailingList (E-mail) Subject:Re: DOCBOOK-APPS: javahelp.xsl questions File: ATT1.txt; charset = iso-8859-2
RE: DOCBOOK-APPS: javahelp.xls (base.dir)
Thanks. I knew that was an option. That was my fall back. It seems from what Norm said that it may be a bug. If that is the case, and it is going to be fixed in the next few months I think I can wait. Vincent -Original Message- From: Jeff Beal [SMTP:[EMAIL PROTECTED]] Sent: Thursday, May 16, 2002 5:55 AM To: Docbook-apps MailingList (E-mail) Subject:RE: DOCBOOK-APPS: javahelp.xls (base.dir) Rather than copy *all* of your XML source to your desired directory, add a line to your ANT script that copies the javahelp control files to the desired directory. -Original Message- From: Vincent Hikida [mailto:[EMAIL PROTECTED]] Sent: Wednesday, May 15, 2002 5:34 PM To: 'Jirka Kosek' Cc: Docbook-apps MailingList (E-mail) Subject: RE: DOCBOOK-APPS: javahelp.xls (base.dir) Jirka, Thanks for all your answers. I'll have to try using the customization layer. I just found a reference on the web to xsl customization. Jirk wrote: You can call transformation from target directory and set base.dir to empty string. This will create all files in the current directory. I am using ant so the current directory would be where my build.xml is. Unfortunately, that is not the directory that I want. I guess I could copy everything to the directory that I want but I would rather have it done by the Xalan XLST. Vincent -Original Message- From: Jirka Kosek [SMTP:[EMAIL PROTECTED]] Sent: Wednesday, May 15, 2002 2:07 PM To: [EMAIL PROTECTED] Cc: Docbook-apps MailingList (E-mail) Subject:Re: DOCBOOK-APPS: javahelp.xls (base.dir) Vincent Hikida wrote: When using Xalan with javahelp.xls I use the base.dir parameter. The html files all go to the directory selected. However, all the other javahelp files (xml, hs, jhm) stay in the the same directory as the docbook xml. Is there a way to direct these files into the same directory? You can call transformation from target directory and set base.dir to empty string. This will create all files in the current directory. Jirka -- - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
DOCBOOK-APPS: javahelp.xsl questions
I have a few questions on using javahelp.xsl. 1) Right after each chapter heading in the javahelp html, I get the text Table of Contents. I realize that in a regular docbook html, that a table of contents goes after the chapter heading, however this seems pretty meaningless in javahelp. Am I doing something wrong and how do I get rid of it? 2) The labels in the map file that is generated seems random alphanumeric text. I need to reference these labels in java code in order to get context sensitive help. a) Is there a tag in the docbook xml that I can use to set these labels? b) Will these labels stay constant accross each iteration of an XLS transform? I am a complete newbie at all this XML related technology. I hope I am posting to the right mailing list. Vincent
DOCBOOK-APPS: javahelp.xls (base.dir)
When using Xalan with javahelp.xls I use the base.dir parameter. The html files all go to the directory selected. However, all the other javahelp files (xml, hs, jhm) stay in the the same directory as the docbook xml. Is there a way to direct these files into the same directory? Vincent
RE: DOCBOOK-APPS: javahelp.xls (base.dir)
Jirka, Thanks for all your answers. I'll have to try using the customization layer. I just found a reference on the web to xsl customization. Jirk wrote: You can call transformation from target directory and set base.dir to empty string. This will create all files in the current directory. I am using ant so the current directory would be where my build.xml is. Unfortunately, that is not the directory that I want. I guess I could copy everything to the directory that I want but I would rather have it done by the Xalan XLST. Vincent -Original Message- From: Jirka Kosek [SMTP:[EMAIL PROTECTED]] Sent: Wednesday, May 15, 2002 2:07 PM To: [EMAIL PROTECTED] Cc: Docbook-apps MailingList (E-mail) Subject:Re: DOCBOOK-APPS: javahelp.xls (base.dir) Vincent Hikida wrote: When using Xalan with javahelp.xls I use the base.dir parameter. The html files all go to the directory selected. However, all the other javahelp files (xml, hs, jhm) stay in the the same directory as the docbook xml. Is there a way to direct these files into the same directory? You can call transformation from target directory and set base.dir to empty string. This will create all files in the current directory. Jirka -- - Jirka Kosek e-mail: [EMAIL PROTECTED] http://www.kosek.cz
RE: DOCBOOK-APPS: javahelp.xsl questions
2) The labels in the map file that is generated seems random alphanumeric text. I need to reference these labels in java code in order to get context sensitive help. a) Is there a tag in the docbook xml that I can use to set these labels? I think that setting id attribute on component container (chapter, section, ...) will help. Content of ID should be used then instead of autogenerated value. Actually I forgot that I actually do use id=x in the sections. I think that after being processed through javahelp.xls. I think that the resulting html should specify target=x but instead I get something like target=N40025F. Is there a way that I can control the target label? Vincent
