Re: [Scrollkeeper-devel] Handling relocatable packages

[Nik C. <ni...@no...>]

Chaps,

Two things, while I remember.

First;

On Mon, Nov 20, 2000 at 09:20:47PM +0000, Nik Clayton wrote:
> DD:  sk should include some support applications that can generate TOC and
>      Index information from a variety of source formats.

<snip>

> Generate TOC and Index
> 
>   sk-generate-toc -format html -db /var/db/master.xml
> 
>   sk-generate-index -format html -db /var/db/master.xml
> 
>   I'll hand wave over these.  Again, they should be cron'able, and probably
>   need to support various different output formats.

Done properly, this should be trivial, using XSLT.

Second;

/var/db/master.xml (or whatever it is) should not (contrary to my message)
handle the grouping of documents in to categories.  By that I mean that
it shouldn't do

    <sect>
      <title>Apps</title>
        <sect>
          <title>Xemacs</title>

          <doc>...</doc>
          <doc>...</doc>
          <doc>...</doc>
        </sect>
 
        ...
    </sect>

Why?  Because then it's a pain in the backside to have the same document 
appear in multiple categories, as you have to list it twice.  Instead,
the format should be more like:

   <doc docid="...">
     <docinstance .../>

     <category>Applications</category>
     <category>Editors</category>
     <category>Lisp</category>
   </doc>

This can then be arranged in to groupings by the same process that generates
the TOC and Index.

Supporting a hierarchy of categories is an exercise left for the reader :-)

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery