This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [docbook-apps] use normal docbook articles for website-2.5.0


As Dave mentioned, you may not need Website to publish your material in HTML
form. You can just use the chunking stylesheets to generate a collection of
HTML that you put on a web server.

However, you can use website to tie together your various documents with a
home page.  If you create a <tocentry> with an href attribute, you can have
your Website home page point to the top of any of your documents generated
with the stock stylesheets.  See this reference for an example:

http://www.sagehill.net/docbookxsl/AddingContent.html

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Dave Pawson" <dpawson@nildram.co.uk>
To: "Marcel Bruch" <marcel@cheruskia.de>
Cc: <docbook-apps@lists.oasis-open.org>
Sent: Thursday, April 08, 2004 8:38 AM
Subject: 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.dt
d"
> >   >
> ><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/.
>
>
>



To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]