12

我正在寻找的是一种良好的屏幕 POD 阅读体验。

多年来,我一直使用perldocman运行在xterm屏幕上阅读 Perl 文档,以及围绕它构建的小型自定义程序Pod::LaTeX来打印它。印刷版很好:脚本做得很好。然而,屏幕阅读是痛苦的:

  • 您可以搜索,但祝您好运,例如,中的as部分DBIx::Class::ResultSet。Less 对文档的结构一无所知,搜索常见的英文单词毫无意义。
  • 我害怕每次文件告诉我see section so-and-so。伟大的。现在我必须找到它。然后回到我原来的位置不会是微不足道的(尽管这可能是我不那么无知的表现)
  • 见文件某某更糟。!perldoc foo可以,但是很难在两个文档之间切换。您可以通过少挂起并perldoc从 shell 运行来解决这个问题,但那是更多的击键,我很懒惰。
  • 格式化还有很多不足之处。

我希望能够单击目录,然后转到该部分。我希望能够单击“查看其他”并去那里。等等。到目前为止,我知道两种可能性:

我正在运行 Lenny 和 Squeeze 的 Debian GNU/Linux。但请为所有平台推荐程序,以使其尽可能有用。

4

5 回答 5

7

您可以尝试Pod::Browser,它是内置的 http 服务器,您可以使用浏览器连接到它,或者像Tk::Pod之类的 gui pod 浏览器。

于 2009-10-02T15:21:29.203 回答
5

你见过CPAN::Mini::WebserverPod::POM::WebApache::Perldoc吗?这些设置了一种本地方式,让您可以查看漂亮的 HTML 版本的文档。

于 2009-10-02T16:07:06.147 回答
2

我建议使用pod2html将所有 POD 转换为 HTML

这使它可浏览、链接和美观,您可以通过 css 自定义外观。

于 2009-10-02T15:15:37.997 回答
1

只是为了添加两个到目前为止似乎已经错过的 POD 服务器!

于 2009-10-03T16:21:25.457 回答
0

还可以查看 Gtk2::Ex::PodViewer,它是一个基于 GTK 的优秀 GUI 查看器。如果您也在使用 Windows,您可以在 Camelbox (http://code.google.com/p/camelbox/) 中找到预构建的包装器。

于 2011-03-15T10:28:03.310 回答