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 に答える