X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs-ru%2Fbefore_begin.rst;h=bfdf742a8f4edd502fe9633854c57766e6d63778;hb=27e67b25ddd894ac7d6c6ef8d507e2d72d1a7004;hp=e23543a179d7529b688dbd30b28b4a1e87b68331;hpb=f914b910cf3f1bd2940a664a67ede3683ba9e1fb;p=m_librarian.git

diff --git a/docs-ru/before_begin.rst b/docs-ru/before_begin.rst
index e23543a..bfdf742 100644
--- a/docs-ru/before_begin.rst
+++ b/docs-ru/before_begin.rst
@@ -8,12 +8,13 @@
 .. contents::
    :local:
 
+.. highlight:: none
 
 Программное обеспечение
 -----------------------
 
 m_Librarian написан на языке Python, так что вам нужно скачать и
-установить Python 2.7. Нужны также библиотеки SQLObject и m_lib.
+установить Python 2.7. Нужны также библиотеки SQLObject и m_lib.defenc.
 
 
 Архивы библиотек
@@ -43,6 +44,26 @@ m_Librarian пока не научился индексировать архив
 | http://home-lib.net/download/inpx/librusec_local_all.inpx
 
 
+Файл конфигурации
+-----------------
+
+Файл конфигурации по умолчанию ищется в $HOME/.config/ (если у вас
+POSIX-совместимая ОС). Файл должен называться ``m_librarian.conf``. Это
+должен быть файл в формате ``ini``. В настоящий момент m_librarian
+понимает следующие секции и ключи в них::
+
+    [database]
+    URI = "DB URI"
+
+    [library]
+    path = "путь к архивам библиотеки"
+
+    [download]
+    format = "формат имён сохраняемых файлов"
+
+Большинство программ имею опцию `-C|--config config`, которая позволяет
+использовать файл произвольный конфигурации.
+
 База данных
 -----------
 
@@ -52,5 +73,25 @@ m_Librarian пока не научился индексировать архив
 вам придётся создать самим. Для SQLite файл БД будет создан программой,
 так что это наиболее простой способ использования m_Librarian,
 
+Database URI
+^^^^^^^^^^^^
+
+Чтобы m_Librarian использовал сервер SQL в файле конфигурации должна
+быть секция ``[database]`` с единственным ключом ``URI``. Значением
+ключа должно быть Database URI в формате, который понимает SQLObject.
+Вот несколько примеров::
+
+   [database]
+   URI = mysql://user:password@host/database
+
+   [database]
+   URI = postgres://user@host/database
+
+   [database]
+   URI = sqlite:///full/path/to/database
+
+Больше примеров есть в файле sample/m_librarian.conf. Детальное описание
+DB URI есть в `документации на SQLObject
+<http://sqlobject.org/SQLObject.html#declaring-a-connection>`_.
 
 .. vim: set tw=72 :