forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Steven Noels <>
Subject Re: [VOTE] Adopt site: linking
Date Tue, 07 Jan 2003 19:09:39 GMT
Jeff Turner wrote:

> Hi,
> On the LINKMAP_BRANCH, I'm at the stage where things are fairly stable,
> and ready to be integrated into the trunk.  Since there are some big
> changes here, I thought this would be a good time to introduce them all
> and [VOTE] on their inclusion.
>>>From a user's POV, the following changes are apparent:
> 1) There's a new file, src/documentation/content/xdocs/site.xml,
> containing an XML map of the website contents.

You know my feelings towards the format of that file, but since it is 
easily adaptable, we let the user decide.

> 2) book.xml's are no longer necessary, but are supported for
> backwards-compatibility.  Normally, menus are now generated directly from
> site.xml.

After setting up some weeks ago, 
and working currently on a new release of, I can only 
say: which I had this sooner ;-)

> 3) You can now use <link href="site:xyz"> to link to xyz.html, providing
> the xyz node is defined in site.xml.  These site: links work wherever the
> linkee or linker are located.  Actually, 'xyz' could identify almost
> anything: a directory, a file, an #anchor node, or an external http: URL.
> It's now Forrest's job to resolve that.


> 4) You can use <link href="ext:abc"> as an aliasing mechanism for
> external URLs defined in site.xml.  Useful for hard-to-remember URLs or
> those used in multiple places.


> 5) Advanced users (people who can configure InputModules) can define
> their own linking schemes.
> I've documented the system from a user and developer POV at
> That doc will have plenty of typos and stupid mistakes, as I haven't
> proof-read it yet.


> As I told Robert off-list, the site.xml format is very much a first cut,
> "simplest thing that works" affair, which at some stage we can replace
> with a decent RDF + dublin core system, more like the LSB site.xml.

Great piece of work, Jeff.

Big +1

Steven Noels                  
Outerthought - Open Source, Java & XML Competence Support Center
Read my weblog at  
stevenn at                stevenn at

View raw message