如何在同一发行版中将 Pod link 从模块制作为脚本?
How to make a Pod link from a module to a script within the same distribution?
考虑这个模块App::TimeTracker. If you click on the tracker
link in the SYNOPSIS
section you end up here whereas you should have ended up here. The Pod source code responsible for the behavior is given here,它表明使用了以下 Pod 格式化代码:
L<tracker>
我可以通过提供绝对值 link 来解决问题:
L<tracker|https://metacpan.org/pod/release/DOMM/App-TimeTracker-3.000/bin/tracker>
但这将 link 修复为版本 3.000,该版本将来可能会更改。
那么一般应该怎么做呢?
使用不带版本号的完整路径:https://metacpan.org/pod/distribution/App-TimeTracker/bin/tracker
.
问题是 tracker_bash_autocomplete 没有被 MetaCPAN 正确索引为文档。 NAME
部分有一个基于联机帮助页的非常具体的格式,MetaCPAN 必须遵守该格式才能知道如何 link 您的文档。将 tracker bash autocomplete
放在连字符之前会使 MetaCPAN 将其索引为 tracker
.
=head1 NAME
tracker_bash_autocomplete - whatever
考虑这个模块App::TimeTracker. If you click on the tracker
link in the SYNOPSIS
section you end up here whereas you should have ended up here. The Pod source code responsible for the behavior is given here,它表明使用了以下 Pod 格式化代码:
L<tracker>
我可以通过提供绝对值 link 来解决问题:
L<tracker|https://metacpan.org/pod/release/DOMM/App-TimeTracker-3.000/bin/tracker>
但这将 link 修复为版本 3.000,该版本将来可能会更改。
那么一般应该怎么做呢?
使用不带版本号的完整路径:https://metacpan.org/pod/distribution/App-TimeTracker/bin/tracker
.
问题是 tracker_bash_autocomplete 没有被 MetaCPAN 正确索引为文档。 NAME
部分有一个基于联机帮助页的非常具体的格式,MetaCPAN 必须遵守该格式才能知道如何 link 您的文档。将 tracker bash autocomplete
放在连字符之前会使 MetaCPAN 将其索引为 tracker
.
=head1 NAME
tracker_bash_autocomplete - whatever