This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: [docbook-apps] Chunked output with .css and images folder
- From: Bob Stayton <bobs at sco dot com>
- To: David Pratt <fairwinds at shaw dot ca>
- Cc: docbook-apps at lists dot oasis-open dot org
- Date: Thu, 1 May 2003 10:39:10 -0700
- Subject: Re: [docbook-apps] Chunked output with .css and images folder
- References: <58BDB9F4-7906-11D7-B84C-000A27B3B070@shaw.ca>
I'm not understanding why you want to split up your
HTML output into multiple directories. I can understand
keeping the XML source in separate directories, but
why split up the HTML?
In addition to your image and stylesheet problems, do you
have cross references between chapters? I don't believe
the xref templates can resolve relative references
between dbhtml-specified output directories.
You mentioned the Linux Documentation Project doc, but
I don't remember seeing anything in the LDP Author Guide
about multiple output directories for a book.
If you are looking for advice, I'd suggest getting
rid of the dir processing instructions and put
all the HTML in one output directory. Put your
images in a subdirectory of that.
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
The SCO Group fax: (831) 429-1887
email: bobs@sco.com
On Sun, Apr 27, 2003 at 04:16:59PM -0700, David Pratt wrote:
> I am chunking xml to xhtml and trying to get my stylesheet and image
> folder all work out with my customization layer. I have to say pulling
> this together is a bit confusing. So I am looking for advice on how to
> best organize my files and folders for a book type project. I have
> provided what I am doing below so hopefully it is possible to follow.
> Here is my problem. An index file is generated in my folder and all my
> html files get generated into their separate chapter folders which is
> great. The problem is - where is my css ? and how is it going to work
> when index.html when it is at the top level and each chapter folder
> also needs it as well? I would currently have to have a copy in each
> chapter folder too. I have the same problem with my images. All my
> images are in a folder at the same level as my working folder. So, my
> pages will get images but my index page not. Is there a better way to
> organize files and folders so that each file is able to find the css
> file and images folder properly? Sorry for being a bit long winded.
>
> In my customization layer I currently have this:
>
> <xsl:param name="html.stylesheet">xhtml-styles.css</xsl:param>
> <xsl:param name="html.stylesheet.type">text/css</xsl:param>
> <xsl:param name="base.dir"></xsl:param>
>
> So output generated in working directory
>
> I currently have my work stored in separate folders for each chapter
> ie chapter01, chapter02 etc.
>
> So here is what I am doing currently which I am trying to follow from a
> Linux Documentation Project doc.
>
> Have a folder that contains each of the chapter folders. In this
> folder I have an index.xml file that is the start of my book. It looks
> like this:
>
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
> "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
> <!ENTITY book SYSTEM "book.xml">
> <!ENTITY version "1.0">
> <!ENTITY releasedate "May 30, 2003">
> <!ENTITY % chapter01 SYSTEM "entities/chapter01.ent">
> <!ENTITY % chapter02 SYSTEM "entities/chapter02.ent">
> %chapter01;
> %chapter02;
> ]>
> <book><title>My Book Title Here</title>
> &book;
> </book>
>
> In my book.xml file I have this:
>
> &ch01s00;
> &ch02s00;
>
> In entities folder in my working directory have a file for each chapter
> (ie. chaper01.ent)
> In this file it looks like this:
>
> <!ENTITY ch01s00 SYSTEM "../chapter01/ch01s00.xml">
> <!ENTITY ch01s01 SYSTEM "../chapter01/ch01s01.xml">
> <!ENTITY ch01s02 SYSTEM "../chapter01/ch01s02.xml">
>
> In each chapter folder, I have a file for the chapter (ie ch01s00.xml
> for chapter 1) that looks like this:
>
> <chapter id="chapter01">
> <title>My Chapter 1 Title Goes Here</title>
> <?dbhtml filename="ch01s00.html" dir="chapter01"?>
> &ch01s01;
> &ch01s02;
> </chapter>
>
> In my documents, I have rigorous in making sure the path in my links
> goes to an images directory:
> ie
> ./images_folder/name-of-image.gif
>
> In my docs I am using relative links to the images folder.
>
> In addition to my ch01s00,xml file in my chapter01 folder I have my
> documents:
>
> ch01s01.xml
> ch01s02.xml
>
> Any advice much appreciated.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org