如何在 Pod 的 L 中添加带有 URL 的链接文本？

Question

如果您要链接到其他 POD，则 L 格式化代码允许您设置链接的显示文本，如 L 中所示，但这对于 L 链接是不允许的，例如

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

如何为此类链接指定显示文本？或者，如何手动编写这样的链接，而无需由 pod2html 实体化的 HTML 尖括号？

Answer 1

正确的格式是这样的：

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

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

Answer 2

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

Answer 3

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，这样您实际上就不需要 L<> 了。根本没有标签。
这对我来说似乎是一个不错的解决方案。

Answer 4

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

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

根据 perldoc perlpod ，额外的空间是强制性的（从

“一种更具可读性，也许更“简单”的方法是使用一组备用分隔符，不需要转义单个“>”。使用以标准开头的 Pod 格式化程序perl5.5.660，当且仅当开始分隔符后面有空格且结束分隔符之前有空格时，才可以使用双尖括号（“<<”和“>>”），例如，以下！就可以了：”

       C<< $a <=> $b >>