Re: [docbook-apps] Question links when making a qandaset into HTML

[David De la nuez <ddelanu@us.ibm.com>]

Whoa my bad.  I must inspected
the wrong file the first time -- it works now with nochunks!  Thanks
for insisting, problem solved! (using an empty title b/c I don't want a
title hehe) :-)

David de la Nuez
ddelanu@us.ibm.com
(914)945-1167  (tie line 862-1167)
COIN-OR www.coin-or.org

"Bob Stayton" <bobs@sagehill.net>

09/17/2004 01:47 PM

To	David De la nuez/Watson/IBM@IBMUS
cc	<docbook-apps@lists.oasis-open.org>
Subject	Re: [docbook-apps] Question links when making  a qandaset into HTML

No, my point is that you should not
blame xsltproc.  When I use xsltproc with html/docbook.xsl, it works
as you want it to.  When I use xsltproc with html/chunk.xsl, it adds
the index.html part.
 
You said you get the same results when
you use the html-nochunks option to xmlto.  That sounds wrong.  What
is the verbose output when you use html-nochunks?  It should use docbook.xsl
instead of chunk.xsl, and you should get no index.html in the hrefs.
 
Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net
 
 
----- Original Message ----- 
From: David
De la nuez 
To: Bob
Stayton 
Cc: docbook-apps@lists.oasis-open.org

Sent: Friday, September 17, 2004 10:37 AM
Subject: Re: [docbook-apps] Question links when
making a qandaset into HTML


Thanks for looking into it on your end.  I suppose I should properly
blame xsltproc, because xmlto is just a script to call it (and a parser
beforehand).  For completeness, included is some screen output:

$ xmlto -vv html temp.xml 
Format script: /usr/share/xmlto/format/docbook/html
Convert to HTML (with chunks) 
xmllint >/dev/null --xinclude --postvalid /home/delanuez/temp/temp.xml
Stylesheet: http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl
xsltproc --nonet --xinclude \ 
 -o /tmp/xmlto.oH2424/temp.proc \ 
 http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl \
 /home/delanuez/temp/temp.xml 

Thanks again.  I suppose that's that.  I can deal. :-)

David de la Nuez
ddelanu@us.ibm.com
(914)945-1167  (tie line 862-1167)
COIN-OR www.coin-or.org

"Bob Stayton" <bobs@sagehill.net>

09/17/2004 01:29 PM

To	David De la nuez/Watson/IBM@IBMUS
cc	<docbook-apps@lists.oasis-open.org>
Subject	Re: [docbook-apps] Question links when making  a qandaset into HTML

If you get "index.html" in hrefs, then xmlto is not working correctly.
 The html/docbook.xsl stylesheet doesn't know the name of the output
filename, and so cannot insert a filename into the references.  When
I process a qandaset document with html/docbook.xsl, all of the hrefs start
with "#". 
  
The bit about the title is because the stylesheets assume the root element
of a document has a title.  That usually is not a bad assumption.
 8^) 
  
Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net
  
  
----- Original Message ----- 
From: David
De la nuez 
To: Bob
Stayton 
Cc: docbook-apps@lists.oasis-open.org
Sent: Friday, September 17, 2004 10:11 AM 
Subject: Re: [docbook-apps] Question links when making a qandaset into
HTML 


Thanks for the reply, Bob. 

I get the same results using the "html-nochunks" argument to
xmlto but I have to include a title in the qandaset or it won't work.  The
verbose option shows me that it is using the current docbook.xsl sheet
(sorry I am not terribly versed in the fine points of stylesheets).

In any case, the reason that the "index.html" is a problem is
that when I include the .proc file in an HTML file which isn't named index.html...
the links aren't correct.  It strikes me as odd default behavior.
 It seems to a novice such as I am that for a qandaset the answers
are always going to be in the same chunk (or file) as the questions so
a simple "#id......" would work.  In any case, that seems
more likely than the answers being in a file named "index.html".

It's not a big problem because I manually include the .proc into my HTML
file, so one more step is a trivial amount of extra work.  I'm sure
there's a smarter way to do this, but this was the first that occurred
to me (though I think someone just asked a question recently about how
to do something similar in a more clever way?). 

David de la Nuez
ddelanu@us.ibm.com
(914)945-1167  (tie line 862-1167)
COIN-OR www.coin-or.org

"Bob Stayton" <bobs@sagehill.net>

09/17/2004 12:52 PM

To	<docbook-apps@lists.oasis-open.org>, David De la nuez/Watson/IBM@IBMUS
cc
Subject	Re: [docbook-apps] Question links when making  a qandaset into HTML

Hi David, 
With the chunking stylesheets, all hrefs start with the filename.html.
Otherwise the stylesheet would have to compute if the target of the cross
reference is in the same chunk as the link text. 
 
I don't understand why the "index.html" in the href is a problem.
 Did you try using the nonchunking stylesheet instead?
 
Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net
 
 
----- Original Message ----- 
From: David
De la nuez 
To: docbook-apps@lists.oasis-open.org
Sent: Friday, September 17, 2004 7:42 AM 
Subject: [docbook-apps] Question links when making a qandaset into
HTML 


When I convert to HTML a DB XML document with qandaset as the root element,
the question links at the top of the resulting .proc page are all of the
form "index.html#idxxxxxx".  It seems to me that the "index.html"
should not be there.  The only reason I care is because to reproduce
on a web site in a quick and dirty way an FAQ I have in a DB book, this
is what I do.  Is this a bug or a design decision I don't understand?

FYI, to the best of my knowledge I am using what the xmlto script uses
in cygwin, namely xsltproc with the current chunk.xsl stylesheet.

David de la Nuez
ddelanu@us.ibm.com
(914)945-1167  (tie line 862-1167)
COIN-OR www.coin-or.org