X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs-ru%2Fcommand_line.rst;h=417955838a061b4bd3f709d27b5d1a6e66e5d2ac;hb=c8d30e34f836043394515b37115dc4b490bd7fc3;hp=a74b45be2d14bedd26cc55969c20781b4c183397;hpb=fc42dcaa2908ea3d5f7e1db5d4a777bbac9a05b4;p=m_librarian.git diff --git a/docs-ru/command_line.rst b/docs-ru/command_line.rst index a74b45b..4179558 100644 --- a/docs-ru/command_line.rst +++ b/docs-ru/command_line.rst @@ -10,6 +10,14 @@ ml-initdb.py ------------ +Использование:: + + ml-initdb.py [-d] + +Опции:: + + -d, --database database Использовать указанную БД + Инициализирует базу данных и импортирует список жанров. Этот скрипт не очень-то нужен, так как следующий скрипт делает всё указанное. @@ -19,7 +27,11 @@ ml-import.py Использование:: - ml-import.py [file.inpx ...] + ml-import.py [-d] [file.inpx ...] + +Опции:: + + -d, --database database Использовать указанную БД Инициализирует базу данных, импортирует список жанров и список файлов INPX, перечисленных в командной строке. При повторных запусках не @@ -32,22 +44,25 @@ ml-search.py Использование:: - ml-search.py [-i] [-I] [-t] [-s] [-f] [-d] ... + ml-search.py [-d] [-i] [-I] [-t] [-s] [-f] [-v] [-c] ... Программа выполняет поиск по базе данных и показывает список результатов. В настоящее время может искать только в списке авторов. Глобальные опции:: - -i, --ignore-case независимо от регистра (по умолчанию: угадать) - -I, --case-sensitive с учётом регистра - -t, --start тип поиска: подстрока в начале строки - (это тип поиска по умолчанию) - -s, --substring тип поиска: подстрока в любом месте - -f, --full тип поиска: полное совпадение всей строки - -d, --details Выводить больше информации о найденных - объектах; повторите эту опцию несколько раз, - чтобы получить ещё больше деталей + -d, --database database Использовать указанную БД + -i, --ignore-case независимо от регистра (по умолчанию: угадать) + -I, --case-sensitive с учётом регистра + -t, --start тип поиска: подстрока в начале строки + (это тип поиска по умолчанию) + -s, --substring тип поиска: подстрока в любом месте + -f, --full тип поиска: полное совпадение всей строки + -c, --count Выводить число найденных объектов, а не сами + объекты + -v, --verbose Выводить больше информации о найденных + объектах; повторите эту опцию несколько раз, + чтобы получить ещё больше деталей Опции ``-i/-I`` не могут использованы одновременно, поскольку означают противоположные команды. В случае, если ни одна из них не использована, @@ -71,7 +86,7 @@ ml-search.py Использование:: - ml-search.py [-i/-I] [-t/-s/-f] author [-s surname] [-n name] [-m misc-name] [fullname] + ml-search.py author [-s surname] [-n name] [-m misc-name] [--id id] [fullname] Искать и печатать список авторов по фамилии, имени, доп. имени (обычно отчеству) или полному имени. @@ -81,6 +96,7 @@ ml-search.py -s, --surname фамилия Искать по фамилии -n, --name имя Искать по имени -m, --misc-name доп. имени Искать по доп. имени + --id id Искать по id автора Пример:: @@ -97,7 +113,7 @@ ml-search.py Искать и печатать список авторов, чья фамилия начинается на "друг" и имя начинается на "в", без учёта регистра. -При использовании опции `-d` также выводится id из БД. +При использовании опции `-v` также выводится id из БД. Поиск книг @@ -105,7 +121,7 @@ ml-search.py Использование:: - ml-search.py [-i/-I] [-t/-s/-f] books [-t title] [-s series] [-a archive] [-f file] [--surname name] [--name name] [--misc-name name] [--fullname name] [--gname name] [--gtitle title] [-e ext] [-l lang] + ml-search.py books [-t title] [-s series] [-a archive] [-f file] [-p path] [--get] [--id id] [--surname name] [--name name] [--misc-name name] [--fullname name] [--aid aid] [-e ext] [--eid eid] [--gname name] [--gtitle title] [--gid gid] [-l lang] [--lid lid] Искать и печатать список книг по заголовку, серии, архиву, имени файла. @@ -115,34 +131,60 @@ ml-search.py -s, --series серия Искать по серии -a, --archive архив Искать по имени архива (zip-файла) -f, --file файл Искать по имени файла (без расширения) + -p, --path path Путь к директории с архивами библиотеки + --get Загрузить ровно один файл + --id id Искать по id книги --surname surname Искать по фамилии автора --name name Искать по имени автора --misc-name misc. name Искать по доп. имени автора --fullname name Искать по полному имени автора + --aid aid Искать по id автора -e, --ext ext Искать по расширению имени файла + --eid eid Искать по id расширения --gname name Искать по названию жанра --gtitle title Искать по заголовку жанра + --gid gid Искать по id жанра -l, --lang lang Искать по языку + --lid lid Искать по id языка По умолчанию программы выводит список заголовков найденных книг. При -использовании опции `-d` также выводится id из БД, список авторов и +использовании опции `-v` также выводится id из БД, список авторов и жанров, а также серия, к которой принадлежит книга (если принадлежит) и -порядковый номер книги в этой серии. С двумя опциями `-d` (`-d -d` или -просто `-dd`) программа выводит дату файла и язык. С тремя `-d` +порядковый номер книги в этой серии. С двумя опциями `-v` (`-v -v` или +просто `-vv`) программа выводит дату файла и язык. С тремя `-v` выводятся имя архива, имя файла, расширение и размер файла, и признак, была ли книга помечена как удалённая. +Опция `-p` задаёт путь к директории с архивами библиотеки. По умолчанию +этот путь берётся из файла конфигурации `m_librarian`, секция +`[library]`, ключ `path`, например:: + + [library] + path = /var/lib/archives + +Опция полезна в ситуации работы с несколькими базами данных (глобальная +опция `-d`). + +Опция `--get` позволяет загрузить книгу из библиотеки в файл. Опция +позволяет загрузить ровно одну книгу, поэтому самый простой способ +использовать эту команду — совместно с опцией `--id`. Файл сохраняется в +текущую директорию с тем именем, под которым он храниться в библиотеке. + Поиск расширений ^^^^^^^^^^^^^^^^ Использование:: - ml-search.py [-i/-I] [-t/-s/-f] ext [name] + ml-search.py ext [name] [--id id] + +Опции:: + + --id id Искать по id расширения Искать и печатать список расширений имён файлов по имени. -При использовании опции `-d` также выводится id из БД. +При использовании опции `-v` также выводится id из БД. Поиск жанров @@ -150,7 +192,7 @@ ml-search.py Использование:: - ml-search.py [-i/-I] [-t/-s/-f] genres [-n name] [-t title] + ml-search.py genres [-n name] [-t title] [--id id] Искать и печатать список жанров по имени и заголовку. @@ -158,8 +200,9 @@ ml-search.py -n, --name имя Искать по названию -t, --title заголовок Искать по заголовку + --id id Искать по id жанра -При использовании опции `-d` также выводится id из БД. +При использовании опции `-v` также выводится id из БД. Поиск языков @@ -167,10 +210,14 @@ ml-search.py Использование:: - ml-search.py [-i/-I] [-t/-s/-f] lang [name] + ml-search.py lang [name] [--id id] + +Опции:: + + --id id Искать по id языка Искать и печатать список языков по имени. -При использовании опции `-d` также выводится id из БД. +При использовании опции `-v` также выводится id из БД. .. vim: set tw=72 :