On Monday 30 November 2009 09:26, ccornell - OpenOffice.org wrote: > > But that's not what I meant. What I meant is like in the file > > system: absolute paths start at the root. So e.g. (imaginary) > > [[Documentation/UserGuide/GettingStarted/chapter1]] > > is an absolute path, while relative paths start with the present > > document's path, so to link to the above Page from another chapter, > > let's say from > > [[Documentation/UserGuide/GettingStarted/chapter2]] > > you can simply write [[../chapter1]] > > Relative links are not used because hardly anyone knows about them.
That was my impression, too, therefore I started to spread the word :-) > 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? > > The only discrepancy is that path names starting with a slash are > > interpreted as childs from the present document. So from the page > > [[Documentation/UserGuide/GettingStarted]] > > the link > > [[/chapter1]] and [[/chapter2]] lead to the above subpages (and > > do not represent absolute pathnames like in dos or unix filesystem > > naming conventions). > > Mmmm within the Wiki structure, this makes sense though. The base > page should never be slash something (have a leading slash). Some > people, myself included, have created base pages with a leading > slash, and it creates all sorts of interesting problems. > > I can see how using relative links would help with translations. Maybe Templates could be reused better for different languages (just a guess, I did not think about it in depth) > 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) > Changing existing pages over... ouch. Not sure the WikiBot can > handle this. Doing it manually would be a painful process. Ideas? From my point of view: * relative links can be helpful for certain purposes. * in most cases, however, normal internal links with the full page path are ok. So we should be aware of them but use them only where it really helps. My own experience with relative links comes from MoinMoin as there are some nice builtin features (like a subpage navigation bar which updates automatically on any subpage creation - just like dpl but with much simpler syntax). I started to use relative links in the DE/WriterGuideTOC Template as I prepared the whole page tree under my own User Page and only later moved it to its final place. This could be done without changing anything but the starting point. Nino --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
