Веб-ориентированное приложение для составления и публикации учебного расписания для Амурского государственного университета на программной платформе Ruby on Rails.
Рекомендуемый тип установки: установка на сервер или рабочую станцию с GNU/Linux, с использованием RVM из под непривилегированного пользователя.
bash -s stable < <(curl -s https://raw.github.com/wayneeseguin/rvm/master/binscripts/rvm-installer ) # Установка RVM
source ~/.bashrc # перезагрузка оболочки для функционирования RVM
rvm requirements # Эта команда выведет пакеты, которые вам нужно будет установить
# Установите то, о чём вас попросили в предыдущей команде!
rvm install ree # Установка интерпретатора языка ruby, версии 1.8.7 enterprise edition
rvm --default use ree # Использовать этот интерпретатор по умолчанию для текущего пользователя
gem install bundler # Установка менеджера зависимостей
cd /path/to/working/directory
git clone [email protected]:AmurSU/taurus.git # Получение актуального исходного кода
cd taurus
bundle install # Установка всех зависимостей приложения
cp config/database.yml.sample config/database.yml
cp config/taurus.yml.sample config/taurus.yml
Отредактируйте файл config/database.yml для вашей базы данных.
Отредактируйте файл config/taurus.yml под ваши нужды.
rake db:setup # Создание базы данных и её заполнение стандартными значениями
Теперь можно запустить приложение локально при помощи команды rails server.
Установите wkhtmltopdf, например так:
wget http://wkhtmltopdf.googlecode.com/files/wkhtmltopdf-0.9.9-static-amd64.tar.bz2
tar xvjf wkhtmltopdf-0.9.9-static-amd64.tar.bz2
sudo mv wkhtmltopdf-amd64 /usr/local/bin/wkhtmltopdf
sudo chmod +x /usr/local/bin/wkhtmltopdf
Проверяйте лог-файлы приложения (находятся в директории log) при помощи команды tail -f:
- server.log
- development.log
Возможна запись своих сообщений в лог-файл. Пример:
class WeblogController < ActionController::Base
def destroy
@weblog = Weblog.find(params[:id])
@weblog.destroy
logger.info("#{Time.now} Destroyed Weblog ID ##{@weblog.id}!")
end
end
В результате в лог-файле появится запись следующего вида:
Mon Oct 08 14:22:29 +1000 2007 Destroyed Weblog ID #1
Вызов отладчика возможен через команду debugger в исходном коде. Например:
class WeblogController < ActionController::Base
def index
@posts = Post.find(:all)
debugger
end
end
Контроллер начнёт выполнять действие, исполнит первую строчку кода и в консоли сервера предоставит интерактивную оболочку отладчика.
Используйте irb для запуска ruby-оболочки для исполнения тестового кода.
Когда закончите с отладчиком, введите cont.
Вызов команды rails console приведёт к запуску консоли приложения.
Вы получите полностью сконфигурированное и запущенное приложение и будете иметь доступ ко всем моделям, сможете изменять значения и сохранять их в базу данных.
При изменении файлов для перезагрузки контроллеров и моделей выполните reload!
Вызов команды rails dbconsole приведёт к тому, что вы будете подключены к консоли вашей базы данных с учётными данными указанными в database.yml.
Если вы хотите помочь проекту:
- Сделайте форк проекта в своём github-аккаунте.
- Создайте отдельную ветвь разработки.
- Внесите в неё желаемые изменения.
- Создайте pull-request из вашей ветви в ветвь master данного репозитария.
Подробнее об этой модели разработки вы можете прочесть в данной статье.
Данное программное обеспечение распространяется на условиях лицензии MIT:
Copyright © 2010 Амурский государственный университет
Данная лицензия разрешает лицам, получившим копию данного программного обеспечения и сопутствующей документации (в дальнейшем именуемыми «Программное Обеспечение»), безвозмездно использовать Программное Обеспечение без ограничений, включая неограниченное право на использование, копирование, изменение, добавление, публикацию, распространение, сублицензирование и/или продажу копий Программного Обеспечения, также как и лицам, которым предоставляется данное Программное Обеспечение, при соблюдении следующих условий:
Указанное выше уведомление об авторском праве и данные условия должны быть включены во все копии или значимые части данного Программного Обеспечения.
ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНО ВЫРАЖЕННЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ ГАРАНТИЯМИ ТОВАРНОЙ ПРИГОДНОСТИ, СООТВЕТСТВИЯ ПО ЕГО КОНКРЕТНОМУ НАЗНАЧЕНИЮ И ОТСУТСТВИЯ НАРУШЕНИЙ ПРАВ. НИ В КАКОМ СЛУЧАЕ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ПО ИСКАМ О ВОЗМЕЩЕНИИ УЩЕРБА, УБЫТКОВ ИЛИ ДРУГИХ ТРЕБОВАНИЙ ПО ДЕЙСТВУЮЩИМ КОНТРАКТАМ, ДЕЛИКТАМ ИЛИ ИНОМУ, ВОЗНИКШИМ ИЗ, ИМЕЮЩИМ ПРИЧИНОЙ ИЛИ СВЯЗАННЫМ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ ИЛИ ИНЫМИ ДЕЙСТВИЯМИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.
С оригинальным текстом лицензии вы можете ознакомиться на сайте opensource.org.