1

次のようなPODがあります

=head2 C<close() on unopened filehandle %s>

=over

=item C<Yer tryna close() %s what ain't been opened yet>

=back

pod2htmlコマンドはそれを

<h2><a name="close____on_unopened_filehandle__s"><a href="#item_close"><code>close () on unopened filehandle %s</code></a></a></h2>
<dl>
<dt><strong><a name="item_close"><code>Yer tryna close() %s what ain't been opened yet</code></a></strong>

</dl>

問題は<a href="#item_close"></a>. 私はこれが役立つと思っていますが（ が=item func()関数定義の開始である一般的なケースで）、私の場合は不適切です（警告メッセージです）。

pod2html=item open()が関数定義として表示されないようにするために、次のことを試みました (成功しませんでした)。

=head2 C<closeZ<>() on unopened filehandle %s>

=head2 C<closeE<40>) on unopened filehandle %s>

=head2 C<closeE<0x28>) on unopened filehandle %s>

最後の 2 つは "(" を出力しません。E<> を間違って使用していますか? これは pod2html のバグですか (私は OS X で Perl 5.8.8 を使用しています)?

考えたブライアンの答えに基づいて、私は別の実験を試みました：

=head2 C<closeE<60>) on unopened filehandle %s>

結果は になるはずでしたが、代わり<code>close<) on unopened filehandle %s</code>に生成されました。<code>close) on unopened filehandle %s</code>だから、pod2html数値エンティティが好きではないようです。

4

2 に答える 2

0

どのバージョンの pod2html と Pod::Html (または pod2html がロードするもの) を使用していますか? 私が Mac に持っているのは Pod::Html 1.0504 で、常に =item に表示されるテキストの最初のインスタンスでリンクを作成しようとします。いつでもソースを見て、それが何かをしている理由を確認できることを覚えておいてください:)

そして、見出しに C<> を使用することは避けたいと思います。プロセッサにそれらを表示する方法を理解させます。

ネストされた内部シーケンスが必要な場合は、山かっこを追加して、認識しやすくすることができます。

C<< closeE<40> >>

それにも関わらず、perldiag の形式を使用することをお勧めします。これは、アイテムの開きかっこに対して特別なことを何もしません。持っている pod2html が気に入らない場合は、独自の pod2html を作成してください。Pod::Simple を使えばとても簡単です。

于 2009-04-04T20:44:06.007 に答える
0

Pod::Html は、数値エンティティに問題はありませんが、内部の数値エンティティが好きではないようC<>ですperldoc。C<>脱いだら

=head2 closeE<40>) on unopened filehandle %s

問題なく動作します (またpod2html、スプリアス リンクの作成を防ぎます)。したがって、答えはここでは使用しないことのようC<>です。

于 2009-04-04T21:43:40.277 に答える