forrest-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ferdinand Soethe <samm...@soethe.net>
Subject Re: Plugging into a site.xml
Date Wed, 16 Mar 2005 06:14:05 GMT
Hi Arik,

AK> We are writing software that utilizes Forrest and generates a complete
AK> Forrest documentation project from some outside data. The only thing
AK> that is provided from outside our software is the menu structure and

Check out this example from a recent thread

      Q: Integrate multipage externally generated content

It shows how to use x-include to insert buildingblocks into an
existing site.xml.

What I don't know/ haven't asked if this works with tabs as well, but
you could always ask Sjur.


Sjur Moshagen <sjurnm@mac.com> wrote:

> In site.xml:
>
> <site xmlns="http://apache.org/forrest/linkmap/1.0" href=""
> label="MyProj" tab="" >
>      <about label="Home" tab="Home" >
>          <index   href="index.html" label="Index" description="Welcome
 divvun.no" />>
>          <changes href="changes.html" label="Changes" description="The
ojects history" />>
>          <todo    href="todo.html" label="Todo" description="The plan
r the project" />>
>      </about>
>
>      <xi:include href="doc/site-frag.xml#xpointer(/tech/*)"
> xmlns:xi="http://www.w3.org/2001/XInclude"/>
>
> </site>
>
>
> In site-frag.xml:
>
> <?xml version="1.0" encoding="UTF-8"?>
> <tech>
>    <techdoc href="doc/" label="Technical doc" tab="TechDoc">
>      <index href="intro.html" label="Introduction" />
>    </techdoc>
>    <!-- add entries ad lib just as in site.xml -->
> </tech>
>
> The same for tabs.xml and tabs-frag.xml.
>
> The outer element in both fragment files are required to make the files
> valid XML files. Hence the reference to the content of that element in
> the XInclude.
>
> It works like a charm, and having the full power of XInclude makes for
> a very flexible solution.
>
> Sjur


Regards
Ferdinand Soethe


Mime
View raw message