forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeff Turner <>
Subject Stylebook goodness (Re: Getting off of Stylebook)
Date Tue, 26 Nov 2002 14:18:28 GMT
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"/>

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

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

  <resource id="xslt4j-current" 
  <resource id="ApacheLicense" 
            title="The Apache Software License, Version 1.1" 
  <resource id="bugzilla"
            title="Bugzilla (the Apache bug database)"

  <human-resource id="sboag"
    name="Scott Boag"

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="">Bugzilla (the Apache bug

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


> Thanks,
> Ted

View raw message