在莢項目文本使用星號

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

在莢項目文本使用星號

回答

相關問題