stas at stason
Jan 24, 2002, 11:41 AM
Post #1 of 1
(327 views)
Permalink
|
|
a problem with internal linking functionality
|
|
There is one last big things I need to do before we can start wrapping
up. It's the internal linking (talking about L<>). This is a very
complicated problem and I still didn't figure out how to do this in the
best way. Remember that each doc should be able to link to another doc
potentially located in a completely different directory. Currently I'm
thinking that each doc must use something like this
L<Title|docs::2.0::api::mod_perl-2.0::Apache::ServerUtil/"whatever">
which is a hell to type, but makes things so easy from the maintenance
point of view. If we don't use a full path, it's possible that two docs
have the same end file name, so doing a search in the file tree may be
not an option :(
Also have to decide what to do about the new layout I started to use:
devel/testing/testing.pod
instead of just
devel/testing.pod
This is done so you can put images and other static objects and code
related to this specific document without messing up with other
documents. But that also means that we need to do something like:
L<Apache::Test framework|docs::2.0::devel::testing::testing/"whatever">
see the duplication? I guess I could resolve it in the code, but what if
later we decide that there could be another doc residing in the same dir
with testing.pod :9
So I'm still thinking and if you have ideas on how to approach this
problem easier please tell me.
_____________________________________________________________________
Stas Bekman JAm_pH -- Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide http://perl.apache.org/guide
mailto:stas [at] stason http://ticketmaster.com http://apacheweek.com
http://singlesheaven.com http://perl.apache.org http://perlmonth.com/
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe [at] perl
For additional commands, e-mail: docs-dev-help [at] perl
|
