calibre - en to uk translation catalogue (162 entries)

en: API documentation for the e-book editing tools
uk: Документація з програмного інтерфейсу засобів редагування електронних книг

en: The e-book editing tools consist of a :class:`calibre.ebooks.oeb.polish.container.Container` object that represents a book as a collection of HTML + resource files, and various tools that can be used to perform operations on the container. All the tools are in the form of module level functions in the various ``calibre.ebooks.oeb.polish.*`` modules.
uk: Засоби редагування електронних книг складаються з об’єкта :class:`calibre.ebooks.oeb.polish.container.Container`, які представляють книгу як збірку HTML + файли ресурсів, і різноманітних засобів, якими можна скористатися для виконання операцій над контейнером. Усі засоби представляються у формі функцій рівня модуля у різноманітних модулях ``calibre.ebooks.oeb.polish.*``.

en: You obtain a container object for a book at a path like this::
uk: Ви отримуєте об’єкт-контейнер книги зі шляхом, подібним до такого::

en: If you are writing a plugin for the E-book editor, you get the current container for the book being edited like this::
uk: Якщо ви створюєте додаток до редактора електронних книг, ви отримуєте контейнер для книги, яка редагується, подібний до такого::

en: The Container object
uk: Об’єкт контейнера

en: A container represents an open e-book as a folder full of files and an OPF file. There are two important concepts:
uk: Контейнер складається з відкритої електронної книги, як теки з файлами, і одного файла OPF. Передбачено два важливих поняття:

en: The root folder. This is the base of the e-book. All the e-books files are inside this folder or in its sub-folders.
uk: Коренева тека. Це основа електронної книги. Усі файли електронної книги зберігаються у цій теці і її підтеках.

en: Names: These are paths to the books' files relative to the root folder. They always contain POSIX separators and are unquoted. They can be thought of as canonical identifiers for files in the book. Most methods on the container object work with names. Names are always in the NFC Unicode normal form.
uk: Назви: це шляхи до файлів книги відносно кореневої теки. У них завжди містяться роздільники POSIX і не міститься лапок. Їх можна вважати канонічними ідентифікаторами файлів у книзі. Більшість методів для об’єктів-контейнерів працюють з назвами. Назви завжди записуються у нормальній формі NFC Unicode.

en: Clones: the container object supports efficient on-disk cloning, which is used to implement checkpoints in the e-book editor. In order to make this work, you should never access files on the filesystem directly. Instead, use :meth:`raw_data` or :meth:`open` to read/write to component files in the book.
uk: Клони: для об’єкти-контейнерів передбачено підтримку ефективного клонування на диску. Таке клонування використовується для реалізації контрольних точок у редакторі електронних книг. Для того, щоб це спрацювало, вам ніколи не слід отримувати доступ до файлів у файловій системі безпосередньо. Замість цього, використовуйте :meth:`raw_data` або :meth:`open` для читання або запису файлів-компонентів електронної книги.

en: When converting between hrefs and names use the methods provided by this class, they assume all hrefs are quoted.
uk: Для перетворення між гіперпосиланнями і назвами використовуйте методи з цього класу, усі гіперпосилання у цих методах вважаються вказаними у лапках.

en: Convert an absolute path to a canonical name relative to :attr:`root`
uk: Перетворити абсолютний шлях на канонічну назву відносно :attr:`root`

en: Parameters
uk: Параметри

en: The base folder. By default the root for this container object is used.
uk: Базова тека. Типово, коренева тека об’єкта-контейнера.

en: Add a file to this container. Entries for the file are automatically created in the OPF manifest and spine (if the file is a text document)
uk: Додати файл до цього контейнера. Записи для файла автоматично створюються у маніфесті OPF і вмісті (якщо файл є текстовим документом)

en: Add an entry to the manifest for a file with the specified name. Returns the manifest id.
uk: Додати запис щодо файла з вказаною назвою до маніфесту. Повертає ідентифікатор маніфесту.

en: Add the specified properties to the manifest item identified by name.
uk: Додати вказані властивості до запису маніфесту, вказаного за назвою.

en: Ensure that the specified properties are set on only the manifest item identified by name. You can pass None as the name to remove the property from all items.
uk: Переконайтеся, що вказані властивості встановлено лише для запису маніфесту, ідентифікованого за назвою. Ви можете передати None як назву для вилучення властивості з усіх записів.

en: The type of book (epub for EPUB files and azw3 for AZW3 files)
uk: Тип книги (epub для файлів EPUB і azw3 для файлів AZW3)

en: Commit all dirtied parsed objects to the filesystem and write out the e-book file at outpath.
uk: Зберегти усі змінені оброблені об’єкти до файлової системи і записати файл електронної книги до outpath.

