X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs-ru%2Fcommand_line.rst;h=eb83521e6a350086bce73283b530d28ffd36c57f;hb=e70acf8e852b2cd075aac1ecfd864e0c8475a689;hp=9a383c415373c96db4a16885ee148a87598aaa7f;hpb=07794a8efe6512dd65b98c692d35a1a41ed5683e;p=m_librarian.git diff --git a/docs-ru/command_line.rst b/docs-ru/command_line.rst index 9a383c4..eb83521 100644 --- a/docs-ru/command_line.rst +++ b/docs-ru/command_line.rst @@ -32,7 +32,7 @@ ml-search.py Использование:: - ml-search.py [-i] [-I] [-t {exact,start,substring}] ... + ml-search.py [-i] [-I] [-t] [-s] [-f] [-d] [-c] ... Программа выполняет поиск по базе данных и показывает список результатов. В настоящее время может искать только в списке авторов. @@ -41,9 +41,15 @@ ml-search.py -i, --ignore-case независимо от регистра (по умолчанию: угадать) -I, --case-sensitive с учётом регистра - -t, --search-type {exact,start,substring} - тип поиска: точный, подстрока в начале (это тип по умолчанию), - подстрока в любом месте. + -t, --start тип поиска: подстрока в начале строки + (это тип поиска по умолчанию) + -s, --substring тип поиска: подстрока в любом месте + -f, --full тип поиска: полное совпадение всей строки + -d, --details Выводить больше информации о найденных + объектах; повторите эту опцию несколько раз, + чтобы получить ещё больше деталей + -c, --count Выводить число найденных объектов, а не сами + объекты Опции ``-i/-I`` не могут использованы одновременно, поскольку означают противоположные команды. В случае, если ни одна из них не использована, @@ -52,14 +58,14 @@ ml-search.py параметров есть параметры в ВЕРХНЕМ или Смешанном регистре - поиск будет с учётом регистра. -Опция ``-t/--search-type`` определяет тип поиска. Возможные значения: +Опции ``-t/-s/-f`` определяют тип поиска. Возможные значения: -* exact - поиск на точное совпадение; поиск "друг" найдёт только "друг", - но не "другой"; * start - поиск подстроки в начале поля; поиск "друг" найдёт "друг" и "другой", но не "подруга"; это тип по умолчанию; * substring - поиск подстроки в любом месте; поиск "друг" найдёт "друг", "другой" и "подруга". +* full - поиск на точное совпадение всей строки; поиск "друг" найдёт + только "друг", но не "другой"; Поиск авторов @@ -67,7 +73,7 @@ ml-search.py Использование:: - ml-search.py [-i] [-I] [-t ...] author [-s surname] [-n name] [-m misc-name] [fullname] + ml-search.py [-i/-I] [-t/-s/-f] author [-s surname] [-n name] [-m misc-name] [fullname] Искать и печатать список авторов по фамилии, имени, доп. имени (обычно отчеству) или полному имени. @@ -93,21 +99,65 @@ ml-search.py Искать и печатать список авторов, чья фамилия начинается на "друг" и имя начинается на "в", без учёта регистра. +При использовании опции `-d` также выводится id из БД. + + +Поиск книг +^^^^^^^^^^ + +Использование:: + + ml-search.py [-i/-I] [-t/-s/-f] books [-t title] [-s series] [-a archive] [-f file] [--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] + +Искать и печатать список книг по заголовку, серии, архиву, имени файла. + +Опции:: + + -t, --title заголовок Искать по заголовку + -s, --series серия Искать по серии + -a, --archive архив Искать по имени архива (zip-файла) + -f, --file файл Искать по имени файла (без расширения) + --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 из БД, список авторов и +жанров, а также серия, к которой принадлежит книга (если принадлежит) и +порядковый номер книги в этой серии. С двумя опциями `-d` (`-d -d` или +просто `-dd`) программа выводит дату файла и язык. С тремя `-d` +выводятся имя архива, имя файла, расширение и размер файла, и признак, +была ли книга помечена как удалённая. + + Поиск расширений ^^^^^^^^^^^^^^^^ Использование:: - ml-search.py [-i] [-I] [-t ...] ext [name] + ml-search.py [-i/-I] [-t/-s/-f] ext [name] Искать и печатать список расширений имён файлов по имени. +При использовании опции `-d` также выводится id из БД. + + Поиск жанров ^^^^^^^^^^^^ Использование:: - ml-search.py [-i] [-I] [-t ...] genres [-n name] [-t title] + ml-search.py [-i/-I] [-t/-s/-f] genres [-n name] [-t title] Искать и печатать список жанров по имени и заголовку. @@ -116,13 +166,18 @@ ml-search.py -n, --name имя Искать по названию -t, --title заголовок Искать по заголовку +При использовании опции `-d` также выводится id из БД. + + Поиск языков ^^^^^^^^^^^^ Использование:: - ml-search.py [-i] [-I] [-t ...] lang [name] + ml-search.py [-i/-I] [-t/-s/-f] lang [name] Искать и печатать список языков по имени. +При использовании опции `-d` также выводится id из БД. + .. vim: set tw=72 :