Rails de base: Où est mon installation, sources, API, sources en ligne

Question

Je suis en train d'exécuter cette méthode qui devrait fonctionner according to this:

ActiveSupport::TimeZone.new("whatever",3600) 

mais cette initialiseur n'existe pas. Donc, je voudrais regarder les sources de ma version Rails (2.3.4) pour voir si elle est privée ou si je manque complètement le point (le constructeur d'un argument fonctionne).

Et soudain je me rends compte que je n'ai aucune idée où trouver les documents pour ma version ni l'API. J'utilise api.rubyonrails.org constamment (lié de here), mais je ne suis même pas sûr à quelle version il se réfère (2.3.2, la version 'actuelle'?). Comment puis-je obtenir les documents API pour mon installation? Comment puis-je voir la version SOURCE pour ma Rails? Puis-je l'afficher dans mon installation Rails (OSX ou Ubuntu)? En ligne?

Si la version a été vendue (ce n'est pas le cas), comment cela affecterait-il ma question?

Answer 1

Découvrez http://github.com/makandra/aegis/tree/master pour un serveur de documentation de gem local. Encore plus simple est la commande gem server. Les deux fournissent la documentation pour les versions installées de gems.

Également, parfois gem install ignore la documentation RDoc; utilisez gem rdoc --all pour créer des documents pour toutes les gemmes installées. Les documents sont enregistrés au /your-ruby-path/lib/ruby/gems/1.8/docs, en passant.

La source de toutes les gemmes est /your-ruby-path/lib/ruby/gems/1.8/gems, qui inclut à la fois Rails et ActiveSupport, qui sont en fait deux gemmes distinctes.

Answer 2

Il existe plusieurs façons d'accéder à vos documents, la plus simple étant d'utiliser une gemme à rails gelés. Si vous ne voulez pas congeler pour une raison quelconque, vous pouvez créer une application factice rails, geler les rails et les docs gen:

rails dummy_app 
rake rails:freeze:gems 
rake doc:rails 
rake rails:unfreeze 

Vous pouvez également générer des documents pour les plugins installés. Essayez rake -T doc.

Congeler vos rails gem a l'avantage supplémentaire que le code est là pour vous permettre de naviguer, mais vous pouvez toujours aller à l'endroit où vos pierres précieuses sont installées sur votre système. Sur MacOS, cela pourrait être soit ~/.gems, /Developer/SDKs/MacOSX10.5.sdk/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/lib/ruby/gems/1.8/gems, ou peut-être autre?