如何通過乘客運行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