【问题标题】:Perl documentation (POD) browsers? [closed]Perl 文档 (POD) 浏览器? [关闭]
【发布时间】:2010-12-03 08:49:28
【问题描述】:

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

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

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

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

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

【问题讨论】:

  • 你抱怨的很多事情都是我在单独的终端窗口(或屏幕,或其他)中所做的事情。我也不太关心格式。 :)

标签: perl user-interface documentation cpan perl-pod


【解决方案1】:

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

【讨论】:

  • 在这些不同的选项之间有什么可供选择的
  • @justintime :未使用 Pod::Webserver,因此无法对此发表评论。但我确实使用了 Pod::Server 并且对它非常满意。我喜欢它渲染 POD 的方式,因为它建立在 Squatting 框架上,我很高兴知道如果需要我可以进行局部修改(到目前为止我还没有......但添加一个搜索选项将是一个好主意!) .
【解决方案2】:

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

【讨论】:

  • 所以你知道,你的第一个链接已经失效了。
  • @Cptn_Hammer 为 mpeters 修复了它
【解决方案3】:

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

【讨论】:

  • 乍一看,podviewer(v0.18,CPAN 称它是最新的)看起来像是一个不太完善的 podbrowser。
【解决方案4】:

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

【讨论】:

    【解决方案5】:

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

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

    【讨论】:

    • 这是我使用的,因为它在与网络断开连接时很方便,并且在 lynx 的命令行中同样可用(遗憾的是不在标准的 MacOSX 发行版中,但 macports 有它)。我想知道是否可以设置 ExtUtils::MakeMaker 首选项以默认为所有安装构建 html 文档...?
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2018-12-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2020-12-16
    相关资源
    最近更新 更多