在荚项目文本使用星号

我写在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

我用podchecker来检查我的文档，以前我用pod2text ，pod2html等。
和它说=item type mismatch ('definition' vs. 'bullet')
我并没有排在首位说这个，因为我觉得每一个转换器依赖于podchecker的解释

来源

2012-03-05 Hachi

Pod ::基于简单的解析器似乎将'S'''''Z'>'和'E'''变体替换为'*'而不是'•'。你在用什么转换器？ – jmcnamara 2012-03-05 12:28:45

显示您的确切输出。显示你想要的输出。 – toolic 2012-03-05 13:38:09

如果您不制作项目符号列表，请不要使用制作项目符号列表的内容。你想做什么？ – 2012-03-05 20:05:00

好吧，我迄今发现的最好的解决方案是使用的=item S< >*产生输出

HEAD 
    a A 

    * B 

    c C

不正是我想要的（*为有点过）但无论如何

来源

2012-03-06 09:37:45 Hachi

如果你表现出你正在寻找确切的输出和输出这将有助于你越来越。

我可以得到星号，只要我让第二=item在perldoc输出到显示：

=head1 OPTIONS 

=over 5 

=item help 

Help me! 

=item * 

Asterisk 

=back 

=cut

下面是输出我从perldoc得到：

OPTIONS 
     help Help me! 

     * Asterisk

以下是perlpod的相关报价：

And perhap最重要的是保持项目的一致性：或者使用 “= item *”来制作子弹;或使用“=项目1”， “=项目2”等，以产生编号列表;或者使用“= item foo”， “= item bar”等等 - 即那些看起来不像子弹或号码的东西。

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

参见：Avoid inconsistent POD =over =item indentation

来源

2012-03-05 13:35:04 toolic

我了解perlpod的方式是，您不得将文本与子弹（星号）或数字混合使用。这也是podchecker所说的。但是我不希望它把星号解释为子弹;只是混合他们将不会帮助我的编辑中提到的 – Hachi 2012-03-06 08:48:17

在荚项目文本使用星号

回答

相关问题