en: The path to write the saved e-book file to. If None, the path of the original book file is used.
uk: Каталог, до якого слід записати збережений файл електронної книги. Якщо має значення None, буде використано каталог, у якому зберігалася початкова книга.

en: If True the parsed representations of committed items are kept in the cache.
uk: Якщо має значення True, оброблене представлення збережених записів зберігатиметься у кеші.

en: Commit a parsed object to disk (it is serialized and written to the underlying file). If ``keep_parsed`` is True the parsed representation is retained in the cache. See also: :meth:`parsed`
uk: Зберегти оброблений об’єкт на диск (його буде перетворено на послідовну форму і записано до підлеглого файла). Якщо ``keep_parsed`` має значення True, оброблене представлення буде збережено у кеші. Див. також :meth:`parsed`

en: Mark the parsed object corresponding to name as dirty. See also: :meth:`parsed`.
uk: Позначити оброблюваний об’єкт, що відповідає назві, як недооброблений. Див. також: :meth:`parsed`.

en: True iff a file/folder corresponding to the canonical name exists. Note that this function suffers from the limitations of the underlying OS filesystem, in particular case (in)sensitivity. So on a case insensitive filesystem this will return True even if the case of name is different from the case of the underlying filesystem file. See also :meth:`has_name`
uk: Має значення True тоді і лише тоді, коли файл або тека, що відповідає канонічній назві, існує. Зауважте, що дію цієї функції обмежено можливостями файлової системи відповідної операційної системи, зокрема тим, чи розрізняються у цій файловій системі назви за регістром символів. Отже, якщо у файловій системі не розрізняється регістр символів, функція поверне True, навіть якщо назва відрізняється за регістром символів від назви файла у файловій системі. Див. також :meth:`has_name`

en: Return the size in bytes of the file represented by the specified canonical name. Automatically handles dirtied parsed objects. See also: :meth:`parsed`
uk: Повернути розмір у байтах для файла, вказаного канонічною назвою. Автоматично обробляє позначені під час обробки необроблені об’єкти. Див. також: :meth:`parsed`

en: Add an item to the manifest with href derived from the given name. Ensures uniqueness of href and id automatically. Returns generated item.
uk: Додати запис до маніфесту із гіперпосиланням, яке отримано з вказаної назви. Автоматично забезпечує унікальність гіперпосилання і ідентифікатора. Повертає створений запис.

en: Similar to open() except that it returns a file path, instead of an open file object.
uk: Подібний до open(), але повертає шлях до файла, а не відкритий об’єкт файла.

en: Mapping of guide type to canonical name
uk: Прив’язка напрямного типу до канонічної назви

en: Return True iff a file with the same canonical name as that specified exists. Unlike :meth:`exists` this method is always case-sensitive.
uk: Повертає True, якщо і лише якщо існує файл із такою самою назвою, яка вказана. На відміну від :meth:`exists`, цей метод завжди враховує регістр символів.

en: Convert an href (relative to base) to a name. base must be a name or None, in which case self.root is used.
uk: Перетворює гіперпосилання (відносно base) на назву. base має бути назвою або None (у цьому випадку буде використано self.root).

en: Insert item into parent (or append if index is None), fixing indentation. Only works with self closing items.
uk: Вставити запис до батьківського запису (або дописати запис, якщо index дорівнює None), виправити відступи. Працює лише із самозакривними записами.

en: If this container represents an unzipped book (a directory)
uk: Якщо цей контейнер відповідає розпакованій книзі (каталогу)

en: Iterate over all links in name. If get_line_numbers is True the yields results of the form (link, line_number, offset). Where line_number is the line_number at which the link occurs and offset is the number of characters from the start of the line. Note that offset could actually encompass several lines if not zero.
uk: Ітеративно обробити усі посилання у `name`. Якщо `get_line_numbers` має значення True, видає результати у формі (посилання, номер_рядка, відступ), де номер_рядка є номером рядка, у якому виявлено посилання, а відступ є кількістю символів від початку цього рядка до посилання. Зауважте, що відступ може включати декілька порожніх рядків, якщо є ненульовим.

en: Ensure that `name` does not already exist in this book. If it does, return a modified version that does not exist.
uk: Забезпечує те, що запис `name` ще не існує у цій книзі. Якщо такий запис існує, повертає змінену версію запису, якої ще не існує.

en: Return True if the manifest has an entry corresponding to name
uk: Повертає True, якщо у маніфесті є запис, що відповідає назві

en: Mapping of manifest id to canonical names
uk: Прив’язка ідентифікаторів маніфесту до канонічних назв

