Perl文档（POD）浏览器？ [英] Perl documentation (POD) browsers?

问题描述

我正在寻找一个很好的屏幕POD阅读体验。

I'm looking for is a good on-screen POD reading experience.

多年来，我使用了 perldoc 或 man 运行在 xterm 中以阅读屏幕上的Perl文档，以及围绕 Pod :: LaTeX 打印。印刷版本很好：脚本做得很好。但是，屏幕阅读很痛苦：

For years, I've used perldoc or man running in an xterm to read Perl documentation on screen, and a small custom program built around Pod::LaTeX to print it. The printed version is good: the script does a nice job. However, on-screen reading is painful:

• 您可以搜索，但祝好运，例如 / code> section in DBIx :: Class :: ResultSet 。较少不了解文件结构的任何信息，搜索常用的英文单词是毫无意义的。


• 我怕每次文档告诉我 请参阅这样一些 。大。现在我必须找到。然后回到我所在的地方不会是微不足道的（尽管这可能是我不太无知的显示）


• 看到文档更糟糕。 ！perldoc foo 工作，但两个文档之间的切换是很困难的。你可以通过从shell中暂停更多的运行 perldoc 来解决这个问题，但这更多是击键，我很懒。


• 我希望能够点击目录，然后转到该部分。

• You can search, but good luck finding e.g., the as section in DBIx::Class::ResultSet. Less doesn't know anything about the structure of the document, and searches for common English words are pointless.
• I fear every time the document tells me see section so-and-so. Great. Now I have to find that. And then getting back to where I was won't be trivial (though that may be my less ignorance showing)
• See document so-and-so is worse. !perldoc foo works, but switching between the two documents is then hard. You can mostly get around this by suspending less and running perldoc from the shell, but that's more keystrokes and I'm lazy.
• Formatting leaves a lot to be desired.

我想要点击查看其他，然后去那里。等等。到目前为止，我知道有两种可能性：

I want to be able to click a table of contents, and go to that section. I want to be able to click that "see other" and go there. And so on. So far, I know of two possibilities:

• search.cpan.org ，例如 DBIx ::类::结果集 。需要连接互联网，但通常不是问题。


• Podbrowser 。刚开始尝试这个，看起来不错。

• search.cpan.org, example DBIx::Class::ResultSet. Requires an Internet connection, but that's not normally a problem.
• Podbrowser. Just started trying this, looks pretty nice.

我正在运行Debian GNU / Linux，Lenny和Squeeze。但是请建议所有平台的程序使其尽可能有用。

I'm running Debian GNU/Linux, both Lenny and Squeeze. But please suggest programs for all platforms to make this as useful as possible.

推荐答案

您可以尝试 Pod :: Browser ，它是可以连接到浏览器的内置http服务器，或类似于 Tk :: Pod ，这是gui pod浏览器。

You can try Pod::Browser which is built-in http server that you can connect to with your browser, or something like Tk::Pod which is gui pod browser.

这篇关于Perl文档（POD）浏览器？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！