cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeremy Quinn <jer...@media.demon.co.uk>
Subject Re: [vote] Diana Shannon as Documentation Coordinator
Date Sun, 21 Apr 2002 15:48:58 GMT
At 17:44 +0200 16 04 2002, Christian Haul wrote:
>One thing that bugs me especially is links between docs. Currently
>this is done by pointing to the place the generated HTML will end
>up. Would be great if we could do better (no idea though, XPointer?)

We might try XLink, we could get something like a shared link glossary.

We could write 'arcs' in the documents that reference 'locators' in a
LinkBase, the shared repository of link information; I do this on a couple
of sites with XInclude and XSLT, though you could formailse it and write a
Transformer to do it.

In the documents:

	Go to <link xl:to="samples.xmldb"/> and try some out.

	or with over-ride:

	See this <link xl:to="samples.xmldb">AMAZING</link> stuff!

In the linkbase (authors register their documents' link here):

	<loc
		xl:label="samples.xmldb"
		xl:href="/samples/apps/xmldb/welcome"
		xl:title="Samples of Cocoon's XML:DB capabilities">
			<name>XML:DB Samples</name>
	</loc>

(You need to arrange for the tags to get a few more xlink attributes added
to them, via a DTD etc. specially xl:type="arc|locator|title")

There are different ways of arranging the processing of these documents
together. I have not done one like this before, but I reckon if you wanted
links to work across sub-sitemaps, you would probably want to reference all
loc/@xl:href's from a standard location, like inside the top level sitemap,
then you would have to pass the portion of the url being requested (from
that standard location) to the Xlink XSLT so it could make relative links.
I'm not sure this is possible at the moment.

At <http://www.hrc.wmin.ac.uk/KISS/>, I do it the other way around, I use a
'LinkMap', as the basis for generating the site, where the navigational
hierarchy is defined by a set of nested XLink locators, urls consist
entirely of the XLink label, so there is no mucking about with relative
paths for the browser. But this does not work so well for static rendered
docs ....

regards Jeremy
-- 
   ___________________________________________________________________

   Jeremy Quinn                                           Karma Divers
                                                       webSpace Design
                                            HyperMedia Research Centre

   <mailto:sharkbait@mac.com>     		 <http://www.media.demon.co.uk>
   <phone:+44.[0].20.7737.6831>             <pager:jermq@vizzavi.net>

---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


Mime
View raw message