en: The names of all manifest items whose media-type matches predicate. `predicate` can be a set, a list, a string or a function taking a single argument, which will be called with the media-type.
uk: Назви усіх записів маніфесту, чий тип даних відповідає predicate. Значенням `predicate` може бути множина, список, рядок або функція, яка приймає один аргумент — назву типу даних.

en: All manifest items that have the specified property
uk: Усі записи маніфесту, які мають вказану властивість

en: Mapping of manifest media-type to list of canonical names of that media-type
uk: Прив’язка media-type маніфесту до списку канонічних назв цього media-type

en: The metadata of this book as a Metadata object. Note that this object is constructed on the fly every time this property is requested, so use it sparingly.
uk: Метадані цієї книги у формі об’єкта Metadata. Зауважте, що цей об’єкт будується «на льоту» кожного разу, коли надсилається запит щодо цієї властивості, тому не варто зловживати її використанням.

en: Convert a canonical name to an absolute OS dependent path
uk: Перетворити канонічну назву на абсолютний шлях у форматі операційної системи

en: Convert a name to a href relative to base, which must be a name or None in which case self.root is used as the base
uk: Перетворює назву на гіперпосилання відносно base, яким має бути назвою або None (якщо основною є self.root)

en: Set of names that must never be renamed. Depends on the e-book file format.
uk: Набір назв, які заборонено перейменовувати. Залежить від формату файла електронної книги.

en: Set of names that must never be deleted from the container. Depends on the e-book file format.
uk: Набір назв, які заборонено вилучати з контейнера. Залежить від формату файла електронної книги.

en: Set of names that are allowed to be missing from the manifest. Depends on the e-book file format.
uk: Набір назв, які можна не згадувати у маніфесті. Залежить від формату файла електронної книги.

en: Open the file pointed to by name for direct read/write. Note that this will commit the file if it is dirtied and remove it from the parse cache. You must finish with this file before accessing the parsed version of it again, or bad things will happen.
uk: Відкрити файл, вказаний за назвою для безпосереднього читання або запису. Зауважте, що у процесі виконання файл буде записано, якщо його було змінено, і вилучено із кешу обробки. Слід завершувати роботу з файлом, перш ніж отримувати доступ до його обробленої версії знову, інакше можуть статися прикрі помилки.

en: The parsed OPF file
uk: Оброблений файл OPF

en: Convenience method to either return the first XML element with the specified name or create it under the opf:package element and then return it, if it does not already exist.
uk: Зручний метод для або повернення першого елемента XML із вказаною назвою, або створення його у елементі opf:package з наступним його поверненням, якщо елемента ще не існувало.

en: The version set on the OPF's <package> element
uk: Версія, встановлена на елементі <package> OPF

en: The version set on the OPF's <package> element as a tuple of integers
uk: Версія, встановлена на елементі <package> OPF, у форматі кортежу цілих чисел

en: Convenience method to evaluate an XPath expression on the OPF file, has the opf: and dc: namespace prefixes pre-defined.
uk: Зручний метод для застосування виразу XPath до файла OPF, містить попередньо визначення префікси просторів назв «opf:» та «dc:».

en: Return a parsed representation of the file specified by name. For HTML and XML files an lxml tree is returned. For CSS files a css_parser stylesheet is returned. Note that parsed objects are cached for performance. If you make any changes to the parsed object, you must call :meth:`dirty` so that the container knows to update the cache. See also :meth:`replace`.
uk: Повертає оброблене представлення файла, який вказано за назвою (`name`). Для файлів HTML і XML буде повернуто дерево lxml. Для файлів CSS буде повернуто таблицю стилів css_parser. Зауважте, що оброблені об’єкти кешуються для підвищення швидкодії. Якщо ви вносите будь-які зміни до обробленого об’єкта, вам слід викликати :meth:`dirty`, щоб повідомити контейнеру, що слід оновити кеш. Див. також :meth:`replace`.

en: Return the raw data corresponding to the file specified by name
uk: Повертає необроблені дані, що відповідають файлу, вказаному за назвою

en: If True and the file has a text based MIME type, decode it and return a unicode object instead of raw bytes.
uk: Якщо має значення True і файл належить до текстового типу MIME, декодувати його і повернути об’єкт unicode замість необробленого набору байтів.

en: If True the returned unicode object is normalized to the NFC normal form as is required for the EPUB and AZW3 file formats.
uk: Якщо True, повернутий об’єкт unicode нормалізується до нормальної форми NFC, як це вимагається форматами файлів EPUB і AZW3.

en: Convert an absolute path (with os separators) to a path relative to base (defaults to self.root). The relative path is *not* a name. Use :meth:`abspath_to_name` for that.
uk: Перетворити абсолютний шлях (із роздільниками операційної системи) на шлях відносно параметра base (типове значення — self.root). Відносний шлях *не є* назвою. Для отримання назви скористайтеся :meth:`abspath_to_name`.

