forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Sylvain Wallez <>
Subject Re: Referring to ressources and Topic Maps
Date Thu, 30 May 2002 13:21:35 GMT
J.Pietschmann wrote:

> Hello forresters,
> while writing some FAQ stuff I got a few questions about the DTDs and
> style sheets.
> The first problem is that I refer to various ressources, both
> documents within the project and external URLs. I'm somewhat uneasy to
> hardcode the URL in a <jump href="..."> everywhere for two reasons:
> 1. Internal projects: A href refers to a .html document, which is not
>    appropriate if a PDF booklet is built from the xdocs. The link
>    should refer to an abstract ressource name which is mapped onto a
>    HTTP URL during the final HTML generation. In a booklet it
>    could/should be transformed into an internal PDF link.
> 2. External URLs: These have often a tendency to change, even if
>    slightly only. Going through all documents and replace the URLs
>    after a spec is updated to a new version or a FAQ has been moved
>    seems to be a drudgery that ought to be avoided.
> Interestingly, some (many?) projects already have a ressources.xml
> document, which lists URLs and some descriptions, possibly structured
> in sections.
> My idea was to formalize the ressources.xml into providing a mapping
> from abstract ressource names to URLs, both for internal and external
> ressources. This sounds like a topic map. However, a formal topic map
> lacks a section structure and inline description.
>  A synthesis could be to use a topic map which defines abstract names
> and points into the xdoc sources for internal ressources and defines
> the hrefs for external URLs. The point is that the topic map is to be
> used for resolving the abstract names into <a href=".."> links during
> HTML generation. The ressources.xml also pulls in URLs from the topic
> map as all other documents.
> (topic maps:
> Some sample code how this could look like:
>  ...look into the <topic name="XSL FAQ">XSL FAQ</topic> ...
>  ...check <topic name="limitations">FOP limitations</topic> for...
>  ...the problem is that there are <topic
>    name="inline-background-not-implemented">limitations</topic> for
>     specifying ...

Thinking out loud...
It looks like the XML version of a Wiki text. Could it be possible that 
a set of xdocs and the associated topic map could be automatically 
generated from a Wiki base ?


Sylvain Wallez
  Anyware Technologies                  Apache Cocoon 

View raw message