This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: [docbook-apps] use normal docbook articles for website-2.5.0
At 11:56 08/04/2004, Marcel Bruch wrote:
Hi Dave,
sorry, I think I didn't understand your explanation completely. I think,
at the moment I do something similar as you describe. I use empty webpages
for each docbook article I want to include in my website using the
xinclude statements.
I don't think there is any reason to use xinlude, unless you want to use it
for another reason?
All my 'main' pages look like
<?xml version="1.0" encoding="iso-8859-1" ?>
<!-- Time-stamp: "2003-12-18 11:02:20 dpawson" -->
<!DOCTYPE webpage SYSTEM "../../nw/website-2.5.0/schema/dtd/website.dtd">
<webpage navto="yes" id="dbroot">
<head>
<title>Docbook Basics and References</title>
<summary>Docbook References</summary>
<keywords>docbook faq FAQ</keywords>
</head>
<qandaset>
etc.
Each webpage (with the xinclude statement) has an entry in the layout.xml.
Maybe two small examples make clear what i currently do:
----
* Example website dummy page:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.5//EN"
"http://docbook.sourceforge.net/release/website/2.5.0/schema/dtd/website.dtd";
>
<webpage id="articleX" lang="de">
<config value="18.03.04" param="rcsdate"/>
<head>
<title>article X</title>
</head>
<xi:include href="../articles/articleX.xml"
xmlns:xi="http://www.w3.org/2003/XInclude"; />
</webpage>
If xinclude expands that to a valid instance, that sounds good.
----
* Example entries in layout.xml:
[...]
<tocentry page="src/webpage/articleX.xml"
filename="articleX.html"/>
<tocentry page="src/webpage/articleY.xml"
filename="articleY.html"/>
<tocentry page="src/webpage/aNormalWebpage.xml"
filename="aNormalWebpage.html"/>
Mine is
<?xml version="1.0"?>
<!DOCTYPE layout SYSTEM "../../nw/website-2.2/layout.dtd">
<layout>
<config param="homebanner-tabular" value="graphics/website.gif"
altval="Home Banner"/>
.... other configuration stuff
<toc page="dbroot.xml" dir="docbook" filename="index.html">
<tocentry page="reference.xml" filename="reference.html" tocskip="0"/>
<tocentry page="markup.xml" filename="markup.html" tocskip="0"/>
<tocentry page="tools.xml" filename="tools.html" tocskip="0"/>
<tocentry page="catalogs.xml" filename ="catalogs.html" tocskip="0"/>
<tocentry page ="ant.xml" filename="ant.html" />
<tocentry page="styling.xml" dir="styling" filename
="styling.html" tocskip="0">
You might be able to relate this to the docbook faq site.
What I'm looking for is something similar to this:
<tocentry page="src/articles/articleX.xml"
filename="articleX.html"/>
to use Docbook articles directly inside a website2.5 set - or thinking a
little bit bigger: publishing more then a few articles - a book or a set
of books without creating an empty webpage for each chapter/article but
mixed with normal webpages. Maybe "single source publishing" might be the
right words.
Not sure you need website to do that?
Just use normal docbook chunking?
Bob, am I right?
Rather than start with web pages, start with your 'book' or set,
then just use the stylesheets to transform that into html chunks
using the parameters in the xsl stylesheets.
maybe think of using xinclude as a seperate thing?
Try with an experiment, a 'book' with 4 chapters,
and get 4 web pages out of it. Each chapter part of the book,
no entities, no xinclude? Keep it simple?
Then try xinclude with the book, including chapters.
I think it will work.
See http://www.sagehill.net/docbookxsl/Xinclude.html
Read it carefully, it does work!
Maybe its a little bit too much I want - now it sounds a little bit
utopistic to me. Sorry for wasting your time.
No, with docbook it is normal to say 'we can do it', just need
to find out how :-)
regards DaveP
To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.