Stylebook goodness (Re: Getting off of Stylebook)

[Jeff Turner <je...@apache.org>]

On Mon, Nov 25, 2002 at 04:26:46PM -0800, Ted Leung wrote:
...
> I would love to see some other projects move from Stylebook to Forrest.
> One thing that would really help those of us in the other projects
> would be a set of stylesheets that we could use to convert our
> stylebook documentation into Forrest documentation.  Is there a plan to
> do something like that?

It looks like Stylebook has some nice features that Forrest lacks:

1) The 'book.xml' can be specified, allowing various sites to be
generated from a single set of sources.  Eg, xalan-jlocal.xml and
xalan-jsite.xml generate slightly different sites, one for local use, one
for the website.

2) From Xalan's xdocs/sources/xalan-jlocal.xml:

<book title="Xalan XSL Transformer User's Guide" copyright="2002 The Apache Software Foundation">
  <resources source="sbk:/sources/xalan/resources.xml"/>
  ...
</book>

And then xalan/resources.xml contains links to 'resources':

<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE resources [
  <!ENTITY % externalEntity SYSTEM "../entities.ent">
  %externalEntity;
  ...
  ]>

<resources>
  <resource id="xslt4j-current" 
    title="&xslt4j-current;" 
    location="http://xml.apache.org/xalan-j"/>
  <resource id="ApacheLicense" 
            title="The Apache Software License, Version 1.1" 
            location="http://xml.apache.org/dist/LICENSE.txt"/>
  <resource id="bugzilla"
            title="Bugzilla (the Apache bug database)"
            location="http://nagoya.apache.org/bugzilla"/>
  ...

  <human-resource id="sboag"
    name="Scott Boag"
    mailto="scott_boag@us.ibm.com"/>
  ...
</resources>


Then XML files can have stuff like:

All known &xslt4j; bugs are listed in <resource-ref idref="bugzilla"/>.

That expands to:

All known Xalan-Java bugs are listed in <a
href="http://nagoya.apache.org/bugzilla">Bugzilla (the Apache bug
database)</a>.


Pretty neat :)  Seems like Forrest has some way to go before equalling
Stylesbook functionality.


--Jeff

> Thanks,
> 
> Ted