问题标签 [perl-pod]

如何将用AsciiDoc轻量级标记语言编写的手册页自动转换为 Perl 的POD（普通旧文档）？

也许是从 DocBook 转换为 POD 的东西（从 AsciiDoc 源到联机帮助页格式的转换，即 troff 通过 DocBook（通过 XML）进行）。

我遇到了 pod2usage 缺少文本的问题，我尝试通过以下方式修复它：

1. 转换换行符
2. 重写它
3. 用 podchecker 检查它

但这些都无助于解决或暗示我的问题

podchecker 的输出：

完整的吊舱：

http://pastebin.com/igH8SamN

Pod2text 输出：

剪断

剪断

信息：

我的操作系统是 OpenSuSE 11.4 Linux 2.6.37.6-0.7-default i686 i686 i386，GNU/Linux

我的编辑器是 SciTE 版本 1.77

此外 ，POD 嵌入在 Perl 代码中，通过以下代码调用 pod2text：

Pod2text 版本： 未知（不在man, info,help或中pod2text --help）

终端信息：

编辑： 这个错误似乎源于 Tk::Text，我在控制台中尝试了 pod2html，看起来还可以，但是在 Tk 中它缺少文本

perlpod文档告诉我，我可以使用 or 链接到 URL ，L<scheme:...>它甚至作为示例L<text|scheme:...>列出。L<The Perl Home Page|http://www.perl.org/>

第一种情况对我来说很好用：pod2html转

进入

但它失败了

刚刚变成

连同警告：

我本来期望像

要生产。我怎样才能做到这一点？

更新Pod::Html因此，正如 Alan Haggai Alavi 指出的那样，这似乎是一个错误。有解决方法吗？

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

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

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

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

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

我有一堆 POD 分布在多个 Perl 脚本文件中。我想使用另一个文件为所有这些 POD编写登录页面。.pod

说，在文件夹中，/my/root/sub_folder/我有一个FirstScript.pl带有以下 POD 的脚本文件。

在TOC.pod文件中，我试图链接到该部分，如下所示。

当我运行时：

我得到错误：

如果我将文件扩展名 (.pl) 添加到代码的name一部分，则链接将被解析L<>，但是生成的 URL 的格式为“ .pl .html”，这不是我希望各个 outfiles 的样子。

这里有什么问题？我是否以不应该使用的方式使用podrootand ？podpath

如何在每个选项卡之前插入两个选项卡，Description以便选项卡显示在html-output 中？

我注意到我的WITH 部分中的 pod 链接不起作用。我查看了链接只是拼写错误，但单击源显示它不是，并且 Pod 在那里。为什么我的 pod 不能在 metacpan.org 或 search.cpan.org 上工作（似乎是 perldoc）？

更新：修复后问题拒绝显示

我想知道是否可以在 Python 中使用 POD（普通旧文档）？我该怎么做？

我喜欢一种文字编程风格，在他们记录的代码旁边有 POD 注释。不幸的是，这会使代码膨胀，这不是很 Perlish ;-) 我现在能找到的最好的方法是像这样使用Dist::Zilla和Pod::Weaver：

有人可能会争论删除空行，但这也会降低可读性。没有像这样重复和不必要的语法，有没有办法写得更简洁：

并将其扩展到完整的 POD：

我认为它应该可能与 Pod::Weaver 插件一起使用，但试图理解 Pod::Weaver 与 Dist::Zilla 和 PPI 相结合的架构让我的大脑受伤:-(

有没有办法测量脚本的 POD 覆盖率（例如*.pl）？

我可以使用and测量包的文档覆盖率，但我无法测量scripts的文档覆盖率，因为用于检查包内容的底层用途，由于缺少文件而失败。Pod::CoverageTest::Pod::CoveragePod::CoverageDevel::Symdumprequire.pm

有没有办法解决这个问题？

（我必须在文件中包含 POD 文档.pl，因此将所有内容移动到模块中并记录它对我来说不是一个好的解决方案。无论我能做到这一点，它已经这样做了。）