calibre - en to ja translation catalogue (161 entries)

en: API documentation for the e-book editing tools
ja: 電子書籍編集ツール 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.
ja: 電子書籍編集ツールは、HTML +リソースファイルのコレクションとして書籍を表す :class:`calibre.ebooks.oeb.polish.container.Container` オブジェクトと、コンテナで操作を実行するために使用できるさまざまなツールで構成されています。すべてのツールは、さまざまな``calibre.ebooks.oeb.polish.*`` モジュールのモジュールレベルの関数の形式になっています。

en: You obtain a container object for a book at a path like this::
ja: 次のようなパスで本のコンテナオブジェクトを取得します。

en: If you are writing a plugin for the E-book editor, you get the current container for the book being edited like this::
ja: 電子書籍エディタのプラグインを作成している場合は、編集中の書籍の現在のコンテナを次のように取得します::

en: The Container object
ja: Container オブジェクト

en: A container represents an open e-book as a folder full of files and an OPF file. There are two important concepts:
ja: コンテナは開いている電子書籍を、OPF ファイルおよびファイルでいっぱいのフォルダとして表します。 2 つの重要な概念があります:

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.
ja: ルートフォルダ。これが電子書籍のベースです。すべての電子書籍ファイルは、このフォルダまたはそのサブフォルダ内にあります。

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.
ja: 名前: ルートフォルダを基準にした書籍のファイルへのパスです。それらは常に 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.
ja: クローン: コンテナオブジェクトは、電子書籍エディタでチェックポイントを実装するために使用される効率的なディスク上のクローンをサポートします。これを機能させるために、ファイルシステム上のファイルには直接アクセスしないでください。代わりに、: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.
ja: href と名前を変換するときに、このクラスが提供するメソッドを使用します。このときすべての href が引用符で囲まれていると想定します。

en: Convert an absolute path to a canonical name relative to :attr:`root`
ja: 絶対パスを :attr:`ルート` を基準とした正規名に変換します

en: Parameters
ja: パラメータ

en: The base folder. By default the root for this container object is used.
ja: ベースフォルダ。デフォルトでは、このコンテナオブジェクトのルートが使用されます。

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)
ja: このコンテナにファイルを追加します。ファイルのエントリは、OPF マニフェストとスパインに自動的に作成されます (ファイルがテキストドキュメントの場合)

en: Add an entry to the manifest for a file with the specified name. Returns the manifest id.
ja: 指定した名前のファイルのマニフェストにエントリを追加します。マニフェスト ID を返します。

en: Add the specified properties to the manifest item identified by name.
ja: 名前で識別されるマニフェスト項目に、指定したプロパティを追加します。

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.
ja: 指定したプロパティを設定するのは、名前で識別されるマニフェスト項目だけにしてください。名前として None を渡すと、すべての項目からプロパティを削除できます。

en: The type of book (epub for EPUB files and azw3 for AZW3 files)
ja: 本のタイプ (EPUB ファイルの場合は epub、AZW3 ファイルの場合は azw3)

en: Commit all dirtied parsed objects to the filesystem and write out the e-book file at outpath.
ja: 汚くなった解析済みオブジェクトをすべてファイルシステムにコミットし、電子書籍ファイルをアウトパスに書き込みます。

en: The path to write the saved e-book file to. If None, the path of the original book file is used.
ja: 保存した電子書籍ファイルを書き込むパス。 None であれば、元の本ファイルのパスが使用されます。

