Как запустить сервер Yardoc через Passenger?

Question

Я знаю, что могу использовать ProxyPass для обслуживания моего yardoc server экземпляра, но, поскольку yard использует Rack, разве не возможно запустить yard через Passenger?

Как бы я настроил это? Документы для пассажиров описывают общедоступный каталог и config.ru для приложений Rack, но их нет в источнике Yardoc.

Answer 1

Yard не обеспечивает удобную интеграцию в стойку AFAIK, но имеет встроенный адаптер стойки, который позволяет запускать его внутри сервера Rack Server, например, Passenger.

Вам необходимо написать собственный config.ru для настройки Passengerзапустить Yard Server, используя класс Yard RackAdapter.Также вам нужно сообщить 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