X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs-ru%2Fcommand_line.rst;h=8dc7aa6913f3c55f351255c7a7940348fe23e498;hb=refs%2Ftags%2F0.1.6;hp=70cd7cf0004d4d1d7b22b77e88e73e53d546837b;hpb=2b29248d0a515b4e0b33183eae584511bf399bfd;p=m_librarian.git diff --git a/docs-ru/command_line.rst b/docs-ru/command_line.rst index 70cd7cf..8dc7aa6 100644 --- a/docs-ru/command_line.rst +++ b/docs-ru/command_line.rst @@ -29,12 +29,13 @@ ml-import.py Использование:: - ml-import.py [-C] [-D] [file.inpx ...] + ml-import.py [-C] [-D] [-P] [file.inpx ...] Опции:: -C, --config config Путь к файлу конфигурации -D, --database database Использовать указанную БД + -P, --no-pbar Не показывать индикатор процесса Инициализирует базу данных, импортирует список жанров и список файлов INPX, перечисленных в командной строке. При повторных запусках не @@ -148,7 +149,9 @@ ml-search.py --gid gid Искать по id жанра -l, --lang lang Искать по языку --lid lid Искать по id языка + --filters Использовать фильтры из файла конфигурации -P, --path path Путь к директории с архивами библиотеки + --download-to [path] Путь к директории для сохранения книг -F, --format format Формат имени сохраняемого файла --get Загрузить ровно один файл --get-many N Загрузить не больше указанного числа файлов @@ -171,6 +174,25 @@ ml-search.py Опция полезна в ситуации работы с несколькими базами данных (глобальная опция `-D`). +Опция `--filters` включает использование фильтров из файла конфигурации. +Фильтры записываются следующим образом:: + + [filters] + lang = en ru + deleted = 0 + +Фильтр `lang` перечисляет список языков, которыми будет ограничен поиск. +Фильтр `deleted` — это флаг 0/1; 0 означает, что удалённые книги не +будут найдены. + +Опция `--download-to` задаёт путь к директории для сохранения книг. +По умолчанию скрипт сохраняет книги в текущую директорию. +Если опция используется без указания аргумента `path` скрипт использует +значение из файла конфигурации, секция `[download]`, ключ `path`:: + + [download] + path = /tmp + Опция `--get` позволяет загрузить книгу из библиотеки в файл. Опция позволяет загрузить ровно одну книгу, поэтому самый простой способ использовать эту команду — совместно с опцией `--id`. Файл сохраняется в @@ -256,4 +278,25 @@ ml-search.py При использовании опции `-v` также выводится id из БД. + +ml-web.py +------------ + +Использование:: + + ml-web.py [-p port] + +Опции:: + + -p, --port port Порт протокола HTTP + +Запускает web-сервер. Если указан порт, то используется указанный порт. +Иначе выбирается случайный порт из числа свободных. Программа запускает +браузер (или открывает новое окно уже запущенного web-обозревателя) с +адресом, указывающим на сервер. + +Если одна копия программы уже запущена, а пользователь запустил вторую, +вторая копия определяет наличие первой, запускает браузер с адресом +первого web-сервера и останавливается. + .. vim: set tw=72 :