Инсталация за разработка

Тук може да прочетете как да си подкарате проекта локално, с цел експеримент, доразработка или персонализиране.

Накратко, сайтът се подкарва като класически Rails проект. Имате нужда от версия на Ruby (1.9+) и Bundler. Използва PostgreSQL база данни. Има и други зависимости, но за повечето експерименти, това би трябвало да е достатъчно.

Подробна документация за зависимостите на проекта и как да се инсталира, включително и на production машина, има в ръководството за инсталация на оригиналния проект.

Стъпка по стъпка

1. Инсталирайте необходими библиотеки на операционната система.

   Необходими пакети devel пакети за RedHat/CentOS-базирани дистрибуции:

   • За mahoro gem yum install ImageMagick-devel file-devel
   • За postgresql gem yum install postgresql-devel
   • За xapian-full-alaveteli gem yum install libuuid-devel

   За Debian/Ubuntu, потърсете съответните пакети и ги инсталирайте с apt-get/aptitude.

   За Mac OS може да използвате homebrew.

2. Клонирайте си хранилището. Изпълнете git submodule update --init.

3. Инсталирайте зависимостите с bundle install.

4. Създайте си config/database.yml, config/general.yml и config/newrelic.yml. Има примерни версии на тези файлове в хранилището, могат да се ползват за основа. Редактирайте ги, за да паснат на вашата конфигурация. Документация за значението на конфигурационните опции има тук.

5. Инсталирайте си темата, посочена в config/general.yml с bundle exec rake themes:install. Този проект използва собствена тема, която се намира в това хранилище.

6. Създайте структурата на базата и заредете примерни данни: bundle exec rake db:create:all db:setup db:seed.

7. Изпълнете script/update-xapian-index.

Това би трябвало да е достатъчно. Като стартирате проекта с rails server, на localhost:3000 би трябвало да може да видите работещо копие.

Тестове

Тестовете се пускат по следния начин:

bundle exec rake db:test:prepare
bundle exec rspec

За да минават тестовете, е необходимо да имате инсталирани следните програми локално:

• elinks
• unrtf
• pdftk

На Mac OS X може да ги инсталирате по следния начин:

brew install unrtf elinks

PDFtk може да се свали и инсталира от официалния сайт.

Следващи стъпки

След като подкарате проекта, е преопръчително да се запознаете с документацията за разработчици. Документацията е кратка и дава добър общ поглед над структурата на проекта.

При неточности, може да допълните това ръководство.