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 или 3.4+). Нужны также библиотеки SQLObject и
  18 m_lib.defenc.
  19
  20
  21 Архивы библиотек
  22 ----------------
  23
  24 Данный программный комплекс работает с локальными файлами библиотек, так
  25 что предварительно скачайте некоторые библиотеки. Вот краткий и совсем
  26 не исчерпывающий список для скачивания:
  27
  28 |   Библиотека Flibusta.net [fb2]
  29 |      https://booktracker.org/viewtopic.php?t=46979
  30 |      https://nnm-club.me/forum/viewtopic.php?t=521962
  31 |      http://rus-tor.com/torrent/542970
  32 |   Библиотека Flibusta.net [fb2, usr]
  33 |      https://booktracker.org/viewtopic.php?t=49016
  34 |      https://nnm-club.me/forum/viewtopic.php?t=353958
  35 |      http://rus-tor.com/torrent/543084
  36 |   Библиотека Либрусек (lib.rus.ec) + MyHomeLib [FB2]
  37 |      https://booktracker.org/viewtopic.php?t=1198
  38 |      https://nnm-club.me/forum/viewtopic.php?t=510054
  39 |      http://rus-tor.com/torrent/212528
  40 |   Библиотека Либрусек (lib.rus.ec) [ALL]
  41 |      https://booktracker.org/viewtopic.php?t=79829
  42 |      https://nnm-club.me/forum/viewtopic.php?t=877707
  43
  44 Кроме самих библиотек вам понадобиться найти для них индексы INPX —
  45 m_Librarian пока не научился индексировать архивы библиотек.
  46
  47 Индексы INPX обычно распространяются вместе с программами для работы с
  48 библиотеками, и такие программы есть в архивах по ссылкам выше.
  49 Некоторые индексы можно скачать с сайта одной из таких программ
  50 `MyHomeLib <http://myhomelib.org/>`_:
  51
  52 | http://myhomelib.org/download/inpx/librusec_local_fb2.inpx
  53 | http://myhomelib.org/download/inpx/librusec_local_usr.inpx (не обновляется)
  54 | http://myhomelib.org/download/inpx/librusec_local_all.inpx (не обновляется)
  55 | https://booktracker.org/viewtopic.php?t=64690
  56 | https://booktracker.org/viewtopic.php?t=74487
  57 | https://nnm-club.me/forum/viewtopic.php?t=875907
  58 | http://rus-tor.com/torrent/543085
  59
  60 Файл конфигурации
  61 -----------------
  62
  63 Файл конфигурации по умолчанию ищется в $HOME/.config/ (если у вас
  64 POSIX-совместимая ОС). Файл должен называться ``m_librarian.conf``. Это
  65 должен быть файл в формате ``ini``. В настоящий момент m_librarian
  66 понимает следующие секции и ключи в них::
  67
  68     [database]
  69     URI = "DB URI"
  70
  71     [library]
  72     path = "путь к архивам библиотеки"
  73
  74     [download]
  75     format = "формат имён сохраняемых файлов"
  76
  77 Большинство программ имею опцию `-C|--config config`, которая позволяет
  78 использовать файл произвольный конфигурации.
  79
  80 База данных
  81 -----------
  82
  83 Для работы m_Librarian требуется база данных. m_Librarian может работать
  84 с любой БД, поддерживаемой библиотекой SQLObject. Предпочтительные
  85 варианты: MySQL, PostgreSQL или SQLite. При использовании сервера SQL БД
  86 вам придётся создать самим. Для SQLite файл БД будет создан программой,
  87 так что это наиболее простой способ использования m_Librarian,
  88
  89 Database URI
  90 ^^^^^^^^^^^^
  91
  92 Чтобы m_Librarian использовал сервер SQL в файле конфигурации должна
  93 быть секция ``[database]`` с единственным ключом ``URI``. Значением
  94 ключа должно быть Database URI в формате, который понимает SQLObject.
  95 Вот несколько примеров::
  96
  97    [database]
  98    URI = mysql://user:password@host/database
  99
 100    [database]
 101    URI = postgres://user@host/database
 102
 103    [database]
 104    URI = sqlite:///full/path/to/database
 105
 106 Больше примеров есть в файле sample/m_librarian.conf. Детальное описание
 107 DB URI есть в `документации на SQLObject
 108 <http://sqlobject.org/SQLObject.html#declaring-a-connection>`_.
 109
 110 .. vim: set tw=72 :