Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Sven Vermeulen <swift@g.o>
Subject: Re: Project-specific documentation and dynamic documentation index
Date: Sun, 28 Nov 2004 14:54:39 +0100
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   <<< http://www.gentoo.org >>>
Attachment:
pgp0uD2Wh1W57.pgp (PGP signature)
References:
Project-specific documentation and dynamic documentation index
-- Sven Vermeulen
Re: Project-specific documentation and dynamic documentation index
-- Xavier Neys
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: Project-specific documentation and dynamic documentation index
Next by thread:
Delivered Message (gentoo-doc@g.o)
Previous by date:
Re: Handbook translations in Japanese
Next by date:
overview-dyn not showing up correct


Updated Jun 17, 2009

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.