L'esecuzione del server gioiello di passeggeri

Question

Sono in esecuzione un paio di rotaie / rake applicazioni in Apache / passeggero e voglio aggiungere l'applicazione di documentazione servito da gem server a queste applicazioni, in modo da poter facilmente dare un speciale (sotto) del dominio, come docs.example. org, quindi è facilmente disponibile per tutti i membri della nostra squadra e nessuno deve avviare il server stesso o ricordare i numeri di porta (come 8808, la porta gem server predefinita).

Answer 1

Vorrei raccomandare esaminando bdoc invece di gem server, esso permette all'utente di accedere a tutti i loro documenti gemma senza un server che esegue a tutti. Sarebbe anche banale modificare bdoc per l'output in una directory specifica, allora si potrebbe facilmente aggiungere un passaggio per rigenerare la documentazione.

La cosa bella di averli in file statici sarebbe la configurazione di Apache è morto semplice.

Se si vuole fare in uscita bdoc a uno specifico aspetto dir al questa linea .

Modifica:

Io sono andato avanti e ramificata questo su github e fatto il cambiamento. Ora è possibile fornire la directory di output sulla riga di comando e genererà le pagine statiche rdoc per voi.

Answer 2

Io corro http: //gems.local sulla mia macchina nel caso in cui voglio fare un po 'di Ruby di cracking disconnesso. (Viaggio Plain, treni, ecc).

Questo è veramente facile, si può effettivamente eseguire passeggero con la documentazione tutte le gemme Ruby a livello locale, senza dover accedere alla rete.

Stavo seguendo i consigli di Jason, ma ho tutto funziona. Vedere il seguente articolo e si dovrebbe essere pronti a partire:

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

Attila

Answer 3

ho scritto un post sul blog su come ho le mie gemme, rubino, rotaie e documenti jQuery localmente utilizzando il server cortile e nginx per proxing in Mac OS X. Passi per linux sono quasi la stessa, unica cosa che cambia è il modo per configurare i demoni.

https://makarius.posterous.com/ offline-rails-ruby-jquery-e-gemme-docs-con