> -----Original Message----- > From: Christopher Lenz [mailto:[EMAIL PROTECTED]] > Sent: 13 January 2003 10:35 > To: Cactus Developers List > Subject: Re: New web site generation and organization > > Vincent Massol wrote: > > Hi, > > > > I've just committed some changed that I hacked while away on vacation > > WRT the web site generation and xdoc files. Here are some more > > information: > > > > - Stylebook has now been removed in favor of pure and straight XSL. We > > have a single stylesheet called document2html.xsl > > > > - Our XSL now supports: > > - arbitrary sub-directories > > - menus that change with subdirectories > > - several levels of sub-menus > > - site map generation (i.e. a page that lists and described all > > topics) > > > > - Here are the changes that have been brought to the xdocs: > > - each xdoc file must now have an id attribute as in: > > <document id="some_unique_id"> > > - this id is used in the navigation.xml file which contains the menu > > definitions for the current directory. Note: If a subdirectory does not > > want to redefine a new menu, it still needs a navigation.xml file but it > > should only contain <navigation/> > > - every page (whether internal or external) is described in a special > > file called sitemap.xml, using its id > > - hrefs must be of the format site:id or ext:id > > For example: > > <link href="site:downloads"> or <link href="ext:junit"> > > where the id is the id of the page > > > > I hope you like it. Please give me your feedback! > > I like it :-) > > Currently, there are a lot of broken links on the pages, because they > haven't been converted to the size:id/ext:id URL format yet... but I > guess you're aware of that ;-)
Could you tell me where? I've tried to convert almost all I knew. BTW, external links will work even when not converted to the ext:id notation. > > Hmm, it'd be nice to have some link-crawling ant task as build step, to > check for broken links... hehe... I knew this one was coming :-). It's actually one of the reason for the sitemap so that we can easily have all the links in one place. > > I also couldn't see the sub-menuing in action. A major revamp of the > menus would probably have the most benefit for the documentation. Normal, I haven't used them yet in what I have committed :-). But the feature is there. > > > Thanks > > -Vincent > > > > Note: A pity jakarta does not have a standard xsl stylesheet like this > > one! Forrest seems very fine but too complex to me (you have to install > > it simply to generate a web site). Agreed, it does more than this > > simplex XSL but for most cases, this XSL should probably be enough. > > Yeah, technology wars stand in the way, mostly :-( -Vincent -- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
