问题标签 [perl-pod]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
130 浏览

perl - Dist::Zilla 之后的文件编码错误

我怎样才能让 mojibake 通过?这可能是贡献者插件中的错误。该字符在 perldoc 中无法正确呈现,但在我的 vim 和提取的 git 日志中正确呈现。

这是来自源代码的片段,可能应该直接查看,因为复制粘贴可能没有发现编码问题。

更多 vim 探索表明:set filencoding正在更改为latin1在 vim 中编辑文件似乎可以解决此问题,但是由于正在生成文件,如何使用正确的编码生成它?

0 投票
1 回答
145 浏览

html - 在使用 Pod::Simple::HTML 之前使用 Pod::Weaver 预处理 POD

我正在尝试制作一个简单的Pod::Simple::HTML子类,以便与Pod::Simple::HTMLBatch 一起使用。我希望所有的 POD 都用POD::Weaver进行预处理。但是,我找不到应该使用哪些 API/命令来使用 Pod::Weaver 处理字符串文档。完成我想要的基本大纲是这样的:

有没有人做过类似的事情?谁能告诉我如何使用 Pod:Weaver转换$in_file可能是文件.pm或文件的方法?.pod

0 投票
1 回答
392 浏览

perl - 相当于 Mojolicious Mojolicious::Plugin::PODRenderer 的舞者?

我想以Dancer与 相同的方式在应用程序中Mojolicious生成文档Mojolicious::Plugin::PODRenderer,我的意思是在浏览器中的/perldoc路径下。

有人知道可以提供帮助的模块吗?我没有找到现成的插件Dancer。如果它不存在,欢迎任何建议。

0 投票
2 回答
1333 浏览

perl - Pod::Usage 无法正常工作

我有:

几乎从在线示例中复制/粘贴。但是,当我什么都不做时script.pl --help,脚本就会退出。

0 投票
1 回答
77 浏览

perl - Pod::Simple 没有输出

我正在尝试在 perl 中使用 Pod::Simple,但我没有得到任何输出。我可以使用 Pod::Simple::Text 获得输出。这是一个简短的测试程序:

我将此 perl 代码放入名为 pod-test.pl 的文件中。如果我使用命令行参数 1、2、3 或 4 运行它,我不会得到任何输出。'perl pod-test.pl 5' 工作正常。

我应该如何调用 output_fh 或 output_string 方法?

0 投票
1 回答
164 浏览

perl - 为什么 perldoc 将 'Münster' 评估为 'Muenster'

我有一个简单的 POD 文本文件:

根据文件的此文字十六进制转储,它以 UTF-8 编码:

“ü”被编码为两个字节 C3 和 BC。

但是当我perldoc在文件上运行时,它会将我可爱的格式化 UTF-8 字符转换为 ASCII。

更重要的是,它正确处理了将“ü”表示为“ue”的德语约定。

为什么要这样做?

我可以在我的文件中添加一个额外的声明来阻止它发生吗?


经过进一步调查后,App::perlbrew我发现不同之处在于拥有特定版本的 Pod::Perldoc。

但是,如果可能的话,我仍然想要一种使 Pod::Perldoc 3.14、3.15 和 3.19 行为“正确”的方法。

0 投票
0 回答
251 浏览

perl - Perldoc 对版权符号使用错误的编码

我注意到Pod::Usage pod2man,甚至pod2markdown在其输出中对某些字符进行了错误的编码。这些程序将版权符号编码为单个字节0xA9,这是它的 Unicode 代码点以及它的 iso-8859-1 和 cp1252 编码,而不是它应该是多字节的 utf-8 编码0xCA:0xA9

这个问题与Pod::Escapes我更新到版本 1.07(最新版本)和utf8::unicode_to_native(我找不到)有关。

查看Pod::Escape%Name2character_number哈希将密钥设置为正确copy的 unicode 字符点0xA9( 169)。

但是,哈希从子例程%Name2character中得到了错误的表示。utf8::unicode_to_native事实上,所有的 Unicode 字符代码0x800xFF被设置为它们的单字节表示,而不是 utf-8 编码。以上所有字符0xFF均已正确设置。

有没有办法解决这个问题?我在 Mac OS X 10.10 (Yosemite) 上运行 Perl 5.18.2,它本身就是 utf-8。

0 投票
1 回答
100 浏览

perl - pod2man 失败并显示“没有为文档提供名称”

我有一个 pod2man 任务,该任务因最近的更新而开始失败(现在正在运行 perl 5.24.0 )。错误输出是

完整的文件托管在gits-checkup。不确定要发布哪个确切的片段。

我应该如何解决这个错误?

0 投票
1 回答
175 浏览

perl - 如何在 Perl Pod 的链接中添加格式?

我想知道:我有一些=item像这样的 POD:

当我尝试在文本中创建链接时,这些都不起作用:

使用pod2html我看到有s,但该name=命令只产生输出。=itemL<..><em>...</em>

我怎样才能创建一个正确的链接=item

这是一个简短的示例 POD:

还说。podchecker --warnings --warnings --warnings_pod syntax OK.

0 投票
2 回答
56 浏览

perl - 如何在同一发行版中创建从模块到脚本的 Pod 链接?

考虑这个模块App::TimeTracker。如果您单击该部分中的tracker链接,您将到达此处,而您应该已到达此处这里给出了负责该行为的 Pod 源代码,这表明使用了以下 Pod 格式化代码:SYNOPSIS

我可以通过提供绝对链接来解决问题:

但这修复了指向 3.000 版本的链接,该版本将来可能会更改。

那么一般应该怎么做呢?