perl - 让 github 使用 perldoc 显示 readme 文档

Question

我可以将 github 配置为显示 perldoc 中的自述文件吗？模块（.pm）已上传到那里，我只想让 githubperldoc module.pm自动生成一些从 eg 生成的输出（我不应该一直自己更改 readme.md）

Answer 1

根据他们的文档，Github 会自动处理“README.pod”文件。创建和维护 README.pod 由您决定。如果您不想手动维护它，您可以考虑使用一些本地自动化工具来维护它。

单独维护 README 有一些好处。例如，Perl 模块的 POD 通常不包含安装说明，但这些将是您希望在 README 文件中找到的第一件事。