calibre - en to zh_HK translation catalogue (26 entries)

en: API documentation for the e-book editing tools
zh_HK: 电子书编辑工具的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.
zh_HK: 电子书编辑工具包括一个：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::
zh_HK: 您可以在如下路径获取图书的容器对象：

en: If you are writing a plugin for the E-book editor, you get the current container for the book being edited like this::
zh_HK: 如果您正在为电子书编辑器编写插件，您将获得正在编辑的图书的当前容器，如下所示：

en: The Container object
zh_HK: 容器对象

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.
zh_HK: 克隆：容器对象支持高效的磁盘克隆，用于在电子书编辑器中实现检查点。为了实现这一点，您不应该直接访问文件系统上的文件。相反，可以使用：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.
zh_HK: 当使用此类提供的方法在href和名称之间进行转换时，它们假定所有href都被引用。

en: Convert an absolute path to a canonical name relative to :attr:`root`
zh_HK: 将绝对路径转换为相对于：attr:`root的规范名称`

en: Parameters
zh_HK: 参数

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)
zh_HK: 将文件添加到此容器。文件条目自动在OPF清单和书脊中创建（如果文件是文本文档）

en: Add an entry to the manifest for a file with the specified name. Returns the manifest id.
zh_HK: 向具有指定名称的文件的清单中添加条目。返回清单ID。

en: Add the specified properties to the manifest item identified by name.
zh_HK: 将指定的属性添加到由名称标识的清单项。

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.
zh_HK: 请确保仅对由名称标识的清单项设置指定的属性。您可以传递None作为名称，以从所有项中移除属性。

en: The type of book (epub for EPUB files and azw3 for AZW3 files)
zh_HK: 图书类型(epub用于EPUB文件，azw3用于AZW3文件)

en: Commit all dirtied parsed objects to the filesystem and write out the e-book file at outpath.
zh_HK: 将所有有害的解析对象提交到文件系统，并在outpath写出电子书文件。

en: The path to write the saved e-book file to. If None, the path of the original book file is used.
zh_HK: 要将保存的电子书文件写入的路径。如果没有，则使用原始书籍文件的路径。

en: If True the parsed representations of committed items are kept in the cache.
zh_HK: 如果为True，则已提交项的解析表示形式保留在缓存中。

en: Add an item to the manifest with href derived from the given name. Ensures uniqueness of href and id automatically. Returns generated item.
zh_HK: 使用从给定名称派生的HREF将项目添加到清单中。自动保证href和id的唯一性。返回生成的项。

en: Similar to open() except that it returns a file path, instead of an open file object.
zh_HK: 与open()类似，不同之处在于它返回文件路径，而不是打开的文件对象。

en: Mapping of guide type to canonical name
zh_HK: 指南类型到规范名称的映射

en: Insert item into parent (or append if index is None), fixing indentation. Only works with self closing items.
zh_HK: 将项目插入父级(如果索引为无，则追加)，修复缩进。仅适用于自动关闭的项目。

en: If this container represents an unzipped book (a directory)
zh_HK: 如果此容器表示解压缩的图书(目录)

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.
zh_HK: 遍历名称中的所有链接。如果get_line_numbers为“真”，则生成表单结果(链接、行号、偏移量)。其中line_number是发生链接的line_number，偏移量是从行开始算起的字符数。请注意，偏移量实际上可以包含多行(如果不是零的话)。

en: Return True if the manifest has an entry corresponding to name
zh_HK: 如果清单具有与Name对应的条目，则返回True

en: Mapping of manifest id to canonical names
zh_HK: 清单ID到规范名称的映射

en: Edit book tool
zh_HK: 書本編輯工具
