You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@forrest.apache.org by Nicola Ken Barozzi <ni...@apache.org> on 2003/02/23 00:19:20 UTC
[Fwd: avalon-phoenix... sitemap.xmap] Disable link traversing
Jeff, it seems that there is a real need for this. More than once it has
been pointed out to me, but I have yet failed to grasp the real need.
Could you please explain it a bit? It seems to me that it should be in
Forrest proper, and I'd like to make it into a more generic feature.
Also, I'll write here a couple of points that I forgot to follow up on:
o Cocoon should not generate an error page for the falied links;
if we deploy it, a linkchecker would not find broken links,
which is obviously wrong
o We should have an online and offline mode for the linkmap, so that
a semantic link changes wether the user is online or offline
-------- Original Message --------
Subject: cvs commit: avalon-phoenix/src/documentation sitemap.xmap
Date: 22 Feb 2003 14:27:15 -0000
From: jefft@apache.org
Reply-To: Avalon Developers List <de...@avalon.apache.org>
To: avalon-phoenix-cvs@apache.org
jefft 2003/02/22 06:27:15
Added: src/documentation sitemap.xmap
Log:
With great reluctance, add a custom sitemap so we can prevent certain
links (listed in resources/stylesheets/avfilterlinks.xsl) from being
traversed.
--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
Re: [Fwd: avalon-phoenix... sitemap.xmap] Disable link traversing
Posted by Nicola Ken Barozzi <ni...@apache.org>.
Jeff Turner wrote, On 23/02/2003 2.38:
> On Sun, Feb 23, 2003 at 12:19:20AM +0100, Nicola Ken Barozzi wrote:
>
>>Jeff, it seems that there is a real need for this. More than once it has
>>been pointed out to me, but I have yet failed to grasp the real need.
>
> It's pretty simple: links to anything 'outside' Forrest (like
> not-yet-generated Javadocs) break. The 'real need' is that people don't
> want Forrest controlling the whole URI space. They want to manually (or
> with Ant) merge docs from multiple sources, one of which is Forrest.
>
>>Could you please explain it a bit? It seems to me that it should be in
>>Forrest proper, and I'd like to make it into a more generic feature.
>
> Yes it should be. Probably the CLI should be pointed to a list of URI
> prefixes that are not to be traversed.
I usually said: who cares, let the link break and overwrite the error
page. Or not make the error page come out with the CLI (working on it).
The fact is that (IIUC) those pages are not broken, and should not be
treated as such.
Ok, since I'm also looking into the resourceMap (the source version of
the linkmap), I'll see if it can be merged into this.
>>Also, I'll write here a couple of points that I forgot to follow up on:
>>
>> o Cocoon should not generate an error page for the falied links;
>> if we deploy it, a linkchecker would not find broken links,
>> which is obviously wrong
>
> True
>
>> o We should have an online and offline mode for the linkmap, so that
>> a semantic link changes wether the user is online or offline
>
> If all the paths are relative, why should it matter whether the user is
> offline or online?
Good question.
The fact is that with Avalon, we want the online docs to reference the
Gump javadocs, while reference the statically generated ones in the
local documentation.
Maybe it's a wrong solution to the need, any other ideas?
Example in site.xml:
<javadocs label="Javadocs"
offline="javadocs/index.html"
href="http://nagoya.apache.org/gump/javadocs/somewhere"/>
--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
Re: [Fwd: avalon-phoenix... sitemap.xmap] Disable link traversing
Posted by Jeff Turner <je...@apache.org>.
On Sun, Feb 23, 2003 at 12:19:20AM +0100, Nicola Ken Barozzi wrote:
>
> Jeff, it seems that there is a real need for this. More than once it has
> been pointed out to me, but I have yet failed to grasp the real need.
It's pretty simple: links to anything 'outside' Forrest (like
not-yet-generated Javadocs) break. The 'real need' is that people don't
want Forrest controlling the whole URI space. They want to manually (or
with Ant) merge docs from multiple sources, one of which is Forrest.
> Could you please explain it a bit? It seems to me that it should be in
> Forrest proper, and I'd like to make it into a more generic feature.
Yes it should be. Probably the CLI should be pointed to a list of URI
prefixes that are not to be traversed.
> Also, I'll write here a couple of points that I forgot to follow up on:
>
> o Cocoon should not generate an error page for the falied links;
> if we deploy it, a linkchecker would not find broken links,
> which is obviously wrong
True
> o We should have an online and offline mode for the linkmap, so that
> a semantic link changes wether the user is online or offline
If all the paths are relative, why should it matter whether the user is
offline or online?
--Jeff