Как сделать ссылку Pod из модуля на скрипт в том же дистрибутиве?
Рассмотрим этот модуль App::TimeTracker. Если вы нажмете наtracker ссылка в SYNOPSISвы попадаете сюда, тогда как должны были оказаться здесь. Исходный код Pod, отвечающий за поведение, приведен здесь, что показывает, что использовался следующий код форматирования Pod:
L<tracker>
Я могу решить проблему, указав вместо этого абсолютную ссылку:
L<tracker|https://metacpan.org/pod/release/DOMM/App-TimeTracker-3.000/bin/tracker>
но это исправляет ссылку на версию 3.000, которая может измениться в будущем.
Так как это вообще должно быть сделано?
2 ответа
Используйте полный путь без номера версии: https://metacpan.org/pod/distribution/App-TimeTracker/bin/tracker.
Проблема в том, что tracker_bash_autocomplete неправильно индексируется как документация MetaCPAN. ВNAMEРаздел имеет очень специфический формат, основанный на страницах руководства, которых необходимо придерживаться, чтобы MetaCPAN знал, как ссылаться на вашу документацию. Положивtracker bash autocomplete перед дефисом MetaCPAN проиндексирует его как tracker.
=head1 NAME
tracker_bash_autocomplete - whatever