我使用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完成?
1条答案
按热度按时间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)