calibre - en to ru translation catalogue (161 entries)

en: API documentation for the e-book editing tools
ru: Документация API инструмента редактирования электронных книг

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.
ru: Инструменты редактирования электронных книг состоят из объекта :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::
ru: Вы получаете объект-контейнер для книги по следующему пути::

en: If you are writing a plugin for the E-book editor, you get the current container for the book being edited like this::
ru:  Если вы пишете плагин для редактора электронной книги, вы получаете текущий контейнер для редактируемой книги следующим образом::

en: The Container object
ru: Объект контейнера

en: A container represents an open e-book as a folder full of files and an OPF file. There are two important concepts:
ru: Контейнер представляет собой открытую электронную книгу в виде папки, полной файлов и файла 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.
ru: Корневая папка. Это основа электронной книги. Все файлы электронных книг находятся внутри этой папки или в ее подпапках.

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.
ru: Имена: это пути к файлам книг относительно корневой папки. Они всегда содержат разделители 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.
ru: Клоны: объект-контейнер поддерживает эффективное клонирование на диске, которое используется для реализации контрольных точек в редакторе электронных книг. Чтобы это работало, вы никогда не должны обращаться к файлам в файловой системе напрямую. Вместо этого используйте :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.
ru: При преобразовании между hrefs и именами используйте методы, предоставляемые этим классом, они предполагают, что все hrefs заключены в кавычки.

en: Convert an absolute path to a canonical name relative to :attr:`root`
ru: Преобразование абсолютного пути в каноническое имя относительно :attr:`root`

en: Parameters
ru: Параметры

en: The base folder. By default the root for this container object is used.
ru: Базовая папка. По умолчанию используется корень для этого объекта-контейнера.

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)
ru:  Добавить файл в этот контейнер. Записи для файла автоматически создаются в манифесте и корешке OPF (если файл является текстовым документом).

en: Add an entry to the manifest for a file with the specified name. Returns the manifest id.
ru: Добавить в манифест запись для файла с указанным именем. Возвращает идентификатор манифеста.

en: Add the specified properties to the manifest item identified by name.
ru: Добавить указанные свойства в элемент манифеста, идентифицированный по имени.

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.
ru: Убедитесь, что указанные свойства установлены только для элемента манифеста, указанного по имени. Вы можете передать None в качестве имени, чтобы удалить свойство из всех элементов.

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

en: Commit all dirtied parsed objects to the filesystem and write out the e-book file at outpath.
ru: Зафиксировать все загрязненные проанализированные объекты в файловой системе и записать файл электронной книги по пути outpath.

en: The path to write the saved e-book file to. If None, the path of the original book file is used.
ru: Путь для записи сохраненного файла электронной книги. Если None, используется путь к исходному файлу книги.