en: If True the parsed representations of committed items are kept in the cache.
ja: 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`
ja: 解析されたオブジェクトをディスクにコミットします (シリアル化され、基になるファイルに書き込まれます)。 ``keep_parsed`` が True なら、解析された表現はキャッシュに保持されます。:meth:`parsed` も参照のこと。

en: Mark the parsed object corresponding to name as dirty. See also: :meth:`parsed`.
ja: name に対応する解析済みオブジェクトを汚いとマークします。: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`
ja: 正規名に対応するファイル/フォルダーが存在すれば True。ただしこの関数は、基盤となる OS ファイルシステムの制限、特に (非) 感度の問題があります。したがって、大文字と小文字を区別しないファイルシステムでは、名前と基になるファイルシステムファイルで大文字と小文字が異なっていても、これは 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`
ja: 指定された正規名で表されるファイルのサイズをバイト単位で返します。汚れた解析済みオブジェクトを自動的に処理します。: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.
ja: 指定された名前から派生した href を使用してマニフェストに項目を追加します。 href と id の一意性を自動的に保証します。生成された項目を返します。

en: Similar to open() except that it returns a file path, instead of an open file object.
ja: open() に似ていますが、開いているファイルオブジェクトの代わりにファイルパスを返す点が異なります。

en: Mapping of guide type to canonical name
ja: ガイドタイプの正規名へのマッピング

en: Return True iff a file with the same canonical name as that specified exists. Unlike :meth:`exists` this method is always case-sensitive.
ja: 指定されたものと同じ正規名のファイルが存在する場合は 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.
ja: (ベースに対して) href を名前に変換します。 base は name または None である必要があり、その場合には self.root が使用されます。

en: Insert item into parent (or append if index is None), fixing indentation. Only works with self closing items.
ja: item を親に挿入し (インデックスが None であれば追加し)、インデントを修正します。自己終了する item でのみ機能します。

en: If this container represents an unzipped book (a directory)
ja: このコンテナが解凍された本 (ディレクトリ) を表すかどうか

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.
ja: 名前のすべてのリンクを繰り返します。get_line_numbers が True のとき、結果は (link, line_number, offset) の形式で得られます。line_number はリンクが発生するline_number、offset は行の先頭からの文字数です。ただし offset は、ゼロでない場合でも実際には複数の線を含む可能性があります。

en: Ensure that `name` does not already exist in this book. If it does, return a modified version that does not exist.
ja: `name` には必ずこの本に存在していないものを指定してください。すでに存在する場合は、変更された存在しないバージョンを返します。

en: Return True if the manifest has an entry corresponding to name
ja: マニフェストに名前に対応するエントリがあれば True を返します

en: Mapping of manifest id to canonical names
ja: マニフェストIDの正規名へのマッピング

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.
ja: メディアタイプが predicate とマッチするすべてのマニフェスト項目の名前。`predicate` は、セット、リスト、文字列、または単一の引数を取る関数であり、メディアタイプで呼び出されます。

en: All manifest items that have the specified property
ja: 指定したプロパティを持つすべてのマニフェスト項目

en: Mapping of manifest media-type to list of canonical names of that media-type
ja: マニフェストメディアタイプの、そのメディアタイプの正規名のリストへのマッピング

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.
ja: Metadata オブジェクトとしてこの本の書誌。ただしこのオブジェクトは、このプロパティが要求されるたびにオンザフライで構築されるため、慎重に使用してください。

en: Convert a canonical name to an absolute OS dependent path
ja: 正規名を OS に依存する絶対パスに変換します

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
ja: 名前をベースを基準にした href に変換します。これは、名前または None である必要があり、self.root がベースとして使用されます。

en: Set of names that must never be renamed. Depends on the e-book file format.
ja: 名前を変更してはならない名前のセット。電子書籍のファイル形式によって異なります。

en: Set of names that must never be deleted from the container. Depends on the e-book file format.
ja: コンテナから削除してはならない名前のセット。電子書籍のファイル形式によって異なります。

en: Set of names that are allowed to be missing from the manifest. Depends on the e-book file format.
ja: マニフェストから欠落することが許可されている名前のセット。電子書籍のファイル形式によって異なります。

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.
ja: 直接読み取り/書き込み用に name で指定されたファイルを開きます。ただしファイルが汚いときには、ファイルがコミットされて解析キャッシュから削除されます。このファイルは、解析されたバージョンのファイルに再度アクセスする前に終了する必要があります。そうしないと、問題が発生します。

en: The parsed OPF file
ja: 解析された 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.
ja: 指定した name の最初の XML 要素を返すか、まだ存在しなければ opf:package 要素の下に作成して、それを返す便利なメソッド。

en: The version set on the OPF's <package> element
ja: OPF の <package> 要素に設定されているバージョン

en: The version set on the OPF's <package> element as a tuple of integers
ja: OPF の <package> 要素に整数のタプルとして設定されたバージョン

en: Convenience method to evaluate an XPath expression on the OPF file, has the opf: and dc: namespace prefixes pre-defined.
ja: OPF ファイルで XPath 式を評価するための便利なメソッドで、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`.
ja: name で指定されたファイルの解析済み表現を返します。HTML および XML ファイルの場合、lxml ツリーが返されます。CSS ファイルの場合、css_parser スタイルシートが返されます。ただし解析されたオブジェクトは、性能上の理由からキャッシュされます。解析されたオブジェクトに変更を加える場合は、:meth:`dirty` を呼び出して、コンテナがキャッシュを更新することを認識できるようにする必要があります。:meth:`replace` も参照のこと。

