Dove trovare il modello RDOC API RAILS

Question

Sto cercando di prettificare la mia documentazione RDOC, usando la versione 3.5.3. Non sono un fan del tema del pesce scuro integrato, quindi ho cercato di trovare un modo per sostituirlo con quello usato dalla documentazione API ufficiale delle Rails a http://api.rubyonrails.org/, ma non ho avuto fortuna a trovarlo in qualsiasi forma prontamente disponibile. Ho cercato in tutto il Github, tra le altre cose.

Quello che ho trovato finora è

• https://github.com/mislav/hanna

che potrebbe essere leggermente obsoleto e è forchetta

• https://github.com/rdoc/hanna-nouveau

Entrambi sono carini, ma non proprio quello che voglio. Quindi, prima di iniziare a armeggiare con quei modelli, qualcuno sa se il modello usato dai documenti API Rails è disponibile come gemma da qualche parte?

Grazie!

Answer 1

Sembra così. Ignora le istruzioni che dicono di fare un gem install horo --pre - Questo ti darà davvero una versione beta più vecchia. Basta fare gem install horo E otterrai l'attuale versione 1.0.3 (Modificare: Ho inviato una richiesta di pull per aggiornare le istruzioni, che è già stata accettata).

https://github.com/tenderlove/horo

A proposito, l'ho trovato guardando il Codice sorgente Rails e visualizzare il Rakefile Per vedere le opzioni RDOC. In particolare, la riga 67 mostra rdoc.options << '-f' << 'horo'.

Answer 2

So che è molto tardi, ma sembra che la nuova versione di Rails usi qualcosa chiamato SDOC, che migliora l'output con la ricerca JavaScript ed è un po 'più pulito. Fare una semplice "gem installazione sdoc" otterrà ciò di cui hai bisogno, quindi userà solo rdoc.options << '-f' << 'sdoc'.

Il progetto GitHub sembra essere a https://github.com/voloko/sdoc/

A proposito, grazie per la domanda! Senza la risposta iniziale pubblicata, non avrei mai trovato dove cercare e rimasto bloccato con quell'orribile tema di pesce scuro per i miei progetti!