Vincent Massol wrote:
I like it :-)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!
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 ;-)
Hmm, it'd be nice to have some link-crawling ant task as build step, to check for broken links...
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.
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 :-( -- Christopher Lenz /=/ cmlenz at gmx.de -- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
