问题标签 [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.
perl - 有没有办法在 perlpod 文档中重用文本？
我的 perlpod 文档中有一堆重复的文本。我当然可以创建一个单独的部分并引用它，但我想知道是否有办法在某处输入文本并将其插入多个位置？
我认为这是不可能的，但我想我会要求确保我没有遗漏任何东西。
或者 - 也许有更好的 perl 文档技术？
perl-pod - perldoc: 'ŷ' 输出为 'X' 和 "=encoding utf8"
在编写 POD 文档时，我意识到 Unicode 字符ŷ变成X了输出。
输入：
PuTTY 中的输出：
在 Emacs 中输入：
使用 Perl 5.18.2 (SLES12 SP4, perl-5.18.2-12.20.1.x86_64) 和LANG=en_US.UTF-8.
更新：
这似乎是 Perl 或 SLES12 SP4 软件包中的一个错误：在 OpenSUSE Leap 15.1 和 Perl 5.26.1 上使用相同的测试，输出看起来不错：
但是使用openSUSE Leap 15.3 的pod2manfrom perl-5.26.1-15.87.x86_64，输出不正确。OTOH 使用perldoc输出也是正确的。
perl - 如何在 Perl POD 中记录参数
我有这个 POD：
podchecker不抱怨。perldoc显示了这一点：
我希望“要检查的内容”行进一步缩进。
如何更改我的 POD 以显示缩进的参数？有没有比使用=items 更好的方法呢？
perl - 如果它是文件名的一部分，为什么 PodSpelling 会抱怨忽略的单词？
PodSpelling（通过 Perlcritic 运行）抱怨“html”，即使我已将其添加到stopwords：
这得到：
（我通过管道输出grep以忽略这个最小示例中与拼写无关的其他抱怨。）
如果我将 POD 更改为使用C<index.html>or F<index.html>，或者将其重写为a .html file，或者添加“index.html”作为停用词，拼写检查器会很高兴。第一个对我来说很有意义（不要检查代码片段或文件名），但我看不出“index.html”和“.html”之间的最大区别是什么。
它是否可以使用，=for stopwords index.html因为它在空白旁边时会忽略点？不过，我只是在这里猜测。
为什么我stopword html对“index.html”不起作用？如果我不想使用C<...>或如何解决这个问题F<...>？
perl - Pod::Usage: `=begin :text`/`=end :text` 打乱了格式
我有一些 POD 文档，其中的一个部分应该在 Latex（使用pod2latex）和纯文本/人中以不同方式呈现。为此，我有一个=begin :text/=end :text部分。
现在，我想在命令行上显示 POD 的各个部分（使用Pod::Usage）。这就是问题所在：在这种模式下，块之后的所有部分:text都出现乱码。
这是一个最小的例子：
输出：
请注意，打印整个 POD（pod2usage(-verbose => 2);或仅perldoc在文件上运行）工作正常。
我已经尝试了所有Pod::Usage可以找到的选项（包括选择不同的Formatter类），但现在可以使用。如果我:text从块中删除 （纯=begin/ =end），它会与部分选择一起出现，但这实际上是一个 POD 语法错误，并perldoc在渲染整个 POD 时抱怨它。
注意：我的 Perl 很旧（v5.18.2），但我坚持使用那个版本。
perl - 如何使 podlinkcheck 不抱怨带有片段的 URL
我有一个带有L<...>如下链接的 Perl 模块：
当我在其上运行podlinkcheck（版本 15）时，它会抱怨：
即使perldoc perlpod说：
或者您可以链接到网页：
方案：...
L<文本|方案：...>
指向绝对 URL 的链接。例如，L http://www.perl.org/或 L<The Perl 主页|http://www.perl.org/>。
我想继续使用podlinkcheck我所有的实际 Perl 模块链接，但是我如何告诉它以超链接开头的https://链接而不是查找该名称的 Perl 模块？
（当我删除片段时它似乎有效（即，See L<RFC 8250|https://datatracker.ietf.org/doc/html/rfc8259>特别是对于我想链接到特定部分的长文档，而不仅仅是整个内容。#用反斜杠转义并在其周围加上双引号并没有帮助。）
html - 如何在 pod2html 中设置网站图标
我用 POD 记录了一些 perl 文件，并用pod2html. 是否可以为此设置一个图标？
但是我的 html 文件中没有关于这个 favicon 的任何内容。
我把这张图片放在哪里了？是否可以直接放在perl文件中？
perl - 如何在 Perl POD 中仅打印特定格式名称？
我正在尝试提取 Perl POD 的一部分，仅此而已。如果我运行以下命令：
然后我得到输出：
我怎样才能得到special pod而没有别的？
我尝试过的事情：
- 不接受的代码、指令和目标
- 附加代码（以及 cut、pod 和 whiteline）处理程序
- 网络搜索（充其量，这会显示如何使用格式名称）
有没有一种简单的方法可以只从 POD 中获取特定格式，或者我应该自己解析文件？