pod2html 输出的 CSS 效果

Question 1

我同意默认输出非常 90 年代。我正在研究一个请求请求立即更新pod2html以使用 HTML5 和一些简单的 CSS。

我很乐意合作开发一些简单 CSS 的最佳实践pod2html。

Answer

我同意默认输出非常 90 年代。我正在研究一个请求请求立即更新pod2html以使用 HTML5 和一些简单的 CSS。

我很乐意合作开发一些简单 CSS 的最佳实践pod2html。

Question 2

--css旗帜不起作用吗？或者您想将 CSS 实际嵌入到生成的 HTML 中吗？

在这两种情况下，将功能添加到 Pod::Html 应该相对容易（在我的家用计算机上，我有 Perl 5.26.1，大约在第 370 行）。

这是一个非常基本的尝试（我的 Perl 有点生疏），修改 Html.pm 模块第 370 行左右：

if ($Css) {
    if ($Css =~ /^@/) {
            $Css = substr($Css, 1);
            open my $csh, '<', $Css or die "Error opening CSS file for inclusion";
            read $csh, my $style, -s $csh;
            $csslink = qq(\n<style type="text/css">\n$style</style>\n");
    } else {
            $csslink = qq(\n<link rel="stylesheet" href="$Css" type="text/css" />);
            $csslink =~ s,\\,/,g;
            $csslink =~ s,(/.):,$1|,;
    }
    $tdstyle= '';
}

该修改不仅允许通过 URL 指定 CSS，还可以通过在路径名前添加“@”来指定 CSS。 IE

pod2html ... --css @/home/lserni/tests/pod.css ...

CSS 将被嵌入（没有检查、没有解析、没有警告！可能包含恶意标签等）到 HTML 文件中。

修改该标志也很容易，这样如果未提供 CSS 并且不在 stdin 中，而不是错误使用默认 CSS（只需设置$csslink为适当的值，而不是死掉“打开 CSS 时出错”）。 CSS 必须在代码中预先提供（并可能在 ~/.podhtmlrc 文件中被覆盖？）

^{^{^{不言而喻，无论谁想要完善这个黑客并将其发送给任何可能关心的人，我们都会允许、鼓励并且非常欢迎这样做；任何功劳都归于他们。}}}

Answer

--css旗帜不起作用吗？或者您想将 CSS 实际嵌入到生成的 HTML 中吗？

在这两种情况下，将功能添加到 Pod::Html 应该相对容易（在我的家用计算机上，我有 Perl 5.26.1，大约在第 370 行）。

这是一个非常基本的尝试（我的 Perl 有点生疏），修改 Html.pm 模块第 370 行左右：

if ($Css) {
    if ($Css =~ /^@/) {
            $Css = substr($Css, 1);
            open my $csh, '<', $Css or die "Error opening CSS file for inclusion";
            read $csh, my $style, -s $csh;
            $csslink = qq(\n<style type="text/css">\n$style</style>\n");
    } else {
            $csslink = qq(\n<link rel="stylesheet" href="$Css" type="text/css" />);
            $csslink =~ s,\\,/,g;
            $csslink =~ s,(/.):,$1|,;
    }
    $tdstyle= '';
}

该修改不仅允许通过 URL 指定 CSS，还可以通过在路径名前添加“@”来指定 CSS。 IE

pod2html ... --css @/home/lserni/tests/pod.css ...

CSS 将被嵌入（没有检查、没有解析、没有警告！可能包含恶意标签等）到 HTML 文件中。

修改该标志也很容易，这样如果未提供 CSS 并且不在 stdin 中，而不是错误使用默认 CSS（只需设置$csslink为适当的值，而不是死掉“打开 CSS 时出错”）。 CSS 必须在代码中预先提供（并可能在 ~/.podhtmlrc 文件中被覆盖？）

^{^{^{不言而喻，无论谁想要完善这个黑客并将其发送给任何可能关心的人，我们都会允许、鼓励并且非常欢迎这样做；任何功劳都归于他们。}}}

Question 3

也许尝试一下乐的Pod::to::HTML模块？

https://raku.land/github:Raku/Pod::To::HTML
https://github.com/Raku/Pod-To-HTML

显然，您可以找到css-url您喜欢的，看看这是否可以改善您的 Pod-To-HTML 转换（根据自述文件.md文件）：

“可以通过提供给 Mustache 模板作为命名参数来提供其他信息render。例如，css-url => https://design.raku.org/perl.css将作为提供给模板css-url。”

或者，有乐的Raku::Pod::Render模块：

https://raku.land/zef:finanalyst/Raku::Pod::Render
https://github.com/finanalyst/raku-pod-render
https://github.com/finanalyst/raku-pod-render/releases

Richard Hainsworth（又名@finalyst）一直在开发他的 Raku::Pod::Render模块，该模块在生产中用于渲染 Raku 的文档站点。 “关于”简介如下：

“将 Raku POD 渲染为 HTML 或 MarkDown。GUI 从模块中获取 POD 并从中创建 README.md。通过更改模板可以实现其他输出格式。”

Answer