1.1.3 Соглашения в этой книге
Соглашения в этой книге главным образом очевидны; в этом разделе я упомяну лишь те которые, возможно, таковыми не являются.
И HTML (#HTML) и PDF выпуски этой книги полны ссылками, как к внутренним разделам (таким как Раздел 1.2) так и к внешним сайтам (таким как основная страница загрузки Ruby on Rails (#http://www.rubyonrails.ru/down.html)).6
Во-вторых, ваш покорный слуга – заядлый линуксоид/маковод и не использует венду в качестве своей основной ОС уже более десяти лет, в результате чего, Rails Tutorial имеет привкус никсов. Например, в этой книге все примеры используют приглашение командной строки в Unix-стиле (знак доллара):
$ echo "hello, world" hello, world
Пользователи Windows должны понимать, что их системы будут использовать в качестве приглашения угловую скобку >:
C:\Sites>echo hello, world hello, world
В Unix системах некоторые команды должны быть выполнены с sudo, (сокращение от “Substitute User DO”) что означает “выполнить от имени суперпользователя”. По умолчанию команда, выполняемая с sudo выполняется как команда администратора, у которого есть доступ к файлам и каталогам, которые недоступны обычному пользователю. Чтобы указать, что использование sudo зависит от системы, используются квадратные скобки, когда это может (или не может) быть необходимо на Вашей системе, так как в этом примере из Раздела 1.2.2:
$ [sudo] ruby setup.rb
Большинство систем Unix/Linux/OS X требует sudo по умолчанию, за исключением использования Ruby Version Manager как рекомендуется в Разделе 1.2.2.3 Отметьте, что недопустимо фактически вводить скобки; следует выполнять:
$ sudo ruby setup.rb
ИЛИ
$ ruby setup.rb
в зависимости от Вашей системы.
Rails поставляется с большим количеством команд, которые можно запустить в командной строке. Например, в Разделе 1.2.5 мы запускаем локальный веб-сервер разработки следующим образом:
$ rails server
Как и с приглашением командной строки, Учебник Rails использует конвенцию Unix для разделителей каталога (то есть, косую черту наклоненную вправо /). Мой пример приложения из Учебника Rails, например, живет в
/Users/mhartl/rails_projects/sample_app
На Windows аналогичный каталог выглядел бы
C:\Sites\sample_app
Корневой каталог для любого приложения называется Rails root, и впредь все каталоги будут относительно этого каталога. (Отметьте в особенности, что “Rails root” не является корневым каталогом для Rails непосредственно.) Например, каталог config моего примера приложения это
/Users/mhartl/rails_projects/sample_app/config
Корень Rails здесь - все что перед config, то есть,
/Users/mhartl/rails_projects/sample_app
Для краткости, при обращении к файлу
/Users/mhartl/rails_projects/sample_app/config/routes.rb
я пропущу корень Rails и просто запишу config/routes.rb
Наконец, Учебник Rails часто показывает вывод из различных программ (команды оболочки, статус управления версиями, программ Ruby, и т.д.). Из-за неисчислимых небольших различий между различными компьютерными системами, вывод, который Вы увидите, возможно, не всегда совпадет в точности с тем, который показывают в тексте, но это не повод для беспокойства. Кроме того, некоторые команды могут произвести погрешности в зависимости от Вашей системы; вместо того, чтобы пытаться выполнить Сизифову задачу документирования всех таких погрешностей в этом учебном руководстве, я делегирую к алгоритму “Ищи в Google сообщение об ошибке”, который между прочим является весьма хорошей практикой для реального программирования.
# coding: utf-8