en: Remove the specified items (by canonical name) from the spine. If ``remove_if_no_longer_in_spine`` is True, the items are also deleted from the book, not just from the spine.
uk: Вилучити вказані записи (за канонічними назвами) із вмісту. Якщо ``remove_if_no_longer_in_spine`` має значення True, записи також буде вилучено із книги, не лише із її вмісту.

en: Removes item from parent, fixing indentation (works only with self closing items)
uk: Вилучає запис з батьківського запису, виправляє відступи (працює лише із самозакривними записами)

en: Remove the item identified by name from this container. This removes all references to the item in the OPF manifest, guide and spine as well as from any internal caches.
uk: Вилучити запис, вказаний за назвою, з цього контейнера. Вилучає усі посилання на запис у маніфесті OPF, покажчику та вмісті, а також з усіх кешів внутрішнього використання.

en: Renames a file from current_name to new_name. It automatically rebases all links inside the file if the folder the file is in changes. Note however, that links are not updated in the other files that could reference this file. This is for performance, such updates should be done once, in bulk.
uk: Перейменовує файл з current_name на new_name. Автоматично оновлює усі посилання у файлі, якщо змінюється тека, у якій зберігається файл. Зауважте, що посилання у інших файлах, які можуть посилатися на цей, не оновлюються. Так зроблено з міркувань підвищення швидкодії, оскільки оновлення в усіх файлах варто виконувати один раз у пакетному режимі.

en: Replace the parsed object corresponding to name with obj, which must be a similar object, i.e. an lxml tree for HTML/XML or a css_parser stylesheet for a CSS file.
uk: Замінити оброблений об’єкт, що відповідає параметру «name», об’єктом «obj», який має бути подібним об’єктом, тобто деревом lxml для HTML/XML або таблицею стилів css_parser для файлів CSS.

en: Replace all links in name using replace_func, which must be a callable that accepts a URL and returns the replaced URL. It must also have a 'replaced' attribute that is set to True if any actual replacement is done. Convenient ways of creating such callables are using the :class:`LinkReplacer` and :class:`LinkRebaser` classes.
uk: Замінити усі посилання у `name` за допомогою функції `replace_func`, яка має приймати адресу і повертати замінену адресу. Вона також повинна мати атрибут `replaced`, який встановлюється у значення True, якщо було виконано хоч одну заміну. Зручним способом створення таких функцій є використання класів :class:`LinkReplacer` та :class:`LinkRebaser`.

en: Convert a parsed object (identified by canonical name) into a bytestring. See :meth:`parsed`.
uk: Перетворює оброблений об’єкт (ідентифікований за канонічною назвою) на рядок байтів. Див. :meth:`parsed`.

en: Set the spine to be spine_items where spine_items is an iterable of the form (name, linear). Will raise an error if one of the names is not present in the manifest.
uk: Встановити для вмісту значення «spine_items», де «spine_items» є ітерованою множиною у форматі (назва, лінійність). Видасть повідомлення про помилку, якщо однієї або декількох назв не буде у маніфесті.

en: An iterator yielding the path for every item in the books' spine. See also: :attr:`spine_iter` and :attr:`spine_items`.
uk: Ітератор, який дає шлях для кожного запису у вмісті книги. Див. також :attr:`spine_iter` і :attr:`spine_items`.

en: An iterator that yields item, name is_linear for every item in the books' spine. item is the lxml element, name is the canonical file name and is_linear is True if the item is linear. See also: :attr:`spine_names` and :attr:`spine_items`.
uk: Ітератор, який видає (запис, назву, is_linear) для усіх записів у вмісті книги. `запис` є елементом lxml, `назва` є канонічною назвою файла, а is_linear має значення True, якщо запис є лінійним. Див. також :attr:`spine_names` та :attr:`spine_items`.

en: An iterator yielding name and is_linear for every item in the books' spine. See also: :attr:`spine_iter` and :attr:`spine_items`.
uk: Ітератор, який дає назву і is_linear для кожного запису у вмісті книги. Див. також :attr:`spine_iter` і :attr:`spine_items`.

en: Managing component files in a container
uk: Керування файлами компонентів у контейнері

en: Replace links to files in the container. Will iterate over all files in the container and change the specified links in them.
uk: Замінює посилання на файли у контейнері. Виконує ітеративну обробку усіх файлів у контейнері і змінює у них вказані посилання.

en: A mapping of old canonical name to new canonical name. For example: :code:`{'images/old.png': 'images/new.png'}`
uk: Прив’язка старої канонічної назви до нової канонічної назви. Приклад: :code:`{'images/old.png': 'images/new.png'}`

