[site] URLs, xdocs, references

[Leo Simons <ma...@leosimons.com>]

Hi gang,

This whole "how do we do URLs for an xdocs website" stuff is interesting. We
were used to the forrest way of doing things (aka being really intelligent
about it), and now we have the anakia way of doing things (aka, at least
currently, ignoring the fact that we're working with URLss completely).

By far the safest way to do all this is to simply forgo the whole relative+
base = absolute and use absolute links everywhere. Failing that, there is the
option to specify the base explicitly (which I put in place) so that it is
trivial to understand what the absolute URL becomes when there is a relative
one given. Failing that, it all becomes a little harder. The next possibility
is to use relative URLs that either start with a '#' (eg are just fragment
identifiers) or with a '/' (eg only use the "host" part of whatever is the
base URL).

I think we're at this last step. So, word of advice:

  in all source xdocs, specify URLs that start either start with

    'http:'
    or with '#'
    or with '/'

does that make sense?

cheers,

Leo


---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org

Re: [site] URLs, xdocs, references

[David Crossley <cr...@apache.org>]

Justin Erenkrantz wrote:
> Leo Simons wrote:
> > This whole "how do we do URLs for an xdocs website" stuff is interesting. We
> > were used to the forrest way of doing things (aka being really intelligent
> > about it), and now we have the anakia way of doing things (aka, at least
> > currently, ignoring the fact that we're working with URLss completely).
> 
> I don't get it - why can't we enable relativise in anakia?  We do it
> for httpd and www.  I've never had to dork with not using .. before. 
> -- justin

I don't know about the "httpd" docs, but the "wwww" docs
do suffer from this same issue as "incubator". Generate the
docs and try to review locally with file:// and links are
broken.

-David

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org

Re: [site] URLs, xdocs, references

[Leo Simons <ma...@leosimons.com>]

On Wed, Feb 15, 2006 at 08:38:13AM -0800, Justin Erenkrantz wrote:
> On 2/14/06, Leo Simons <ma...@leosimons.com> wrote:
> > This whole "how do we do URLs for an xdocs website" stuff is interesting. We
> > were used to the forrest way of doing things (aka being really intelligent
> > about it), and now we have the anakia way of doing things (aka, at least
> > currently, ignoring the fact that we're working with URLss completely).
> 
> I don't get it - why can't we enable relativise in anakia? 

I don't know. Don't look at me. I seem to remember from a few years ago there
were some issues with some website at some point and the solution was to use
maven 1.0 beta 6. Or something. I just patched some things. I'm not an anakia
expert and I don't want to be :-)

- LSD

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org

Re: [site] URLs, xdocs, references

[Justin Erenkrantz <ju...@erenkrantz.com>]

On 2/14/06, Leo Simons <ma...@leosimons.com> wrote:
> This whole "how do we do URLs for an xdocs website" stuff is interesting. We
> were used to the forrest way of doing things (aka being really intelligent
> about it), and now we have the anakia way of doing things (aka, at least
> currently, ignoring the fact that we're working with URLss completely).

I don't get it - why can't we enable relativise in anakia?  We do it
for httpd and www.  I've never had to dork with not using .. before. 
-- justin

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org