.. _calibre-debug-uk:

.. raw:: html

    <style>code {font-size: 1em; background-color: transparent; font-family: sans-serif }</style>

``calibre-debug``
===================================================================

.. code-block:: none

    calibre-debug [параметри]


З метою діагностики роботи calibre можна скористатися різними інтерфейсами командного рядка. Якщо виконати цю команду
без параметрів, буде запущено вбудований інтерпретатор python. Крім того, ви можете запустити
у режимі діагностики основний графічний інтерфейс calibre, переглядач calibre та редактор calibre.

Передбачено також інтерфейси для різноманітних частин calibre, у яких немає відповідних
інструментів командного рядка, зокрема засобу обрізання шрифтів, засобу порівняння електронних книг
тощо.

Ви також можете скористатися :command:`calibre-debug` для запуску окремих скриптів. Зробити це можна так:

:command:`calibre-debug` -e myscript.py ``--`` ``--option1`` ``--option2`` file1 file2 ...

Скрипту буде передано усі дані після --. Ви також можете скористатися :command:`calibre-debug`
як вступною частиною у скриптах, ось так:

   #!/usr/bin/env -S :command:`calibre-debug` -e ``--`` --


Якщо ви передаєте аргументи :command:`calibre-debug`, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces»

[параметри]
----------------------------------------

.. program:: calibre-debug

.. option:: --add-simple-plugin

    Додати простий додаток (тобто додаток, що складається лише з файла .py) можна за допомогою визначення шляху до файла py, який містить код додатка.

.. option:: --command, -c

    Виконати код мовою програмування Python.

.. option:: --debug-device-driver, -d

    Діагностика виявлення пристроїв

.. option:: --default-programs

    Зареєструвати (скасувати реєстрацію) calibre серед типових програм Windows. :option:`--default-programs` = ``(register|unregister)``

.. option:: --diff

    Запустити засіб пошуку відмінностей calibre. Приклад: calibre-debug :option:`--diff` файл1 файл2

.. option:: --edit-book

    Запустити засіб редагування книг calibre у режимі діагностики.

.. option:: --exec-file, -e

    Виконати код Python у файлі.

.. option:: --explode-book, -x

    Розпакувати книгу до вказаної теки. Користування: -x файл.epub тека_виведення Експортує книгу як збірку файлів та метаданих HTML, які ви зможете редагувати за допомогою стандартних інструментів редагування HTML. Працює з файлами EPUB, AZW3, HTMLZ і DOCX.

.. option:: --export-all-calibre-data

    Експортувати усі дані calibre (книги, параметри, додатки). Зазвичай, програма попросить вас вказати теку і бібліотеки для експортування. Ви також можете вказати їх як аргументи командного рядка, щоб пропустити питання. Теку експортування і бібліотеки слід вказувати у форматі абсолютних шляхів. Для експортування усіх бібліотеки можна скористатися спеціальним ключовим слоовом «all». Приклади:    calibre-debug :option:`--export-all-calibre-data`  # інтерактивне користування   calibre-debug :option:`--export-all-calibre-data` /шлях/до/порожньої/теки/експортування /шлях/до/теки/бібліотеки1 /шлях/до/бібліотеки2   calibre-debug :option:`--export-all-calibre-data` /тека/експортування all  # експортувати усі відомі бібліотеки

.. option:: --fix-multiprocessing

    Для внутрішнього використання

.. option:: --gui, -g

    Запустити графічний інтерфейс з увімкненою діагностикою. Дані діагностики буде виведено до stdout та stderr.

.. option:: --gui-debug

    Запустити графічний інтерфейс з консоллю діагностики, записавши журнал до вказаного каталогу. Призначено лише для внутрішнього використання. Скористайтеся параметром -g для відкриття графічного інтерфейсу у режимі діагностики.

.. option:: --help, -h

    показати це довідкове повідомлення і завершити роботу

.. option:: --implode-book, -i

    Запакувати раніше розпаковану книгу. Користування: -i каталог_виведення файл.epub Імпортує книгу з файлів у каталозі каталог_виведення. Такі файли має бути попередньо створено за допомогою виклику команди із параметром :option:`--explode-book`. Не забудьте вказати саме той тип файла, який було використано для розпаковування книги.

.. option:: --import-calibre-data

    Імпортувати раніше експортовані дані calibre

.. option:: --inspect-mobi, -m

    Перевірити файли MOBI за вказаними шляхами.

.. option:: --paths

    Вивести записи шляхів, необхідних для налаштовування середовища calibre.

.. option:: --run-plugin, -r

    Запустити додаток інтерфейсу командного рядка. Приклад: calibre-debug -r \ ``"``\ Назва додатка\ ``"``\  ``--`` файл1 ``--option1`` Всі дані після ``--`` буде передано додатку як параметри.

.. option:: --run-test, -t

    Запустити вказані перевірки. Скористайтеся особливим словом «all», щоб наказати виконати усі перевірки. Якщо назва перевірки починається з крапки, програма припускатиме, що вказано назву модуля. Якщо назва перевірки починається з @, програма вважатиме її назвою категорії.

.. option:: --run-without-debug

    Не запускати із встановленим прапорцем DEBUG

.. option:: --shutdown-running-calibre, -s

    Завершує роботу запущеного екземпляра calibre, якщо такий існує. Зауважте, що якщо програма виконує завдання, виконання цих завдань буде перервано без додаткових повідомлень, отже будьте обережні з цією командою.

.. option:: --subset-font, -f

    Підмножина символів вказаного шрифту. Додайте ``--`` після цього параметра, щоб передати параметр програмі створення підмножин символів.

.. option:: --test-build

    Перевірити бінарні модулі у збірці.

.. option:: --version

    показати дані щодо версії програми і завершити роботу

.. option:: --viewer, -w

    Запустити програму для перегляду електронних книг у режимі діагностики