en: A callable that takes two arguments ``(name, anchor)`` and returns a new anchor. This is useful if you need to change the anchors in HTML files. By default, it does nothing.
uk: Функція, яка приймає два аргументи, ``(назва, прив’язка)``, і повертає нову прив’язку. Корисно, якщо вам потрібно змінити прив’язки у файлах HTML. Типово не виконує ніяких дій.

en: If False, links are not replaced in the OPF file.
uk: Якщо False, посилання у файлі OPF не замінюються.

en: Rename files in the container, automatically updating all links to them.
uk: Перейменовує файли у контейнері, автоматично оновлюючи усі посилання у них.

en: A mapping of old canonical name to new canonical name, for example: :code:`{'text/chapter1.html': 'chapter1.html'}`.
uk: Прив’язка старої канонічної назви до нової канонічної назви. Приклад: :code:`{'text/chapter1.html': 'chapter1.html'}`.

en: Return the folders that are recommended for the given filenames. The recommendation is based on where the majority of files of the same type are located in the container. If no files of a particular type are present, the recommended folder is assumed to be the folder containing the OPF file.
uk: Повертає теки, які рекомендовано використовувати для вказаних назв файлів. Рекомендація засновується на тому, де зберігається більшість файлів такого типу у контейнері. Якщо файлів певного типу немає, рекомендованою буде тека, у якій зберігається файл OPF.

en: Pretty printing and auto fixing parse errors
uk: Структурований друк і автовиправлення помилок обробки

en: Fix any parsing errors in the HTML represented as a string in raw. Fixing is done using the HTML5 parsing algorithm.
uk: Виправити усі помилки обробки у HTML, який представлено як рядок у параметрі «raw». Виправлення виконується на основі алгоритму обробки HTML5.

en: Fix any parsing errors in all HTML files in the container. Fixing is done using the HTML5 parsing algorithm.
uk: Виправити усі помилки обробки в усіх файлах HTML у контейнері «container». Виправлення виконується на основі алгоритму обробки HTML5.

en: Pretty print the HTML represented as a string in raw
uk: Структурований друк HTML, представленого як рядок у raw

en: Pretty print the CSS represented as a string in raw
uk: Структурований друк CSS, представленого як рядок у raw

en: Pretty print the XML represented as a string in raw. If ``name`` is the name of the OPF, extra OPF-specific prettying is performed.
uk: Структурований друк XMLS, представленого як рядок у «raw». Якщо ``name`` є назвою OPF, буде виконано додаткову обробку друкованих даних, специфічну для OPF.

en: Pretty print all HTML/CSS/XML files in the container
uk: Структурований друк усіх файлів HTML/CSS/XML у контейнері

en: Managing book jackets
uk: Керування обгортками книг

en: Remove an existing jacket, if any. Returns False if no existing jacket was found.
uk: Вилучити наявну обгортку, якщо така існує. Повертає False, якщо обгортку не знайдено.

en: Either create a new jacket from the book's metadata or replace an existing jacket. Returns True if an existing jacket was replaced.
uk: Або створити нову обгортку на основі метаданих книги або замінити наявну обгортку. Повертає True, якщо було замінено наявну обгортку.

en: Splitting and merging of files
uk: Поділ і об’єднання файлів

en: Split the file specified by name at the position specified by loc_or_xpath. Splitting automatically migrates all links and references to the affected files.
uk: Розділити файл, вказаний за допомогою параметра `name`, на позиції, вказаній за допомогою loc_or_xpath. Під час поділу програма автоматично змінить усі посилання на файли і прив’язки до них у інших файлах.

en: Should be an XPath expression such as //h:div[@id="split_here"]. Can also be a *loc* which is used internally to implement splitting in the preview panel.
uk: Має бути виразом XPath, наприклад //h:div[@id="split_here"]. Також може бути *loc* для внутрішнього використання для реалізації поділу на панелі попереднього перегляду.

en: If True the split occurs before the identified element otherwise after it.
uk: Якщо True, поділ відбувається до ідентифікованого елемента, якщо ні, після нього.

en: Used internally
uk: Для внутрішнього використання

en: Split the specified file at multiple locations (all tags that match the specified XPath expression). See also: :func:`split`. Splitting automatically migrates all links and references to the affected files.
uk: Поділити вказаний файл у декількох місцях (усіх теґах, які відповідають вказаному виразу XPath). Див. також :func:`split`. Під час поділу усі посилання та прив’язки буде перенесено до розділених файлів.

en: If True the splits occur before the identified element otherwise after it.
uk: Якщо True, поділ відбувається до ідентифікованого елемента, якщо ні, після нього.

