如何通过乘客运行Yardoc服务器？

Question

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

我该如何去设置它？ The Passenger Docs描述了一个公共目录和一个适用于Rack应用的config.ru，但它们在Yardoc的源代码中不可用。

Answer 1

堆场没有提供方便的机架集成AFAIK，但它具有一个机架适配器，可让您在机架服务器（如Passenger）内运行它。

您需要编写自己的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是要服务于库的名称。

在这里看到：

• RackAdapter
• LibraryVersion