我正在使用Apache/乘客运行一些Rails/Rake应用程序,我想添加文档应用程序。 gem server 对于这些应用程序,因此我可以轻松地给它一个特殊的(子)域,例如docs.example.org,因此我们团队的所有成员都可以轻松地使用它,没有人必须自己启动服务器或记住端口号(例如8808,例如8808,默认值 gem server 港口)。

有帮助吗?

解决方案

我建议您研究BDOC而不是 gem server, ,它允许用户在没有服务器运行的情况下访问其所有宝石文档。修改BDOC以输出到特定目录也是微不足道的,然后您可以轻松添加一个步骤以重新生成文档。

将它们放在静态文件中的好处是,Apache配置很简单。

如果您确实想将BDOC输出到特定的DIR查看 这线.

编辑:

我实际上继续了 在github上分支 并进行了更改。现在,您可以在命令行上提供输出目录,它将为您生成静态RDOC页面。

其他提示

我在跑 http://gems.local 在我的机器上,如果我想离线进行一些红宝石开裂。 (普通的旅程,火车等)。

这真的很容易,您实际上可以在本地使用所有Ruby Gems的文档运行乘客,而无需访问网络。

我正在关注杰森的技巧,并让一切正常。请参阅以下文章,您应该准备好:

http://jasonseifer.com/2009/02/22/offline-gem-server-rdocs

阿提拉

我写了一篇博客文章,介绍了我如何使用Yard Server和Nginx在本地使用宝石,Ruby,Rails和jQuery Docs在Mac OS X中代理。 Linux的步骤几乎是相同的,唯一改变的是配置守护程序的方法。

https://makarius.posterous.com/offline-rails-ruby-jquery-and-gems-docs-with

许可以下: CC-BY-SA归因
不隶属于 StackOverflow
scroll top