Ejecutando el servidor GEM en el pasajero

Question

Estoy ejecutando algunas aplicaciones Rails/Rake en Apache/Passenger y quiero agregar la aplicación de documentación atendida por gem server a estas aplicaciones, por lo que puedo darle fácilmente un dominio (sub) especial, como docs.example.org, por lo que está fácilmente disponible para todos los miembros de nuestro equipo y nadie tiene que iniciar el servidor él mismo o recordar números de puerto (como 8808, el valor por defecto gem server Puerto).

Answer 1

Recomendaría investigar BDOC en lugar de gem server, le permite al usuario acceder a todos sus documentos de gemas sin un servidor que se ejecute en absoluto. También sería trivial modificar BDOC para emitir un directorio específico, entonces podría agregar fácilmente un paso para regenerar los documentos.

Lo bueno de tenerlos en archivos estáticos sería la configuración de Apache es simple.

Si desea realizar la salida de BDOC a una mirada específica de DIR a esta línea.

Editar:

De hecho seguí adelante y ramificó esto en Github e hizo el cambio. Ahora puede suministrar el directorio de salida en la línea de comando y generará las páginas RDOC estáticas para usted.

Answer 2

Estoy corriendo http: //gems.local En mi máquina en caso de que quiera hacer un poco de rubí sin conexión. (Viaje simple, trenes, etc.).

Esto es realmente fácil, en realidad puede ejecutar pasajero con toda la documentación de Ruby Gems localmente sin tener que acceder a la red.

Estaba siguiendo los consejos de Jason y conseguí que todo funcionara. Vea el siguiente artículo y debería estar listo para ir:

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

Atila

Answer 3

Escribí una publicación de blog sobre cómo tengo mis gemas, Ruby, Rails y JQuery Docs localmente usando el servidor de Yard y Nginx para proxing en Mac OS X. Los pasos para Linux son casi lo mismo, lo único que cambia es la forma de configurar los demonios.

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