【问题标题】:Equivalent for Dancer of Mojolicious Mojolicious::Plugin::PODRenderer?相当于 Mojolicious Mojolicious::Plugin::PODRenderer 的舞者?
【发布时间】:2014-03-24 06:50:30
【问题描述】:

我想在Dancer 应用程序中生成文档,就像MojoliciousMojolicious::Plugin::PODRenderer 所做的那样,我的意思是在浏览器中,在/perldoc 路径下。

有人知道可以提供帮助的模块吗?我没有找到Dancer 的现成插件。如果不存在,欢迎提出任何建议。

【问题讨论】:

  • 作为 Mojolcious 的开发人员,请问您不开发 Mojolicious 应用程序是否有一些外部原因?如果 Dancer 适合你,那就太好了,但如果你对 Mojo 有一些困难并继续前进,我很乐意提供帮助。
  • 感谢您提出的帮助乔尔的建议。我目前正在测试这两个框架。我正在寻找具有最多文档和简单示例的中级初学者可以理解的常见事物的文档。我对极端的性能事实并不感兴趣。我已经阅读了有关 Dancer-likes-CPAN VS Mojo-has-no-dependencies 的辩论,并承认它并没有真正帮助选择。两者都很容易开始(依赖与否),但您首先回答的事实可以帮助我做出选择。 PODRenderer 插件非常有趣,也许我想用它来破解一下。
  • 我们认为我们拥有非常好的文档。要解决一些常见问题,请先阅读Mojolicious::Lite 的文档(这是教程,不应跳过),然后按照here 的顺序阅读指南。此外,个别课程文档仅供参考,不作为教程。
  • 这是一个宝贵的东西,有一个路径可以遵循指南和教程,而不是跳过 ::lite 部分。
  • 许多人跳过::Lite 教程,因为他们只对完整的应用程序感兴趣。然而,引入了许多重要的概念,并且在整个文档中使用了 lite 语法。它真的不应该被跳过。享受吧!

标签: perl documentation-generation mojolicious dancer perl-pod


【解决方案1】:

将 Mojolicious 的 PODRenderer 移植到 Dancer 应该相当简单 - 它是一个示例插件,代码相当短。我在工作中的 CGI 框架中为自己使用了这个。

https://github.com/kraih/mojo/blob/master/lib/Mojolicious/Plugin/PODRenderer.pm#L34

插件所做的基本上是定义路由/perldoc/:module来调用_perldoc方法; _perldoc 方法使用Pod::Simple::Search@INC 目录中查找与模块参数匹配的文档文件;如果没有,它会将搜索重定向到 MetaCPAN。如果是,它使用Pod::Simple::HTML 将文档转换为HTML,然后用Mojo::DOM 整理并包装在一个可爱的模板中。

找到该模板的位置留作练习......哦,没关系,这里是:https://github.com/kraih/mojo/blob/master/lib/Mojolicious/templates/perldoc.html.ep

【讨论】:

猜你喜欢
  • 2018-01-08
  • 1970-01-01
  • 2013-12-20
  • 2017-08-25
  • 2011-05-31
  • 2016-12-09
  • 2016-03-14
  • 2017-06-05
  • 2013-06-27
相关资源
最近更新 更多