docs-ru/before_begin.rst

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