.. contents::
:local:
+.. highlight:: none
Программное обеспечение
-----------------------
m_Librarian написан на языке Python, так что вам нужно скачать и
-установить Python 2.7. Нужны также библиотеки SQLObject и m_lib.
+установить Python (2.7 или 3.4+). Нужны также библиотеки SQLObject и
+m_lib.defenc.
Архивы библиотек
что предварительно скачайте некоторые библиотеки. Вот краткий и совсем
не исчерпывающий список для скачивания:
-| http://torrent.rus.ec/index.php?c=3
-| http://booktracker.org/index.php?c=18
-| https://nnm-club.me/forum/viewtopic.php?t=353958
-| https://nnm-club.me/forum/viewtopic.php?t=510054
-| https://nnm-club.me/forum/viewtopic.php?t=521962
-| https://nnm-club.me/forum/viewtopic.php?t=877707
+| Библиотека Flibusta.net [fb2]
+| https://booktracker.org/viewtopic.php?t=46979
+| https://nnmclub.to/forum/viewtopic.php?t=521962
+| http://rutor.info/torrent/703143
+| Библиотека Flibusta.net [fb2, usr]
+| https://booktracker.org/viewtopic.php?t=49016
+| https://nnmclub.to/forum/viewtopic.php?t=353958
+| http://rutor.info/torrent/703146
+| Библиотека Либрусек (lib.rus.ec) + MyHomeLib [FB2]
+| https://booktracker.org/viewtopic.php?t=1198
+| https://nnmclub.to/forum/viewtopic.php?t=1689402
+| http://rutor.info/torrent/962201
+| Библиотека Либрусек (lib.rus.ec) [ALL]
+| https://booktracker.org/viewtopic.php?t=79829
+| https://nnmclub.to/forum/viewtopic.php?t=877707
Кроме самих библиотек вам понадобиться найти для них индексы INPX —
m_Librarian пока не научился индексировать архивы библиотек.
Индексы INPX обычно распространяются вместе с программами для работы с
библиотеками, и такие программы есть в архивах по ссылкам выше.
Некоторые индексы можно скачать с сайта одной из таких программ
-`MyHomeLib <http://home-lib.net/>`_:
+`MyHomeLib <http://myhomelib.org/>`_:
-| http://home-lib.net/download/inpx/librusec_local_fb2.inpx
-| http://home-lib.net/download/inpx/librusec_local_usr.inpx
-| http://home-lib.net/download/inpx/librusec_local_all.inpx
+| http://myhomelib.org/download/inpx/librusec_local_fb2.inpx
+| http://myhomelib.org/download/inpx/librusec_local_usr.inpx (не обновляется)
+| http://myhomelib.org/download/inpx/librusec_local_all.inpx (не обновляется)
+| https://booktracker.org/viewtopic.php?t=64690
+| https://booktracker.org/viewtopic.php?t=74487
+| https://nnmclub.to/forum/viewtopic.php?t=875907
+| http://rutor.info/torrent/543085
+Файл конфигурации
+-----------------
+
+Файл конфигурации по умолчанию ищется в $HOME/.config/ (если у вас
+POSIX-совместимая ОС). Файл должен называться ``m_librarian.conf``. Это
+должен быть файл в формате ``ini``. В настоящий момент m_librarian
+понимает следующие секции и ключи в них::
+
+ [database]
+ URI = "DB URI"
+
+ [library]
+ path = "путь к архивам библиотеки"
+
+ [download]
+ format = "формат имён сохраняемых файлов"
+
+Большинство программ имею опцию `-C|--config config`, которая позволяет
+использовать файл произвольный конфигурации.
База данных
-----------
вам придётся создать самим. Для 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
+<http://sqlobject.org/SQLObject.html#declaring-a-connection>`_.
.. vim: set tw=72 :