perldoc 不顯示節之間的文本

[英]perldoc does not display text between section

我有這個 POD 文件： 當我運行perldoc t.pod時，“=begin perl”和“=end perl”之間的代碼不可見。 我不明白我做錯了什么。 ...

如何檢查 function 是否具有 POD（perl 文件內文檔）？

[英]How can I check if a function has POD (perl in-file documentation)?

是否有任何庫可以告訴我特定的 function 是否具有 POD？ 我想將它添加到我們的構建系統中。 如在POD 文檔中建立的約定， 我想寫這樣的東西my @functions = get_functions_with_PPI($file); foreach my $func (@functio ...

我如何（如果有的話）在 shell 腳本中使用 Perl POD 文檔？

[英]How (if at all) can I use Perl POD documentation in a shell script?

我想知道：在 Perl POD 部分被 Perl 解析器識別，並且有__END__關鍵字來停止 Perl 解析。 如果我想在 shell 腳本（可能在腳本末尾）中編寫 POD，可以這樣做嗎？如果可以：如何？ ...

如何在 Perl POD 中僅打印特定格式名稱？

[英]How can I print only a specific format name in a Perl POD?

我正在嘗試提取 Perl POD 的一部分，僅此而已。 如果我運行以下命令：use strict; use warnings; use Pod::Simple; use Pod::Text; =head1 podTest normal pod =cut print "normalPod:\ ...

如何在 pod2html 中設置網站圖標

[英]How to setting a favicon in pod2html

我用 POD 記錄了一些 perl 文件，並用pod2html制作了一個網頁。 是否可以為此設置一個圖標？ =pod =encoding UTF-8 =begin pod2html <link rel="..." type="..." href="/..."> =end pod2 ...

如果它是文件名的一部分，為什么 PodSpelling 會抱怨忽略的單詞？

[英]Why does PodSpelling complain about an ignored word if it's part of a file name?

PodSpelling （通過 Perlcritic 運行）抱怨“html”，即使我已將其添加到stopwords中：=for stopwords html =head2 some function Generates an index.html page. =cut 這得到：rober ...

如何在 Perl POD 中記錄參數

[英]How to document parameters in Perl POD

我有這個 POD： podchecker不會抱怨。 perldoc顯示了這一點： 我希望“檢查內容”行進一步縮進。 我需要如何更改我的 POD 以顯示縮進的參數？ 有沒有比=item更好的方法來做到這一點？ ...

有沒有辦法在 perlpod 文檔中重用文本？

[英]Is there a way to re-use text in perlpod documentation?

我的 perlpod 文檔中有一堆重復的文本。 我當然可以創建一個單獨的部分並引用它，但我想知道是否有辦法在某處輸入文本並將其插入多個位置？ 我認為這是不可能的，但我想我會要求確保我沒有遺漏任何東西。 或者 - 也許有更好的 perl 文檔技術？ ...

如何在同一發行版中創建從模塊到腳本的 Pod 鏈接？

[英]How to make a Pod link from a module to a script within the same distribution?

考慮這個模塊App::TimeTracker 。 如果您單擊SYNOPSIS部分中的tracker鏈接，您最終會出現在此處，而您應該會出現在此處。 這里給出了負責該行為的 Pod 源代碼，這表明使用了以下 Pod 格式化代碼： 我可以通過提供絕對鏈接來解決問題： 但這修復了指向 3.000 版本 ...

如何在Perl Pod中的鏈接中添加格式？

[英]How do I add formatting in a link in Perl Pod?

我想知道：我有一些像這樣的=item的POD： 當我嘗試在文本中創建鏈接時，這些都不起作用： 使用pod2html我看到name= for =item s，但L<..>命令只生成<em>...</em>輸出。 如何為=item創建正確的鏈 ...

Pod::使用幫助格式化

[英]Pod::Usage help formatting

我想為我的 Perl 腳本正確格式化我的幫助消息，如果可能的話，使用標准模塊，如Pod::Usage 。 不幸的是，我不太喜歡 pod2usage 的輸出格式。 例如，使用grep我得到以下幫助結構： 但這與Pod::Usage非常不同，我得到不需要的\n和\t ： 我想以傳統方式修改我的幫 ...

Pod :: Simple沒有輸出

[英]No output from Pod::Simple

我正在嘗試在Perl中使用Pod :: Simple，但沒有得到任何輸出。 我可以用Pod :: Simple :: Text獲得輸出。 這是一個簡短的測試程序： 我將此perl代碼放入名為pod-test.pl的文件中。 如果我使用命令行參數1、2、3或4運行它，則不會得到任何輸 ...

Pod ::用法無法正常工作

[英]Pod::Usage not working correctly

我有： 幾乎從在線示例復制/粘貼。 但是，當我執行script.pl --help沒有打印，腳本退出。 ...

相當於 Mojolicious Mojolicious::Plugin::PODRenderer 的舞者？

[英]Equivalent for Dancer of Mojolicious Mojolicious::Plugin::PODRenderer?

我想在生成文檔Dancer以同樣的方式，應用Mojolicious確實與Mojolicious::Plugin::PODRenderer ，我的意思是在瀏覽器中，下/perldoc路徑。 有人知道可以提供幫助的模塊嗎？ 我發現沒有現成的Dancer插件。 如果它不存在，歡迎任何推薦。 ...

在使用 Pod::Simple::HTML 之前使用 Pod::Weaver 預處理 POD

[英]Preprocess POD with Pod::Weaver before using Pod::Simple::HTML

我正在嘗試創建一個簡單的Pod::Simple::HTML子類以與Pod::Simple::HTMLBatch 一起使用。 我希望使用POD::Weaver對所有 POD 進行預處理。 但是，我無法找到應該使用哪些 API/命令來處理帶有 Pod::Weaver 的字符串文檔。 完成我想要的基本大綱 ...

Dist::Zilla 后文件編碼錯誤

[英]Wrong file encoding after Dist::Zilla

我怎樣才能讓 mojibake 通過？ 這可能是貢獻者插件中的一個錯誤。 該字符在 perldoc 中無法正確呈現，但在我的 vim 和提取的 git 日志中可以。 這是源代碼中的一個片段，由於復制粘貼可能沒有捕獲編碼問題，因此可能應該直接查看該片段。 多一點 vim 探索表明:set fi ...

如何在 pod2usage 中指定寬度？

[英]How to specify a width in pod2usage?

我有一個小的 perl 模塊，正在使用 Getopt::Long，我想我不妨使用 Pod::Usage 來獲得漂亮的幫助顯示。 經過一番擺弄，我讓它工作得相當好，只有一個小例外。 我無法設置輸出的寬度。 我的終端有 191 個字符寬。 使用 perldoc Module.pm，它可以正確地將文檔 ...

POD 項目的自動遞增整數

[英]Auto-increment integers for POD items

有誰知道一種動態增加項目標題整數的方法？ 這主要是為了避免在需要在大量步驟中間的某處添加/刪除新步驟時必須更改每個步驟編號。 以下是一個小的三步過程，可讓您大致了解模板結構： 不考慮項目名稱和結構，目標是嘗試消除對每個項目的標題進行靜態編號的使用。 我想知道是否有可能的方法來生成一個遞增的整數； ...

如何使用 Pod::Weaver 在 Perl POD 中添加 HTML 部分

[英]How to add HTML section in Perl POD using Pod::Weaver

我將Pod::Weaver與Dist::Zilla 一起使用。 它為我做了幾件好事。 它會自動添加 POD 部分 VERSION、AUTHOR、LICENSE，在我的源代碼中，我可以使用簡單的 POD 語法，我可以編寫“=method new”，它將被轉換為正確的 POD。 現在我想向 POD 添 ...

Perl 在運行時以編程方式修改 POD

[英]Perl programmatically modify POD at runtime

我為我正在處理的一些腳本編寫了一個方便的庫。 除了提供強制參數之外，它還將Getopt::Long包裝成更簡單的東西。 因此，庫將許多參數添加到腳本的必需/可能命令行參數列表中。 由於腳本還在--help標志上調用 pod2usage，我希望庫以某種方式提供它提供給單個腳本的每個標志的定義，以便在 ...