Прежде чем вы начнёте

Прежде чем вы начнёте, вам потребуются некоторые приготовления.

Программное обеспечение

m_Librarian написан на языке Python, так что вам нужно скачать и установить Python (2.7 или 3.4+). Нужны также библиотеки SQLObject и m_lib.defenc.

Архивы библиотек

Данный программный комплекс работает с локальными файлами библиотек, так что предварительно скачайте некоторые библиотеки. Вот краткий и совсем не исчерпывающий список для скачивания:

Кроме самих библиотек вам понадобиться найти для них индексы INPX — m_Librarian пока не научился индексировать архивы библиотек.

Индексы INPX обычно распространяются вместе с программами для работы с библиотеками, и такие программы есть в архивах по ссылкам выше. Некоторые индексы можно скачать с сайта одной из таких программ MyHomeLib:

Файл конфигурации

Файл конфигурации по умолчанию ищется в $HOME/.config/ (если у вас POSIX-совместимая ОС). Файл должен называться m_librarian.conf. Это должен быть файл в формате ini. В настоящий момент m_librarian понимает следующие секции и ключи в них:

[database]
URI = "DB URI"

[library]
path = "путь к архивам библиотеки"

[download]
format = "формат имён сохраняемых файлов"

Большинство программ имею опцию -C|–config config, которая позволяет использовать файл произвольный конфигурации.

База данных

Для работы m_Librarian требуется база данных. m_Librarian может работать с любой БД, поддерживаемой библиотекой SQLObject. Предпочтительные варианты: MySQL, PostgreSQL или SQLite. При использовании сервера SQL БД вам придётся создать самим. Для SQLite файл БД будет создан программой, так что это наиболее простой способ использования m_Librarian,

Database URI

Чтобы m_Librarian использовал сервер SQL в файле конфигурации должна быть секция [database] с единственным ключом URI. Значением ключа должно быть Database URI в формате, который понимает SQLObject. Вот несколько примеров:

[database]
URI = mysql://user:password@host/database

[database]
URI = postgres://user@host/database

[database]
URI = sqlite:///full/path/to/database

Больше примеров есть в файле m_librarian.conf.sample. Детальное описание DB URI есть в документации на SQLObject.