0

我正在以 POD 格式编写我的 perl 文档
我的问题是，我想要一个简单地称为 * 的项目标签

我试过=item *,=item S<*>和=item Z<>*=item E<42>

所有方法都被解释为项目符号，但我希望星号被解释为普通文本
任何想法，我一般如何在不添加更多文本的情况下解决这个问题=item "*"？

我不确定这是否有帮助，但这是一个小例子（我放弃了空行）：

=pod
=head1 HEAD
=over 4
=item a
A
=item *
B
=item c
C
=back
=cut

在使用 pod2text、pod2html 等之前，我使用podchecker检查我的文档。
它说=item type mismatch ('definition' vs. 'bullet')
我一开始没有说这个，因为我认为每个转换器都取决于 podchecker 的解释

4

2 回答 2

3

如果您显示您正在寻找的确切输出和您获得的输出，这将有所帮助。

perldoc只要我将它设为第二个，我就可以在输出中显示星号=item：

=head1 OPTIONS

=over 5

=item help

Help me!

=item *

Asterisk

=back

=cut

这是我得到的输出perldoc：

OPTIONS
       help Help me!

       *    Asterisk

这是perlpod的相关引用：

也许最重要的是，保持项目一致：要么对所有项目使用“=item *”，以产生子弹；或使用“=item 1.”、“=item 2.”等生成编号列表；或使用“=item foo”、“=item bar”等——也就是说，看起来一点也不像项目符号或数字的东西。

如果您从项目符号或数字开始，请坚持使用它们，因为格式化程序使用第一个“=item”类型来决定如何格式化列表。

另请参阅：避免不一致的 POD =over =item 缩进

于 2012-03-05T13:35:04.740 回答
0

好的，到目前为止我发现的最好的解决方案是使用=item S< >*它产生输出

HEAD
    a   A

     *  B

    c   C

不完全是我想要的（* 有点偏离）但无论如何

于 2012-03-06T09:37:45.753 回答