I still find that people are using the full http path for links
within the Wiki... so a link to the next page shows as an external
link instead of an internal link. :-(
Ok, but is that a big problem?
Ultimately it gets the job done, but internal links really should not be
linked using external link syntax - that is more of an issue than using
absolute over relative internal links.
There are not a lot of instances of this, but I bumble across them from
time to time... and I fix them when I see them.
Are
there any "gotchas" that anyone can think of with using relative
links? What about with transcluded content? The User Guides use a
lot of transluded pages....
Where? I only once saw a transcluded content (AFAIR a function reference
page was transcluded in a Calc Guide or something the like)
Transcluded content is difficult to spot since when you read the page,
you cannot tell the content is transcluded and when you edit the page,
you also may not notice, especially if the whole page is transcluded and
you're editing only a section within the transcluded block. I usually
only notice after editing, and saving. At this point you end up at the
original page in the Wiki hierarchy, and not where you expected to be.
As for specifically which pages... well, the Math guide is a good
example (there are more pages with transclusions.. this is one I know of
off the top of my head).
Within the Doc subpages, you find it here:
http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Math_Guide
(with a TOC, license attribution, Category assignment, etc.), but the
"real" page is actually here:
http://wiki.services.openoffice.org/wiki/Getting_Started_with_Math (with
no TOC, and no license or Category applied... hmm this should probably
be fixed).
It's pages like this that I wonder about... what happens with relative
links in cases like this? To the reader, and the editor (depending on
how they edit page content.. ie if you edit a section instead of the
whole page) it appears to be relative to Documentation/OOo3_User_Guides
when it's actually somewhere else. If an editor edits a section of a
transcluded page, and adds a relative link instead of an absolute
link... does it work as expected?
So we should be aware of them but use them only where it really helps.
:-) The same with anything in the Wiki.
It's good to know relative links exist.. I wasn't aware you could do
this until you brought it up.
C.
--
Clayton Cornell [email protected]
OpenOffice.org Documentation Project co-lead
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
