You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs-dev@perl.apache.org by Bill Moseley <mo...@hank.org> on 2002/04/25 05:42:33 UTC
L links?
I had a few minutes, so I converted the src/start/tips from html to pod.
But, I'm not understanding how to make the L<> links work correctly. Can
someone help?
For example, what's the correct way to write:
L<mod_perl FAQs|"../../docs/1.0/faqs/index.html">
or (can I do something like)?
L<The Guide|guide::config.html/toc_Apache_Configuration_in_Perl>
BTW -- does Opera 6.1 on Windows do what IE does and ignore
content-type?!?! If I click on the src link Opera shows my new pod files
as text/html! My server is returning text/plain. Other src links work ok,
so maybe it's the embedded HTML that I'm using (=for html) that's confusing
Opera? I hope it's something I've got set up wrong, but other clients work
ok.
Oh, also, I'm still not thrilled about the example. For the "Gain access
to all request stages" section there's an example that is a PerlLogHandler
that sends email when /private is accessed. That's a dumb example. So if
you look go favicon.html instead of logging.html
http://mardy.hank.org:5000/start/tips/favicon.html
it's a much more useful example, but not very interesting. Should I use
the favicon example instead of the logging email example?
Oh, and the L<modperlcookbook.com> link doesn't work right either, there.
Geoff recommended using that example, but I haven't asked permission to use
it yet.
--
Bill Moseley
mailto:moseley@hank.org
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: L links?
Posted by Stas Bekman <st...@stason.org>.
Bill Moseley wrote:
> See L<The Guide|guide::config.html/toc_Apache_Configuration_in_Perl>
> for other examples of configuring Apache with mod_perl.
s/guide::config.html/guide::config/
> But that doesn't work. Is docset suppose to fixup the "guide::" link?
yes, and it's cross docset, it does a search in its virtual @INC defined
in src/config.cfg.
> Also, how do I create off-site (full URL) link with L<>?
>
> One thing I don't like about using pod here is it's making my (only) =head1
> a link to a TOC entry that doesn't exist (since there's only one head
> there's no TOC). Can that be fixed?
well, earlier we decided not to create TOC if there is only one item. We
can revert that, if that what you mean.
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: L links?
Posted by Per Einar Ellefsen <pe...@skynet.be>.
At 07:43 25.04.2002, Bill Moseley wrote:
>On Thu, 25 Apr 2002 07:24:17 +0200 Per Einar Ellefsen wrote:
>
> > >See L<The Guide|guide::config.html/toc_Apache_Configuration_in_Perl>
> > >for other examples of configuring Apache with mod_perl.
> > >
> > >But that doesn't work. Is docset suppose to fixup the "guide::"
> > >link?
> >
> > Yes, it's supposed to do that. But you should drop the ".html" part
> > too, so you're only left with L<The
> > Guide|guide::config/Apache_Configuration_in_Perl>
>
>Still doesn't seem to work. Could it be because they are "hidden"?
>Different docsets should not matter, right?
No, as Stas said, it doens't matter. Have you checked if just
L<guide::config> works?
> > >Also, how do I create off-site (full URL) link with L<>?
> >
> > By putting the URL with http:// somewhere. You can't link a word
> > offsite though :( Should be fixed by the U<> escape Stas suggested.
>
>Hum, maybe HTML source is the way to go after all for these small files?
I'd really like to have them in Pod. But if it's really too much of a
hassle, just go ahead with HTML. I won't insist :)
--
Per Einar Ellefsen
per.einar@skynet.be
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: L links?
Posted by Bill Moseley <mo...@hank.org>.
On Thu, 25 Apr 2002 07:24:17 +0200 Per Einar Ellefsen wrote:
> >See L<The Guide|guide::config.html/toc_Apache_Configuration_in_Perl>
> >for other examples of configuring Apache with mod_perl.
> >
> >But that doesn't work. Is docset suppose to fixup the "guide::"
> >link?
>
> Yes, it's supposed to do that. But you should drop the ".html" part
> too, so you're only left with L<The
> Guide|guide::config/Apache_Configuration_in_Perl>
Still doesn't seem to work. Could it be because they are "hidden"?
Different docsets should not matter, right?
> >Also, how do I create off-site (full URL) link with L<>?
>
> By putting the URL with http:// somewhere. You can't link a word
> offsite though :( Should be fixed by the U<> escape Stas suggested.
Hum, maybe HTML source is the way to go after all for these small files?
--
Bill Moseley
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: L links?
Posted by Per Einar Ellefsen <pe...@skynet.be>.
At 06:41 25.04.2002, Bill Moseley wrote:
>At 12:19 PM 04/25/02 +0800, Stas Bekman wrote:
> >> L<The Guide|guide::config.html/toc_Apache_Configuration_in_Perl>
> >
> >yes this works, but drop the toc_
>
>Oh, right. We talked about that.
>
>If you look at the bottom of:
>
> http://mardy.hank.org:5000/start/tips/config.html
>
>I have:
>
>See L<The Guide|guide::config.html/toc_Apache_Configuration_in_Perl>
>for other examples of configuring Apache with mod_perl.
>
>But that doesn't work. Is docset suppose to fixup the "guide::" link?
Yes, it's supposed to do that. But you should drop the ".html" part too, so
you're only left with L<The Guide|guide::config/Apache_Configuration_in_Perl>
Hope that helps.
>Also, how do I create off-site (full URL) link with L<>?
By putting the URL with http:// somewhere. You can't link a word offsite
though :( Should be fixed by the U<> escape Stas suggested.
--
Per Einar Ellefsen
per.einar@skynet.be
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: L links?
Posted by Bill Moseley <mo...@hank.org>.
At 12:19 PM 04/25/02 +0800, Stas Bekman wrote:
>> L<The Guide|guide::config.html/toc_Apache_Configuration_in_Perl>
>
>yes this works, but drop the toc_
Oh, right. We talked about that.
If you look at the bottom of:
http://mardy.hank.org:5000/start/tips/config.html
I have:
See L<The Guide|guide::config.html/toc_Apache_Configuration_in_Perl>
for other examples of configuring Apache with mod_perl.
But that doesn't work. Is docset suppose to fixup the "guide::" link?
Also, how do I create off-site (full URL) link with L<>?
One thing I don't like about using pod here is it's making my (only) =head1
a link to a TOC entry that doesn't exist (since there's only one head
there's no TOC). Can that be fixed?
>> it's a much more useful example, but not very interesting. Should I use
>> the favicon example instead of the logging email example?
>
>yes, looks good and it's shorter. I also liked that <<back brings you
>back to the para you left off at :)
Ok, favicon it is.
--
Bill Moseley
mailto:moseley@hank.org
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: L links?
Posted by Stas Bekman <st...@stason.org>.
Bill Moseley wrote:
> I had a few minutes, so I converted the src/start/tips from html to pod.
>
> But, I'm not understanding how to make the L<> links work correctly. Can
> someone help?
>
> For example, what's the correct way to write:
>
> L<mod_perl FAQs|"../../docs/1.0/faqs/index.html">
this is illegal POD.
> or (can I do something like)?
>
> L<The Guide|guide::config.html/toc_Apache_Configuration_in_Perl>
yes this works, but drop the toc_
> BTW -- does Opera 6.1 on Windows do what IE does and ignore
> content-type?!?! If I click on the src link Opera shows my new pod files
> as text/html! My server is returning text/plain. Other src links work ok,
> so maybe it's the embedded HTML that I'm using (=for html) that's confusing
> Opera? I hope it's something I've got set up wrong, but other clients work
> ok.
>
> Oh, also, I'm still not thrilled about the example. For the "Gain access
> to all request stages" section there's an example that is a PerlLogHandler
> that sends email when /private is accessed. That's a dumb example. So if
> you look go favicon.html instead of logging.html
>
> http://mardy.hank.org:5000/start/tips/favicon.html
>
> it's a much more useful example, but not very interesting. Should I use
> the favicon example instead of the logging email example?
yes, looks good and it's shorter. I also liked that <<back brings you
back to the para you left off at :)
> Oh, and the L<modperlcookbook.com> link doesn't work right either, there.
> Geoff recommended using that example, but I haven't asked permission to use
> it yet.
I guess that shouldn't be a problem :)
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org