This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: Announce: Website 2.0a1 (ALPHA) released
- To: docbook at lists dot oasis-open dot org
- Subject: Re: DOCBOOK: Announce: Website 2.0a1 (ALPHA) released
- From: Dave Pawson <daveP at dpawson dot freeserve dot co dot uk>
- Date: Tue, 05 Jun 2001 21:53:19 +0100
Comments.
1. subdirtest1a.html and subdirtest1a.html are wrongly linked in the examples.
2. <dirty> What changes have their been to the config element</dirty>
E.g. rcsdate appears new?
the layout file has 'global' config params etc, are these the same
as in lower level files?
3. Layout.dtd
<layout>
<toc page="website.xml" filename="index.html">
<tocentry page="doc1.xml" dir="subdir"
filename="index.html">
<tocentry page="doc1.1.xml" filename="page2.html"/>
<tocentry page="doc1.2.xml" filename="page3.html"/>
</tocentry>
<tocentry page="doc2.xml" filename="page2.html"/>
</toc>
</layout>
Can I specify
<tocentry page="doc1.xml" dir="subdir1/subdir2"
filename="index.html">
to request the output file be put two dirs deep?
Will
<tocentry page="directory1/doc1.xml" dir="subdir"
filename="index.html">
pull doc1.xml from directory1, if I ever get round to sorting
out all the xml files :-)
"<para>By default, directories are inherited (hence
<filename>page2.html</filename> and <filename>page3.html</filename>
will appear in the <filename>subdir</filename> directory)</para>"
What does this mean please Norm? Specifically, the 'directories
are inherited'?
4. Typo? wslayout.xml
<programlisting>
+ index.html
+ subdir/index.html
+ subdir/page2.html
+ subdir/page2.html
+ page2.html
</programlisting>
Does this exemplify last point in 3, directory inheritance?
E.g. I don't need to specify that the second html file in subdir
needs to be put in subdir? E.g.
<layout>
<toc page="website.xml" filename="index.html">
<tocentry page="doc1.xml" dir="subdir"
filename="index.html">
<tocentry page="doc1.1.xml" filename="page2.html"/>
<tocentry page="doc1.2.xml" filename="page3.html"/>
</tocentry>
<tocentry page="doc2.xml" filename="page2.html"/>
</toc>
</layout>
Implies that pages 2 and 3, being children of tocentry with subdir 2,
are both 'in' subdir2? Just to confirm I think!
5. 'If a directory is not specified, the files will appear in the currently
inherited directory (or in the root, if no directory is specified anywhere
in the <sgmltag>tocentry</sgmltag> ancestry).'
Definition of 'root' please? Is this root of the file system, or
root relative to the build point, the root relative to the first
xml file processed... or something else?
6. <notoc> ..... I guess these must be explicitly linked to then?
As per the 'about' example?
7. The example discussed, doesn't actually have an 'index.html'
derived from website.xml
8. There is no example usage of tocskip.
9. Relative references.
I've lost track of your directory layout Norm, in chunk-website you
have ../../xsl/html/chunker.xsl
are you expecting the following layout?
docbook
website
xsl
if not, what does the default expect please?
10. Last error, was the xbel bookmarks, called up from autolayout.xml.
(suggest you remove
<tocentry page="test3.xml" id="test3" filename="test3.html">
<title>XBEL Bookmarks</title>
<summary>XBEL Bookmark test</summary>
</tocentry>
from the toc, it tries to go on line.
Phew. Not bad for me. 2 hours and I have HTML!
Comments on the results:
1. The link to the text only version, txtindex.html, is invalid,
is that a build option?
Rest looks fine!
Great build Norm.
Now to see if I can do it on my stuff!
Biggest change will be directory layout.
I copied yours once, though the XSL additions I guess I made
a bad guess at where you were going to put them!
Given
nw
docbook
etc - std docbook 412 dtd
where would you expect to see the XSL please? Inside docbook?
and where does the website sit relative to this?
Are you happy that the two dtd's stay in the website area?
Again I suppose its a catalog thing?
Regards DaveP