Gentoo Archives: gentoo-doc

From: Sven Vermeulen <swift@g.o>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] Project-specific documentation and dynamic documentation index
Date: Sun, 28 Nov 2004 13:54:55
In Reply to: Re: [gentoo-doc] Project-specific documentation and dynamic documentation index by Xavier Neys
On Fri, Nov 26, 2004 at 07:16:42PM +0100, Xavier Neys wrote:
> The only reason gorg makes it an error 500 is that AxKit does.
> Missing document()'ed files can be tested in xsl if needed:
We /can/ develop some XSL magic so that AxKit doesn't 500 as well. It's ugly and I don't want to be the person that implemented it (I'd rather see AxKit go away), but the possible workaround is: 1. In en/metadoc.xml, define additional entities for each location... <!ENTITY CEEnglishMain SYSTEM "CVS/Entries"!> <!ENTITY CEEnglishHandbook SYSTEM "handbook/CVS/Entries"!> ... <!ENTITY CEInfraMain SYSTEM "/proj/en/infrastructure/CVS/Entries"!> 2. In en/metadoc.xml, have a location that places all this information on-loading: <metadoc> ... <allfiles> <listing location="/doc/en">&CEEnglishMain;</listing> <listing location="/doc/en/handbook">&CEEnglishHandbook;</listing> ... <listing location="/proj/en/infrastructure">&CEInfraMain;</listing> </allfiles> ... </metadoc> 3. In inserts.xsl, create two functions (func:basename and func:dirname) that return the basename of a url and the dirname 4. In metadoc.xsl, first verify if func:basename($fileurl) occurs in document($metadoc)/allfiles/listing[@location == func:dirname($fileurl)] before document()'ing it Okay, just to say that it "is" possible... probably ;) -- Documentation & PR project leader The Gentoo Project <<< >>>