Perl 如何在同一发行版中创建从模块到脚本的Pod链接？

考虑这个模块。如果您单击

概要

部分中的

跟踪器

链接，您将结束，而您应该结束。给出了负责该行为的Pod源代码，表明使用了以下Pod格式代码：

L<tracker>

L

我可以通过提供绝对链接来解决此问题：

L<tracker|https://metacpan.org/pod/release/DOMM/App-TimeTracker-3.000/bin/tracker>

L

但这修复了3.000版的链接，该版本将来可能会更改

---

那么通常应该如何做呢？

使用不带版本号的完整路径：。

使用不带版本号的完整路径：。

问题是Metaspan没有将tracker\u bash\u autocomplete作为文档正确索引。

NAME

部分有一个基于手册页的非常具体的格式，Metaspan必须遵守该格式才能知道如何链接到您的文档。在连字符前面放置

tracker bash autocomplete

，使metaspan将其索引为

tracker

=head1 NAME

tracker_bash_autocomplete - whatever

---

问题是Metaspan没有将tracker\u bash\u autocomplete作为文档正确索引。

NAME

部分有一个基于手册页的非常具体的格式，Metaspan必须遵守该格式才能知道如何链接到您的文档。在连字符前面放置

tracker bash autocomplete

，使metaspan将其索引为

tracker

=head1 NAME

tracker_bash_autocomplete - whatever

---

https://metacpan.org/release/App-TimeTracker/source/bin/tracker

maybe？Hi@choroba，谢谢你的建议，但它是脚本的源代码，而不是Pod文档。因此？1）如果你在发行版中链接，你应该链接到特定的版本。本地文档与安装的版本不同是没有意义的。2） 这是一个XY问题。真正的问题是创建两个同名的豆荚。修复该问题，然后继续使用

L

。如果只有第二个文档存在，它肯定会链接到它？

https://metacpan.org/release/App-TimeTracker/source/bin/tracker

maybe？Hi@choroba，谢谢你的建议，但它是脚本的源代码，而不是Pod文档。因此？1）如果你在发行版中链接，你应该链接到特定的版本。本地文档与安装的版本不同是没有意义的。2） 这是一个XY问题。真正的问题是创建两个同名的豆荚。修复该问题，然后继续使用

L

。如果只有第二个文档存在，它肯定会链接到它？这毫无意义！不要让本地文档指向本地版本以外的内容。你需要从

man

/

perldoc

切换到网络浏览器，这已经够糟糕的了；至少链接到正确的版本。@ikegami:链接在我的本地版本的

man

/

perldoc

中不起作用。我必须同意@ikegami-Metaspan在同一发行版中有链接的逻辑，但使用完整的“无版本”link绕过了这个功能，会导致读者意外地跳转版本。@choroba，这带来了一个更大的问题：

man tracker

和

perldoc tracker

调出了错误的页面。这尤其糟糕，因为你看到一个名为“跟踪器”的链接。这毫无意义！不要让本地文档指向本地版本以外的内容。你需要从

man

/

perldoc

切换到网络浏览器，这已经够糟糕的了；至少链接到正确的版本。@ikegami:链接在我的本地版本的

man

/

perldoc

中不起作用。我必须同意@ikegami-Metaspan在同一发行版中有链接的逻辑，但使用完整的“无版本”link绕过了这个功能，会导致读者意外地跳转版本。@choroba，这带来了一个更大的问题：

man tracker

和

perldoc tracker

调出了错误的页面。这尤其糟糕，因为你看到了一个名为“tracker”的链接。所以连字符前面的字符串中不允许有空格？perlpodstyle或man（7）并没有明确说明这一点，但我相信（对于每个程序）都是这样。程序之间用逗号和空格分隔。所以连字符前面的字符串中不允许有空格？perlpodstyle或man（7）没有明确说明这一点，但我相信（对于每个程序）都是这样。程序由逗号和空格分隔。