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