Allow to set download format

[m_librarian.git] / docs-ru / command_line.rst

diff --git a/docs-ru/command_line.rst b/docs-ru/command_line.rst
index 417955838a061b4bd3f709d27b5d1a6e66e5d2ac..872ef5c9d1ebf16b02a51f960a5e9e69273b7a97 100644 (file)
--- a/docs-ru/command_line.rst
+++ b/docs-ru/command_line.rst
@@ -116,8 +116,8 @@ ml-search.py
 При использовании опции `-v` также выводится id из БД.
 
 
-Поиск книг
-^^^^^^^^^^
+п÷п╬п╦я│п╨ п╦ п╥п╟пЁя─я┐п╥п╨п╟ п╨п╫п╦пЁ
+^^^^^^^^^^^^^^^^^^^^^
 
 Использование::
 
@@ -170,6 +170,30 @@ ml-search.py
 использовать эту команду — совместно с опцией `--id`. Файл сохраняется в
 текущую директорию с тем именем, под которым он храниться в библиотеке.
 
+Ключ `format` в секции `[download]` файла конфигурации m_librarian.conf
+
+|    [download]
+|    format = %a/%s/%n %t
+
+позволяет управлять именами директорий и именем файла, куда m_Librarian
+будет сохранять файлы. Формат по умолчанию `%f`, т.е. просто имя файла.
+Другие доступные спецификаторы::
+
+    %a - автор (один из, если их несколько)
+    %e - расширение имени файла
+    %f - имя файла
+    %G - жанр (один из, если их несколько), имя из БД
+    %g - жанр (один из, если их несколько), название
+    %l - язык
+    %n - номер в серии (или 0)
+    %s - серия
+    %t - название
+
+Формат не должен заканчиваться на разделитель директорий (`/` или `\\`).
+Если спецификатор `%e` (расширение) не найден в формате, он добавляется
+в конец с точкой в качестве разделителя. Т.о. формат `%f` эквивалентен
+формату `%f.%e`.
+
 
 Поиск расширений
 ^^^^^^^^^^^^^^^^