如何通过Passenger 运行Yardoc Server？

【问题标题】：How do I run Yardoc Server via Passenger?如何通过Passenger 运行Yardoc Server？
【发布时间】：2010-12-22 16:32:31
【问题描述】：

我知道我可以使用 ProxyPass 来提供我的 yardoc server 实例，但是由于 yard 使用 Rack，难道不应该可以通过 Passenger 运行 yard 吗？

我将如何进行设置？ The Passenger Docs 为 Rack 应用程序描述了一个公共目录和一个 config.ru，但它们在 Yardoc 的源代码中不可用。

【问题讨论】：

看起来这个guide 有cijoe 的最佳解决方案，它与我用yardoc 描述的问题相同

标签： ruby passenger rack

【解决方案1】：

Yard 不提供便利的机架集成 AFAIK，但它具有机架适配器，允许您在像乘客这样的机架服务器中运行它。

您需要编写自己的config.ru 来配置Passenger 以使用Yard 的RackAdapter 类运行Yard 服务器。您还需要告诉 Yard 在哪里可以找到它应该提供的文档。

我没有对此进行测试，但这里粗略猜测config.ru 应该是什么样子：

require "yard/server/rack_adapter"

run YARD::Server::RackAdapter.new({
  "mylib" => [
    YARD::Server::LibraryVersion.new("mylib", "1.0", "/path/to/mylib/.yardoc")
  ]
})

mylib 是您要服务的库的名称。

看这里：

【讨论】：