OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: Re: DOCBOOK: Announce: Website 2.0a1 (ALPHA) released


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



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC