calibre - en to ja translation catalogue (217 entries)

en: E-book conversion
ja: 電子書籍変換

en: calibre has a conversion system that is designed to be very easy to use. Normally, you just add a book to calibre, click convert and calibre will try hard to generate output that is as close as possible to the input. However, calibre accepts a very large number of input formats, not all of which are as suitable as others for conversion to e-books. In the case of such input formats, or if you just want greater control over the conversion system, calibre has a lot of options to fine tune the conversion process. Note however that calibre's conversion system is not a substitute for a full blown e-book editor. To edit e-books, I recommend first converting them to EPUB or AZW3 using calibre and then using the :guilabel:`Edit book` feature to get them into perfect shape. You can then use the edited e-book as input for conversion into other formats in calibre.
ja: calibre には、非常に使いやすいように設計された変換システムがあります。通常、本を calibre に追加し、変換をクリックすると、calibre はできるだけ入力に近い出力を生成しようとします。ただし calibre は数多くの入力形式を受け付けますが、そのすべてが電子書籍への変換に適しているわけではありません。このような入力形式の場合、または変換システムをより細かく制御したい場合、calibreには変換プロセスを微調整するための多くのオプションがあります。ただし、calibreの変換システムは、本格的な電子書籍エディタの代わりにはならないことに注意してください。電子書籍を編集するには、まず calibre を使用して EPUB または AZW3 に変換し、次に :guilabel:`本の編集` 機能を使って完璧に仕上げることをお勧めします。それが終われば編集した電子書籍を入力として、calibre の他の形式に変換するために利用できます。

en: This document will refer mainly to the conversion settings as found in the conversion dialog, pictured below. All these settings are also available via command line interface to conversion, documented at :doc:`generated/en/ebook-convert`. In calibre, you can obtain help on any individual setting by holding your mouse over it, a tooltip will appear describing the setting.
ja: このドキュメントでは主に、下の図に示す変換ダイアログの変換設定について説明します。これらの設定はすべて、コマンドラインインターフェイスからの変換にも使用できます。これについては、:doc:`generated/ja/ebook-convert` に記載されています。calibreでは、それぞれの設定項目の上にマウスを置くと、その設定に関するヘルプがツールチップで表示されます。

en: E-book conversion dialog
ja: 電子書籍変換ダイアログ

en: Contents
ja: 目次

en: Introduction
ja: はじめに

en: Debug icon
ja: デバッグアイコン

en: The first thing to understand about the conversion system is that it is designed as a pipeline. Schematically, it looks like this:
ja: 変換システムについて最初に理解すべきは、パイプラインとして設計されているということです。図にすると、次のようになっています:

en: The conversion pipeline
ja: 変換パイプライン

en: The input format is first converted to XHTML by the appropriate *Input plugin*. This HTML is then *transformed*. In the last step, the processed XHTML is converted to the specified output format by the appropriate *Output plugin*. The results of the conversion can vary greatly, based on the input format. Some formats convert much better than others. A list of the best source formats for conversion is available :ref:`here <best-source-formats>`.
ja: 入力形式は、まず適切な *入力プラグイン* によってXHTMLに変換されます。このHTMLは次に *変形* されます。最後のステップで、この処理された XHTML が、適切な *出力プラグイン* によって指定された出力形式に変換されます。変換の結果は、入力形式によって大きく異なる可能性があります。一部の形式は、他の形式よりもずっとうまく変換されます。変換にあたりソースとして最適な形式の一覧は :ref:`こちら <best-source-formats>` にあります。

en: The transforms that act on the XHTML output are where all the work happens. There are various transforms, for example, to insert book metadata as a page at the start of the book, to detect chapter headings and automatically create a Table of Contents, to proportionally adjust font sizes, et cetera. It is important to remember that all the transforms act on the XHTML output by the *Input plugin*, not on the input file itself. So, for example, if you ask calibre to convert an RTF file to EPUB, it will first be converted to XHTML internally, the various transforms will be applied to the XHTML and then the *Output plugin* will create the EPUB file, automatically generating all metadata, Table of Contents, et cetera.
ja: XHTML 出力に作用する変形こそが、すべての作業が行われる場所です。変形にはさまざまなものがありますが、たとえば、書誌を本の冒頭にページとして挿入したり、章の見出しを探して目次を自動的に作成したり、フォントサイズを比例的に調整したりするなど、といったことを行います。ただしこうした変形はすべて、入力ファイルそのものではなく、*入力プラグイン* から出力される XHTML に対して作用します。したがって、たとえば、calibre に RTF ファイルを EPUB に変換するよう求めると、まず内部で XHTML に変換され、さまざまな変形が XHTML に適用されてから、*出力プラグイン* がすべての書誌や目次などを自動的に生成して EPUB ファイルを作成します。

en: You can see this process in action by using the debug option |dbgi|. Just specify the path to a folder for the debug output. During conversion, calibre will place the XHTML generated by the various stages of the conversion pipeline in different sub-folders. The four sub-folders are:
ja: デバッグオプション |dbgi| を使用すると、この処理が動いているところ確認できます。デバッグ出力用のフォルダへのパスを指定するだけで使用できます。変換中、calibre は変換パイプラインのさまざまな段階で生成された XHTML を別々のサブフォルダに配置します。この 4つのサブフォルダは次のものです:

en: Stages of the conversion pipeline
ja: 変換パイプラインのステージ

en: Folder
ja: フォルダ

en: Description
ja: 説明

en: input
ja: 入力

en: This contains the HTML output by the Input plugin. Use this to debug the Input plugin.
ja: これには入力プラグインによる HTML 出力が含まれています。入力プラグインをデバッグするには、これを使用します。

en: parsed
ja: 解析

en: The result of pre-processing and converting to XHTML the output from the Input plugin. Use to debug structure detection.
ja: 入力プラグインからの出力を前処理して XHTML に変換した結果。構造検出をデバッグするために使用します

en: structure
ja: 構築

en: Post structure detection, but before CSS flattening and font size conversion. Use to debug font size conversion and CSS transforms.
ja: 構造検出後、ただし CSS フラット化とフォントサイズ変換の前。フォントサイズ変換と CSS 変形をデバッグするために使用します。

en: processed
ja: 処理

en: Just before the e-book is passed to the Output plugin. Use to debug the Output plugin.
ja: 電子書籍が出力プラグインに渡される直前。出力プラグインをデバッグするために使用します。

en: If you want to edit the input document a little before having calibre convert it, the best thing to do is edit the files in the :file:`input` sub-folder, then zip it up, and use the ZIP file as the input format for subsequent conversions. To do this use the :guilabel:`Edit meta information` dialog to add the ZIP file as a format for the book and then, in the top left corner of the conversion dialog, select ZIP as the input format.
ja: calibre で変換する前に入力ドキュメントを少し編集したい場合、最善なのは :file:`input` サブフォルダ内のファイルを編集してから圧縮し、その ZIP ファイルを変換の入力として使用することです。これを行うには、:guilabel:`書誌の編集` ダイアログを使用して、書籍の形式に ZIP ファイルを追加し、変換ダイアログの左上端で、入力形式として ZIP を選択します。

en: This document will deal mainly with the various transforms that operate on the intermediate XHTML and how to control them. At the end are some tips specific to each input/output format.
ja: このドキュメントでは、主に中間XHTMLに対して行うさまざまな変形と、それを制御する方法について説明します。最後に、各入出力形式に固有のヒントをいくつか記載します。

en: Look & feel
ja: 外観

en: This group of options controls various aspects of the look and feel of the converted e-book.
ja: このオプションのグループは、変換した電子書籍の見た目をさまざまな側面から制御します。

en: Fonts
ja: フォント

en: One of the nicest features of the e-reading experience is the ability to easily adjust font sizes to suit individual needs and lighting conditions. calibre has sophisticated algorithms to ensure that all the books it outputs have a consistent font sizes, no matter what font sizes are specified in the input document.
ja: 電子読書体験において最もすばらしい機能のひとつは、個々のニーズや照明条件に合わせてフォントサイズを簡単に調整できることです。calibre には高度なアルゴリズムがあり、入力ドキュメントでどのようなフォントサイズが指定されていようとも、出力される本ではどれもフォントサイズがそのままであることを保証します。

en: The base font size of a document is the most common font size in that document, i.e., the size of the bulk of text in that document. When you specify a :guilabel:`Base font size`, calibre automatically rescales all font sizes in the document proportionately, so that the most common font size becomes the specified base font size and other font sizes are rescaled appropriately. By choosing a larger base font size, you can make the fonts in the document larger and vice versa. When you set the base font size, for best results, you should also set the font size key.
ja: ドキュメントの基本フォントサイズとは、そのドキュメントで最もよく使われているフォントサイズ、つまりそのドキュメントのテキストの大部分で使われるサイズのことです。 :guilabel:`基本フォントサイズ` を指定すると、calibreはドキュメント内のすべてのフォントサイズを比例して自動的に再スケーリングします。これにより、最もよく使われているフォントサイズが指定された基本フォントサイズになり、他のフォントは適宜サイズ調整されます。基本フォントサイズを大きくすれば、ドキュメント内の他のフォントも大きくなりますし、逆もまた同じです。基本フォントサイズを設定する場合には、最良の結果を得るために、フォントサイズのキーも設定するとよいでしょう。

en: Normally, calibre will automatically choose a base font size appropriate to the output profile you have chosen (see :ref:`page-setup`). However, you can override this here in case the default is not suitable for you.
ja: 通常、calibreは、選択した出力プロファイルに適した基本フォントサイズを自動的に選択します (:ref:`page-setup` を参照)。ただしデフォルトが適切でない場合は、ここで上書きできます。

en: The :guilabel:`Font size key` option lets you control how non-base font sizes are rescaled. The font rescaling algorithm works using a font size key, which is simply a comma-separated list of font sizes. The font size key tells calibre how many "steps" bigger or smaller a given font size should be compared to the base font size. The idea is that there should be a limited number of font sizes in a document. For example, one size for the body text, a couple of sizes for different levels of headings and a couple of sizes for super/sub scripts and footnotes. The font size key allows calibre to compartmentalize the font sizes in the input documents into separate "bins" corresponding to the different logical font sizes.
ja: :guilabel:`フォントサイズのキー` オプションを使用すると、基本フォントサイズ以外のフォントをサイズ調整する方法を制御できます。フォントサイズ調整アルゴリズムは、フォントサイズのキーを使用して機能します。フォントサイズのキーは、フォントサイズのコンマ区切りのリストです。フォントサイズのキーは、特定のフォントサイズを基本フォントサイズと比較して、いくつの「ステップ」を大きくしたり小さくしたりするかを calibre に指示します。大事なのは、ドキュメント内のフォントサイズの数を制限する必要があるということです。たとえば、本文テキスト用に 1 個のサイズ、さまざまなレベルの見出し用に 2、3 個のサイズ、上付き/下付き文字と脚注用に 2、3 個のサイズがあります。フォントサイズのキーを使用すれば、calibre が入力ドキュメントのフォントサイズを、さまざまな論理フォントサイズに対応する個別の「ビン」に区分することができるようになります。

en: Let's illustrate with an example. Suppose the source document we are converting was produced by someone with excellent eyesight and has a base font size of 8pt. That means the bulk of the text in the document is sized at 8pts, while headings are somewhat larger (say 10 and 12pt) and footnotes somewhat smaller at 6pt. Now if we use the following settings::
ja: 例を挙げて説明しましょう。変換しようとしているソースドキュメントが、視力に優れた人によって作成されているため、基本フォントサイズが 8pt であるとします。つまり、ドキュメント内のテキストの大部分のサイズが 8 ポイントで、見出しはやや大きく (たとえば、10 および 12 ポイント)、脚注は 6 ポイントでやや小さくなっています。ここで、次の設定を使用するとします:

en: The output document will have a base font size of 12pt, headings of 14 and 16pt and footnotes of 8pt. Now suppose we want to make the largest heading size stand out more and make the footnotes a little larger as well. To achieve this, the font key should be changed to::
ja: 出力ドキュメントの基本フォントサイズは 12pt、見出しは 14 および 16pt、脚注は 8pt になります。ここで、最も大きな見出しサイズをより目立たせ、脚注も少し大きくしたいとします。これを実現するには、フォントのキーを次のように変更する必要があります::

en: The largest headings will now become 18pt, while the footnotes will become 9pt. You can play with these settings to try and figure out what would be optimum for you by using the font rescaling wizard, which can be accessed by clicking the little button next to the :guilabel:`Font size key` setting.
ja: 最大の見出しが 18pt になり、脚注は 9pt になります。これらの設定を試して、フォントサイズ調整ウィザードを使用して最適なものを見つけてください。このウィザードには :guilabel:`フォントサイズのキー` 設定の横にある小さなボタンをクリックすると利用できます。

en: All the font size rescaling in the conversion can also be disabled here, if you would like to preserve the font sizes in the input document.
ja: 入力ドキュメントのフォントサイズをそのまま使いたい場合は、変換でフォントのサイズ調整を行わないよう、ここで設定できます。

en: A related setting is :guilabel:`Line height`. Line height controls the vertical height of lines. By default, (a line height of 0), no manipulation of line heights is performed. If you specify a non-default value, line heights will be set in all locations that don't specify their own line heights. However, this is something of a blunt weapon and should be used sparingly. If you want to adjust the line heights for some section of the input, it's better to use the :ref:`Extra CSS <extra-css>`.
ja: 関連する設定は :guilabel:`行の高さ` です。行の高さは、行の垂直方向の高さを制御します。デフォルトでは (行の高さは0)、行の高さの操作は実行されません。デフォルト以外の値を指定すると、行の高さは、独自の行の高さを指定しないすべての場所に設定されます。ただしこれは鈍器のようなものであり、控えめに使用する必要があります。入力の一部のセクションの行の高さを調整する場合は、:ref:`追加 CSS <extra-css>` を使用することをお勧めします。

en: In this section you can also tell calibre to embed any referenced fonts into the book. This will allow the fonts to work on reader devices even if they are not available on the device.
ja: このセクションでは、参照されているフォントを本に埋め込むように calibre に指示することもできます。これにより、そのフォントがデバイス上にない場合でも、リーダデバイスで機能するようになります。

en: Text
ja: テキスト

en: Text can be either justified or not. Justified text has extra spaces between words to give a smooth right margin. Some people prefer justified text, others do not. Normally, calibre will preserve the justification in the original document. If you want to override it you can use the :guilabel:`Text justification` option in this section.
ja: テキストは両端揃えにする場合としない場合があります。両端揃えのテキストには、単語の間に余分な空白があり、右マージンが滑らかになります。両端揃えのテキストを好む人もいれば、好まない人もいます。通常、calibre は元のドキュメントのテキスト揃えの状態をそのまま使用します。これを上書きしたい場合は、このセクションの :guilabel:`テキスト揃え` オプションを使用できます。

en: You can also tell calibre to :guilabel:`Smarten punctuation` which will replace plain quotes, dashes and ellipses with their typographically correct alternatives. Note that this algorithm is not perfect so it is worth reviewing the results. The reverse, namely, :guilabel:`Unsmarted punctuation` is also available.
ja: また、calibreに :guilabel:`句読点をスマート化` を指定することもできます。指定すると、プレーンな引用符、ダッシュ、省略記号が、活字で正しい代替記号に置き換えられます。ただしアルゴリズムは完全ではないため、結果を確認する価値があります。逆、つまり :guilabel:`スマート化されていない句読点` も使用できます。

en: Finally, there is :guilabel:`Input character encoding`.  Older documents sometimes don't specify their character encoding. When converted, this can result in non-English characters or special characters like smart quotes being corrupted.  calibre tries to auto-detect the character encoding of the source document, but it does not always succeed. You can force it to assume a particular character encoding by using this setting.  `cp1252` is a common encoding for documents produced using Windows software. You should also read :ref:`char-encoding-faq` for more on encoding issues.
ja: 最後に、:guilabel:`入力文字コード` があります。古いドキュメントでは、文字コードが指定されていないことがあります。これを変換すると、英語以外の文字やスマート引用符などの特殊文字が破損する可能性があります。calibre はソースドキュメントの文字コードを自動検出を試みますが、常に成功するとは限りません。この設定を使用すすれば、特定の文字コードを前提とするように強制できます。 cp1252は、Windowsソフトウェアを使用して作成されたドキュメントの一般的な文字コードです。文字コードの問題について詳しくは :ref:`char-encoding-faq` もお読みください。

en: Layout
ja: レイアウト

en: Normally, paragraphs in XHTML are rendered with a blank line between them and no leading text indent. calibre has a couple of options to control this. :guilabel:`Remove spacing between paragraphs` forcefully ensure that all paragraphs have no inter paragraph spacing. It also sets the text indent to 1.5em (can be changed) to mark the start of every paragraph. :guilabel:`Insert blank line` does the opposite, guaranteeing that there is exactly one blank line between each pair of paragraphs. Both these options are very comprehensive, removing spacing, or inserting it for *all* paragraphs (technically <p> and <div> tags). This is so that you can just set the option and be sure that it performs as advertised, irrespective of how messy the input file is. The one exception is when the input file uses hard line breaks to implement inter-paragraph spacing.
ja: 通常、XHTML の段落は、段落の間に空白行があり、先頭にテキストのインデントがない状態でレンダリングされます。calibre には、これを制御するためのいくつかのオプションがあります。 :guilabel:`段落間の空白を削除` は、すべての段落に段落間の間隔がないことを強制的に保証します。また、テキストのインデントを 1.5em (変更可能) に設定して、すべての段落の開始をマークします。 :guilabel:`空行を挿入` は逆のことを行い、段落の各ペアの間に正確に 1 つの空白行があることを保証します。これらのオプションはどちらも非常に包括的で、空白の削除や挿入は *すべての* 段落に対して行われます (技術的には <p> タグと <div> タグ)。これは入力ファイルがどれほど乱雑であろうとも、オプションを設定するだけで、宣伝どおりに機能することを保証できるようにするためです。唯一の例外は、入力ファイルが段落間の間隔を実装するためにハード改行を使用している場合です。

en: If you want to remove the spacing between all paragraphs, except a select few, don't use these options. Instead add the following CSS code to :ref:`Extra CSS <extra-css>`::
ja: すべての段落間の間隔を削除したい場合は、一部の例外を除き、これらのオプションを使用しないでください。代わりに、次の CSS コードを :ref:`追加 CSS <extra-css>` に追加します::

en: Then, in your source document, mark the paragraphs that need spacing with `class="spacious"`. If your input document is not in HTML, use the Debug option, described in the Introduction to get HTML (use the :file:`input` sub-folder).
ja: 次にソースドキュメントで、間隔が必要な段落に `class="spacious"` とマークします。入力ドキュメントが HTML でない場合は、HTML を取得するための入門書で説明されているデバッグオプションを使用します (:file:`input` サブフォルダを使用します)。

en: Another useful options is :guilabel:`Linearize tables`.  Some badly designed documents use tables to control the layout of text on the page.  When converted these documents often have text that runs off the page and other artifacts. This option will extract the content from the tables and present it in a linear fashion.  Note that this option linearizes *all* tables, so only use it if you are sure the input document does not use tables for legitimate purposes, like presenting tabular information.
ja: もうひとつの便利なオプションは、:guilabel:`表を展開` です。不適切に設計されたドキュメントの中には、表を使ってページ上のテキストのレイアウトを制御するものがあります。このようなドキュメントを変換すると、ページからはみ出すテキストやその他の歪みが含まれていることがよくあります。このオプションは、表からコンテンツを抽出し、線形に表示します。ただしこのオプションはすべての表を線形化するため、入力ドキュメントが表形式の情報の表示などの正当な目的でテーブルを使用していないことが確実な場合にのみ使用してください。

en: Styling
ja: スタイル

en: The :guilabel:`Extra CSS` option allows you to specify arbitrary CSS that will be applied to all HTML files in the input. This CSS is applied with very high priority and so should override most CSS present in the **input document** itself. You can use this setting to fine tune the presentation/layout of your document. For example, if you want all paragraphs of class `endnote` to be right aligned, just add::
ja: :guilabel:`追加 CSS` オプションを使用すると、入力内のすべての HTML ファイルに適用される任意のCSSを指定できます。このCSSは非常に高い優先度で適用されるため、 **入力ドキュメント** 自体に存在するほとんどの CSS を上書きします。この設定を使用すれば、ドキュメントのプレゼンテーション/レイアウトを微調整できます。たとえば、クラスの文末脚注のすべての段落を右揃えにしたい場合は、次を追加します::

en: or if you want to change the indentation of all paragraphs::
ja: または、すべての段落のインデントを変更したい場合には次のようにします::

en: :guilabel:`Extra CSS` is a very powerful option, but you do need an understanding of how CSS works to use it to its full potential. You can use the debug pipeline option described above to see what CSS is present in your input document.
ja: :guilabel:`追加 CSS` は非常に強力なオプションですが、CSS を最大限に活用するには、CSS がどのように機能するかを理解する必要があります。上記のデバッグパイプラインオプションを使用すると、入力ドキュメントに存在する CSS を確認できます。

en: A simpler option is to use :guilabel:`Filter style information`. This allows you to remove all CSS properties of the specified types from the document. For example, you can use it to remove all colors or fonts.
ja: より簡単なオプションは、:guilabel:`スタイル情報を絞り込み` を使用することです。これを使うと、指定したタイプのすべての CSS プロパティをドキュメントから削除できます。たとえば、すべての色またはフォントの削除に利用できます。

en: Transform styles
ja: スタイルの変形

en: This is the most powerful styling related facility. You can use it to define rules that change styles based on various conditions. For example you can use it to change all green colors to blue, or remove all bold styling from the text or color all headings a certain color, etc.
ja: これは、最も強力なスタイリング関連の機能です。これを使用すると、さまざまな条件に基づいてスタイルを変更するルールを定義できます。たとえば、すべての緑色を青色に変更したり、テキストからすべての太字のスタイルを削除したり、すべての見出しを特定の色に着色したりするのに利用できます。

en: Transform HTML
ja: HTML の変形

en: Similar to transform styles, but allows you to make changes to the HTML content of the book. You can replace one tag with another, add classes or other attributes to tags based on their content, etc.
ja: 変換スタイルに似た機能で、本の HTML コンテンツに変更を加えることができます。あるタグを別のタグに置き換えたり、コンテンツに基づいてクラスやその他の属性をタグに追加したりできます。

en: Page setup
ja: ページ設定

en: The :guilabel:`Page setup` options are for controlling screen layout, like margins and screen sizes. There are options to setup page margins, which will be used by the output plugin, if the selected output format supports page margins. In addition, you should choose an Input profile and an output profile. Both sets of profiles basically deal with how to interpret measurements in the input/output documents, screen sizes and default font rescaling keys.
ja: :guilabel:`ページ` オプションは、余白や画面サイズなどの画面レイアウトを制御するためのものです。選択した出力形式がページ余白をサポートしている場合に出力プラグインによって使用される、ページ余白を設定するオプションがあります。さらに、入力プロファイルと出力プロファイルを選択する必要があります。プロファイルのセットは両方とも基本的には、入力/出力ドキュメント、画面サイズ、およびデフォルトのフォントサイズ調整のキーの寸法をどのように解釈するかを扱います。

en: If you know that the file you are converting was intended to be used on a particular device/software platform, choose the corresponding input profile, otherwise just choose the default input profile. If you know the files you are producing are meant for a particular device type, choose the corresponding output profile. Otherwise, choose one of the Generic output profiles. If you are converting to MOBI or AZW3 then you will almost always want to choose one of the Kindle output profiles. Otherwise, your best bet for modern E-book reading devices is to choose the :guilabel:`Generic e-ink HD` output profile.
ja: 変換しようとしているファイルが特定のデバイス/ソフトウェアプラットフォームでの使用を目的としていることがわかっている場合は、対応する入力プロファイルを選択します。それ以外の場合は、デフォルトの入力プロファイルを選択します。作成しているファイルが特定のデバイスタイプ用であることがわかっている場合は、対応する出力プロファイルを選択してください。それ以外の場合は、汎用出力プロファイルのひとつを選択します。MOBI または AZW3 に変換するのであれば、ほとんどの場合、Kindle の出力プロファイルのひとつを選択したいと思うでしょう。そうでなければ、最新の電子書籍リーダデバイスに最善なのは、:guilabel:`汎用電子ペーパー HD`` 出力プロファイルを選択することです。

en: The output profile also controls the screen size. This will cause, for example, images to be auto-resized to be fit to the screen in some output formats. So choose a profile of a device that has a screen size similar to your device.
ja: 出力プロファイルは、画面サイズも制御します。これにより、たとえば一部の出力形式では、画像が画面に収まるように自動的にサイズ変更されることになります。ですから、デバイスと同じような画面サイズを持つデバイスのプロファイルを選択してください。

en: Heuristic processing
ja: ヒューリスティック処理

en: Heuristic processing provides a variety of functions which can be used to try and detect and correct common problems in poorly formatted input documents.  Use these functions if your input document suffers from poor formatting. Because these functions rely on common patterns, be aware that in some cases an option may lead to worse results, so use with care.  As an example, several of these options will remove all non-breaking-space entities, or may include false positive matches relating to the function.
ja: ヒューリスティック処理は、書式のくずれた入力ドキュメントにありがちな問題を検出して修正するためのさまざまな機能を提供します。入力ドキュメントの書式がくずれている場合は、これらの関数を使用してください。ただしこれらの関数は一般的なパターンに頼っているため、オプションによっては結果が悪化する可能性があります。例を挙げると、これらのオプションのいくつかは、すべてのノンブレークスペースエンティティを削除したり、関数に関連して誤検知することがあります。

en: :guilabel:`Enable heuristic processing`
ja: :guilabel:`ヒューリスティック処理を行う`

en: This option activates calibre's :guilabel:`Heuristic processing` stage of the conversion pipeline. This must be enabled in order for various sub-functions to be applied
ja: このオプションは、calibreの 変換パイプラインの :guilabel:`ヒューリスティック処理` ステージを有効にします。さまざまなサブ機能を適用するには、これが有効になっている必要があります。

en: :guilabel:`Unwrap lines`
ja: :guilabel:`行折り返し解除`

en: Enabling this option will cause calibre to attempt to detect and correct hard line breaks that exist within a document using punctuation clues and line length. calibre will first attempt to detect whether hard line breaks exist, if they do not appear to exist calibre will not attempt to unwrap lines. The line-unwrap factor can be reduced if you want to 'force' calibre to unwrap lines.
ja: このオプションを有効にすると、calibre は句読点の手がかりと行の長さを使用して、ドキュメント内に存在するハード改行を検出して修正しようとします。 calibreは、まずハード改行が存在するかどうかを検出しようとします。存在しないように見える場合、calibreは行の折り返しを解除しようとはしません。calibre に行の折り返しを解除するように強制したい場合には、行折り返し解除係数を減らすことができます。

en: :guilabel:`Line-unwrap factor`
ja: :guilabel:`行折り返し解除係数`

en: This option controls the algorithm calibre uses to remove hard line breaks. For example, if the value of this option is 0.4, that means calibre will remove hard line breaks from the end of lines whose lengths are less than the length of 40% of all lines in the document. If your document only has a few line breaks which need correction, then this value should be reduced to somewhere between 0.1 and 0.2.
ja: このオプションは、calibre がハード改行の削除に使用するアルゴリズムを制御します。たとえばこのオプションの値が 0.4 の場合、ドキュメント内のすべての行の長さの 40％ より短ければ、その行の末尾から calibre がハード改行を削除することを意味します。ドキュメントに修正が必要な改行が数個しかない場合は、この値を 0.1 〜 0.2 の範囲に減らす必要があります。

en: :guilabel:`Detect and markup unformatted chapter headings and sub headings`
ja: :guilabel:`書式のない章見出しとサブ見出しを探してマークアップ`

en: If your document does not have chapter headings and titles formatted differently from the rest of the text, calibre can use this option to attempt to detect them and surround them with heading tags. <h2> tags are used for chapter headings; <h3> tags are used for any titles that are detected.
ja: ドキュメントの中に、他のテキストと書式が異なる章見出しとタイトルが存在しない場合、このオプションを使用すると calibre はそれを探して見出しタグで囲むことができます。 <h2> タグは、章見出しに使用されます。 <h3> タグは、見つかったすべてのタイトルに使用されます。

en: This function will not create a TOC, but in many cases it will cause calibre's default chapter detection settings to correctly detect chapters and build a TOC.  Adjust the XPath under Structure detection if a TOC is not automatically created.  If there are no other headings used in the document then setting "//h:h2" under Structure detection would be the easiest way to create a TOC for the document.
ja: この機能が目次を作成するわけではありませんが、たいていの場合はこれによって calibre のデフォルトの章検出設定が正しく章を探して目次を作成するようになります。目次が自動的に作成されない場合は、構造検出で XPath を調整してください。ドキュメント内で他に見出しが使用されていなければ、目次を作成する最も簡単な方法は、構造検出で "//h:h2" を設定することです。

en: The inserted headings are not formatted, to apply formatting use the :guilabel:`Extra CSS` option under the Look and Feel conversion settings.  For example, to center heading tags, use the following::
ja: 挿入される見出しには書式がありません。書式を適用するには、変換設定の外観の下にある :guilabel:`追加 CSS` オプションを使用します。たとえば見出しタグを中央に配置するには、次のようにします::

en: :guilabel:`Renumber sequences of <h1> or <h2> tags`
ja: :guilabel:`<h1> や <h2> タグ順を再割り当て`

en: Some publishers format chapter headings using multiple <h1> or <h2> tags sequentially. calibre's default conversion settings will cause such titles to be split into two pieces.  This option will re-number the heading tags to prevent splitting.
ja: 一部の出版社は、複数の <h1> または <h2> タグを順番に使用して章の見出しの書式を設定します。 calibre のデフォルトの変換設定では、このようなタイトルは 2 つに分割されます。このオプションは、分割を防ぐために見出しタグに番号を付け直します。

en: :guilabel:`Delete blank lines between paragraphs`
ja: :guilabel:`段落間の空行を削除`

en: This option will cause calibre to analyze blank lines included within the document.  If every paragraph is interleaved with a blank line, then calibre will remove all those blank paragraphs.  Sequences of multiple blank lines will be considered scene breaks and retained as a single paragraph. This option differs from the :guilabel:`Remove paragraph spacing` option under :guilabel:`Look and Feel` in that it actually modifies the HTML content, while the other option modifies the document styles.  This option can also remove paragraphs which were inserted using calibre's :guilabel:`Insert blank line` option.
ja: このオプションを設定すると、calibreはドキュメントに含まれる空白行を分析します。すべての段落に空白行がとじ込みされている場合、calibre はその空白の段落をすべて削除します。連続した複数行の空白はシーン区切りと見なされ、ひとつの段落としてそのまま保持されます。このオプションは :guilabel:`外観`の下の :guilabel:`段落間の空白を削除` オプションとは HTML コンテンツ自体を変更する点が異なります。:guilabel:`段落間の空白を削除` オプションはドキュメントスタイルを変更します。このオプションでは、calibreの :guilabel:`空行を挿入` オプションを使って挿入された段落を削除することもできます。

en: :guilabel:`Ensure scene breaks are consistently formatted`
ja: :guilabel:`シーン区切りの書式を変更しない`

en: With this option calibre will attempt to detect common scene-break markers and ensure that they are center aligned. 'Soft' scene break markers, i.e. scene breaks only defined by extra white space, are styled to ensure that they will not be displayed in conjunction with page breaks.
ja: このオプションを使用すると、calibre は一般的なシーン区切りマーカーを探して中央に配置します。 「ソフト」シーン区切りマーカー、つまり余分な空白によってのみ定義されるシーン区切りが、改ページと同時に表示されることのないようにスタイルを設定します。

en: :guilabel:`Replace scene breaks`
ja: :guilabel:`シーン区切りを置換`

en: If this option is configured then calibre will replace scene break markers it finds with the replacement text specified by the user.  Please note that some ornamental characters may not be supported across all reading devices.
ja: このオプションが設定されていると、calibreは検出したシーン区切りマーカーをユーザが指定した置換テキストに置き換えます。ただし一部の装飾用文字は、読み取りデバイスによっては表示できないこともあります。

en: In general you should avoid using HTML tags, calibre will discard any tags and use pre-defined markup.  <hr /> tags, i.e. horizontal rules, and <img> tags are exceptions.  Horizontal rules can optionally be specified with styles, if you choose to add your own style be sure to include the 'width' setting, otherwise the style information will be discarded.  Image tags can used, but calibre does not provide the ability to add the image during conversion, this must be done after the fact using the 'Edit book' feature.
ja: 全般的に HTML タグの使用は避けてください。calibre はタグをすべて破棄し、事前に定義したマークアップを使用します。 <hr /> タグ、つまり水平線、および <img> タグは例外です。オプションで水平線のスタイルを指定できます。自分でスタイルを追加する場合には、必ず '幅' 設定を含めてください。そうしないと、スタイル情報が破棄されます。画像タグは使用可能ですが、calibre は変換中に画像を追加する機能を提供していません。これは、'本の編集' 機能を使用して事後に行う必要があります。

en: Example image tag (place the image within an 'Images' folder inside the EPUB after conversion):
ja: 画像タグの例 (変換後に EPUB 内部の 'Images' フォルダに画像を配置)

en: Example horizontal rule with styles:
ja: 書式つき水平線の例:

en: :guilabel:`Remove unnecessary hyphens`
ja: :guilabel:`不要なハイフンを削除`

en: calibre will analyze all hyphenated content in the document when this option is enabled.  The document itself is used as a dictionary for analysis.  This allows calibre to accurately remove hyphens for any words in the document in any language, along with made-up and obscure scientific words.  The primary drawback is words appearing only a single time in the document will not be changed.  Analysis happens in two passes, the first pass analyzes line endings.  Lines are only unwrapped if the word exists with or without a hyphen in the document.  The second pass analyzes all hyphenated words throughout the document, hyphens are removed if the word exists elsewhere in the document without a match.
ja: このオプションを有効にすると、calibre はドキュメント内のハイフンでつながれたすべてのコンテンツを分析します。ドキュメントそのものが、分析用の辞書として使われます。これのオプションを使用すれば、calibre は文書内の言語が何であれ、造語であろうとあいまいな科学用語であろうと正しくハイフンを削除できます。主な欠点は、ドキュメントに 1 回しか表示されない単語は変更できないことです。分析は 2 つの工程で行われ、最初の工程では行末を分析します。その単語がドキュメント内にハイフンの有無にかかわらず存在する場合にのみ、行の折り返しが解除されます。 2 番目の工程では、ドキュメント全体でハイフンが付けられたすべての単語が分析されます。単語がマッチすることなくドキュメント内の他の場所に存在する場合、ハイフンは削除されます。

en: :guilabel:`Italicize common words and patterns`
ja: :guilabel:`常用句やパターンをイタリック体にする`

en: When enabled, calibre will look for common words and patterns that denote italics and italicize them.  Examples are common text conventions such as ~word~ or phrases that should generally be italicized, e.g. latin phrases like 'etc.' or 'et cetera'.
ja: 有効にすると、calibre はイタリックを表す一般的な単語やパターンを探し、それらをイタリック体にします。例としては、~word~ のようによく使われているテキスト慣習や、'etc.' や 'et cetera' などのラテン語の語句のように一般的にイタリック体にされるものが挙げられます。

en: :guilabel:`Replace entity indents with CSS indents`
ja: :guilabel:`要素のインデントを CSS のインデントに置換`

en: Some documents use a convention of defining text indents using non-breaking space entities.  When this option is enabled calibre will attempt to detect this sort of formatting and convert them to a 3% text indent using CSS.
ja: 一部のドキュメントでは、ノンブレークスペースを使用してテキストインデントを定義する手法をとっています。このオプションを有効にすると、calibre はこのような書式を探し出し、CSS を用いて 3％ のテキストインデントに変換しようとします。

en: Search & replace
ja: 検索と置換

en: These options are useful primarily for conversion of PDF documents or OCR conversions, though they can also be used to fix many document specific problems. As an example, some conversions can leaves behind page headers and footers in the text. These options use regular expressions to try and detect headers, footers, or other arbitrary text and remove or replace them. Remember that they operate on the intermediate XHTML produced by the conversion pipeline. There is a wizard to help you customize the regular expressions for your document.  Click the magic wand beside the expression box, and click the 'Test' button after composing your search expression.  Successful matches will be highlighted in Yellow.
ja: これらのオプションは、主に PDF ドキュメントの変換や OCR 変換に役立つものですが、多くのドキュメント固有の問題を修正するためにも使用できます。例として、一部の変換では、テキストにページのヘッダとフッタが残る場合があります。これらのオプションは、正規表現を使用して、ヘッダ、フッタ、またはその他の任意のテキストを探し、削除したり置換したりします。ただしこれが操作する対象は、変換パイプラインによって生成された中間 XHTML です。ウィザードを使うと、ドキュメントの正規表現のカスタマイズを手助けしてくれます。式ボックスの横にある魔法の杖をクリックし、検索式を作成した後、'テスト' ボタンをクリックしてください。マッチに成功したものは黄色で強調表示されます。

en: The search works by using a Python regular expression. All matched text is simply removed from the document or replaced using the replacement pattern. The replacement pattern is optional, if left blank then text matching the search pattern will be deleted from the document.  You can learn more about regular expressions and their syntax at :ref:`regexptutorial`.
ja: 検索は、Python 正規表現を使用して機能します。マッチしたテキストはすべて、ドキュメントから削除されるか、置換パターンを使用して置換されます。置換パターンはオプションです。空白にしておくと、検索パターンにマッチするテキストがドキュメントから削除されます。正規表現とその構文について詳しくは :ref:`regexptutorial` を参照してください。

en: Structure detection
ja: 構造検出

en: Structure detection involves calibre trying its best to detect structural elements in the input document, when they are not properly specified. For example, chapters, page breaks, headers, footers, etc. As you can imagine, this process varies widely from book to book. Fortunately, calibre has very powerful options to control this. With power comes complexity, but if once you take the time to learn the complexity, you will find it well worth the effort.
ja: 構造検出は、入力ドキュメント内の構造要素が適切に指定されていない場合に、caliber がそれ検出するのに最善を尽くすことに関わります。たとえば、章、ページ分割、ヘッダ、フッタなどです。容易に想像できることですが、この処理は本ごとに大きく異なります。幸い、calibre にはこれを制御するための非常に強力なオプションがあります。強力さには複雑さが伴うものですが、時間をかけて複雑さを学んでみれば、努力するだけの価値が十分にあるとわかるでしょう。

en: Chapters and page breaks
ja: 章と改ページ

en: calibre has two sets of options for :guilabel:`chapter detection` and :guilabel:`inserting page breaks`. This can sometimes be slightly confusing, as by default, calibre will insert page breaks before detected chapters as well as the locations detected by the page breaks option. The reason for this is that there are often location where page breaks should be inserted that are not chapter boundaries. Also, detected chapters can be optionally inserted into the auto generated Table of Contents.
ja: calibreには、:guilabel:`章の検出` と:guilabel:`改ページの挿入` という 2 つのオプションセットがあります。デフォルトでは、calibre は検出された章の前に改ページを挿入した上に、改ページオプションによって検出された場所にも挿入するため、少々混乱する場合があります。こうする理由は、しばしば章の境界ではない場所に改ページを挿入する必要があるためです。検出された章は、オプションで自動生成された目次に挿入することもできます。

en: calibre uses *XPath*, a powerful language to allow the user to specify chapter boundaries/page breaks. XPath can seem a little daunting to use at first, fortunately, there is a :ref:`XPath tutorial <xpath-tutorial>` in the User Manual. Remember that Structure detection operates on the intermediate XHTML produced by the conversion pipeline. Use the debug option described in the :ref:`conversion-introduction` to figure out the appropriate settings for your book. There is also a button for a XPath wizard to help with the generation of simple XPath expressions.
ja: caliberは *XPath* を使用しています。これはユーザが章の境界/改ページを指定できるようにする、強力な言語です。最初のうち XPath は使い方が難しく感じるかもしれませんが、ありがたいことにユーザマニュアルの中には :ref:`XPath チュートリアル <xpath-tutorial>` があります。構造検出が処理するのは、変換パイプラインによって生成された中間 XHTML です。書籍に適した設定を探すには :ref:`conversion-introduction` に説明されているデバッグオプションを使用してください。簡単な XPath 式の生成を支援するために、XPath ウィザードのボタンも用意されています。

en: By default, calibre uses the following expression for detecting chapters::
ja: デフォルトでは、calibre は章を探すのに次の式を使用します::

en: This expression is rather complex, because it tries to handle a number of common cases simultaneously. What it means is that calibre will assume chapters start at either `<h1>` or `<h2>` tags that have any of the words `(chapter, book, section or part)` in them or that have the `class="chapter"` attribute.
ja: この式はかなり複雑です。数多くの一般的なケースを同時に処理しようとしているためです。どういう意味かと言うと、calibreは、章が <h1> または <h2> タグのいずれかで始まり、その中に単語 `(chapter, book, section または part)` のうちいずれかが含まれている、または `class="chapter"` 属性がつけられているものと想定しています。

en: A related option is :guilabel:`Chapter mark`, which allows you to control what calibre does when it detects a chapter. By default, it will insert a page break before the chapter. You can have it insert a ruled line instead of, or in addition to the page break. You can also have it do nothing.
ja: 関連するオプションに :guilabel:`章のマーク` があります。これを使用すると、章を見つけたときの calibre の動作を制御できます。デフォルトでは、章の前に改ページが挿入されます。改ページの代わりに、または改ページに加えて、罫線を挿入することができます。何もしないようにすることもできます

en: The default setting for detecting page breaks is::
ja: 改ページを探すためのデフォルトの設定は次のようになっています::

en: which means that calibre will insert page breaks before every `<h1>` and `<h2>` tag by default.
ja: これは、デフォルトで、calibreがすべての <h1> および <h2> タグの前に改ページを挿入することを意味します。

en: The default expressions may change depending on the input format you are converting.
ja: 変換する入力形式によっては、デフォルトの式が変わることがあります。

en: Miscellaneous
ja: その他

en: There are a few more options in this section.
ja: このセクションにはさらにいくつかのオプションがあります。

en: :guilabel:`Insert metadata as page at start of book`
ja: :guilabel:`本の最初のページに書誌を挿入`

en: One of the great things about calibre is that it allows you to maintain very complete metadata about all of your books, for example, a rating, tags, comments, etc. This option will create a single page with all this metadata and insert it into the converted e-book, typically just after the cover. Think of it as a way to create your own customised book jacket.
ja: calibreの優れた点のひとつに、書籍に関するまさに完璧な書誌を管理できることが挙げられます。評価、タグ、コメントなど、すべてを管理できます。このオプションは、こうした書誌を含むひとつのページを作成し、変換した電子書籍に挿入します。通常は表紙の直後に挿入します。自分でカスタマイズした表紙を作成する方法のひとつと考えてください。

en: :guilabel:`Remove first image`
ja: :guilabel:`最初の画像を削除`

en: Sometimes, the source document you are converting includes the cover as part of the book, instead of as a separate cover. If you also specify a cover in calibre, then the converted book will have two covers. This option will simply remove the first image from the source document, thereby ensuring that the converted book has only one cover, the one specified in calibre.
ja: 時として変換するソースドキュメントには、表紙として分離されたものではなく、表紙が本の一部に含まれていることがあります。calibre でも表紙を指定した場合、変換された本は 2 つの表紙を持つことになります。このオプションは、単にソースドキュメントから最初の画像を削除します。その結果、変換された本の表紙は calibre によって指定されたものだけになります。

en: Table of Contents
ja: 目次

en: When the input document has a Table of Contents in its metadata, calibre will just use that. However, a number of older formats either do not support a metadata based Table of Contents, or individual documents do not have one. In these cases, the options in this section can help you automatically generate a Table of Contents in the converted e-book, based on the actual content in the input document.
ja: 入力ドキュメントの書誌に目次があれば、calibre はそれを使用します。しかし古い形式の多くは書誌ベースの目次をサポートしていなかったり、個々のドキュメントが書誌を持たなかったりします。こうした場合にこのセクションのオプションを使えば、入力ドキュメントの実際のコンテンツに基づいて、変換された電子書籍の中に自動的に目次を生成してくれます。

en: Using these options can be a little challenging to get exactly right. If you prefer creating/editing the Table of Contents by hand, convert to the EPUB or AZW3 formats and select the checkbox at the bottom of the Table of Contents section of the conversion dialog that says :guilabel:`Manually fine-tune the Table of Contents after conversion`. This will launch the ToC Editor tool after the conversion. It allows you to create entries in the Table of Contents by simply clicking the place in the book where you want the entry to point. You can also use the ToC Editor by itself, without doing a conversion. Go to :guilabel:`Preferences->Interface->Toolbars` and add the :guilabel:`ToC Editor` to the main toolbar. Then just select the book you want to edit and click the :guilabel:`ToC Editor` button.
ja: このオプションの使い方を正確に理解するのには、少々手こずるかもしれません。目次を手作業で作成/編集したい場合は、EPUB または AZW3 形式に変換し、変換ダイアログの目次セクションの下部にある :guilabel:`変換完了後に目次を手動で調整` にチェックします。こうすると、変換後に目次編集ツールが起動するようになります。このツールを使えば、本の中の目次に入れたい場所をクリックするだけで目次に項目を作成できます。変換せずに目次エディタを単独で使用することもできます。:guilabel:`環境変数->インタフェース->ツールバー` へ行き、:guilabel:`目次エディタ` をメインツールバーに追加してください。それから編集する本を選択して、:guilabel:`目次エディタ` ボタンをクリックします。

en: The first option is :guilabel:`Force use of auto-generated Table of Contents`. By checking this option you can have calibre override any Table of Contents found in the metadata of the input document with the auto generated one.
ja: 最初のオプションは :guilabel:`自動生成された目次を強制的に使用` です。このオプションをチェックすると、入力ドキュメントの書誌にある目次を自動生成された目次で上書きできます。

en: The default way that the creation of the auto generated Table of Contents works is that, calibre will first try to add any detected chapters to the generated table of contents. You can learn how to customize the detection of chapters in the :ref:`structure-detection` section above. If you do not want to include detected chapters in the generated table of contents, check the :guilabel:`Do not add detected chapters` option.
ja: 自動生成される目次はデフォルトでは、calibreはまず、見つかった章を生成される目次に追加しようとします。章の検出をカスタマイズする方法については、上の :ref:`structure-detection` の章で詳しく説明しています。見つかった章を生成される目次に含めたくない場合は、:guilabel:`見つかった章を目次に追加しない` オプションをチェックしてください。

en: If less than the :guilabel:`Chapter threshold` number of chapters were detected, calibre will then add any hyperlinks it finds in the input document to the Table of Contents. This often works well: many input documents include a hyperlinked Table of Contents right at the start. The :guilabel:`Number of links` option can be used to control this behavior. If set to zero, no links are added. If set to a number greater than zero, at most that number of links is added.
ja: 見つけた章の数が :guilabel:`章のしきい値` より少ない場合、calibreは入力ドキュメントで見つかったハイパーリンクを目次に追加します。たいていの場合はこれでうまくいきます。入力ドキュメントには、先頭にハイパーリンクつきの目次が含まれていることが多いからです。:guilabel:`リンク数` オプションを使うと、この動作を制御できます。ゼロを設定すれば、リンクは追加されません。ゼロより大きい数を設定した場合には、最大でその数までのリンクが追加されます。

en: calibre will automatically filter duplicates from the generated Table of Contents. However, if there are some additional undesirable entries, you can filter them using the :guilabel:`TOC Filter` option. This is a regular expression that will match the title of entries in the generated table of contents. Whenever a match is found, it will be removed. For example, to remove all entries titles "Next" or "Previous" use::
ja: calibre は、生成された目次から重複を自動的に取り除きます。もしそれ以外にも望ましくない項目があれば、:guilabel:`目次を除去` オプションを使って取り除くことができます。ここに指定するのは、生成される目次のタイトルとマッチさせる正規表現です。マッチするものが見つかれば、削除します。たとえば "Next" または "Previous" というタイトルをすべて削除するには、次のようにします::

en: The :guilabel:`Level 1,2,3 TOC` options allow you to create a sophisticated multi-level Table of Contents. They are XPath expressions that match tags in the intermediate XHTML produced by the conversion pipeline. See the :ref:`conversion-introduction` for how to get access to this XHTML. Also read the :ref:`xpath-tutorial`, to learn how to construct XPath expressions. Next to each option is a button that launches a wizard to help with the creation of basic XPath expressions. The following simple example illustrates how to use these options.
ja: :guilabel:`レベル 1,2,3 目次` オプションを使用すると、洗練されたマルチレベルの目次を作成できます。ここに XPath 式を指定して、変換パイプラインによって生成された中間 XHTML のタグとマッチさせます。この XHTML にアクセスする方法については、:ref:`conversion-introduction` を参照してください。XPath 式の作成方法については、:ref:`xpath-tutorial` もお読みください。各オプションの横には、基本的な XPath 式の作成を支援するウィザードを起動するためのボタンがついています。これらのオプションの使用方法を、次の簡単な例で示します。

en: Suppose you have an input document that results in XHTML that look like this:
ja: 次のような XHTML を生成する入力ドキュメントがあるとします:

en: Then, we set the options as::
ja: 次に、オプションを次のように設定します::

en: This will result in an automatically generated two level Table of Contents that looks like::
ja: これにより、次のような 2 レベルの目次が自動的に生成されます。

en: Not all output formats support a multi level Table of Contents. You should first try with EPUB output. If that works, then try your format of choice.
ja: すべての出力形式がマルチレベルの目次をサポートしているわけではありません。最初に EPUB 出力を試してみてください。それがうまくいったら、実際に使いたい形式を試してください。

en: Using images as chapter titles when converting HTML input documents
ja: HTML入力ドキュメントを変換するときに章のタイトルとして画像を使用

en: Suppose you want to use an image as your chapter title, but still want calibre to be able to automatically generate a Table of Contents for you from the chapter titles. Use the following HTML markup to achieve this:
ja: 章タイトルとして画像を使用したいが、それでも calibre に章タイトルから目次を自動的に生成させたいとします。これを実現するには、次の HTML マークアップを使用します:

en: Set the :guilabel:`Level 1 TOC` setting to ``//h:h2``. Then, for chapter two, calibre will take the title from the value of the ``title`` attribute on the ``<h2>`` tag, since the tag has no text.
ja: :guilabel:`レベル 1 目次` に ``//h:h2`` を設定します。そうすると第 2 章ではタグにテキストがないため、calibre は ``<h2>`` タグの ``title` 属性の値からタイトルを取得します。

en: Using tag attributes to supply the text for entries in the Table of Contents
ja: 目次項目のテキストとしてタグの属性を使用

en: If you have particularly long chapter titles and want shortened versions in the Table of Contents, you can use the title attribute to achieve this, for example:
ja: 著しく長い章のタイトルがあり、目次用にはそれを短くしたものを使用したい場合は、title 属性を使用すれば実現できます。たとえば次のようにします:

en: Set the :guilabel:`Level 1 TOC` setting to ``//h:h2/@title``. Then calibre will take the title from the value of the ``title`` attribute on the ``<h2>`` tags, instead of using the text inside the tag. Note the trailing ``/@title`` on the XPath expression, you can use this form to tell calibre to get the text from any attribute you like.
ja: :guilabel:`レベル 1 目次` に ``//h:h2/@title`` を設定します。そうするとタグ内のテキストを使用する代わりに、calibre は ``<h2>`` タグの ``title`` 属性の値からタイトルを取得します。 XPath 式の末尾の ``/@title`` に注目してください。この形式を使えば、任意の属性からテキストを取得するように calibre に指示できます。

en: How options are set/saved for conversion
ja: 変換のためにオプションを設定/保存する方法

en: There are two places where conversion options can be set in calibre. The first is in Preferences->Conversion. These settings are the defaults for the conversion options. Whenever you try to convert a new book, the settings set here will be used by default.
ja: calibre で変換オプションを設定できる場所は2つあります。 1 つ目は、設定->変換 にあります。これらの設定は、変換オプションのデフォルトです。新しい本を変換しようとするとき、ここで設定したものがデフォルトとして使用されます。

en: You can also change settings in the conversion dialog for each book conversion. When you convert a book, calibre remembers the settings you used for that book, so that if you convert it again, the saved settings for the individual book will take precedence over the defaults set in :guilabel:`Preferences`. You can restore the individual settings to defaults by using the :guilabel:`Restore defaults` button in the individual book conversion dialog. You can remove the saved settings for a group of books by selecting all the books and then clicking the :guilabel:`Edit metadata` button to bring up the bulk metadata edit dialog, near the bottom of the dialog is an option to remove stored conversion settings.
ja: 本の変換ごとに、変換ダイアログで設定を変更することもできます。本を変換するとき、calibre はその本に使用した設定を記憶します。次にまた変換するときには、:guilabel:`環境設定` で設定されたデフォルトよりも、それぞれの本に保存された設定を優先します。本の変換ダイアログの :guilabel:`デフォルトに戻す` ボタンを使用すれば、個別の設定をデフォルトに戻すことができます。本のグループに保存されている設定を削除するには、すべての本を選択して :guilabel:`書誌を編集` ボタンをクリックし、書誌の一括編集ダイアログを表示します。ダイアログの下部に、保存されている変換を削除するオプションがあります。

en: When you bulk convert a set of books, settings are taken in the following order (last one wins):
ja: 本のセットを一括変換する場合、設定は次の順に取得します (最後のものが優先されます)。

en: From the defaults set in Preferences->Conversion
ja: 環境設定->変換で設定したデフォルトから

en: From the saved conversion settings for each book being converted (if any). This can be turned off by the option in the top left corner of the Bulk conversion dialog.
ja: 変換されるそれぞれの本の保存された変換設定から (もしあれば)。これは、一括変換ダイアログの左上隅にあるオプションで無効にできます。

en: From the settings set in the Bulk conversion dialog
ja: 一括変換ダイアログでで設定した内容から

en: Note that the final settings for each book in a Bulk conversion will be saved and re-used if the book is converted again. Since the highest priority in Bulk Conversion is given to the settings in the Bulk conversion dialog, these will override any book specific settings. So you should only bulk convert books together that need similar settings. The exceptions are metadata and input format specific settings. Since the Bulk conversion dialog does not have settings for these two categories, they will be taken from book specific settings (if any) or the defaults.
ja: 一括変換するそれぞれの本の最終設定は保存され、再びその本が変換されときには再利用されます。一括変換では、一括変換ダイアログの設定が最も優先されるため、個別の本の設定を上書きします。したがって、一括変換する本は同じような設定が必要な本に限る必要があります。例外は書誌と、入力形式に固有の設定です。一括変換ダイアログにはこれら 2 つのカテゴリの設定がないため、個別の本の設定 (あれば) またはデフォルトから取得されます。

en: You can see the actual settings used during any conversion by clicking the rotating icon in the lower right corner and then double clicking the individual conversion job. This will bring up a conversion log that will contain the actual settings used, near the top.
ja: 右下端にある回転アイコンをクリックしてから、個々の変換ジョブをダブルクリックすると、変換中に使用された実際の設定を確認できます。これは使用された実際の設定を含む変換ログを上部に表示します。

en: Format specific tips
ja: 形式固有のヒント

en: Here you will find tips specific to the conversion of particular formats. Options specific to particular format, whether input or output are available in the conversion dialog under their own section, for example `TXT input` or `EPUB output`.
ja: ここでは特定の形式の変換に固有な情報を記載します。特定の形式に特有なオプションや、`TXT 入力` や `EPUB 出力` のような入力と出力がそれぞれの変換ダイアログのもとで利用可能かどうか、といったことです。

en: Convert Microsoft Word documents
ja: Microsoft Word ドキュメントの変換

en: calibre can automatically convert ``.docx`` files created by Microsoft Word 2007 and newer. Just add the file to calibre and click convert.
ja: calibre は、Microsoft Word 2007 以降で作成された ``.docx`` ファイルを自動的に変換できます。ファイルを calibre に追加し、変換をクリックするだけです。

en: There is a :download_file:`demo .docx file <demos/demo.docx>` that demonstrates the capabilities of the calibre conversion engine. Just download it and convert it to EPUB or AZW3 to see what calibre can do.
ja: calibre 変換エンジンの機能を示す :download_file:`デモ用 .docx ファイル <demos/demo.docx>` があります。ダウンロードして EPUB または AZW3 に変換するだけで、calibre で何ができるかを確認できます。

en: calibre will automatically generate a Table of Contents based on headings if you mark your headings with the ``Heading 1``, ``Heading 2``, etc. styles in Microsoft Word. Open the output e-book in the calibre E-book viewer and click the :guilabel:`Table of Contents` button to view the generated Table of Contents.
ja: Microsoft Wordで ``Heading 1``, ``Heading 2`` などのスタイルで見出しをマークすると、calibre は見出しをもとにして目次を自動的に生成します。出力された電子書籍を calibre の電子書籍ビューアで開き、:guilabel:`目次` ボタンをクリックして、生成された目次を表示してください。

en: Older .doc files
ja: 古い .doc ファイル

en: For older .doc files, you can save the document as HTML with Microsoft Word and then convert the resulting HTML file with calibre. When saving as HTML, be sure to use the "Save as Web Page, Filtered" option as this will produce clean HTML that will convert well. Note that Word produces really messy HTML, converting it can take a long time, so be patient. If you have a newer version of Word available, you can directly save it as .docx as well.
ja: 古い .doc ファイルの場合には、Microsoft Word を使用してドキュメントを HTML として保存し、その HTML ファイルを calibre を使って変換できます。 HTML として保存するときは、必ず "Webページ (フィルター後)" を選択してください。こうすると、適切に変換できるクリーンな HTML が生成されます。ただし Wordは非常に厄介なHTMLを生成するため、変換には長い時間がかかる可能性があります。気長に待ちましょう。新しいバージョンの Word を利用できる場合は、それを .docx として直接保存することもできます。

en: Another alternative is to use the free LibreOffice. Open your .doc file in LibreOffice and save it as .docx, which can be directly converted in calibre.
ja: もうひとつの方法は、無料の LibreOffice を使用することです。 LibreOfficeで.docファイルを開き、.docxとして保存します。これは、calibreで直接変換できます。

en: Convert TXT documents
ja: テキストドキュメントの変換

en: TXT documents have no well defined way to specify formatting like bold, italics, etc, or document structure like paragraphs, headings, sections and so on, but there are a variety of conventions commonly used.  By default calibre attempts automatic detection of the correct formatting and markup based on those conventions.
ja: テキストドキュメントには、太字、斜体などの書式設定や、段落、見出し、セクションなどのドキュメント構造を指定する明確な方法はありませんが、一般的に使用されるさまざまな慣習があります。デフォルトでは calibreは、これらの慣習をもとにして、正しい書式とマークアップの自動検出を試みます。

en: TXT input supports a number of options to differentiate how paragraphs are detected.
ja: テキスト入力は、段落の検出方法を差別化するためのいくつかのオプションをサポートしています。

en: :guilabel:`Paragraph style: Auto`
ja: :guilabel:`段落スタイル: 自動`

en: Analyzes the text file and attempts to automatically determine how paragraphs are defined.  This option will generally work fine, if you achieve undesirable results try one of the manual options.
ja: テキストファイルを分析し、段落がどのように定義されているかを自動的に判断しようとします。このオプションはたいていうまくいきますが、望ましい結果が得られない場合は手動オプションを試してください。

en: :guilabel:`Paragraph style: Block`
ja: :guilabel:`段落スタイル: ブロック`

en: Assumes one or more blank lines are a paragraph boundary::
ja: ひとつ以上の空白行が段落境界であると想定します:

en: :guilabel:`Paragraph style: Single`
ja: :guilabel:`段落スタイル: 一行`

en: Assumes that every line is a paragraph::
ja: すべての行を段落とみなします::

en: :guilabel:`Paragraph style: Print`
ja: :guilabel:`段落スタイル: 印刷`

en: Assumes that every paragraph starts with an indent (either a tab or 2+ spaces). Paragraphs end when the next line that starts with an indent is reached::
ja: すべての段落がインデント (タブまたは2 つ以上のスペース) で始まると想定します。その次にインデントで始まる行に到達すると、段落は終了します。

en: :guilabel:`Paragraph style: Unformatted`
ja: :guilabel:`段落スタイル: 書式なし`

en: Assumes that the document has no formatting, but does use hard line breaks.  Punctuation and median line length are used to attempt to re-create paragraphs.
ja: ドキュメントには書式設定がないものとみなしますが、ハード改行は使用します。段落の再現を試みるために、句読点と中線の長さを使用します

en: :guilabel:`Formatting style: Auto`
ja: :guilabel:`書式スタイル: 自動`

en: Attempts to detect the type of formatting markup being used.  If no markup is used then heuristic formatting will be applied.
ja: 使用されている書式マークアップのタイプを検出しようとします。マークアップが使用されていない場合は、ヒューリスティックな書式が適用されます。

en: :guilabel:`Formatting style: Heuristic`
ja: :guilabel:`書式スタイル: ヒューリスティック`

en: Analyzes the document for common chapter headings, scene breaks, and italicized words and applies the appropriate HTML markup during conversion.
ja: 一般的な章の見出し、シーン区切り、イタリック体の単語がないかドキュメントを解析し、変換中に適切な HTML マークアップを適用します。

en: :guilabel:`Formatting style: Markdown`
ja: :guilabel:`書式スタイル: Markdown`

en: calibre also supports running TXT input though a transformation preprocessor known as Markdown. Markdown allows for basic formatting to be added to TXT documents, such as bold, italics, section headings, tables, lists, a Table of Contents, etc. Marking chapter headings with a leading # and setting the chapter XPath detection expression to "//h:h1" is the easiest way to have a proper table of contents generated from a TXT document. You can learn more about the Markdown syntax at `daringfireball <https://daringfireball.net/projects/markdown/syntax>`_.
ja: calibre は、Markdownと呼ばれる変換プリプロセッサを介した TXT 入力の実行もサポートしています。Markdown を使用すると、太字、斜体、セクション見出し、表、リスト、目次などの基本的な書式を TXTドキュメントに追加できます。章の見出しには先頭に＃を付けて、章のXPath検出式を "//h:h1" に設定するのが、TXTドキュメントから適切な目次を生成するための最も簡単な方法です。Markdown 構文の詳細については、 `daringfireball <https://daringfireball.net/projects/markdown/syntax>`_ を参照してください。

en: :guilabel:`Formatting style: None`
ja: :guilabel:`書式スタイル: なし`

en: Applies no special formatting to the text, the document is converted to HTML with no other changes.
ja: テキストに特別な書式を適用せず、ドキュメントが HTML に変換される以外の変更は加えられません。

en: Convert PDF documents
ja: PDF ドキュメントの変換

en: PDF documents are one of the worst formats to convert from. They are a fixed page size and text placement format. Meaning, it is very difficult to determine where one paragraph ends and another begins. calibre will try to unwrap paragraphs using a configurable, :guilabel:`Line un-wrapping factor`. This is a scale used to determine the length at which a line should be unwrapped. Valid values are a decimal between 0 and 1. The default is 0.45, just under the median line length. Lower this value to include more text in the unwrapping. Increase to include less. You can adjust this value in the conversion settings under :guilabel:`PDF Input`.
ja: PDFドキュメントは、変換元としては最悪の形式のひとつです。ページサイズは固定で、テキスト配置形式です。つまり、ある段落がどこで終わり、別の段落がどこから始まるかを判断するのが非常に困難なのです。 calibre は、設定変更可能な :guilabel:`行折り返し解除係数` を使って段落の行折り返し解除を試みます。この係数は、どの長さで行の折り返しを解除をするか判断するために使用する尺度です。有効な値は 0 から 1 までの小数です。デフォルトは 0.45 で、中線の長さのすぐ下です。この値を下げると、折り返し解除した行により多くのテキストが含まれます。増やすとテキストが少なくなります。この値は、:guilabel:`PDF 入力` の下の変換設定で調整できます。

en: Also, they often have headers and footers as part of the document that will become included with the text. Use the :guilabel:`Search and replace` panel to remove headers and footers to mitigate this issue. If the headers and footers are not removed from the text it can throw off the paragraph unwrapping. To learn how to use the header and footer removal options, read :ref:`regexptutorial`.
ja: また多くの場合、ドキュメントの一部であるヘッダとフッタがテキストに含まれるよう形になっています。 :guilabel:`検索と置換` パネルを使用してヘッダとフッタを削除し、この問題を緩和してください。ヘッダとフッタがテキストから削除されていないと、段落の行折り返し解除を放棄する可能性があります。ヘッダとフッタの削除オプションの使い方については :ref:`regexptutorial` を参照してください。

en: Some limitations of PDF input are:
ja: PDF 入力での制約の一部を挙げると:

en: Complex, multi-column, and image based documents are not supported.
ja: 複雑なドキュメント、マルチカラムなドキュメント、画像ベースのドキュメントをサポートしていません。

en: Extraction of vector images and tables from within the document is also not supported.
ja: ドキュメントからのベクタ画像の抽出と、表の抽出もサポートしていません。

en: Some PDFs use special glyphs to represent ll or ff or fi, etc. Conversion of these may or may not work depending on just how they are represented internally in the PDF.
ja: 一部のPDFは、ll、ff、fiなどを表すのに特別なグリフを使用してます。PDF内部での表現方法次第で、これらのテキストの変換が機能する場合と機能しない場合があります。

en: Links and Tables of Contents are not supported
ja: リンクと目次をサポートしていません。

en: PDFs that use embedded non-Unicode fonts to represent non-English characters will result in garbled output for those characters
ja: 埋め込みの非 Unicode フォントを使って英語以外の文字を表現している PDF は、それらの文字の出力が文字化けします。

en: Some PDFs are made up of photographs of the page with OCRed text behind them. In such cases calibre uses the OCRed text, which can be very different from what you see when you view the PDF file
ja: 一部の PDF は、ページを写真に写したものに OCR で読み取ったテキストを裏につけたものでできています。このような場合に calibre は OCR で読み取ったテキストを使用しますが、そうすると PDF ファイルを表示したときの見た目とは大きく異なってしまう可能性があります。

en: PDFs that are used to display complex text, like right to left languages and math typesetting will not convert correctly
ja: 右から左へ流れる言語や数式のような、複雑なテキストを表示する PDF は正しく変換されません。

en: To re-iterate **PDF is a really, really bad** format to use as input. If you absolutely must use PDF, then be prepared for an output ranging anywhere from decent to unusable, depending on the input PDF.
ja: 何度も繰り返しますが、入力として **PDF は本当に、本当にダメな** 形式です。何が何でも PDF を使わざるを得ない場合、入力 PDF によっては、まともなものから使い物にならないものまで出力の幅が大きいことを覚悟してください。

en: Comic book collections
ja: コミック本のコレクション

en: A comic book collection is a .cbc file. A .cbc file is a ZIP file that contains other CBZ/CBR files. In addition the .cbc file must contain a simple text file called comics.txt, encoded in UTF-8. The comics.txt file must contain a list of the comics files inside the .cbc file, in the form filename:title, as shown below::
ja: コミック本コレクションとは .cbc ファイルのことです。 .cbc ファイルは、他の CBZ/CBR ファイルを含む ZIP ファイルです。さらに .cbc ファイルには、UTF-8 でエンコードされた comics.txt という簡単ななテキストファイルが含まれている必要があります。comics.txt ファイルには、次のように .cbc ファイル内のコミックスファイルのリストが filename:title の形式で含まれていなくてはなりません:

en: The .cbc file will then contain::
ja: そして .cbc ファイルには次のものが含まれます:

en: calibre will automatically convert this .cbc file into a e-book with a Table of Contents pointing to each entry in comics.txt.
ja: caliberは、この .cbc ファイルを comics.txt の各項目を指す目次付きの電子書籍に自動的に変換します。

en: EPUB advanced formatting demo
ja: EPUB の優れた書式のデモ

en: Various advanced formatting for EPUB files is demonstrated in this :download_file:`demo file <demos/demo.epub>`. The file was created from hand coded HTML using calibre and is meant to be used as a template for your own EPUB creation efforts.
ja: この :download_file:`デモファイル <demos/demo.epub>` では、EPUBファイルのさまざまな優れた書式を紹介しています。このファイルは calibre を使用して手書きの HTML から作成しました。自分で EPUB を作成するときのテンプレートとして使えるよう作られています。

en: The source HTML it was created from is available :download_file:`demo.zip <demos/demo.zip>`. The settings used to create the EPUB from the ZIP file are::
ja: これを作成した元となる HTMLは :download_file:`demo.zip <demos/demo.zip>` です。この ZIP ファイルから EPUB を作成するにあたって使用した設定は次のとおりです::

en: Note that because this file explores the potential of EPUB, most of the advanced formatting is not going to work on readers less capable than calibre's built-in EPUB viewer.
ja: ただしこのファイルでは EPUB の可能性を追求しているため、優れた書式のうちかなりの部分は、calibre のビルトイン EPUBビューアに比べて能力の劣るリーダでは機能しません。

en: Convert ODT documents
ja: ODT ドキュメントの変換

en: calibre can directly convert ODT (OpenDocument Text) files. You should use styles to format your document and minimize the use of direct formatting. When inserting images into your document you need to anchor them to the paragraph, images anchored to a page will all end up in the front of the conversion.
ja: calibreは、ODT (OpenDocument Text) ファイルを直接変換できます。ドキュメントの書式にはスタイルを使用し、書式を直接使用するのは最小限に抑えるとよいでしょう。ドキュメントに画像を挿入する場合、画像は段落に固定する必要があります。ページに固定した画像はすべて、変換したものの先頭に置かれてしまいます。

en: To enable automatic detection of chapters, you need to mark them with the built-in styles called :guilabel:`Heading 1`, :guilabel:`Heading 2`, ..., :guilabel:`Heading 6` (:guilabel:`Heading 1` equates to the HTML tag ``<h1>``, :guilabel:`Heading 2` to ``<h2>``, etc). When you convert in calibre you can enter which style you used into the :guilabel:`Detect chapters at` box. Example:
ja: 章の自動検出を有効にするには、ビルトインスタイルで :guilabel:`Heading 1`, :guilabel:`Heading 2`, ..., :guilabel:`Heading 6` (:guilabel:`Heading 1` は HTML タグ ``<h1>``, :guilabel:`Heading 2` は ``<h2>`` という具合に相当します) でマークする必要があります。calibre で変換するときには、使用したスタイルを :guilabel:`章を検出` ボックスに入力できます。例:

en: If you mark Chapters with style :guilabel:`Heading 2`, you have to set the 'Detect chapters at' box to ``//h:h2``
ja: 章をスタイル :guilabel:`Heading 2` でマークする場合、'章を検出' ボックスは ``//h:h2``

