docs-ru/before_begin.rst

   1
   2 Прежде чем вы начнёте
   3 =====================
   4
   5 Прежде чем вы начнёте, вам потребуются некоторые приготовления.
   6
   7
   8 .. contents::
   9    :local:
  10
  11 .. highlight:: none
  12
  13 Программное обеспечение
  14 -----------------------
  15
  16 m_Librarian написан на языке Python, так что вам нужно скачать и
  17 установить Python 2.7. Нужны также библиотеки SQLObject и m_lib.
  18
  19
  20 Архивы библиотек
  21 ----------------
  22
  23 Данный программный комплекс работает с локальными файлами библиотек, так
  24 что предварительно скачайте некоторые библиотеки. Вот краткий и совсем
  25 не исчерпывающий список для скачивания:
  26
  27 | http://torrent.rus.ec/index.php?c=3
  28 | http://booktracker.org/index.php?c=18
  29 | https://nnm-club.me/forum/viewtopic.php?t=353958
  30 | https://nnm-club.me/forum/viewtopic.php?t=510054
  31 | https://nnm-club.me/forum/viewtopic.php?t=521962
  32 | https://nnm-club.me/forum/viewtopic.php?t=877707
  33
  34 Кроме самих библиотек вам понадобиться найти для них индексы INPX —
  35 m_Librarian пока не научился индексировать архивы библиотек.
  36
  37 Индексы INPX обычно распространяются вместе с программами для работы с
  38 библиотеками, и такие программы есть в архивах по ссылкам выше.
  39 Некоторые индексы можно скачать с сайта одной из таких программ
  40 `MyHomeLib <http://home-lib.net/>`_:
  41
  42 | http://home-lib.net/download/inpx/librusec_local_fb2.inpx
  43 | http://home-lib.net/download/inpx/librusec_local_usr.inpx
  44 | http://home-lib.net/download/inpx/librusec_local_all.inpx
  45
  46
  47 База данных
  48 -----------
  49
  50 Для работы m_Librarian требуется база данных. m_Librarian может работать
  51 с любой БД, поддерживаемой библиотекой SQLObject. Предпочтительные
  52 варианты: MySQL, PostgreSQL или SQLite. При использовании сервера SQL БД
  53 вам придётся создать самим. Для SQLite файл БД будет создан программой,
  54 так что это наиболее простой способ использования m_Librarian,
  55
  56 Database URI
  57 ^^^^^^^^^^^^
  58
  59 Чтобы m_Librarian использовал сервер SQL создайте файл конфигурации и
  60 поместите его в $HOME/.config/ (если у вас POSIX-совместимая ОС). Файл
  61 должен называться ``m_librarian.conf``. Это должен быть файл в формате
  62 ``ini``, в нём должна быть единственная секция ``[database]`` с
  63 единственным ключом ``URI``. Значением ключа должно быть Database URI в
  64 формате, который понимает SQLObject. Вот несколько примеров::
  65
  66    [database]
  67    URI = mysql://user:password@host/database
  68
  69    [database]
  70    URI = postgres://user@host/database
  71
  72    [database]
  73    URI = sqlite:///full/path/to/database
  74
  75 Больше примеров есть в файле sample/m_librarian.conf. Детальное описание
  76 DB URI есть в `документации на SQLObject
  77 <http://sqlobject.org/SQLObject.html#declaring-a-connection>`_.
  78
  79 .. vim: set tw=72 :