7

The L<name> formatting code allows you to set the display text for the link if you're linking to other POD, as in L<Display Text|link_dest>, but this isn't allowed for L<scheme:...> links, such as

L<http://perldoc.perl.org/strict.html>

How do I specify a display text for such links? Alternatively, how do I manually write such a link without the angle brackets being HTML entitized by pod2html?

4

4 回答 4

6

正确的格式是这样的：

L<strict|http://perldoc.perl.org/strict.html>

另请参阅http://justatheory.com/computers/programming/perl/sane-pod-links.html

于 2013-03-28T20:18:01.670 回答
2

如果你想用你的 Pod 做一些花哨的事情，写一个 Pod 翻译器真的很容易。Pod::Simple 中已经为您完成了大部分工作，因此您只需处理L<>. Mastering Perl中有一章是关于它的。

于 2009-08-23T18:25:21.477 回答
1

http://perldoc.perl.org/perlpod.html#Formatting-Codes

L<<a href="http://www.perl.org/">http://www.perl.org/</a>>

正如您所指出的，看起来这应该可行，但也许我误解了您的问题？

编辑：似乎 pod2html 不喜欢这种方法。
我在以下位置找到了一个稍微复杂的解决方案，

https://web.archive.org/web/1/http://blogs.techrepublic%2ecom%2ecom/howdoi/?p=114


#!/usr/bin/perl                                                                                                              
use strict;
use warnings;
use Pod::2::html;


my $pod_file =  $ARGV[0];
my $template =  $ARGV[1];

# Create pod2html object                                                                                                    
my $pod = Pod::2::html->new($pod_file);

# The path to the HTML template                                                                                             
$pod->template($template);

# The formatted HTML will go to STDOUT                                                                                      
$pod->readpod();

我对此进行了测试，插入通用 html 似乎没有问题，因此您实际上根本不需要 th L<> 标记。这对我来说似乎是一个不错的解决方案。

于 2009-08-23T03:51:06.597 回答
1

你离得太近了！您在尖括号和 URL 之间缺少必需的空格。尝试这个：

I think L<< http://example.com >> is the best site on the web!

根据（从此处perldoc perlpod向下滚动以找到它），额外的空间是强制性的：

“一种更易读，也许更“简单”的方法是使用一组不需要单个“>”来转义的分隔符。对于从 perl5.5.660 开始的标准 Pod 格式化程序，双尖括号("<<" 和 ">>") 当且仅当在开始分隔符之后有空格并且在结束分隔符之前有空格时才可以使用！例如，以下将起作用："

       C<< $a <=> $b >>
于 2010-10-02T01:30:56.363 回答