en: Merge the specified files into a single file, automatically migrating all links and references to the affected files. The file must all either be HTML or CSS files.
uk: Об’єднати вказані файли у єдиний файл, автоматично перенести усі посилання та прив’язки у відповідних файлах. Усі файли мають бути або файлами HTML, або файлами CSS.

en: Must be either ``'text'`` for HTML files or ``'styles'`` for CSS files
uk: Має бути або ``'text'`` для файлів HTML, або ``'styles'`` для файлів CSS

en: The list of files to be merged
uk: Список файлів, які слід об’єднати

en: Which of the merged files is the *master* file, that is, the file that will remain after merging.
uk: Визначає, який з об’єднаних файлів буде *основним*, тобто те, який з файлів залишиться після об’єднання.

en: Managing covers
uk: Керування обкладинками

en: Set the cover of the book to the image pointed to by cover_path.
uk: Встановити для обкладинки книги зображення, на яке вказує cover_path.

en: Either the absolute path to an image file or the canonical name of an image in the book. When using an image in the book, you must also set options, see below.
uk: Або абсолютний шлях до файла зображення, або канонічна назва зображення у файлі книги. Якщо використовується файл з книги, вам слід також встановити певні параметри, див. нижче.

en: An optional callable that takes a single argument. It will be called with information about the tasks being processed.
uk: Необов’язкова функція для виклику, яка приймає один аргумент. Її буде викликано із даними щодо завдань, які виконуються.

en: None or a dictionary that controls how the cover is set. The dictionary can have entries: **keep_aspect**: True or False  (Preserve aspect ratio of covers in EPUB) **no_svg**: True or False  (Use an SVG cover wrapper in the EPUB titlepage) **existing**: True or False  (``cover_path`` refers to an existing image in the book)
uk: None або словник, який керує тим, як встановлюється зображення обкладинки. Словник може мати такі записи: **keep_aspect**: True або False (чи слід зберігати співвідношення розмірів зображення обкладинки у EPUB) **no_svg**: True або False (чи слід використовувати обгортку зображення обкладинки SVG на титульній сторінці EPUB) **existing**: True або False  (чи вказує ``cover_path`` на наявне зображення у книзі)

en: Mark the specified image as the cover image.
uk: Позначити вказане зображення як зображення обкладинки.

en: Mark the specified HTML file as the titlepage of the EPUB.
uk: Позначити вказаний файл HTML як файл титульної сторінки EPUB.

en: If True the HTML file is moved to the start of the spine
uk: Якщо True, файл HTML пересувається на початок комплекту

en: Working with CSS
uk: Робота з CSS

en: Change a font family from old_name to new_name. Changes all occurrences of the font family in stylesheets, style tags and style attributes. If the old_name refers to an embedded font, it is removed. You can set new_name to None to remove the font family instead of changing it.
uk: Змінити гарнітуру шрифту з old_name на new_name. Змінює усі записи гарнітури шрифту у таблицях стилів, теґах стилів та атрибутах стилів. Якщо шрифт old_name є вбудованим, його буде вилучено. Ви можете вказати для new_name назву None, щоб вилучити гарнітуру шрифтів, а не замінювати її.

en: Remove all unused CSS rules from the book. An unused CSS rule is one that does not match any actual content.
uk: Вилучає усі невикористані у книзі правила CSS. Невикористаним вважається правило CSS, яке не стосується жодного фрагмента даних у книзі.

en: An optional callable that takes a single argument. It is called with information about the operations being performed.
uk: Необов’язкова функція для виклику, яка приймає один аргумент. Її буде викликано із даними щодо дій, які виконуються.

en: If True, class attributes in the HTML that do not match any CSS rules are also removed.
uk: Якщо має значення True, атрибути класу у HTML, які не відповідають жодному з правил CSS, також буде вилучено.

en: If True, rules with identical selectors are merged.
uk: Якщо True, правила із ідентичними селекторами об’єднуються.

en: If True, rules with identical properties are merged.
uk: Якщо True, правила із тотожними властивостями буде об'єднано.

en: If True, stylesheets that are not referenced by any content are removed
uk: Якщо True, таблиці стилів, які не використано у даних, буде вилучено

en: Remove the specified CSS properties from all CSS rules in the book.
uk: Вилучити вказані властивості CSS з усіх правил CSS.

en: Set of properties to remove. For example: :code:`{'font-family', 'color'}`.
uk: Встановити властивості для вилучення. Приклад: :code:`{'font-family', 'color'}`.

en: The files from which to remove the properties. Defaults to all HTML and CSS files in the book.
uk: Файли, з яких слід вилучити властивості. Типово, усі файли HTML і CSS у книзі.

en: Working with the Table of Contents
uk: Робота зі змістом

