.. _calibredb-uk: .. raw:: html ``calibredb`` =================================================================== .. code-block:: none calibredb команда [параметри] [аргументи] :command:`calibredb` — інтерфейс командного рядка до бази даних calibre. Передбачено декілька допоміжних команд, які документовано нижче. :command:`calibredb` можна скористатися для керування або базою даних calibre, вказаної шляхом, або :guilabel:`Сервером даних` calibre, запущеного або на локальному комп'ютері, або в інтернеті. Запустити :guilabel:`Сервер даних` calibre можна або за допомогою команди :command:`calibre-server`, або з головного вікна програми calibre вибором пункту :guilabel:`З'єднатись/Роздати -> Запустити сервер даних`. Оскільки :command:`calibredb` може вносити зміни до ваших бібліотек calibre, вам слід спочатку налаштувати розпізнавання на сервері. Це можна зробити у два способи: * Якщо ви плануєте з'єднуватися лише з сервером, який запущено на тому самому комп'ютері, ви можете просто скористатися параметром ``--enable-local-write`` сервера даних, щоб уможливити для будь-якої програми, зокрема calibredb, запущеної на локальному комп'ютері, внесення змін до ваших даних calibre. Якщо ви запускаєте сервер із головного вікна програми calibre, цей пункт можна знайти у розділі :guilabel:`Налаштування -> Обмін мережею -> Додатково`. * Якщо ви хочете увімкнути доступ інтернетом, вам слід налаштувати облікові записи користувачів на сервері і скористатися параметрами :option:`--username` і :option:`--password` програми :command:`calibredb` для надання їй доступу. Ви можете налаштувати розпізнавання для :command:`calibre-server` за допомогою параметра ``--enable-auth`` і скористатися параметром ``--manage-users`` для створення облікових записів користувачів. Якщо ви працюєте із сервером з головного вікна програми calibre, скористайтеся пунктом, :guilabel:`Налаштування->Обмін мережею->Вимагати введення імені користувача і пароля`. Для встановлення з'єднання із запущеним сервером даних, передайте адресу сервера у параметрі :option:`--with-library`. Див. документацію до цього параметра, щоб дізнатися більше і ознайомитися із прикладами. .. contents:: :local: ЗАГАЛЬНІ ПАРАМЕТРИ ~~~~~~~~~~~~~~~~~~~~~~ .. option:: --help, -h показати це довідкове повідомлення і завершити роботу .. option:: --library-path, --with-library Шлях до бібліотеки calibre. Типово, використовується шлях, який збережено у параметрах роботи програми. В також можете встановити з’єднання із сервером даних calibre для виконання дій із віддаленими бібліотеками. Для цього скористайтеся адресою у такому форматі: http://назва_вузла:порт/#ідентифікатор_бібліотеки, наприклад, http://localhost:8080/#mylibrary. Ідентифікатором бібліотеки є ідентифікатор бібліотеки на сервері даних. Ви можете скористатися спеціальним значенням параметра ідентифікатор_бібліотеки, «-», щоб отримати список ідентифікаторів бібліотек на сервері. Докладний опис налаштовування доступу за допомогою сервера даних можна знайти у розділі https://manual.calibre-ebook.com/uk/generated/uk/calibredb.html. .. option:: --password Пароль для встановлення з’єднання із сервером даних calibre. Щоб пароль було прочитано із стандартного джерела введення, скористайтеся спеціальним значеннямв: . Щоб пароль було прочитано з файла, скористайтеся такою конструкцією: (тобто ). Символи «менше» і «більше» є обов\ ``'``\ язковими. Не забудьте про їхнє екранування та лапки, якщо використовуєте їх у командній оболонці. .. option:: --timeout Час очікування, у секундах, на встановлення з\ ``'``\ єднання мережею із бібліотекою calibre. Типовим є час у дві хвилини. .. option:: --username Ім’я користувача для встановлення з’єднання із сервером даних calibre .. option:: --version показати дані щодо версії програми і завершити роботу .. _calibredb-uk-list: list ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb list [параметри] Показати список книг у базі даних calibre. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb list .. option:: --ascending Впорядкувати дані за зростанням .. option:: --fields, -f Поля, які слід показувати у списку книг бази даних. Поля у списку слід відокремлювати комами. Можливі поля: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Типовий список: title,authors. Особливим значенням «all» можна скористатися для вибору всіх полів. Крім вбудованих полів, назви яких наведено вище, можна скористатися нетиповими полями, доступ до яких здійснюється у форматі \*назва_поля, наприклад, для нетипового поля #rating, слід скористатися назвою \*rating .. option:: --for-machine Вивести дані у форматі JSON, який є придатнішим для обробки комп’ютером. Призводить до ігнорування параметрів ширини рядків та роздільників. .. option:: --limit Максимальна кількість показаних результатів. Типове значення: всі результати. .. option:: --line-width, -w Максимальна ширина окремого рядка виведених даних. Типове значення визначається на основі розмірів екрана. .. option:: --prefix Префікс всіх шляхів до файлів. Типовим є абсолютний шлях до теки бібліотеки. .. option:: --search, -s Фільтрувати результати за запитом щодо пошуку. Настанови щодо форматування запитів для пошуку наведено у підручнику користувача. Типово не виконується жодного фільтрування. .. option:: --separator Рядок, який відокремлюватиме поля. Типовим є пробіл. .. option:: --sort-by Поза, за яким слід упорядковувати результати. Ви можете вказати декілька полів, відокремивши їхні записи комами. Доступні поля: author_sort, authors, comments, cover, formats, identifiers, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, size, tags, template, timestamp, title, uuid Типове значення: id .. option:: --template Шаблон, який слід запустити, якщо у списку полів є «template». Типове значення: немає .. option:: --template_file, -t Шлях до файла, що містить шаблон, який слід запустити, якщо у списку полів є «template». Типове значення: немає .. option:: --template_heading Заголовок стовпчика шаблонів. Типове значення: template. Цей параметр буде проігноровано, якщо встановлено параметр :option:`--for-machine` .. _calibredb-uk-add: add ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb add [параметри] файл1 файл2 файл3 ... Додати вказані файли як книги до бази даних. Ви також можете вказати теки. Докладніший опис параметрів, пов’язаних з теками, наведено нижче. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb add .. option:: --authors, -a Встановити авторів для доданих книг .. option:: --automerge, -m Якщо буде виявлено книги із однаковими назвами і авторами, об\ ``'``\ єднати вхідні формати (файли) автоматично із наявними записами книг. Значення «ignore» означає, що дублікати форматів буде відкинуто. Значення «overwrite» означає, що дублікати форматів у бібліотеці буде перезаписано новими доданими файлами. Значення «new_record» означає, що дублікати форматів буде записано до нового запису книги. .. option:: --cover, -c Шлях до зображення обкладинки, яке слід використати для доданої книги .. option:: --duplicates, -d Додати записи книг до бази даних, навіть якщо такі записи у цій базі вже створено. Порівняння виконуватиметься за назвами або авторами книг. Зауважте, що пріоритет буде надано параметру :option:`--automerge`. .. option:: --empty, -e Додати порожню книгу (книгу без формату) .. option:: --identifier, -I Встановити ідентифікатори для цієї книги, наприклад -I asin:XXX -I isbn:YYY .. option:: --isbn, -i Встановити ISBN для доданих книг .. option:: --languages, -l Список мов, відокремлених комами (варто користуватися кодами мов ISO639, втім, передбачено розпізнавання і деяких повних назв мов) .. option:: --series, -s Встановити цикл для доданих книг .. option:: --series-index, -S Встановити номер у циклі для доданих книг .. option:: --tags, -T Встановити мітки для доданих книг .. option:: --title, -t Встановити заголовки для доданих книг ДОДАВАННЯ З ТЕК ^^^^^^^^^^^^^^^^^^^ Параметри, які керують додаванням книг з тек. Типово, програма додаватиме лише файли книг, суфікси назв яких є відомими як суфікси назв файлів електронних книг. .. option:: --add Взірець (загальний) назви файла. Файли, назви яких відповідатимуть взірцеві буде додано під час пошуку файлів у теках, навіть якщо суфікс назви не належить до відомого програмі набору суфіксів назв файлів електронних книг. Можна вказати декілька взірців. .. option:: --ignore Взірець (загальний) назви файла. Файли, назви яких відповідатимуть взірцеві буде проігноровано під час пошуку файлів у теках. Можна вказати декілька взірців. Якщо, наприклад, вказати взірець \*.pdf, буде проігноровано усі файли PDF. .. option:: --one-book-per-directory, -1 Припускати, що у кожній теці міститься лише одна книга, всі файли у цьому каталозі є цією книгою, записаною у різних форматах .. option:: --recurse, -r Обробляти теки рекурсивно .. _calibredb-uk-remove: remove ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb remove ідентифікатори Вилучити книги, визначені ідентифікаторами з бази даних. Ідентифікатори у списку слід відокремлювати комами. Отримати номери ідентифікаторів можна за допомогою команди search. Приклад: 23,34,57-85 (у діапазон ідентифікаторів не включатиметься запис діапазону, у нашому прикладі 85). Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb remove .. option:: --permanent Не використовувати Смітник .. _calibredb-uk-add_format: add_format ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb add_format [параметри] ідентифікатор файл_книги Додати книгу з файла файл_книги до доступних форматів для логічної книги, визначеної ідентифікатором. Ідентифікатор може бути визначено за допомогою команди search. Якщо запис формату вже існує, його буде замінено, якщо не вказано параметр вимикання такої заміни. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb add_format .. option:: --as-extra-data-file Додати файл як додатковий файл даних, а не формат книги .. option:: --dont-replace Не замінювати формат, якщо файл у цьому форматі вже існує .. _calibredb-uk-remove_format: remove_format ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb remove_format [параметри] ідентифікатор формат Вилучити формат з запису логічної книги, визначеної ідентифікатором. Визначити ідентифікатор можна за допомогою команди search. Формат має бути визначено суфіксом назви файла, наприклад LRF, TXT або EPUB. Якщо у записі логічної книги не міститиметься запису формату, ніяких дій не буде виконано. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb remove_format .. _calibredb-uk-show_metadata: show_metadata ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb show_metadata [параметри] ідентифікатор Показати метадані, що зберігаються у базі даних calibre для книги з ідентифікатором «ідентифікатор». «ідентифікатор» є ідентифікатором, який повертає команда search. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb show_metadata .. option:: --as-opf Вивести метадані у форматі OPF (XML) .. _calibredb-uk-set_metadata: set_metadata ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb set_metadata [параметри] ідентифікатор_книги [/шлях/до/метадані.opf] Встановити у базі метаданих calibre для книги, вказаної за ідентифікатором, метадані з файла OPF метадані.opf. ідентифікатором має бути значення зі списку, який надається командою search. Коротку довідку щодо формату OPF можна отримати за допомогою ключа --as-opf, доданого до команди show_metadata. Крім того, можна встановлювати метадані для окремих полів за допомогою параметра --field. Якщо використовується параметр --field, вказувати файл OPF не потрібно. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb set_metadata .. option:: --field, -f Поле, значення якого слід встановити. Формат визначення поля такий: назва_поля:значення. Приклад: :option:`--field` tags:tag1,tag2. Скористайтеся :option:`--list-fields,` щоб отримати список всіх назв полів. Цей параметр можна використовувати декілька разів з метою встановлення значень для декількох полів. Зауваження: для полів мов слід використовувати коди мов ISO639 (наприклад en для англійської, uk для української тощо). Синтаксис ідентифікаторів: :option:`--field` identifiers:isbn:XXXX,doi:YYYYY. Для булевих полів (полів «так/ ні») слід використовувати значення true та false або yes та no. .. option:: --list-fields, -l Показати список назв полів метаданих, які може бути використано з параметром :option:`--field` .. _calibredb-uk-export: export ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb export [параметри] ідентифікатори Експортувати книги, вказані за допомогою ідентифікаторів (розділених у списку комами) до файлової системи. Під час дії з експортування зберігаються всі формати книги, зображення обкладинки книги і метадані (у форматі файла OPF). Також буде збережено усі файли додаткових даних, які пов'язано із книгою. Визначити номери ідентифікаторів можна за допомогою команди search. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb export .. option:: --all Експортувати всі книги у бібліотеці з ігноруванням списку ідентифікаторів. .. option:: --dont-asciiize Наказати calibre перетворити усі символи у назвах файлів, яких немає у англійській абетці, на символи англійської абетки. Це корисно для зберігання даних у застарілих файлових системах без повної підтримки назв файлів у форматі Unicode. Визначення цього перемикача вимкне вказану поведінку. .. option:: --dont-save-cover Зазвичай calibre зберігатиме зображення обкладинки у окремому файлі разом з файлами електронної книги. Визначення цього перемикача вимкне вказану поведінку. .. option:: --dont-save-extra-files Зберегти усі файли даних, які пов\ ``'``\ язано із книгою, при зберігання книги Визначення цього перемикача вимкне вказану поведінку. .. option:: --dont-update-metadata Зазвичай calibre оновлює метадані у збережених файлах на основі даних бібліотеки calibre. Уповільнює запис на диск. Визначення цього перемикача вимкне вказану поведінку. .. option:: --dont-write-opf Зазвичай calibre записуватиме метадані до окремого файла OPF разом з файлами електронної книги. Визначення цього перемикача вимкне вказану поведінку. .. option:: --formats Відокремлений комами список форматів, у яких слід зберігати кожну книгу. Типово книга зберігатиметься у всіх форматах. .. option:: --progress Сповіщати про поступ .. option:: --replace-whitespace Замінити пробіли підкреслюваннями. .. option:: --single-dir Експортувати всі книги до однієї теки .. option:: --template Шаблон для керування назвами файлів та структурою тек збережених файлів. Типовим є шаблон «{author_sort}/{title}/{title} - {authors}», у разі використання якого книги буде збережено до окремих підтек за авторами, назви файлів міститимуть назви книг і імена авторів. Доступні можливості керування: {author_sort, authors, id, isbn, languages, last_modified, pubdate, publisher, rating, series, series_index, tags, timestamp, title} .. option:: --timefmt Формат, у якому слід показувати дати. %d — день, %b — місяць, %m — номер місяця, %Y — рік. Типовим форматом є %b, %Y .. option:: --to-dir Експортувати книги до вказаної теки. Типовою текою є . .. option:: --to-lowercase Перетворити символи шляхів на нижній регістр. .. _calibredb-uk-catalog: catalog ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb catalog /path/to/destination.(csv|epub|mobi|xml...) [options] Export a :command:`catalog` in format specified by path/to/destination extension. Options control how entries are displayed in the generated :command:`catalog` output. Note that different :command:`catalog` formats support different sets of options. To see the different options, specify the name of the output file and then the --help option. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb catalog .. option:: --ids, -i Список значень ідентифікаторів бази даних, відокремлених комами, для каталогізації. Якщо визначено, :option:`--search` буде проігноровано. Типове значення: всі значення (all) .. option:: --search, -s Фільтрувати результати за запитом щодо пошуку. Настанови щодо форматування запитів для пошуку наведено у підручнику користувача. Типово не виконується жодного фільтрування .. option:: --verbose, -v Показувати докладні виведені дані. Корисно для діагностики. ПАРАМЕТРИ EPUB ^^^^^^^^^^^^^^^^^^ .. option:: --catalog-title Заголовок створеного каталогу, використаний як заголовок у метаданих. Типове значення: «My Books» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --cross-reference-authors Створювати перехресні посилання у розділі авторів для книг з декількома авторами. Типове значення: «False» Застосовується до таких форматів виведення даних: AZW3, EPUB, MOBI .. option:: --debug-pipeline Зберігати виведені дані на різних кроків у вказаній теці. Корисно, якщо ви не впевнені, на якому кроці сталася помилка. Типове значення: «None» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --exclude-genre Формальний вираз, що описує мітки для виключення жанрів. Типове значення: «\[.+\]|^\+$» виключає мітки у квадратних дужках, наприклад «[Project Gutenberg]», та «+», типову мітку прочитаних книг. Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --exclusion-rules Визначає правила виключення книг зі створеного каталогу. Модель правила виключення записується у форматі (\ ``'``\ <назва правила>\ ``'``\ ,\ ``'``\ Tags\ ``'``\ ,\ ``'``\ <список міток, відокремлених комами>\ ``'``\ ) або (\ ``'``\ <назва правила>\ ``'``\ ,\ ``'``\ <нетиповий стовпчик>\ ``'``\ ,\ ``'``\ <шаблон>\ ``'``\ ). Приклад: ((\ ``'``\ Архівовані книги\ ``'``\ ,\ ``'``\ #status\ ``'``\ ,\ ``'``\ Archived\ ``'``\ ),) виключить книги зі значенням «Archived» у нетиповому стовпчику «status». Якщо визначено декілька правил, буде застосовано всі з них. Типове значення: ((\ ``'``\ Архівовані книги\ ``'``\ ,\ ``'``\ #status\ ``'``\ ,\ ``'``\ Archived\ ``'``\ ),) виключить книги зі значенням «Archived» у нетиповому стовпчику «status». Якщо визначено декілька правил, буде застосовано всі з них. Типове значення: \ ``"``\ ((\ ``'``\ Catalogs\ ``'``\ ,\ ``'``\ Tags\ ``'``\ ,\ ``'``\ Catalog\ ``'``\ ),)\ ``"``\ Застосовується до форматів результатів AZW3, EPUB, MOBI .. option:: --generate-authors Включення розділу «Автори» до каталогу. Типове значення: «False» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --generate-descriptions Включення розділу «Описи» до каталогу. Типове значення: «False» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --generate-genres Включення розділу «Жанри» до каталогу. Типове значення: «False» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --generate-recently-added Включення розділу «Нещодавно додані» до каталогу. Типове значення: «False» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --generate-series Включення розділу «Цикли» до каталогу. Типове значення: «False» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --generate-titles Включення розділу «Заголовки» до каталогу. Типове значення: «False» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --genre-source-field Поле джерела даних для розділу жанру. Типове значення: «Теґи» Стосується таких форматів виведення даних: AZW3, EPUB, MOBI .. option:: --header-note-source-field Нетипове поле, що містить текст нотатки для додавання до заголовка опису. Типове значення: «» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --merge-comments-rule #<нетипове поле>:[before|after]:[True|False] визначає: <нетипове поле> — нетипове поле, що містить нотатки, які має бути додано до коментарів [before|after] — розташування нотаток відносно коментарів [True|False] — визначає чи слід додавати горизонтальну лінію між нотатками і коментарями Типове значення: «::» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --output-profile Визначає профіль виведення даних. Іноді профіль виведення даних потрібен для оптимізації каталогу для пристрою. Наприклад, профілі «kindle» і «kindle_dx» створюють структурований зміст з розділами і статтями. Типове значення: «None» Формати: формати виведення AZW3, EPUB, MOBI .. option:: --prefix-rules Визначає правила, використані для включення префіксів, що позначають прочитані книги, пункти списку бажаних книг та інші визначені користувачами префікси. Модель правила префіксів є такою: (\ ``'``\ <назва правила>\ ``'``\ ,\ ``'``\ <поле джерела>\ ``'``\ ,\ ``'``\ <шаблон>\ ``'``\ ,\ ``'``\ <префікс>\ ``'``\ ). Якщо буде визначено декілька правил, застосовуватиметься лише перше відповідне з них. Типове значення: \ ``"``\ ((\ ``'``\ Read books\ ``'``\ ,\ ``'``\ tags\ ``'``\ ,\ ``'``\ +\ ``'``\ ,\ ``'``\ ✓\ ``'``\ ),(\ ``'``\ Wishlist item\ ``'``\ ,\ ``'``\ tags\ ``'``\ ,\ ``'``\ Wishlist\ ``'``\ ,\ ``'``\ ×\ ``'``\ ))\ ``"``\ Застосовується до форматів результатів AZW3, EPUB, MOBI .. option:: --preset Використовувати вказаний за назвою шаблон, створений за допомогою графічних інструментів збирання каталогу. У такому шаблоні визначено всі параметри збирання каталогу. Типове значення: \ ``'``\ None\ ``'``\ Застосування: формати виведення результатів AZW3, EPUB, MOBI. .. option:: --thumb-width Основний розмір (у дюймах) для зображень обкладинок у каталозі. Діапазон: 1.0 — 2.0 Типове значення: «1.0» Застосування: формати виведення AZW3, EPUB, MOBI .. option:: --use-existing-cover Замінювати зображення обкладинок під час створення каталогу. Типове значення: «False» Застосування: формати виведення AZW3, EPUB, MOBI .. _calibredb-uk-saved_searches: saved_searches ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb збережені_пошуки [параметри] (list|add|remove) Керування збереженими записами пошуків, що зберігаються у цій базі даних. Якщо ви спробуєте додати запит з назвою, яку вже записано до бази даних, попередній запис буде замінено новим. Синтаксис для додавання: calibredb збережені_пошуки add назва_пошуку вираз_пошуку Синтаксис для вилучення: calibredb збережені_пошуки remove назва_пошуку Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb saved_searches .. _calibredb-uk-add_custom_column: add_custom_column ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb add_custom_column [параметри] мітка назва тип_даних Створити нетиповий стовпчик. «мітка» — комп’ютерна назва стовпчика. Мітка не повинна містити пробілів і двокрапок. «назва» — зручна для читання назва стовпчика. «тип_даних» має бути одним з таких значень: bool, comments, composite, datetime, enumeration, float, int, rating, series, text Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb add_custom_column .. option:: --display Набір параметрів для налаштовування обробки даних у цьому стовпчику. Має бути рядком JSON. Для стовпчиків нумерації скористайтеся :option:`--display`\ ``"``\ {\\ ``"``\ enum_values\\ ``"``\ :[\\ ``"``\ значення1\\ ``"``\ , \\ ``"``\ значення2\\ ``"``\ ]}\ ``"``\ Передбачено багато варіантів передавання значень показаній змінній. Серед варіантів за типами стовпчиків: мішаний тип: composite_template, composite_sort, make_category,contains_html, use_decorations дата і час: date_format нумерація: enum_values, enum_colors, use_decorations ціле, десятковий дріб: number_format текст: is_names, use_decorations Найкращим способом визначення відповідних комбінацій є створення нетипового стовпчика відповідного типу за допомогою графічного інтерфейсу з наступним вивченням резервної копії OPF книги (переконайтеся, що новий OPF було створено після додавання стовпчика). У такому OPF можна знайти JSON для показу (\ ``"``\ display\ ``"``\ ) нового стовпчика. .. option:: --is-multiple У цьому стовпчику зберігаються дані, подібні до міток (тобто значення, відокремлені комами). Застосовується, лише якщо типом даних є «text». .. _calibredb-uk-custom_columns: custom_columns ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb custom_columns [параметри] Показати доступні нетипові стовпчики. Виводить мітки та ідентифікатори стовпчиків. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb custom_columns .. option:: --details, -d Показати параметри кожного стовпчика. .. _calibredb-uk-remove_custom_column: remove_custom_column ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb remove_custom_column [параметри] мітка Вилучити нетиповий стовпчик, визначений міткою. Переглянути список доступних стовпчиків можна за допомогою команди custom_columns. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb remove_custom_column .. option:: --force, -f Не питати про підтвердження .. _calibredb-uk-set_custom: set_custom ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb set_custom [параметри] стовпчик ідентифікатор значення Встановити значення у нетиповому стовпчику для книги, визначеної ідентифікатором. Список ідентифікаторів можна отримати за допомогою команди search. Отримати список назв нетипових стовпчиків можна отримати за допомогою команди custom_columns. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb set_custom .. option:: --append, -a Якщо у стовпчику зберігається декілька значень, дописати вказані значення до вже записаних замість заміни цих значень. .. _calibredb-uk-restore_database: restore_database ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb restore_database [параметри] Відновити цю базу даних на основі метаданих, що зберігаються у файлах OPF кожної з тек бібліотеки calibre. Корисно, якщо ваш файл metadata.db пошкоджено. ПОПЕРЕДЖЕННЯ: у результаті виконання цієї команди вашу базу даних буде створено з нуля. Ви втратите всі збережені дані пошуку, категорії користувача, засоби обробки, збережені параметри перетворення окремих книг та нетипові рецепти. Відновлені метадані будуть настільки точними, наскільки точними є дані, збережені у файлах OPF. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb restore_database .. option:: --really-do-it, -r Виконати відновлення. Команду не буде виконано, якщо не буде вказано цього параметра. .. _calibredb-uk-check_library: check_library ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb бібліотека_для_перевірки [параметри] Виконати деякі перевірки у файловій системі бібліотеки. Звіти буде invalid_titles, extra_titles, invalid_authors, extra_authors, missing_formats, extra_formats, extra_files, missing_covers, extra_covers, failed_folders Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb check_library .. option:: --csv, -c Виведення у форматі CSV .. option:: --ignore_extensions, -e Список суфіксів назв, які слід ігнорувати, відокремлений комами. Типове значення: всі (all) .. option:: --ignore_names, -n Список назв, які слід ігнорувати, відокремлений комами. Типове значення: всі (all) .. option:: --report, -r Список звітів, відокремлених комами. Типове значення: всі (all) .. option:: --vacuum-fts-db Очистити базу даних повнотекстового пошуку. Процедура може бути дуже повільною і вимогливою до пам\ ``'``\ яті, залежно від розміру бази даних. .. _calibredb-uk-list_categories: list_categories ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb list_categories [параметри] Створити звіт щодо даних категорій у базі даних. Отримані дані еквівалентні до даних, показаних на панелі навігації мітками. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb list_categories .. option:: --categories, -r Список назв фільтрів категорій, відокремлених комами. Типове значення: всі (all) .. option:: --csv, -c Виведення у форматі CSV .. option:: --dialect Тип файл CSV, який слід створити. Варіанти: excel, excel-tab, unix .. option:: --item_count, -i Виводити лише кількість пунктів у категорії замість кількостей елементів у пункті категорії .. option:: --width, -w Максимальна ширина окремого рядка виведених даних. Типове значення визначається на основі розмірів екрана. .. _calibredb-uk-backup_metadata: backup_metadata ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb backup_metadata [параметри] Створити резервну копію метаданих, що зберігаються у базі даних у окремих файла OPF у кожній з тек книг. Зазвичай, така дія виконується автоматично, але ви можете наказати програмі виконати примусове повторне створення файлів OPF, якщо вкажете параметр --all. Зауважте, що зазвичай потреби у цій команді немає, оскільки резервні копії файлів OPF створюються автоматично у разі внесення змін до метаданих. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb backup_metadata .. option:: --all Зазвичай, ця програма обробляє лише ті книги, файли OPF яких застаріли. За допомогою цього параметра ви можете наказати програмі обробляти всі файли книг. .. _calibredb-uk-clone: clone ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb clone шлях/до/нової/бібліотеки Створити клон поточної бібліотеки. За допомогою цієї програми можна створити нову порожню бібліотеку з тими самими нетиповими стовпчиками, віртуальними бібліотеками та іншими параметрами, що і у поточній бібліотеці. У клонованій бібліотеці не буде жодної книги. Якщо вам потрібно створити дублікати бібліотеки з усіма книгами, просто скористайтеся інструментами для керування файлами і скопіюйте теку бібліотеки. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb clone .. _calibredb-uk-embed_metadata: embed_metadata ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb embed_metadata [параметри] ідентифікатор_книги Оновити метадані файлів книги, що зберігаються у бібліотеці calibre на основі метаданих з бази даних calibre. Зазвичай, метадані оновлюються лише під час експортування файлів з calibre. Ця команда корисна, якщо ви хочете оновити файли на місці. Зауважте, що у файлах різних форматів передбачено зберігання різних наборів метаданих. Щоб оновити метадані у всіх книгах, скористайтеся спеціальним значенням ідентифікатора — «all». Крім того, можна вказати декілька ідентифікаторів книг, відокремивши їх пробілами, або діапазони ідентифікаторів з межами, відокремленими дефісами. Приклад: calibredb :command:`embed_metadata` 1 2 10-15 23 Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb embed_metadata .. option:: --only-formats, -f Оновити метадані лише у файлах вказаного формату. Можна вказувати декілька таких параметрів, якщо потрібно обробити файли декількох форматів. Якщо параметр не вказано, програма оновлює усі формати. .. _calibredb-uk-search: search ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb search [параметри] вираз для пошуку Шукати у бібліотеці записи із вказаним ключем для пошуку. Повертає список ідентифікаторів відповідних книг, відокремлених комами. Формат виведення даних корисний для передавання іншим командам, які приймають вхідні дані у форматі списку ідентифікаторів. Виразом для пошуку може бути будь-який запис потужною мовою запитів calibre. Приклад: calibredb :command:`search` author:asimov 'title:"i robot"' Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb search .. option:: --limit, -l Максимальна кількість повернутих результатів. Типово буде повернуто усі результати. .. _calibredb-uk-fts_index: fts_index ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb fts_index [параметри] enable/disable/status/reindex Керування процедурою індексування для повнотекстового пошуку. enable — увімкнути індексування для повнотекстового пошуку для цієїї бібліотеки disable — вимкнути індексування для повнотекстового пошуку для цієї бібліотеки status — показати поточний стан індексування reindex — можна скористатися для повторного індексування певних книг або усієї бібліотеки. Щоб повторно індексувати якісь книги, вкажіть ідентифікатори книг як додаткові аргументи після команди reindex. Якщо ідентифікаторів книг не буде вказано, буде виконано повторне індексування усієї бібліотеки. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb fts_index .. option:: --indexing-speed Швидкість індексування. Скористайтеся швидким індексуванням з використанням усіх ресурсів комп\ ``'``\ ютера або повільним, якщо слід заощаджувати ресурси на індексуванні. Зауважте, що програма скидатиме швидкість на повільну після кожного виклику. .. option:: --wait-for-completion Очікувати на завершення індексування усіх книг, періодично показуючи дані щодо поступу індексуування .. _calibredb-uk-fts_search: fts_search ~~~~~~~~~~~~~~~~~~~~ .. code-block:: none calibredb fts_search [параметри] вираз для пошуку Виконати повнотекстовий пошук в усій бібліотеці або її підмножині. Якщо ви передаєте аргументи calibredb, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces» .. program:: calibredb fts_search .. option:: --do-not-match-on-related-words Встановлювати відповідність лише за точним словом, а не за пов\ ``'``\ язаними з ним словами. Таким чином, пошук «виправлення» не призводитиме до показу відповідника «виправити». .. option:: --include-snippets Включати фрагменти тексту навколо кожного відповідника. Зауважте, що це значно уповільнить пошук. .. option:: --indexing-threshold Частка бібліотеки у відсотках, яку має бути індексовано, перш ніж повнотекстовий пошук буде увімкнено. Типовим є значення 90. .. option:: --match-end-marker Позначка, яку буде використано для кінця відповідного слова у фрагменті .. option:: --match-start-marker Позначка, яку буде використано для початку відповідного слова у фрагменті .. option:: --output-format Формат виведення результатів пошуку. Може мати значення «text» для звичайного тексту або «json» для виведення у форматі JSON. .. option:: --restrict-to Обмежити перелік книг для пошуку за допомогою якогось виразу для пошуку або списку ідентифікаторів. Приклад: ids:1,2,3 — обмежити пошук вказаними ідентифікаторами, або search:tag:щось — обмежити пошук книгами із міткою «щось».