en: For a nested TOC with Sections marked with :guilabel:`Heading 2` and the Chapters marked with :guilabel:`Heading 3` you need to enter ``//h:h2|//h:h3``. On the Convert - TOC page set the :guilabel:`Level 1 TOC` box to ``//h:h2`` and the :guilabel:`Level 2 TOC` box to ``//h:h3``.
ja: セクションが :guilabel:`Heading 2` でマーク、章を :guilabel:`Heading 3` でマークしている階層化された目次には、``//h:h2|//h:h3`` と入力する必要があります。変換の目次ページでは :guilabel:`レベル 1 目次` ボックスに ``//h:h2`` を、そして :guilabel:`レベル 2 目次` ボックスには ``//h:h3`` を入力します。

en: Well-known document properties (Title, Keywords, Description, Creator) are recognized and calibre will use the first image (not to small, and with good aspect-ratio) as the cover image.
ja: よく知られているドキュメントのプロパティ (タイトル、キーワード、説明、著者) が認識され、calibre は最初の画像 (小さすぎず、縦横比が良好) を表紙画像として使用します。

en: There is also an advanced property conversion mode, which is activated by setting the custom property ``opf.metadata`` ('Yes or No' type) to Yes in your ODT document (File->Properties->Custom Properties). If this property is detected by calibre, the following custom properties are recognized (``opf.authors`` overrides document creator)::
ja: 優れたプロパティ変換モードもあり、このモードを有効にするには ODT ドキュメントでカスタムプロパティ ``opf.metadata`` (Yes/No タイプ) を Yesに設定します (ファイル->プロパティ->カスタムプロパティ)。calibre がこのプロパティを検出すると、次のカスタムプロパティが認識されます (``opf.authors`` はドキュメント作成者を上書きします)::

en: In addition to this, you can specify the picture to use as the cover by naming it ``opf.cover`` (right click, Picture->Options->Name) in the ODT. If no picture with this name is found, the 'smart' method is used.  As the cover detection might result in double covers in certain output formats, the process will remove the paragraph (only if the only content is the cover!) from the document. But this works only with the named picture!
ja: これに加え、表紙として使用する画像を指定することも可能です。それには ODTで表紙画像に ``opf.cover`` と名前を付けます (右クリックして画像->オプション->名前)。この名前の画像が見つからない場合は、スマート方式が使用されます。表紙の検出のせいで特定の出力形式では表紙が二重になってしまう可能性があるため、この処理はその段落をドキュメントから削除します (ただし中身が表紙しかない場合に)。これが機能するのは名前付きの画像に限られます。

en: To disable cover detection you can set the custom property ``opf.nocover`` ('Yes or No' type) to Yes in advanced mode.
ja: 表紙検出を無効にするには、上級者モードでカスタムプロパティ ``opf.nocover`` (Yes/No タイプ) に Yes を設定します。

en: Converting to PDF
ja: PDF への変換

en: The first, most important, setting to decide on when converting to PDF is the page size. By default, calibre uses a page size of "U.S. Letter". You can change this to another standard page size or a completely custom size in the :guilabel:`PDF Output` section of the conversion dialog. If you are generating a PDF to be used on a specific device, you can turn on the option to use the page size from the :guilabel:`output profile` instead. So if your output profile is set to Kindle, calibre will create a PDF with page size suitable for viewing on the small Kindle screen.
ja: PDF に変換するときに決めなくてはならない最初の、最も重要な設定は、ページサイズです。デフォルトでは calibreは "U.S. Letter" のページサイズを使用します。変換ダイアログの :guilabel:`PDF 出力` のセクションで、これを別の標準ページサイズにしたり、または完全にカスタムなサイズに変更したりすることが可能です。特定のデバイス用に PDF を生成しようとしている場合には、その代わりに :guilabel:`出力プロファイル` に設定したページサイズを使用するオプションを有効にしてもかまいません。つまり出力プロファイルが Kindle に設定されていれば、calibre は小さな Kindle 画面での表示に適したページサイズの PDF を作成します。

en: Headers and Footers
ja: ヘッダとフッタ

en: You can insert arbitrary headers and footers on each page of the PDF by specifying header and footer templates. Templates are just snippets of HTML code that get rendered in the header and footer locations. For example, to display page numbers centered at the bottom of every page, in green, use the following footer template::
ja: ヘッダとフッタのテンプレートを指定することにより、PDF の各ページに任意のヘッダとフッタを挿入できます。テンプレートは、ヘッダとフッタの場所にレンダリングされる HTML コードのスニペットにすぎません。たとえば、すべてのページの下部の中央にあるページ番号を緑色で表示するには、次のフッタテンプレートを使用します::

en: calibre will automatically replace :code:`_PAGENUM_` with the current page number. You can even put different content on even and odd pages, for example the following header template will show the title on odd pages and the author on even pages::
ja: caliberは、:code:`_PAGENUM_` を現在のページ番号に自動的に置き換えます。偶数ページと奇数ページに異なるコンテンツを配置することもできます。たとえば、次のヘッダテンプレートでは、奇数ページにタイトルが表示され、偶数ページに著者名が表示されます::

en: calibre will automatically replace :code:`_TITLE_` and :code:`_AUTHOR_` with the title and author of the document being converted. Setting :code:`justify-content` to :code:`flex-end` will cause the text to be right aligned.
ja: caliberは :code:`_TITLE_` と :code:`_AUTHOR_` を、変換されるドキュメントのタイトルと著者名に自動的に置き換えます。 :code:`justify-content` を :code:`flex-end` に設定すると、テキストは右揃えになります。

en: You can also display text at the left and right edges and change the font size, as demonstrated with this header template::
ja: このヘッダテンプレートで示されているように、左端と右端にテキストを表示したり、フォントサイズを変更したりすることもできます::

en: This will display the title at the left and the author at the right, in a font size smaller than the main text.
ja: こうすると左側にタイトル、右側に著者名が本文よりも小さいフォントサイズで表示されます。

en: You can also use the current section in templates, as shown below::
ja: 以下に示すように、テンプレートで現在のセクションを使用することもできます::

en: :code:`_SECTION_` is replaced by whatever the name of the current section is. These names are taken from the metadata Table of Contents in the document (the PDF Outline). If the document has no table of contents then it will be replaced by empty text. If a single PDF page has multiple sections, the first section on the page will be used. Similarly, there is a variable named :code:`_TOP_LEVEL_SECTION_` that can be used to get the name of the current top-level section.
ja: :code:`_SECTION_` は、現在のセクションの名前に置き換えられます。これらの名前は、ドキュメントの書誌の目次 (PDF アウトライン) から取得されます。ドキュメントに目次がなければ、空のテキストに置き換えられます。 ひとつの PDF ページに複数のセクションがある場合、ページの最初のセクションが使用されます。同様に、現在の最上位セクションの名前を取得するには :code:`_TOP_LEVEL_SECTION_` という名前の変数を使用します。

en: You can even use JavaScript inside the header and footer templates, for example, the following template will cause page numbers to start at 4 instead of 1::
ja: ヘッダテンプレートとフッタテンプレート内では、JavaScript を使用することさえ可能です。たとえば、次のテンプレートを使用すると、ページ番号が 1 ではなく 4 から始まります::

en: In addition there are some more variables you can use in the headers and footers, documented below:
ja: さらにヘッダとフッタで利用可能な変数がいくつかあります。次に説明します::

en: ``_TOTAL_PAGES_`` - total number of pages in the PDF file, useful for implementing a progress counter, for example.
ja: ``_TOTAL_PAGES_`` - PDF ファイルの総ページ数。たとえば、進行状況カウンタの実装に役立ちます。

en: ``_TOP_LEVEL_SECTION_PAGES_`` - total number of pages in the current top level section
ja: ``_TOP_LEVEL_SECTION_PAGES_`` - 現在のトップレベルセクションの総ページ数

en: ``_TOP_LEVEL_SECTION_PAGENUM_`` - the page number of the current page within the current top level section
ja: ``_TOP_LEVEL_SECTION_PAGENUM_`` - 現在のトップレベルセクション内にある現在のページのページ番号

en: When adding headers and footers make sure you set the page top and bottom margins to large enough values, under the :guilabel:`PDF Output` section of the conversion dialog.
ja: ヘッダとフッタを追加するときは、変換ダイアログの :guilabel:`PDF 出力` セクションで、必ずページの上部と下部の余白を十分な大きさに設定してください。

en: Printable Table of Contents
ja: 印刷可能な目次

en: You can also insert a printable Table of Contents at the end of the PDF that lists the page numbers for every section. This is very useful if you intend to print out the PDF to paper. If you wish to use the PDF on an electronic device, then the PDF Outline provides this functionality and is generated by default.
ja: PDFの最後に、すべてのセクションのページ番号を一覧にした、印刷可能な目次を挿入することもできます。PDFを紙に印刷する場合に、非常に便利です。電子デバイスでPDFを使用する場合は、PDFアウトラインがこの機能を提供し、デフォルトで生成されます。

en: You can customize the look of the generated Table of contents by using the Extra CSS conversion setting under the Look & feel part of the conversion dialog. The default CSS used is listed below, simply copy it and make whatever changes you like.
ja: 変換ダイアログの外観セクションにある 追加 CSS 変換設定を使用して、生成される目次の見た目をカスタマイズできます。デフォルトの CSS を次に示すので、これをコピーして必要な変更を加えてください。

en: Custom page margins for individual HTML files
ja: HTML ファイルごとのカスタムページ余白

en: If you are converting an EPUB or AZW3 file with multiple individual HTML files inside it and you want to change the page margins for a particular HTML file you can add the following style block to the HTML file using the calibre E-book editor:
ja: 複数の HTML ファイルを含む EPUB または AZW3 ファイルを変換していて、特定の HTML ファイルのページ余白を変更したい場合には、calibre の電子書籍エディタを使用して HTML ファイルに次のスタイルブロックを追加できます:

en: Then, in the PDF output section of the conversion dialog, turn on the option to :guilabel:`Use page margins from the document being converted`. Now all pages generated from this HTML file will have ``10pt`` margins.
ja: 次に、変換ダイアログの PDF 出力セクションで、:guilabel:`変換するドキュメントのページマージンを使用` オプションを有効にします。ここうすると、この HTML ファイルから生成されたすべてのページに ``10pt`` の余白ができます。
