Question

我使用模块Pod::Simple::HTMLBatch来创建我编写的软件的文档。

使用的脚本取自文档：

use Pod::Simple::HTMLBatch;
my $batchconv = Pod::Simple::HTMLBatch->new;
$batchconv->some_option( some_value );
$batchconv->some_other_option( some_other_value );
$batchconv->batch_convert( \@search_dirs, $output_dir );

该模块只考虑pm文件。如何告诉模块也为pl文件创建文档？

我在文档中找不到选项。

Answer 1

Pod :: Simple :: Search查找文件matching this regular expression：

m/^[-_a-zA-Z0-9]+\.(?:pod|pm|plx?)\z/is

其中应包含任何*.pl个文件。如果它不适合你，请尝试打开其费力的旗帜，这对文件名更为宽容，测试如下：

m/\.(pod|pm|plx?)\z/i || -x _ and -T _

使用Pod :: Simple :: HTMLBatch启用繁重搜索的唯一方法是创建一个搜索子类，就像我为Pod::Site所做的那样：

package My::Pod::Search;
use parent 'Pod::Simple::Search';
sub new {
    my $self = shift->SUPER::new(@_);
    $self->laborious(1);
    return $self;
}

然后告诉HTMLBatch使用您的子类：

$batchconv->search_class('My::Pod::Search');
$batchconv->batch_convert( \@search_dirs, $output_dir );

可能很高兴更新HTMLBatch以接受其构造函数中的搜索对象，以消除这种愚蠢的解决方法。

如何在批处理pod转换中包含pl文件？

1 个答案: