docs-ru/command_line.rst

   1
   2 Скрипты командной строки
   3 ========================
   4
   5
   6 .. contents::
   7    :local:
   8
   9
  10 ml-initdb.py
  11 ------------
  12
  13 Инициализирует базу данных и импортирует список жанров. Этот скрипт не
  14 очень-то нужен, так как следующий скрипт делает всё указанное.
  15
  16
  17 ml-import.py
  18 ------------
  19
  20 Использование::
  21
  22     ml-import.py [file.inpx ...]
  23
  24 Инициализирует базу данных, импортирует список жанров и список файлов
  25 INPX, перечисленных в командной строке. При повторных запусках не
  26 переинициализирует БД и не переимпортирует жанры; так же не
  27 переимпортирует уже проимпортированные книги, но импортирует в БД новые.
  28
  29
  30 ml-search.py
  31 ------------
  32
  33 Использование::
  34
  35     ml-search.py [-i] [-I] [-t] [-s] [-f] ...
  36
  37 Программа выполняет поиск по базе данных и показывает список
  38 результатов. В настоящее время может искать только в списке авторов.
  39
  40 Глобальные опции::
  41
  42     -i, --ignore-case     независимо от регистра (по умолчанию: угадать)
  43     -I, --case-sensitive  с учётом регистра
  44     -t, --start           тип поиска: подстрока в начале строки
  45                           (это тип поиска по умолчанию)
  46     -s, --substring       тип поиска: подстрока в любом месте
  47     -f, --full            тип поиска: полное совпадение всей строки
  48
  49 Опции ``-i/-I`` не могут использованы одновременно, поскольку означают
  50 противоположные команды. В случае, если ни одна из них не использована,
  51 программа угадывает зависимость от регистра: если все параметры даны в
  52 нижнем регистре, программы выполнит поиск без учёта регистра. Если среди
  53 параметров есть параметры в ВЕРХНЕМ или Смешанном регистре - поиск будет
  54 с учётом регистра.
  55
  56 Опции ``-t/-s/-f`` определяют тип поиска. Возможные значения:
  57
  58 * start - поиск подстроки в начале поля; поиск "друг" найдёт "друг" и
  59   "другой", но не "подруга"; это тип по умолчанию;
  60 * substring - поиск подстроки в любом месте; поиск "друг" найдёт "друг",
  61   "другой" и "подруга".
  62 * full - поиск на точное совпадение всей строки; поиск "друг" найдёт
  63   только "друг", но не "другой";
  64
  65
  66 Поиск авторов
  67 ^^^^^^^^^^^^^
  68
  69 Использование::
  70
  71     ml-search.py [-i/-I] [-t/-s/-f] author [-s surname] [-n name] [-m misc-name] [fullname]
  72
  73 Искать и печатать список авторов по фамилии, имени, доп. имени (обычно
  74 отчеству) или полному имени.
  75
  76 Опции::
  77
  78     -s, --surname фамилия       Искать по фамилии
  79     -n, --name имя              Искать по имени
  80     -m, --misc-name доп. имени  Искать по доп. имени
  81
  82 Пример::
  83
  84     ml-search.py -i author -s друг
  85
  86 Искать и печатать список авторов, чья фамилия начинается на "друг", без
  87 учёта регистра.
  88
  89 Если использовать несколько опций, поиск будет сужен оператором "И".
  90 Пример::
  91
  92     ml-search.py -i author -s друг -n в
  93
  94 Искать и печатать список авторов, чья фамилия начинается на "друг" и имя
  95 начинается на "в", без учёта регистра.
  96
  97 Поиск книг
  98 ^^^^^^^^^^
  99
 100 Использование::
 101
 102     ml-search.py [-i/-I] [-t/-s/-f] books [-t title] [-s series] [-a archive] [-f file] [-d]
 103
 104 Искать и печатать список книг по заголовку, серии, архиву, имени файла.
 105
 106 Опции::
 107
 108     -t, --title заголовок  Искать по заголовку
 109     -s, --series серия     Искать по серии
 110     -a, --archive архив    Искать по имени архива (zip-файла)
 111     -f, --file файл        Искать по имени файла (без расширения)
 112     -d, --details          Выводить больше информации о найденных книгах;
 113                            повторите эту опцию несколько раз, чтобы
 114                            получить ещё больше деталей
 115
 116 По умолчанию программы выводит список заголовков найденных книг. При
 117 использовании опции `-d` также выводится список авторов и жанров.
 118
 119 Поиск расширений
 120 ^^^^^^^^^^^^^^^^
 121
 122 Использование::
 123
 124     ml-search.py [-i/-I] [-t/-s/-f] ext [name]
 125
 126 Искать и печатать список расширений имён файлов по имени.
 127
 128 Поиск жанров
 129 ^^^^^^^^^^^^
 130
 131 Использование::
 132
 133     ml-search.py [-i/-I] [-t/-s/-f] genres [-n name] [-t title]
 134
 135 Искать и печатать список жанров по имени и заголовку.
 136
 137 Опции::
 138
 139     -n, --name имя         Искать по названию
 140     -t, --title заголовок  Искать по заголовку
 141
 142 Поиск языков
 143 ^^^^^^^^^^^^
 144
 145 Использование::
 146
 147     ml-search.py [-i/-I] [-t/-s/-f] lang [name]
 148
 149 Искать и печатать список языков по имени.
 150
 151 .. vim: set tw=72 :