設定ファイルでんでんコンバーターが利用する設定ファイルの使い方について解説します。いう設定ファイルをアップロードすると、変換の度に本の情報を入力する手間を省くことができるばかりか、詳細な書誌情報を入力することができるようになります。設定ファイルの例を以下に示します。YAMLで記述されたDDconvの設定ファイルです。「#」以降のテキストは無視されます。この行は編集しないでください。具体的な識別子を指定します。「uuid」または「isbn」を指定します。タイトルを指定します。著者などの名前を指定します。YYYYMMDDの形式で指定します。設定ファイルを使った利用手順は次のとおりです。作品のディレクトリにコピーします。メモ帳等のテキストエディタで開き、作品の内容にあわせて編集してください。エンコーディングはUTF-8にします。選択してアップロードしてください。タイトルの入力欄に適当な文字(「あ」でも「a」でも構いません)を入力して、変換ボタンを押します(この時タイトルに入力した文字は、タイトルには使われません)。設定ファイルではインデント(字下げ)の数が重要な意味を持ちます。インデントを変更すると正しく解釈されませんので注意してください。設定ファイルをアップロードした場合、トップページで入力した「タイトル」や「作成者」、「オプション」等の項目は、内容に関わらず全て無視されます。タイトルの入力欄だけは必須入力チェックが行われているため、適当な文字を入れてチェックを回避してください。設定ファイルのバージョン情報を記述します。この情報は必ず入れるようにしてください。identifiers任意EPUBファイルには、その出版物だけが持つ固有の識別子が必要です。いう識別子を自動生成して付与していますが、本来ならば、同じ作品は、大きな改変が行われない限り同じ識別子を使い続けるのが望ましいです。設定ファイルで識別子を指定すると、でんでんコンバーターはその値を識別子として使用します。次の例では特定のUUIDを識別子に指定しています。uuid次の例では特定のISBNを識別子に指定しています。isbn次の例ではUUDIとISBNの両方を識別子に指定しています。通常は一番上に書いた識別子が利用されます。いずれかを指定してください。本のタイトルを指定します。複数のタイトルを指定したり、種別を指定することもできますが、ほとんどのEPUBの閲覧ソフト(リーディングシステム)は複雑な書誌情報を表示することができないので、現時点ではあまり効果は期待できません。シンプルに書くのがよいでしょう。シンプルにタイトルのみを指定した例です。参考までに、より複雑な指定方法を紹介します。3の仕様に準拠した形で上から順に指定されます。優先度を無視して最後のタイトルを本棚に表示します。マルチベンダー対応を目指すならば、利用するのは現実的ではありません。タイトルとサブタイトルを区別した例です。subtitleタイトルにシリーズ名と版数を加えた例です。本の作成者を指定します。複数の作成者を指定したり、役割を指定することもできますが、タイトル同様ほとんどのEPUBの閲覧ソフト(リーディングシステム)は複雑な書誌情報を表示することができないので、現時点ではあまり効果は期待できません。シンプルに書くのがよいでしょう。シンプルに作成者の名前を指定した例です。作成者の役割はroleで指定することができます。複数の作成者と役割を指定した例です。trl次に示すのはroleに指定する値の一例です。作成者ほど重要ではないが、作品に何らかの形で貢献した人や団体の名前は、貢献者contributorsとして記述しておくことができます。書き方は作成者と同じです。シンプルに貢献者の名前を指定した例です。複数の貢献者と役割を指定した例です。本が使用する言語を指定します。languageの指定がない場合には、日本語を意味する「ja」が指定されたと見做されます。ja英語ならば「en」、フランス語なら「fr」を指定します。出版年月日を明示するには、半角数字で西暦4桁月2桁日2桁の計8桁の数字を書きます。次の例は出版年月日が2013年2月14日であることを表しています。本のページ送り方向はpageDirectionで指定します。「ltr」を指定すると左から右、「rtl」を指定すると右から左になります。pageDirectionを省略すると、ページ送り方向は閲覧ソフト(リーディングシステム)に委ねることになります。何らかの値を指定しておいたほうが無難です。次の例はページ送り方向に右から左を指定しています。optionsでんでんコンバーターの細かな挙動を指定するためのオプションです。表紙ページをスキップするNameskipCoverValue<boolean>Initialtrue通常の読み順から表紙ページを除外します。有効にする場合は「true」、無効にする場合は「false」を指定します。初期値は「true」となっており、指定がない場合には有効と見做されます。KindleではEPUB内部の表紙画像とは別に、独自に表紙を表示する機能があります。そのためこの指定を有効にして表紙の重複を回避することを推奨します。表紙のスキップを有効にした場合でも、ランドマークナビゲーションをサポートするリーディングシステムではナビゲーションを通じて表紙ページにアクセスすることができます。titlepageに「true」、しない場合には「false」を指定します。初期値は「false」となっており、指定がない場合には無効と見做されます。tocInSpineに「true」、しない場合には「false」を指定します。初期値は「false」となっており、指定がない場合には無効と見做されます。表示する目次の階層指定NametocDisplayDepthValue<integer>Initial6目次ページに表示する目次の階層を1〜6の範囲の数値によって指定します。「1」なら第1階層の目次のみ、「6」なら第1〜第6階層までの全ての目次を表示します。アップロードしたテキストが持つ目次階層よりも大きな値を指定しても問題ありません。初期値は「6」となっており、指定がない場合にはすべての階層の目次が表示されます。これによって表示されなくなった階層の項目は、視覚的に隠されているだけなのでリーディングシステムの目次機能からは利用することができます。「true」でない場合には意味がありません。非表示にした階層が目次機能からも利用できなくなるバグがあります。目次ページでのランドマークナビゲーションの表示NamedisplayLandmarksNavValue<boolean>Initialfalseでんでんコンバーターでは読者を表紙、とびら、目次などのページへ案内するナビゲーションを自動的に生成します。「true」、しない場合には「false」を指定します。初期値は「false」となっており、指定がない場合には無効と見做されます。「true」でない場合には意味がありません。「true」、しない場合には「false」を指定します。初期値は「false」となっており、指定がない場合には無効と見做されます。「true」でない場合には意味がありません。「true」、しない場合には「false」を指定します。初期値は「false」となっており、指定がない場合には無効と見做されます。「true」でない場合には意味がありません。縦書きにおける縦中横の自動指定NameautoTcyValue<boolean>InitialpageDirectionがltrならfalse、rtlならtrue縦書きにおいて連続する半角数字を自動的に縦中横にします。有効にする場合は「true」、しない場合には「false」を指定します。初期値はpageDirectionによって異なります。横書きでは無効、縦書きでは有効です。「!!」「!?」「??」など2桁の半角感嘆符や疑問符も縦中横にします。処理する桁数はtcyDigitで指定されており、デフォルトで2桁となっています。縦書きにおける自動縦中横の桁数NametcyDigitValue<integer>Initial2autoTcyが処理の対象にする半角数字の桁数を2以上の数値で指定します。指定しなかった場合の初期値は2です。縦書きにおける文字の向き自動指定NameautoTextOrientationValue<boolean>Initialtrue縦書きにおける特定の文字の向き(正立/横倒し)を自動処理によって明示的に指定します。この処理を有効にする場合には「true」、しない場合には「false」を指定します。初期値は「true」となっており、指定がない場合には有効になります。準じたものとなります。対象文字はひとつずつ<span>タグで囲まれ、正立する文字にはupright、横倒しになる文字にはsidewaysのクラス名が付与されます。いずれかのクラス名が付与されている文字は、自動処理の対象から除外されます。Inkデバイス向けに拡張子を「.kepub.epub」にするにはkepubに「true」、しない場合には「false」を指定します。初期値は「false」となっており、指定がない場合には無効と見做されます。EPUBの中に埋め込みます。これによって、画像を利用することなく様々なアイコンを表示することができます。使い方はこちらを参照してください。埋め込まれるフォーマットはWOFFのみです。有効にする場合には「true」、しない場合には「false」を指定します。初期値は「false」となっており、指定がない場合には無効になります。埋め込みフォントやCSS擬似要素に対応していないリーディングシステムでは正しく表示されないリスクがあります。Kindleは文字化けします。Readerではアイコンが表示されません。iBooksなどWebKit系は大丈夫です。自己責任で利用してください。文を句点ごとにspanで囲むNameautoSentenceWrapValue<boolean>Initialfalseテキストを句点「。」毎にspanタグで囲みます。音声をテキストに同期させるEPUBを作る際、日本語や中国語の文章は文を一つずつ読み上げさせる指定が困難です。このオプションを有効にすると、テキストが句点ごとにspanタグで囲まれるので、文を単位とした読み上げ単位の指定が用意になります。このオプションが追加したspanタグはmoというクラス名を持ちます。falseを指定した場合<p>これは文です。