perl Pod链接L< Module::Subfile>不链接到lib/Module/Subfile.pod

qv7cva1a  于 2023-10-24  发布在  Perl
关注(0)|答案(1)|浏览(120)

我使用Dist::Zilla作为CPAN发行版https://metacpan.org/pod/ODF::lpOD_Helper
该发行版包括两个包含pod文档的文件:

lib/ODF/lpOD_Helper.pm
lib/ODF/lpOD_Helper/Unicode.pod

lpOD_Helper.pm中的pod包含对Unicode.pod文件的引用,如

See L<ODF::lpOD_Helper::Unicode>

安装后,perldoc ODF::lpOD_Helper::Unicode显示Unicode.pod内容。
然而,点击metacpan上显示的html中的链接不起作用。L<ODF::lpOD_Helper::Unicode> pod链接被翻译成一个包含URL https://metacpan.org/pod/ODF::lpOD_Helper::Unicode(没有后缀)的html链接,这会得到一个404错误--没有这样的页面。
类似的链接**在其他发行版中也可以工作。

L<ODF::lpOD::Tutorial>

当呈现在元页面上时,它是一个包含URL https://metacpan.org/pod/distribution/ODF-lpOD/lpOD/Tutorial.pod(带有.pod后缀)的链接,该链接可以工作(大概是Web服务器将以.pod结尾的URL转换或Map为html)。

**pod-to-html和/或metacpan如何将<...>pod中的L链接关联到发行版中的.pod文件?**我是否需要提供有关文件的一些元信息,如果需要,如何通过Dist::Zilla完成?

mqxuamgl

mqxuamgl1#

在我添加了META.json(以前只有META.yml),并将完全限定的模块路径作为消失的.pod的NAME部分的第一件事之后,问题得到了解决-- * 感谢池上在评论中的建议!*
我不知道这是哪一个负责,似乎META.json不包含META.yml中没有的信息;但现在Unicode.pod页面正确链接到https://metacpan.org/pod/ODF::lpOD_Helper
(因为我使用Dist::Zilla,所以我将[MetaJSON]添加到dist.ini并安装Dist::Zilla::Plugin::MetaJSON)

相关问题