en: Return the raw data corresponding to the file specified by name
ja: name で指定したファイルに対応する生データを返します

en: If True and the file has a text based MIME type, decode it and return a unicode object instead of raw bytes.
ja: True かつ、ファイルにテキストベースの MIME タイプがあるときは、それをデコードして、raw バイトの代わりに 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.
ja: True のとき、返される Unicode オブジェクトは、EPUB および AZW3 ファイル形式で必要とされる NFC 正規形に規格化されます。

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.
ja: 絶対パス (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.
ja: 指定された項目 (正規名) をスパインから削除します。`remove_if_no_longer_in_spine`` が True のとき、スパインからだけでなく、本からも項目が削除されます。

en: Removes item from parent, fixing indentation (works only with self closing items)
ja: 親から item を削除し、インデントを修正します (自己終了する item でのみ機能します）

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.
ja: このコンテナから name で識別される項目を削除します。これにより、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.
ja: ファイル名を 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.
ja: name に対応する解析済みオブジェクトを obj に置き換えます。これは類似したオブジェクト、つまりHTML / XML ならば lxml ツリー、CSSファイルならば css_parser スタイルシートである必要があります

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.
ja: replace_func を使用して、name のすべてのリンクを置き換えます。replace_func は URL を受け入れ、置き換えられた URL を返す呼び出し可能である必要があります。また、実際の置換が行われた場合に True に設定される 'replaced' 属性が必要です。このような呼び出し可能オブジェクトは作成するには、:class:`LinkReplacer` および :class:`LinkRebaser` classes を使用すると便利です。

en: Convert a parsed object (identified by canonical name) into a bytestring. See :meth:`parsed`.
ja: 解析されたオブジェクト (正規名で識別される) をバイト文字列に変換します。: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.
ja: スパインを spine_items に設定します。ここで、spine_itemsは (name, linear) の形式のイテラブルです。名前の中にマニフェストに存在しないものがあれば、エラーが発生します。

en: An iterator yielding the path for every item in the books' spine. See also: :attr:`spine_iter` and :attr:`spine_items`.
ja: 本のスパインのすべての項目のパスを生成するイテレータ。: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`.
ja: 本の背表紙のすべての項目に対してitem, name, 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`.
ja: 本の背表紙のすべての item に name と is_linear を生成するイテレータ。:attr:`spine_iter` および :attr:`spine_items` も参照のこと。

en: Managing component files in a container
ja: コンテナ内のコンポーネントファイルの管理

en: Replace links to files in the container. Will iterate over all files in the container and change the specified links in them.
ja: コンテナ内のファイルへのリンクを置き換えます。コンテナ内のすべてのファイルを反復処理し、それらの中で指定されたリンクを変更します。

en: A mapping of old canonical name to new canonical name. For example: :code:`{'images/old.png': 'images/new.png'}`
ja: 古い正規名から新しい正規名へのマッピング。例: {'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.
ja: 2 つの引数 ``(name, anchor)`` を取り、新しいアンカーを返す呼び出し可能オブジェクト。これは HTML ファイルのアンカーを変更する必要がある場合に役立ちます。デフォルトでは、何もしません。

en: If False, links are not replaced in the OPF file.
ja: False のとき、リンクは OPF ファイルで置き換えられません。

en: Rename files in the container, automatically updating all links to them.
ja: コンテナ内のファイルの名前を変更し、それらへのすべてのリンクを自動的に更新します。

en: A mapping of old canonical name to new canonical name, for example: :code:`{'text/chapter1.html': 'chapter1.html'}`.
ja: 古い正規名から新しい正規名へのマッピング。例: :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.
ja: 指定したファイル名に推奨されるフォルダを返します。推奨内容は、同じタイプのファイルの大部分がコンテナ内のどこにあるかに基づいています。特定の種類のファイルが存在しない場合、推奨フォルダーは OPF ファイルを含むフォルダであると見なされます。

en: Pretty printing and auto fixing parse errors
ja: きれいな印刷と解析エラーの自動修正

en: Fix any parsing errors in the HTML represented as a string in raw. Fixing is done using the HTML5 parsing algorithm.
ja: コンテナ内のすべての HTML ファイルの解析エラーを修正します。修正は、HTML5 解析アルゴリズムを使用して行われます。

en: Fix any parsing errors in all HTML files in the container. Fixing is done using the HTML5 parsing algorithm.
ja: raw で文字列として表される HTML の解析エラーを修正します。修正は、HTML5 解析アルゴリズムを使用して行われます。

en: Pretty print the HTML represented as a string in raw
ja: raw に文字列として表された HTML をきれいに印刷します

en: Pretty print the CSS represented as a string in raw
ja: raw に文字列として表された 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.
ja: raw に文字列として表されたXMLをきれいに印刷します。name が OPF の名前のとき、追加の OPF 固有の美化が実行されます。

en: Pretty print all HTML/CSS/XML files in the container
ja: raw に文字列として表された HTML/CSS/XML をきれいに印刷します

en: Managing book jackets
ja: 本のジャケットの管理

en: Remove an existing jacket, if any. Returns False if no existing jacket was found.
ja: 既存のジャケットがあれば、削除します。既存のジャケットが見つからなければ 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.
ja: 本の書誌から新しいジャケットを作成するか、既存のジャケットを交換します。既存のジャケットが交換された場合は True を返します。

en: Splitting and merging of files
ja: ファイルの分割とマージ

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.
ja: 名前で指定されたファイルを 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.
ja: //h:div[@id="split_here"] などの XPath 式である必要があります。プレビューパネルで分割を実装するために内部的に使用される *loc* にすることもできます。

en: If True the split occurs before the identified element otherwise after it.
ja: True のとき、分割は識別された要素の前に発生し、そうでなければその後に発生します。

en: Used internally
ja: 内部で使用

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.
ja: 指定されたファイルを複数の場所 (指定された XPath 式に一致するすべてのタグ) で分割します。:func:`split` も参照のこと。分割すると、影響を受けるファイルへのすべてのリンクと参照が自動的に移行されます。

en: If True the splits occur before the identified element otherwise after it.
ja: 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.
ja: 指定したファイルをひとつのファイルにマージし、影響を受けるファイルへのすべてのリンクと参照を自動的に移行します。ファイルはすべて HTML または CSS ファイルである必要があります。

en: Must be either ``'text'`` for HTML files or ``'styles'`` for CSS files
ja: HTML ファイルなら ``'text'``、CSS ファイルなら ``'styles'`` のいずれか。

en: The list of files to be merged
ja: マージするファイルのリスト

en: Which of the merged files is the *master* file, that is, the file that will remain after merging.
ja: マージされたファイルのどれが*マスター*ファイルか。つまり、マージ後に残るファイルです。

en: Managing covers
ja: 表紙の管理

en: Set the cover of the book to the image pointed to by cover_path.
ja: 本の表紙を 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.
ja: 画像ファイルへの絶対パスまたは本の画像の正規名。本で画像を使用する場合は、オプションも設定する必要があります。以下を参照してください。

en: An optional callable that takes a single argument. It will be called with information about the tasks being processed.
ja: 単一の引数を取るオプションの呼び出し可能オブジェクト。実行中の操作に関する情報とともに呼び出されます。

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)
ja: None、または表紙の設定方法を制御する辞書。辞書には次のエントリを含めることができます。**keep_aspect**: True または False (EPUBで表紙の縦横比を保持）**no_svg**: True または False (EPUB タイトルページで SVG 表紙ラッパーを使用）

en: Mark the specified image as the cover image.
ja: 指定した画像を表紙画像としてマークします。

en: Mark the specified HTML file as the titlepage of the EPUB.
ja: 指定した HTML ファイルを EPUB のタイトルページとしてマークします。

en: If True the HTML file is moved to the start of the spine
ja: True のとき、HTML ファイルはスパインの先頭に移動されます。

en: Working with CSS
ja: 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.
ja: フォントファミリを 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.
ja: 使用されていない CSS 規則をすべて本から削除します。使用されていない CSS 規則とは、実際のコンテンツと一致しない規則です。

en: An optional callable that takes a single argument. It is called with information about the operations being performed.
ja: 単一の引数を取るオプションの呼び出し可能オブジェクト。処理中のタスクに関する情報とともに呼び出されます。

en: If True, class attributes in the HTML that do not match any CSS rules are also removed.
ja: True の場合、CSS 規則に一致しない HTML のクラス属性も削除されます。

en: If True, rules with identical selectors are merged.
ja: True のとき、同一のセレクタを持つ規則がマージされます。

en: If True, rules with identical properties are merged.
ja: True のとき、同一のプロパティを持つ規則がマージされます。

en: If True, stylesheets that are not referenced by any content are removed
ja: True のとき、どのコンテンツからも参照されていないスタイルシートは削除されます

en: Remove the specified CSS properties from all CSS rules in the book.
ja: 本の中のすべての CSS 規則から指定された CSS プロパティを削除します。

en: Set of properties to remove. For example: :code:`{'font-family', 'color'}`.
ja: 削除するプロパティのセット。例: :code:`{'font-family', 'color'}`.

en: The files from which to remove the properties. Defaults to all HTML and CSS files in the book.
ja: プロパティを削除するファイル。デフォルトでは、本の中のすべての HTML ファイルと CSS ファイルになります。

en: Working with the Table of Contents
ja: 目次の処理

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.
ja: XPath 式のリストから目次を生成します。リスト内の式はそれぞれ、生成する目次のレベルに対応しています。例: :code:`['//h:h1', '//h:h2', '//h:h3']` は ``<h1>``, ``<h2>`` および ``<h3>`` タグから 3 階層の目次を作成します。

en: Generate a Table of Contents from links in the book.
ja: 本の中にあるリンクから目次を生成します。

en: Generate a Table of Contents from files in the book.
ja: 本の中にあるファイルから目次を生成します。

en: Create an inline (HTML) Table of Contents from an existing NCX Table of Contents.
ja: 既存の NCX 目次からインライン (HTML) 目次を作成します。

en: The title for this table of contents.
ja: この目次のタイトル。

en: Edit book tool
ja: 書籍編集ツール

en: The base class for individual tools in an Edit Book plugin. Useful members include:
ja: EditBook プラグインの個々のツールの基本クラス。便利なメンバーには次のものがあります:

en: ``self.plugin``: A reference to the :class:`calibre.customize.Plugin` object to which this tool belongs.
ja: ``self.plugin``: このツールが属する :class:`calibre.customize.Plugin` オブジェクトへの参照。

en: Methods that must be overridden in sub classes:
ja: サブクラスでオーバーライドする必要があるメソッド:

en: Set this to a unique name it will be used as a key
ja: これを一意の名前に設定すると、キーとして使用されます

en: If True the user can choose to place this tool in the plugins toolbar
ja: True のとき、ユーザはこのツールをプラグインツールバーに配置することを選択できます

en: If True the user can choose to place this tool in the plugins menu
ja: True のとき、ユーザはこのツールをプラグインメニューに配置することを選択できます

en: The popup mode for the menu (if any) of the toolbar button. Possible values are 'delayed', 'instant', 'button'
ja: ツールバーボタンのメニュー (あれば) のポップアップモード。可能な値は、'delayed', 'instant', 'button' です。

en: The :class:`calibre.gui2.tweak_book.boss.Boss` object. Used to control the user interface.
ja: :class:`calibre.gui2.tweak_book.boss.Boss` オブジェクト。ユーザインタフェースを制御するために使用されます。

en: The main window of the user interface
ja: ユーザインタフェースのメインウィンドウ

en: Return the current :class:`calibre.ebooks.oeb.polish.container.Container` object that represents the book being edited.
ja: 編集中の本を表す現在の :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.
ja: 指定された ``qaction`` をトリガーするキーボードショートカットを登録します。このキーボードショートカットは、自動的にエディタ設定のキーボードショートカットセクションでユーザがカスタマイズできるようになります。

en: A QAction object, it will be triggered when the configured key combination is pressed by the user.
ja: 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.
ja: このショートカット/アクションの一意の名前。内部で使用されます。このプラグインの他のアクションで共有しないでください。

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')``.
ja: デフォルトのキーボードショートカットのリスト。指定しない場合、デフォルトのショートカットは設定されません。ここで指定したショートカットが、組み込みのショートカットまたはユーザ設定/他のプラグインからのショートカットと競合する場合、それらは無視されます。その場合、ユーザは環境設定からショートカットを手動で設定する必要があります。例: ``default_keys=('Ctrl+J', 'F9')``

en: An optional short description of this action. If not specified the text from the QAction will be used.
ja: このアクションのオプションの短いな説明。指定しない場合、QAction からのテキストが使用されます。

en: An optional longer description of this action, it will be used in the preferences entry for this shortcut.
ja: このアクションのオプションの長めの説明。このショートカットの設定エントリで使用されます。

en: Create a QAction that will be added to either the plugins toolbar or the plugins menu depending on ``for_toolbar``. For example::
ja: ``for_toolbar`` に応じて、プラグインツールバーまたはプラグインメニューのいずれかに追加される QAction を作成します。例:

en: Method :meth:`register_shortcut`.
ja: メソッド :meth:`register_shortcut`。

en: Controlling the editor's user interface
ja: エディタのユーザインタフェースを制御

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.
ja: 電子書籍エディタのユーザインタフェースは、単一のグローバル *Boss* オブジェクトによって制御されます。これには、プラグインコードで一般的なタスクを実行するために使用できる多くの便利なメソッドがあります。

en: Create a restore checkpoint with the name specified as ``msg``
ja: ``msg`` で指定した名前で復元チェックポイントを作成します

en: Update all the components of the user interface to reflect the latest data in the current book container.
ja: 現在の本コンテナの最新データを反映するように、ユーザインタフェースのすべてのコンポーネントを更新します。

en: If True, the book will be marked as modified, so the user will be prompted to save it when quitting.
ja: Trueのとき、本は変更済みとしてマークされるため、ユーザは終了時に本を保存するように求められます。

en: Close the editor that is editing the file specified by ``name``
ja: ``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
ja: ユーザがエディタで開いているファイルに加えた変更をコンテナにコミットします。現在のコンテナでアクションを実行する前に、このメソッドを呼び出す必要があります

en: Return the name of the file being edited currently or None if no file is being edited
ja: 現在編集中のファイルの名前を返します。編集中のファイルがない場合は None を返します。

en: Open the file specified by name in an editor
ja: name で指定したファイルをエディタで開きます

en: The media type of the file, for example, ``'text/html'``. If not specified it is guessed from the file extension.
ja: ファイルのメディアタイプ、たとえば `'text/html'` など。指定されていない場合は、ファイル拡張子から推測されます。

en: A template to initialize the opened editor with
ja: 開いたエディタを初期化するためのテンプレート

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.
ja: 編集用の ``path`` で電子書籍を開きます。電子書籍がサポートされている形式でない場合、または現在の書籍に未保存の変更がある場合は、エラーが表示されます。

en: The name of a file inside the newly opened book to start editing. Can also be a list of names.
ja: 編集を開始するために新しく開いた本の中のファイルの名前。名前のリストにすることもできます。

en: Undo the previous creation of a restore checkpoint, useful if you create a checkpoint, then abort the operation with no changes
ja: 復元チェックポイントの以前の作成を元に戻します。チェックポイントを作成してから、変更せずに操作を中止する場合に便利です。

en: Save the book. Saving is performed in the background
ja: 本を保存します。保存はバックグラウンドで実行されます

en: Mark the book as having been modified
ja: 書籍を変更済みとしてマークします

en: Show the changes to the book from its last checkpointed state
ja: 最後のチェックポイント状態からの本への変更を表示します

en: If True the diff dialog will have a button to allow the user to revert all changes
ja: True のとき、diff ダイアログには、ユーザがすべての変更を元に戻すことができるボタンがつきます。

en: A container object to compare the current container to. If None, the previously checkpointed container is used
ja: 現在のコンテナを比較するコンテナオブジェクト。 None のとき、以前にチェックポイントされたコンテナが使用されます

en: Show the editor that is editing the file specified by ``name``
ja: ``name`` で指定されたファイルを編集しているエディターを表示します

en: Sync the position of the preview panel to the current cursor position in the current editor
ja: プレビューパネルの位置を現在のエディタの現在のカーソル位置に同期します
