Руководство пользователя Установка необходимого программного обеспечения

На прилагаемом компакт-диске находится программное обеспечение и сама программа. Программное обеспечение разбито на папки Windows и Linux для установки под Windows и Linux соответственно. В папке src находится программа.

Windows

1. Установка MySQL Server (пункт не является необходимым, если вы хотите использовать программу с другой базой или имеете установленную MySQL)

1. Запустите файл mysql-5.1.52-winx64.msi или скачайте новую версию с mysql.org

2. Следуйте инструкциям в ходе установки

2. Установка Python 2.6

1. Запустите python-2.6.6.msi

2. Желательно устанавливать по короткому пути (например, C:\Python), так как при использовании многосложных путей (Program Files) могут возникнуть ошибки

3. Установка wxPython

1. Запустите wxPython2.8-win64-unicode-2.8.11.0-py26.exe или wxPython2.8-win32-docs-demos-2.8.11.0.exe в зависимости от используемой версии windows

2. Следуйте инструкциям при установке. Программа должна сама найти установленный интерпретатор Python. Если этого не происходит, то попробуйте перезагрузиться, а в случае неудачи повторите 2-й пункт

4. Установка MySQL-python-1.2.3

1. Распакуйте архив MySQL-python-1.2.3 (1).tar.gz

2. Зайдите в распакованную папку

3. Из командной строки (cmd) выполните команду python setup.py install

4. Возможно для установки потребуется аналог компилятора c++ (например gcc, cygwin или Microsoft c++ redistrutable)

5. Установка sqlalchemy

1. Распакуйте SQLAlchemy-0.6.5.tar.gz

2. Зайдите в распакованную папку

3. Выполните python setup.py install

6. Установка iniparser

1. Распакуйте iniparser3.0b.tar.gz

2. Зайдите в распакованную папку

3. Из командной строки выполните python setup.py install

Linux

Вообще для установки python и wxPython я рекомендую использовать какой-нибудь менеджер пакетов, например synaptic (/usr/sbin/synaptic). В других же случаях установка python, wxPython, gtk и gtk-inspector (последние 2 требуются для нормальной компиляции wxPython) могут быть связаны с трудностями. На диске лежат дистрибутивы, установка большинства из них проходит стандартным путём через ./configure, make, make install. Стандартные опции для компиляции можно найти на сайтах производителей.

Дистрибутив MySQL представлен RPM-пакетом.

Первым делом рекомендую установить easy_install. Для этого распакуйте setuptools-0.6c11.tar.gz и выполнители последовательно шаги ./configure make make install. Или используйте apt-get install easy_install.

Затем другие пакеты можно использовать посредством easy_install. Для этого должен быть подключен интернет. В easy_install передаётся путь на репозитарий

Запуск и использование программы

1. Создайте пустую базу данных в MySQL

2. Распакуйте myLib.tar.gz в удобную вам папку.

3. Выполните запросы к базе. allstructure.sql в принципе можно не выполнять, так как sqlalchemy сама создаст необходимую базу, а вот alldata.sql выполнить рекомендуется, так как там описаны встроенные и используемые мной типы аудио и видеофайлов, а также база тэгов.

4. Если вы используете Windows, то в файле удалите (закомментируйте) 4 строку в файле parser.py

import smbclient

Также удалите строки со 106 по 135, и замените 136 на if 1: если вы не хотите удалять табуляцию ниже. Получившаяся функция должна иметь такой вид:

def parseDir(self, line=''):

print 'Line %s' %line

if 1:

top = self.line

for root, dirs, files in os.walk(top, topdown=False):

for name in files:

print os.path.join(root, name)

sPath = self.nPath2Storage(os.path.join(root, name))

print self.sPath2Native(sPath)

if self.retExtension(str(name)) in self.videoExt:

self.session.add(films(sPath, str(name)))

elif self.retExtension(str(name)) in self.audioExt:

self.session.add(audio(sPath, str(name)))

elif self.retExtension(str(name)) in self.docsExt:

self.session.add(docs(sPath, str(name)))

self.session.commit()

5. В mainFrame.py измените строку 1247 на используемую вами БД. Если вы запустили сервер MySQL на локальной машине и оставили пустой root-овый пароль, то строка будет выглядеть так:

engine = create_engine('mysql://root@127.0.0.1:3306/[имя_вашей_базы_на_1м_шаге]', echo=True)

echo можно установить в False, если вы не хотите получать вывод информации в консоль

6. Запуск программы осуществляется посредством выполнения команды python myLib.py. В Linux рекомендую выполнять данную команду как sudo python myLib.py

7. При первом запуске рекомендуется сразу создать хранилища. Не используйте встроенные хранилища, то есть, например, если у вас есть папка D:\my и в ней есть 2 подпапки D:\my\video и D:\my\audio, то либо создайте 2 разных соответствующих хранилища, либо используйте 1 хранилище D:\my

8. Добавляйте папки или целые директории посредством пункта меню

9. После нажатия на сохранить программа начнёт рекурсивно перебирать папки и сохранять найденные файлы в соответствующие базы. В консоле это будет выглядеть так:

10. Программа может обрабатывать сетевые пути. В Windows для этого ничего делать не надо (только добавить на 7м шаге правильно хранилища, например, \\comp1\Share\), а в Linux надо указать smb://comp1/Share/ (или smb://username:password@comp1/Share/) в качестве адреса, причём нельзя указывать smb://comp1/ или smb://comp1/Share/somedir. Это связано с особенностями работы smbclient, но можно сказать, что правила подключения аналогичны таковым при монтировании сетевой папки (mount -t smbfs //server/share /mnt/<папка>)

11. После добавления вы идёте в нужный раздел и выбираете необходимый объект. Компонент поддерживает редактирование непосредственно в решётке:

12. Вы можете кликнуть по названию столбца для сортировки по этому столбцу:

13. Для расширенного редактирования, например для редактирования группы файлов, или для ввода тэгов и актёров или преподавателей кликните правой кнопкой мыши после выделения нужны полей.

14. В открывшемся окне редактирования можно редактировать любые поля. Следует помнить, что если поле не пустое и не None, то для группы файлов оно будет заменено. Будьте аккуратны например с именем файла, которое случайно может замениться.

15. Как видно из скриншота выше, поле тэги поддерживает автозаполнение. Оно автоматом подбирает тэги на начальные буквы которые вы ввели (или показывает все тэги если фокус стоит в поле, а букв не введено). Аналогичное действует и для полей артисты и для полей преподаватели.

16. Для перехода к просмотру тэгов можно использовать пункт меню Тэги -> Тезаурус или нажать Alt-T на клавиатуре. Каждый тэг можно просмотреть и отредактировать. Например, сейчас мы редактируем тэг groove metal.

17. Облака тэгов служит для просмотра и визуальной оценки количества используемых тэгов. Например, здесь появился новый тэг groove metal (по сравнению с рисунком на странице 17), вырос тэг alternative metal и nu metal.

18. В целом обзор программы закончен. В программе действуют следующие быстрые клавиши:

• Alt-X – выход из программы

• Alt-T – просмотр тезауруса

• Alt-C – просмотр облака тэгов

Из дополнительных продуктов на диске находится программа Protégé для создания онтологий, а также Navicat – программа для удобной работы с базой данных. Обе программы находятся в папке Windows. Кроме того на диске находится разработанная онтология (my.owl в папке src).