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.defenc.
  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 Файл конфигурации по умолчанию ищется в $HOME/.config/ (если у вас
  51 POSIX-совместимая ОС). Файл должен называться ``m_librarian.conf``. Это
  52 должен быть файл в формате ``ini``. В настоящий момент m_librarian
  53 понимает следующие секции и ключи в них::
  54
  55     [database]
  56     URI = "DB URI"
  57
  58     [library]
  59     path = "путь к архивам библиотеки"
  60
  61     [download]
  62     format = "формат имён сохраняемых файлов"
  63
  64 Большинство программ имею опцию `-C|--config config`, которая позволяет
  65 использовать файл произвольный конфигурации.
  66
  67 База данных
  68 -----------
  69
  70 Для работы m_Librarian требуется база данных. m_Librarian может работать
  71 с любой БД, поддерживаемой библиотекой SQLObject. Предпочтительные
  72 варианты: MySQL, PostgreSQL или SQLite. При использовании сервера SQL БД
  73 вам придётся создать самим. Для SQLite файл БД будет создан программой,
  74 так что это наиболее простой способ использования m_Librarian,
  75
  76 Database URI
  77 ^^^^^^^^^^^^
  78
  79 Чтобы m_Librarian использовал сервер SQL в файле конфигурации должна
  80 быть секция ``[database]`` с единственным ключом ``URI``. Значением
  81 ключа должно быть Database URI в формате, который понимает SQLObject.
  82 Вот несколько примеров::
  83
  84    [database]
  85    URI = mysql://user:password@host/database
  86
  87    [database]
  88    URI = postgres://user@host/database
  89
  90    [database]
  91    URI = sqlite:///full/path/to/database
  92
  93 Больше примеров есть в файле sample/m_librarian.conf. Детальное описание
  94 DB URI есть в `документации на SQLObject
  95 <http://sqlobject.org/SQLObject.html#declaring-a-connection>`_.
  96
  97 .. vim: set tw=72 :