en: Generate a Table of Contents from a list of XPath expressions. Each expression in the list corresponds to a level of the generate ToC. For example: :code:`['//h:h1', '//h:h2', '//h:h3']` will generate a three level Table of Contents from the ``<h1>``, ``<h2>`` and ``<h3>`` tags.
uk: Створює таблицю змісту на основі списку виразів XPath. Кожен вираз у списку відповідає рівню створення записів змісту. Приклад: за списком :code:`['//h:h1', '//h:h2', '//h:h3']` бдуе створено трирівневу таблицю змісту на основі вмісту теґів ``<h1>``, ``<h2>`` і ``<h3>``.

en: Generate a Table of Contents from links in the book.
uk: Створити зміст на основі посилань у книзі.

en: Generate a Table of Contents from files in the book.
uk: Створити зміст на основі файлів книги.

en: Create an inline (HTML) Table of Contents from an existing NCX Table of Contents.
uk: Створює вбудовану таблицю змісту (у форматі HTML) на основі наявної таблиці змісту NCX.

en: The title for this table of contents.
uk: Заголовок цієї таблиці змісту.

en: Edit book tool
uk: Засіб редагування книг

en: Bases: :py:class:`object`
uk: Основа: :py:class:`object`

en: The base class for individual tools in an Edit Book plugin. Useful members include:
uk: Базовий клас для окремих інструментів у додатку редагування книг. Серед його корисних учасників:

en: ``self.plugin``: A reference to the :class:`calibre.customize.Plugin` object to which this tool belongs.
uk: ``self.plugin``: посилання на об’єкт :class:`calibre.customize.Plugin`, до якого належить цей інструмент.

en: Methods that must be overridden in sub classes:
uk: Методи, які слід перевизначити у підкласах:

en: Set this to a unique name it will be used as a key
uk: Встановіть унікальне значення, яке буде використано як ключ

en: If True the user can choose to place this tool in the plugins toolbar
uk: Якщо має значення True, користувач зможе вибирати місце для цього інструмента на панелі інструментів додатків.

en: If True the user can choose to place this tool in the plugins menu
uk: Якщо має значення True, користувач зможе вибирати місце для пункту цього інструмента у меню додатків.

en: The popup mode for the menu (if any) of the toolbar button. Possible values are 'delayed', 'instant', 'button'
uk: Режим контекстного меню для меню (якщо таке передбачено) кнопки панелі інструментів. Можливі значення: 'delayed', 'instant', 'button'.

en: The :class:`calibre.gui2.tweak_book.boss.Boss` object. Used to control the user interface.
uk: Об’єкт :class:`calibre.gui2.tweak_book.boss.Boss`. Використовується для керування інтерфейсом користувача.

en: The main window of the user interface
uk: Головне вікно інтерфейсу користувача

en: Return the current :class:`calibre.ebooks.oeb.polish.container.Container` object that represents the book being edited.
uk: Повертає поточний об’єкт :class:`calibre.ebooks.oeb.polish.container.Container`, який відповідає книзі, яка редагується.

en: Register a keyboard shortcut that will trigger the specified ``qaction``. This keyboard shortcut will become automatically customizable by the user in the Keyboard shortcuts section of the editor preferences.
uk: Реєструє комбінацію клавіш, яка запускатиме вказану дію ``qaction``. Цю комбінацію клавіш автоматично буде додано до таблиці комбінацій клавіш у розділі «Клавіатурні скорочення» налаштувань редактора із можливістю внесення змін користувачем.

en: A QAction object, it will be triggered when the configured key combination is pressed by the user.
uk: Об’єкт QAction, його буде викликано, якщо користувач натисне налаштовану комбінацію клавіш.

en: A unique name for this shortcut/action. It will be used internally, it must not be shared by any other actions in this plugin.
uk: Унікальна назва цього клавіатурного скорочення або дії. Буде використано на внутрішньому рівні, назва не повинна збігатися із назвою будь-якої іншої дії у цьому додатку.

en: A list of the default keyboard shortcuts. If not specified no default shortcuts will be set. If the shortcuts specified here conflict with either builtin shortcuts or shortcuts from user configuration/other plugins, they will be ignored. In that case, users will have to configure the shortcuts manually via Preferences. For example: ``default_keys=('Ctrl+J', 'F9')``.
uk: Список типових комбінацій клавіш. Якщо не вказано, типових комбінацій клавіш не визначатиметься. Якщо вказані комбінації клавіш конфліктуватимуть із вбудованими комбінаціями клавіш або комбінаціями клавіш, які налаштовано користувачем або іншими додатками, ці комбінації клавіш буде проігноровано. Конфліктні комбінації користувач повинен налаштувати власноруч за допомогою вікна «Налаштування». Приклад: ``default_keys=('Ctrl+J', 'F9')``.

