Ruby / Rails вопрос о поиске справки / определений в системе

Question

Это, вероятно, супер базовый, но, ну, я не могу его найти ...

Какой самый лучший способ изучить Rails из самой установки. Позволь мне объяснить. Я смотрю на какой-то Миграционный код и любопытно, что означает символ. Как / где я могу это посмотреть? В данном случае, в частности, мне любопытно узнать о :force => true и о том, что он делает, но более общий ' как мне ответить на этот вопрос для себя без SO или Googling? ' - это более важный вопрос ...

class CreateHomes < ActiveRecord::Migration
  def self.up
    create_table :homes, :force => true do |t|
      t.column :name, :string
      t.column :city, :string
    # ...
    end
  end
end

Answer 1

Если вы хотите исследовать рельсы из самой установки, возможно, вы могли бы использовать «сервер гемов», он откроет локальный сервер документации для ваших локальных гемов

http://localhost:8808/

если вы ищете что-то, например, о миграции (activerecord), вам нужно получить доступ к http://localhost:8808/doc_root/activerecord-2.3.8/rdoc/index.html

это простой способ, или вы можете зайти в свой каталог gems и посмотреть источники. (иногда это приятно делать)

Answer 2

Если вы заморозите свое приложение rails, то у вас будет весь код rails в вашем каталоге vendor/rails. Поэтому, если вам интересно или вы не знаете, как что-то действительно работает под капотом, просто поищите в этом каталоге.

Если вас не интересует код и только документация, вы можете локально использовать различные онлайн-ресурсы или gemserver. Тем не менее, есть хороший гем под названием bdoc, который вы можете использовать для просмотра всех локально установленных гемов в симпатичном формате. Вы можете настроить его, используя http://nasir.wordpress.com/2009/09/22/pretty-rdocs-for-local-gems

Answer 3

Я лично использую APIdock для документации по Rails, потому что он отслеживает устаревание, хотя иногда он отстает в версиях. Может быть другой сайт, который вам больше нравится. Их там несколько.

:force => true - это аргумент create_table, который задокументирован здесь .