PerlPod - 鏈接似乎沒有工作

我有下面這行我的POD文檔中：PerlPod - 鏈接似乎沒有工作

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.

Accordin g到Perlpod文檔和Perlpodspec文檔，這應該是正確的。或者，至少它對我來說是這樣。

我在做什麼錯？

順便說一句，鏈接確實與pod2markdown工作。

來源

2013-05-28 David W.

'podchecker'對它做了什麼？ – Zaid

如果將'「+」轉換爲「」％2B「'會發生什麼？ – Zaid

@Zaid Podchecker沒問題，把'+'改成'％28'沒有任何作用。它也將它的cookies轉儲到'L <[email protected] | mailto：[email protected]>'上。再一次'pod2markdown'對兩者都很好。 –

可選一樣已經假定，你pod2html太舊。事情開始在perl 5.14.x和perl 5.16.x之間的某個時間點工作。

爲了解釋這一點：在舊的天，構建L<text|href>被禁止。原因在於，如果僅顯示鏈接文本，則非超文本Pod渲染器（例如pod2text）將丟失信息。這一禁令在perlpodspec.pod除去與此提交：

commit f6e963e4dd62b8e3c01b31f4a4dd57e47e104997 
Author: Ricardo Signes <[email protected]> 
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-04 09:20:43

PerlPod - 鏈接似乎沒有工作

回答

相關問題