en: If True the parsed representations of committed items are kept in the cache.
ru: Если 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`
ru: Зафиксировать проанализированный объект на диске (он сериализуется и записывается в базовый файл). Если ``keep_parsed`` - True, проанализированное представление сохраняется в кеше. См. также ::meth:`parsed`

en: Mark the parsed object corresponding to name as dirty. See also: :meth:`parsed`.
ru: Отметить проанализированный объект, соответствующий имени, как грязный. См. Также ::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`
ru: Истинно, только если существует файл/папка, соответствующие каноническому имени. Обратите внимание, что эта функция страдает от ограничений базовой файловой системы ОС, в частности из-за (не) чувствительности. Таким образом, в файловой системе, нечувствительной к регистру, это вернет 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`
ru: Вернуть размер в байтах файла, представленного указанным каноническим именем. Автоматически обрабатывает загрязненные проанализированные объекты. См. также ::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.
ru: Добавить в манифест элемент с href, производным от заданного имени. Автоматически обеспечивает уникальность href и id. Возвращает сгенерированный элемент.

en: Similar to open() except that it returns a file path, instead of an open file object.
ru: Подобно open(), за исключением того, что он возвращает путь к файлу вместо объекта открытого файла.

en: Mapping of guide type to canonical name
ru: Сопоставление guide типа с каноническим именем

en: Return True iff a file with the same canonical name as that specified exists. Unlike :meth:`exists` this method is always case-sensitive.
ru: Вернуть 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.
ru: Преобразование href (относительно base) в имя. base должно быть именем или None, в этом случае используется self.root.

en: Insert item into parent (or append if index is None), fixing indentation. Only works with self closing items.
ru: Вставить элемент в родительский (или добавить, если индекс равен None), исправив отступ. Работает только с самозакрывающимися элементами.

en: If this container represents an unzipped book (a directory)
ru: Если этот контейнер представляет собой распакованную книгу (каталог)

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.
ru: Перебрать все ссылки по имени. Если get_line_numbers имеет значение True, выдает результаты формы (ссылка, номер_строки, смещение). Где line_number - это номер line_number, в котором находится ссылка, а смещение - это количество символов от начала строки. Обратите внимание, что смещение может охватывать несколько строк, если не ноль.

en: Ensure that `name` does not already exist in this book. If it does, return a modified version that does not exist.
ru: Убедится, что `name` уже не существует в этой книге. Если это так, вернуть измененную версию, которая не существует.

en: Return True if the manifest has an entry corresponding to name
ru: Вернуть True, если в манифесте есть запись, соответствующая имени

en: Mapping of manifest id to canonical names
ru: Сопоставление идентификатора манифеста с каноническими именами

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.
ru: Имена всех элементов манифеста, тип носителя которых соответствует предикату. `predicate` может быть набором, списком, строкой или функцией, принимающей один аргумент, которая будет вызываться с медиа-типом.

en: All manifest items that have the specified property
ru: Все элементы манифеста, имеющие указанное свойство

en: Mapping of manifest media-type to list of canonical names of that media-type
ru: Сопоставление манифестного медиа-типа со списком канонических имен этого медиа-типа

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.
ru: Метаданные этой книги как объект метаданных. Обратите внимание, что этот объект создается «на лету» каждый раз, когда это свойство запрашивается, поэтому используйте его с осторожностью.

en: Convert a canonical name to an absolute OS dependent path
ru: Преобразование канонического имени в путь, полностью зависящий от ОС

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
ru:  Преобразование имени в href относительно базы, которое должно быть именем или None, в этом случае в качестве базы используется self.root.

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

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

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

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.
ru: Открыть файл, указанный по имени, для прямого чтения/записи. Обратите внимание, что это зафиксирует файл, если он загрязнен, и удалит его из кеша синтаксического анализа. Вы должны закончить работу с этим файлом, прежде чем снова обращаться к его проанализированной версии, иначе произойдут неприятности.

en: The parsed OPF file
ru: Разобранный файл 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.
ru: Удобный метод, позволяющий либо вернуть первый элемент XML с указанным именем, либо создать его в элементе opf:package, а затем вернуть его, если он ещё не существует.

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

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

en: Convenience method to evaluate an XPath expression on the OPF file, has the opf: and dc: namespace prefixes pre-defined.
ru: Удобный метод для оценки выражения 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`.
ru: Вернуть проанализированное представление файла, указанного по имени. Для файлов HTML и XML возвращается дерево lxml. Для файлов CSS возвращается таблица стилей css_parser. Обратите внимание, что проанализированные объекты кэшируются для повышения производительности. Если вы вносите какие-либо изменения в анализируемый объект, вы должны вызвать :meth:`dirty`, чтобы контейнер знал, что нужно обновить кеш. См. Также :meth:`replace`.

en: Return the raw data corresponding to the file specified by name
ru: Вернуть необработанные данные, соответствующие файлу, указанному по имени

