2

我的 POD 文档中有以下行：

This is taken by the L<< Promoted Build
Plugin|https://wiki.jenkins-ci.org/display/JENKINS/Promoted+Builds+Plugin
>> C<$PROMOTED_JOB_NAME> environment variable.

我希望将其格式化为：

This is taken by the 
<a href="https://wiki.jenkins-ci.org/display/JENKINS/Promoted+Builds+Plugin">
Promoted Builds Plugin</a> <code>$PROMOTED_JOB_NAME</code>
environment variable.

但是，当我运行时pod2html，我收到以下错误：

/usr/bin/pod2html: jdescribe.pl: cannot resolve 
L<Promoted Build Plugin|https://wiki.jenkins-ci.org/display/JENKINS/Promoted+Builds+Plugin>
 in paragraph 46.

根据Perlpod文档和Perlpodspec文档，这应该是正确的。或者，至少在我看来是这样的。

我究竟做错了什么？

顺便说一句，这些链接确实适用于pod2markdown.

4

1 回答 1

2

就像已经假设的可选一样，您的 pod2html 太旧了。在 perl 5.14.x 和 perl 5.16.x 之间的某个时间点，事情开始起作用了。

为了解释这一点：在过去，该构造L<text|href>是被禁止的。这样做的原因是，如果仅显示链接文本，非超文本 Pod 渲染器（例如 pod2text）会丢失信息。此提交在 perlpodspec.pod 中删除了此禁令：

commit f6e963e4dd62b8e3c01b31f4a4dd57e47e104997
Author: Ricardo Signes <rjbs@cpan.org>
Date:   Mon Dec 7 18:19:28 2009 -0500

    remove prohibition against L<text|href>

如今，pod2text 显示的链接如text <href>. 并且 pod2html 现在也能够创建真正的链接。

如果您无法切换到较新版本的 pod2html，那么您必须限制为没有文本部分的链接，例如L<http://wiki.jenkinsci.org/display/JENKINS/Promoted+Foo+Bar>.

于 2013-07-04T09:20:43.680 回答