Skip to content

1. Setup с чего начать?

Jump to bottom
Elmira edited this page Oct 3, 2017 · 8 revisions

Setup - с чего начать работу над корпусом?

1) Репозиторий

Во-первых, тебе нужен весь код корпуса на твоем компьютере, иначе как ты будешь писать код=)

Для этого тебе нужно склонировать репозиторий на свой компьютер:

git clone https://github.com/elmiram/russian_learner_corpus.git your_directory_name

или в PyCharm:

VCS -> Checkout from Version Control -> GitHub и ввести ссылку на этот репозиторий + придумать название папки на твоем компе, куда все скопируется.

2) Virtualenv

Проект писался на Python 2.7 и Django 1.7. Скорее всего у тебя стоит третий питон и какая-нибудь новая версия джанги, с ними ничего работать не будет. Нам нужно создать виртуальное окружение, внутри которого будет жить проект.

Это проще всего сделать в PyCharm: File -> Settings -> Project -> Project Interpreter. Затем снова кликаем Project Interpreter и в выпадающем списке выбираем Show all, нажимаем плюсик и выбираем Create VirtualEnv, придумываем окружению название, выбираем место установки и версию питона 2.7.

Ну или можно то же самое сделать в командной строке - https://virtualenv.pypa.io/en/latest/.

Затем нужно в виртуальное окружение установить нужные нам модули:

  • Django 1.7
  • XlsxWriter 1.0.0
  • mysql-python 1.2.5

3) База данных

В-третьих, тебе нужна база данных, которая используется в корпусе.

В корпусе используется MySQL, поэтому для работы нужно установить MySQL сервер на свой компьютер. Установщик для твоей операционной системы скачать можно здесь - https://dev.mysql.com/downloads/mysql/, нам нужен MySQL Community Server. При установке можно выбрать mode - лучше если это будет Developer Mode, там кроме самого сервера есть еще полезные штуки, например MySQL Workbench, который нам пригодится.

Еще нужно скачать саму базу данных - это будет sql файл, ссылку можно попросить у меня (предупреждаю, база весит 1 ГБ).

Дальше загружаем базу данных на наш локальный MySQL Server:

  • открываем MySQL Workbench,
  • там есть такой сайдбар с надписью MANAGEMENT, там выбираем Data Import/Restore,
  • Import from Disk -> Import from Self-Contained File -> выбираем наш файл с базой данных,
  • там, где написано Default target schema нажимаем New... и придумываем название нашей базы данных (например, corpus),
  • нажимаем Start Import и ждем (может быть и все минут 20), до тех пор пока нам не скажут, что Import Successful или что-то такое.

4) Настройки и пароли

Тебе нужен файл с секретными сеттингами - там пароли от баз данных и т.д.

Для него нужно знать все ту же ссылку. Это json-файл, его нужно положить в папку с проектом (туда же, где лежит manage.py) и руками туда внести изменения:

  • "DEV_DATABASES_USER": написать свой юзернейм, который мы писали при установке MySQL Server (если ничего не писали, то ставим root)",
  • "DEV_DATABASES_PASSWORD": здесь пароль от MySQL Server,
  • "DEV_DATABASES_NAME": это как мы назвали таргет схему, когда импортили базу в Workbench,
  • "DEV_PATH_TO_MYSTEM": это путь к майстему на компьютере.

Кроме того, нужно убедиться, что "DEBUG" установлен как true.

5) Запуск сервера

Теперь нужно проверить, что все работает.

Если у тебя PyCharm, то открываем проект с корпусом, дальше в меню Tools -> Run manage.py Task.. -> в появившейся консоли пишем runserver и жмем Enter.

Если не PyCharm, то идем в терминал, переходим в директорию с проектом, и пишем

python manage.py runserver

Всё! На этом месте консоль должна сказать что-то вроде

Starting development server at http://127.0.0.1:8000/

Quit the server with CTRL-BREAK.

и локальная версия корпуса будет доступна на http://127.0.0.1:8000/.

Теперь можно попробовать внести свои изменения! Для начала можно сделать что-нибудь маленькое, например, в папке templates есть файл base.html. Можно попробовать в строчке

<a href="{% url 'start_page' %}" class="navbar-brand">{% trans "RLC"%}</a>

заменить RLC на траляля и посмотреть, что получится.

Clone this wiki locally