en: If True and the file has a text based MIME type, decode it and return a unicode object instead of raw bytes.
ru: Если 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.
ru: Если 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.
ru: Преобразование абсолютного пути (с разделителями os) в путь относительно базы (по умолчанию 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.
ru: Удалить указанные пункты (по каноническому имени) из корешка. Если remove_if_no_longer_in_spine имеет значение True, элементы также удаляются из книги, а не только из корешка.

en: Removes item from parent, fixing indentation (works only with self closing items)
ru: Удалить элемент из родительского, исправляя отступ (работает только с самозакрывающимися элементами)

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.
ru: Удалить из этого контейнера элемент, указанный по имени. Это удалит все ссылки на элемент в манифесте, руководстве и корешке 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.
ru: Переименовывает файл с 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.
ru: Заменить проанализированный объект, соответствующий имени, на 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.
ru: Заменить все ссылки в имени с помощью replace_func, которая должна быть вызываемой, которая принимает URL-адрес и возвращает замененный URL-адрес. Он также должен иметь атрибут replace, который имеет значение True, если выполняется какая-либо фактическая замена. Удобные способы создания таких вызываемых объектов - это использование классов :class:`LinkReplacer` и :class:`LinkRebaser`.

en: Convert a parsed object (identified by canonical name) into a bytestring. See :meth:`parsed`.
ru: Преобразовать проанализированный объект (идентифицируемый каноническим именем) в байтовую строку. Смотрите :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.
ru: Задать для spine значение 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`.
ru: Итератор, определяющий путь для каждого элемента корешка книги. См. также ::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`.
ru: Итератор, который выдает элемент с именем is_linear для каждого элемента в корешке книги. item - это элемент lxml, name - каноническое имя файла, а 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`.
ru: Итератор, дающий имя и is_linear для каждого элемента в корешке книги. См. также ::attr:`spine_iter` и :attr:`spine_items`.

en: Managing component files in a container
ru: Управление файлами компонентов в контейнере

en: Replace links to files in the container. Will iterate over all files in the container and change the specified links in them.
ru: Заменить ссылки на файлы в контейнере. Будет перебирать все файлы в контейнере и изменять в них указанные ссылки.

en: A mapping of old canonical name to new canonical name. For example: :code:`{'images/old.png': 'images/new.png'}`
ru: Сопоставление старого канонического имени с новым каноническим именем. Например: :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.
ru: Вызываемый объект, который принимает два аргумента ``(имя, привязка)`` и возвращает новую привязку. Это полезно, если вам нужно изменить привязки в файлах HTML. По умолчанию ничего не делает.

en: If False, links are not replaced in the OPF file.
ru: Если false, ссылки не заменяются в файле OPF.

en: Rename files in the container, automatically updating all links to them.
ru: Переименовывать файлы в контейнере, автоматически обновляя все ссылки на них.

en: A mapping of old canonical name to new canonical name, for example: :code:`{'text/chapter1.html': 'chapter1.html'}`.
ru: Сопоставление старого канонического имени с новым каноническим именем, например: :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.
ru: Вернуть папки, рекомендованные для данных имен файлов. Рекомендация основана на том, где в контейнере находится большинство файлов одного типа. Если файлы определенного типа отсутствуют, рекомендуемая папка считается папкой, содержащей файл OPF.

en: Pretty printing and auto fixing parse errors
ru: Хорошая печать и автоматическое исправление ошибок синтаксического анализа

en: Fix any parsing errors in the HTML represented as a string in raw. Fixing is done using the HTML5 parsing algorithm.
ru: Исправить любые ошибки синтаксического анализа в HTML, представленном в виде строки в необработанном виде. Исправление производится с помощью алгоритма парсинга HTML5.

en: Fix any parsing errors in all HTML files in the container. Fixing is done using the HTML5 parsing algorithm.
ru: Исправить все ошибки синтаксического анализа во всех файлах HTML в контейнере. Исправление производится с помощью алгоритма парсинга HTML5.

en: Pretty print the HTML represented as a string in raw
ru: Хорошая печать HTML в представленного виде строки в необработанном виде

en: Pretty print the CSS represented as a string in raw
ru: Хорошая печать CSS, представленной в виде строки в необработанном виде

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.
ru: Хорошая печать XML, представленного в виде строки в необработанном виде. Если name - это имя OPF, выполняется дополнительная обработка, специфичная для OPF.

en: Pretty print all HTML/CSS/XML files in the container
ru: Хорошая печать всех файлов HTML/CSS/XML в контейнере

en: Managing book jackets
ru: Управление обложками книг

en: Remove an existing jacket, if any. Returns False if no existing jacket was found.
ru: Удалить существующую обложку, если таковая имеется. Возвращает 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.
ru: Либо создать новую обложку из метаданных книги, либо заменить существующую обложку. Возвращает True, если существующая обложка была заменена.

en: Splitting and merging of files
ru: Разделение и слияние файлов

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.
ru: Разделить файл, указанный по имени, в позиции, указанной параметром 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.
ru: Должно быть выражением XPath, например //h:div[@id='split_here']. Также может быть *loc*, который используется внутри для реализации разделения на панели предварительного просмотра.

en: If True the split occurs before the identified element otherwise after it.
ru: Если True, разделение происходит до идентифицированного элемента, иначе после него.

en: Used internally
ru: Используется внутри

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.
ru: Разделить указанный файл в нескольких местах (все теги, соответствующие указанному выражению XPath). См. также: :func:`split`. При разделении автоматически переносятся все ссылки и ссылки на затронутые файлы.

en: If True the splits occur before the identified element otherwise after it.
ru: Если 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.
ru: Объединить указанные файлы в один файл, автоматически перенеся все ссылки и ссылки на затронутые файлы. Все файлы должны быть либо HTML, либо CSS.

en: Must be either ``'text'`` for HTML files or ``'styles'`` for CSS files
ru: Должен быть либо ``text`` для файлов HTML, либо ``styles`` для файлов CSS.

en: The list of files to be merged
ru: Список файлов для слияния

en: Which of the merged files is the *master* file, that is, the file that will remain after merging.
ru: Какой из объединенных файлов является *главным* файлом, то есть файлом, который останется после объединения.

en: Managing covers
ru: Управление обложками

en: Set the cover of the book to the image pointed to by cover_path.
ru: Установить обложку книги на изображение, на которое указывает 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.
ru: Либо абсолютный путь к файлу изображения, либо каноническое имя изображения в книге. При использовании изображения в книге вы также должны установить параметры, см. ниже.

en: An optional callable that takes a single argument. It will be called with information about the tasks being processed.
ru: Необязательный вызываемый объект, который принимает единственный аргумент. Он будет вызываться с информацией об обрабатываемых задачах

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)
ru: 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.
ru: Отметить указанное изображение как изображение обложки.

en: Mark the specified HTML file as the titlepage of the EPUB.
ru: Отметить указанный HTML-файл как титульную страницу EPUB.

en: If True the HTML file is moved to the start of the spine
ru: Если True, HTML-файл перемещается в начало корешка.

en: Working with CSS
ru: Работа с 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.
ru: Изменить семейство шрифтов с 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.
ru: Удалить из книги все неиспользуемые правила CSS. Неиспользуемое правило CSS - это правило, не соответствующее фактическому содержанию.

en: An optional callable that takes a single argument. It is called with information about the operations being performed.
ru: Необязательный вызываемый объект, который принимает единственный аргумент. Вызывается с информацией о выполняемых операциях.

en: If True, class attributes in the HTML that do not match any CSS rules are also removed.
ru: Если True, атрибуты класса в HTML, которые не соответствуют никаким правилам CSS, также удаляются.

en: If True, rules with identical selectors are merged.
ru: Если True, правила с идентичными селекторами объединяются.

en: If True, rules with identical properties are merged.
ru: Если True, правила с одинаковыми свойствами объединяются.

en: If True, stylesheets that are not referenced by any content are removed
ru: Если True, таблицы стилей, на которые не ссылается какой-либо контент, удаляются.

en: Remove the specified CSS properties from all CSS rules in the book.
ru: Удалить указанные свойства CSS из всех правил CSS в книге.

en: Set of properties to remove. For example: :code:`{'font-family', 'color'}`.
ru: Набор свойств для удаления. Например: :code:`{'font-family', 'color'}`.

en: The files from which to remove the properties. Defaults to all HTML and CSS files in the book.
ru: Файлы, из которых нужно удалить свойства. По умолчанию используются все файлы HTML и CSS в книге.

en: Working with the Table of Contents
ru: Работа с оглавлением

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.
ru: Создать оглавление из списка выражений XPath. Каждое выражение в списке соответствует уровню создания ToC. Например: :code:`['//h:h1','//h:h2','//h:h3']` сгенерирует трехуровневую таблицу содержания из ``<h1>``, ``<h2>`` и ``<h3>`` тегов.

en: Generate a Table of Contents from links in the book.
ru: Создать оглавление из ссылок в книге.

en: Generate a Table of Contents from files in the book.
ru: Создать оглавление из файлов в книге.

en: Create an inline (HTML) Table of Contents from an existing NCX Table of Contents.
ru: Создать встроенное (HTML) оглавление из существующего оглавления NCX.

en: The title for this table of contents.
ru: Заголовок этого оглавления.

en: Edit book tool
ru: Средство редактирования книги

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

en: ``self.plugin``: A reference to the :class:`calibre.customize.Plugin` object to which this tool belongs.
ru: ``self.plugin``: ссылка на объект :class:`calibre.customize.Plugin`, которому принадлежит этот инструмент.

en: Methods that must be overridden in sub classes:
ru: Методы, которые необходимо переопределить в подклассах:

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

en: If True the user can choose to place this tool in the plugins toolbar
ru: Если True, пользователь может разместить этот инструмент на панели инструментов плагинов.

en: If True the user can choose to place this tool in the plugins menu
ru: Если True, пользователь может выбрать размещение этого инструмента в меню плагинов.

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

en: The :class:`calibre.gui2.tweak_book.boss.Boss` object. Used to control the user interface.
ru: Объект :class:`calibre.gui2.tweak_book.boss.Boss`. Используется для управления пользовательским интерфейсом.

en: The main window of the user interface
ru: Главное окно пользовательского интерфейса

en: Return the current :class:`calibre.ebooks.oeb.polish.container.Container` object that represents the book being edited.
ru: Вернуть текущий объект :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.
ru: Зарегистрируйте сочетание клавиш, которое будет запускать указанное действие ``qaction``. Это сочетание клавиш станет автоматически настраиваемым пользователем в разделе «Сочетания клавиш» настроек редактора.

en: A QAction object, it will be triggered when the configured key combination is pressed by the user.
ru: Объект 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.
ru: Уникальное имя для этого ярлыка/действия. Он будет использоваться для внутренних целей, он не должен использоваться другими действиями в этом плагине.

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')``.
ru: Список сочетаний клавиш по умолчанию. Если не указано иное, ярлыки по умолчанию не будут установлены. Если указанные здесь ярлыки конфликтуют со встроенными ярлыками или ярлыками из пользовательской конфигурации/других плагинов, они будут проигнорированы. В этом случае пользователям придется настраивать ярлыки вручную в настройках. Например: ``default_keys=('Ctrl+J', 'F9')``.

en: An optional short description of this action. If not specified the text from the QAction will be used.
ru: Необязательное краткое описание этого действия. Если не указано иное, будет использован текст из QAction.

en: An optional longer description of this action, it will be used in the preferences entry for this shortcut.
ru: Необязательное более подробное описание этого действия, оно будет использовано в записи настроек для этого ярлыка.

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

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

en: Controlling the editor's user interface
ru: Управление пользовательским интерфейсом редактора

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.
ru: Пользовательский интерфейс редактора электронных книг управляется одним глобальным объектом *Boss*. У этого есть много полезных методов, которые можно использовать в коде плагина для выполнения общих задач.

en: Create a restore checkpoint with the name specified as ``msg``
ru: Создать контрольную точку восстановления с именем, указываемым как ``msg``

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

en: If True, the book will be marked as modified, so the user will be prompted to save it when quitting.
ru: Если True, книга будет помечена как изменённая, поэтому пользователю будет предложено сохранить её при выходе.

en: Close the editor that is editing the file specified by ``name``
ru: Закрыть редактор, который редактирует файл, указанный в ``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
ru: Зафиксировать любые изменения, внесённые пользователем в файлы, открытые в редакторах, в контейнер. Вы должны вызвать этот метод перед выполнением каких-либо действий с текущим контейнером.

en: Return the name of the file being edited currently or None if no file is being edited
ru: Вернуть имя редактируемого файла или None, если файл не редактируется.

en: Open the file specified by name in an editor
ru: Открыть файл, указанный по имени, в редакторе

en: The media type of the file, for example, ``'text/html'``. If not specified it is guessed from the file extension.
ru: Медиа-тип файла, например, ``text/html``. Если не указано, это определяется по расширению файла.

en: A template to initialize the opened editor with
ru: Шаблон для инициализации открытого редактора с помощью

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.
ru: Открыть электронную книгу по пути для редактирования. Будет отображена ошибка, если формат электронной книги не поддерживается или в текущей книге есть несохраненные изменения.

en: The name of a file inside the newly opened book to start editing. Can also be a list of names.
ru: Имя файла во вновь открытой книге, чтобы начать редактирование. Также может быть список имен.

en: Undo the previous creation of a restore checkpoint, useful if you create a checkpoint, then abort the operation with no changes
ru: Отменить предыдущее создание контрольной точки восстановления, полезно, если вы создаете контрольную точку, а затем прерываете операцию без изменений

en: Save the book. Saving is performed in the background
ru: Сохранить книгу. Сохранение происходит в фоновом режиме

en: Mark the book as having been modified
ru: Отметить книгу как изменённую

en: Show the changes to the book from its last checkpointed state
ru: Показать изменения в книге по сравнению с последней контрольной точкой

en: If True the diff dialog will have a button to allow the user to revert all changes
ru: Если True, в диалоговом окне сравнения будет кнопка, позволяющая пользователю отменить все изменения.

en: A container object to compare the current container to. If None, the previously checkpointed container is used
ru: Объект контейнера, с которым сравнивается текущий контейнер. Если None, используется контейнер с ранее установленной контрольной точкой.

en: Show the editor that is editing the file specified by ``name``
ru: Показать редактор, редактирующий файл, указанный в ``name``

en: Sync the position of the preview panel to the current cursor position in the current editor
ru: Синхронизировать положение панели предварительного просмотра с текущей позицией курсора в текущем редакторе