en: An optional short description of this action. If not specified the text from the QAction will be used.
uk: Необов’язковий короткий опис цієї дії. Якщо не вказано, буде використано текст для QAction.

en: An optional longer description of this action, it will be used in the preferences entry for this shortcut.
uk: Необов’язковий розширений опис цієї дії, буде використано як запис для цього клавіатурного скорочення у списку налаштування скорочень.

en: Create a QAction that will be added to either the plugins toolbar or the plugins menu depending on ``for_toolbar``. For example::
uk: Створює QAction, яку буде додано або на панель інструментів додатків, або до меню додатків, залежно від ``for_toolbar``. Приклад::

en: Method :meth:`register_shortcut`.
uk: Метод :meth:`register_shortcut`.

en: Controlling the editor's user interface
uk: Керування інтерфейсом користувача редактора

en: The e-book editor's user interface is controlled by a single global *Boss* object. This has many useful methods that can be used in plugin code to perform common tasks.
uk: Інтерфейс користувача редактора електронних книг керується єдиним загальним об’єктом. Цей об’єкт має багато корисних методів, яким можна скористатися у коді додатка для виконання типових завдань.

en: Create a restore checkpoint with the name specified as ``msg``
uk: Створює контрольну точку відновлення із назвою, яку вказано параметром ``msg``.

en: Update all the components of the user interface to reflect the latest data in the current book container.
uk: Оновлює усі компоненти інтерфейсу користувача так, щоб вони відповідали найсвіжішим даним у поточному контейнері книги.

en: If True, the book will be marked as modified, so the user will be prompted to save it when quitting.
uk: Якщо має значення True, книгу буде позначено як змінену, щоб програма попросила користувача зберегти внесені зміни, коли завершуватиме роботу.

en: Close the editor that is editing the file specified by ``name``
uk: Закрити вікно редактора, у якому відбувається редагування файла, вказаного параметром ``name``.

en: Commit any changes that the user has made to files open in editors to the container. You should call this method before performing any actions on the current container
uk: Записати усі зміни, які внесено користувачем до файлів, які відкрито у вікнах редактора, до контейнера. Вам слід викликати цей метод до виконання будь-яких дій над поточним контейнером.

en: Return the name of the file being edited currently or None if no file is being edited
uk: Повертає назву файла, який зараз редагують, або None, якщо користувач не редагує жодного файла.

en: Open the file specified by name in an editor
uk: Відкрити файл, який вказано параметром ``name``, у редакторі.

en: The media type of the file, for example, ``'text/html'``. If not specified it is guessed from the file extension.
uk: Тип вмісту файла, наприклад ``'text/html'``. Якщо не вказано, тип буде визначено за суфіксом назви файла.

en: A template to initialize the opened editor with
uk: Шаблон яким слід ініціалізувати відкритий редактор

en: Open the e-book at ``path`` for editing. Will show an error if the e-book is not in a supported format or the current book has unsaved changes.
uk: Відкрити електронну книгу за шляхом ``path`` для редагування. Покаже повідомлення про помилку, якщо дані книги зберігаються у непідтримуваному форматі або до поточної книги було внесено зміни, які згодом не було збережено.

en: The name of a file inside the newly opened book to start editing. Can also be a list of names.
uk: Назва файла у щойно відкритій для редагування книзі. Може також бути списком назв.

en: Undo the previous creation of a restore checkpoint, useful if you create a checkpoint, then abort the operation with no changes
uk: Скасувати попереднє створення контрольної точки відновлення. Корисно, якщо ви створюєте контрольну точку, а потім перериваєте дію без внесення змін до файлів.

en: Save the book. Saving is performed in the background
uk: Зберегти книгу. Зберігання виконується у фоновому режимі.

en: Mark the book as having been modified
uk: Позначити книгу як таку, яку було змінено

en: Show the changes to the book from its last checkpointed state
uk: Показує зміни у книзі з часу створення останньої контрольної точки книги.

en: If True the diff dialog will have a button to allow the user to revert all changes
uk: Якщо має значення True, діалогове вікно різниці міститиме кнопку, яка надаватиме змогу користувачеві скасувати усі внесені зміни.

en: A container object to compare the current container to. If None, the previously checkpointed container is used
uk: Об’єкт-контейнер для порівняння з поточним контейнером. Якщо має значення None, буде використано контейнер з попередньої контрольної точки.

en: Show the editor that is editing the file specified by ``name``
uk: Показати вікно редактора, у якому відбувається редагування файла, вказаного параметром ``name``.

en: Sync the position of the preview panel to the current cursor position in the current editor
uk: Синхронізувати позицію на панелі попереднього перегляду зі поточною позицією у вікні редактора.
