2018-09-11

同人小説を初めてEPUBにした時の覚書

EPUB Doujin

この記事は、自分の試行錯誤の垂れ流しなので、いつも以上に突っ込み歓迎です

過去発行していた同人小説のEPUB版を作ることにしました

EPUBを選んだ理由は縦書きにしたい、固定レイアウトにする必要はない内容なのでリフロー版にしたいだったので、EPUBでも3.0.1か3.1が対象になります

その上で、今回参照した本がEPUB3を対象としており、これに従ってEPUBを作ったらValidatorからEPUB3.0.1と認定されたので下記は3.0.1 (としてValidatorを通過できるファイル) を作る作業記録になります

仕様 (邦訳) とか参考文献とか資料とかツールとか

サンプルEPUBを作ってみる

EPUBファイルは特定のディレクトリィ構造、ファイルを持つZIPファイルです

今回作るSample EPUBの構成は以下の通りです (下記の Content、SampleEpub、Navigation は任意の名称)

mimetype
META-INF/container.xml
Content/SampleEpub.opf
Content/SampleEpub.xhtml
Content/Navigation.xhtml

ファイル名、フォルダ名

EPUBの内容となるファイルのファイル名、フォルダ名は基本的に任意ですが、複数OS間での互換性の為や、予約されているファイル名などもありますので、以下を参照してください

雑に言えばファイル名は大文字小文字を区別した上でUTF-8で表現可能かつ記号は避け、またMETA-INFフォルダ配下には所定のファイル (今回の例示では container.xml) のみみしておけば大丈夫っぽいです

mimetype

4.3 OCF ZIP Container Media Type Identification - EPUB Open Container Format (OCF) 3.1

mimetypeファイルは application/epub+zip のみを内容物として持つファイルで文字コードはUS-ASCIIです

META-INF/container.xml

META-INF/container.xml は以下の通りです

フォルダ名の META-INF ファイル名の container.xml 共に名称は固定です

<?xml version='1.0' encoding='utf-8'?>
<container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
  <rootfiles>
    <rootfile full-path="Content/SampleEpub.opf" media-type="application/oebps-package+xml" />
  </rootfiles>
</container>

rootfile 要素の full-path 属性の値は、実際のopfファイルの相対パスになり、それ以外の内容は固定になります

Content/SampleEpub.opf

Content/SampleEpub.opf (フォルダ名、ファイル名は container.xml で指定した任意の物) は以下の通りです

フォルダ名の Content ファイル名の SampleEpub は任意の名称になりますが、拡張子の '.opf' は多分固定です (あるいは変えない方が無難です)

<?xml version='1.0' encoding='utf-8'?>
<package unique-identifier="BookId" version="3.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns="http://www.idpf.org/2007/opf">
  <metadata>
    <dc:title>Sample Epub</dc:title>
    <dc:language>ja</dc:language>
    <dc:identifier id="BookId">tag:example.com,2018-09-11:BookId/Sample Epub</dc:identifier>
    <meta property="dcterms:modified">2018-09-11T00:00:00Z</meta>
  </metadata>
  <manifest>
    <item id="Navigation" href="Navigation.xhtml" media-type="application/xhtml+xml" properties="nav" />
    <item id="SampleEpub" href="SampleEpub.xhtml" media-type="application/xhtml+xml" />
  </manifest>
  <spine>
    <itemref idref="Navigation" />
    <itemref idref="SampleEpub" />
  </spine>
</package>

opfファイルはXMLファイルで、document要素は package 要素となります

package 要素の unique-identifier 属性の値は任意のIDとなる値です

package 要素の子要素は metadata、manifest、spine の3要素となり、それぞれについて説明します

`metadata` 要素

metadata 要素は要素名の通りEPUBファイルのメタデータ (書誌情報) を格納する要素です

dc名前空間の子要素として最低限 title、language、identifier を記述します

title 要素は文字通りの本のタイトルを記述し、language 要素はIETF言語タグ (RFC 4646 および RFC 4647) で日本語の場合は ja または　ja-JP を記述します

identifier要素は id 属性に document 要素の package 要素の unique-identifier 属性の値と同一の値を設定し、子要素としてIDREF (XML)のTextNodeを記述します

この identifier 要素の内容となる IDREF は、 property 属性に dcterms:modified を持つ meta 要素の日付と合わせて同一の書籍の同一性と異なる版の判別に使われます

Sample EpubのIDについて

例では RFC 4151のThe 'tag' URI Scheme をIDとして使っています

Examples of tag URIs are:
     tag:timothy@hpl.hp.com,2001:web/externalHome
     tag:sandro@w3.org,2004-05:Sandro
     tag:my-ids.com,2001-09-15:TimKindberg:presentations:UBath2004-05-19
     tag:blogger.com,1999:blog-555
     tag:yaml.org,2002:int

2.1. Tag Syntax and Examples - The 'tag' URI Scheme

`manifest` 要素

manifest 要素には子要素として順不同でEPUB内に格納しているコンテンツを item 要素として記載します

XHTML内から参照される画像や直接コンテンツとはならないstyle sheetなどもEPUBを構成するファイルは item 要素となります

`item` 要素

item 要素には id 属性、href 属性、media-type 属性を記載します

id属性は任意のid、href属性にはopfファイルから見た相対パス、media-typeにはMINEの値を記載します

なお参照するファイルがXHTMLの場合、拡張子は.xhtml、MIMEはapplication/xhtml+xmlとします

また、カバー絵となる画像を参照する item 要素には properties 属性でcover-image を設定し、目次となるXHTMLを参照する itme要素には同じくproperties 属性で nav" を記述します

`spine` 要素

spine 要素には子要素としてEPUBの内容を昇順で itemref 要素として記述します

`itemref` 要素

itemref要素にはidref属性で各リソースのIDを記述します

このidは manifest 要素の子要素の item 要素の id 属性の値になります

目次を記述する

XHTMLで目次を記述します

<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE html>
<html xml:lang="ja" lang="ja" xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops">
  <head>
    <meta charset="utf-8" />
    <title>Sample Epub</title>
  </head>
  <body>
    <nav epub:type="toc">
      <h1>Sample Epub - 目次</h1>
      <ol>
        <li><a href="Sample Epub.xhtml">Sample Epub</a></li>
      </ol>
    </nav>
  </body>
</html>

EPUBの目次は opf ファイルの item 要素には properties 属性で properties 属性で nav" を記述した上で、XHTML文書内ではnav要素を使ってマークアップし、更に nav 要素には http://www.idpf.org/2007/ops 名前空間の type 属性として toc を記述します

ZIP化してみる

Windows上でEPUBファイルとなるZIPファイルを作ろうとしたがどうしてもうまくいかなかったので、今回は EPUB で電子書籍を作成するのEPUB ファイルを ZIP アーカイブとしてバンドルするを参考にbashでコマンドを叩くことにしました

以下、bashでZIPファイルを作ったときの作業

身近なbashがWindows 10上のWindows Subsystem for LinuxのUbuntu 18.04のbashだったのでそれを起動
WSLにZIPがインストールされていなかったので $ sudo apt install zip unzip でZIPをインストール
Windows上のドライブはrootの mnt ディレクトリィにマウントされているので $ cd /mnt/c/users/(以下略) でEpupファイルを作りたいディレクトリィに移動
最初に mimetype ファイルを非圧縮でzipに追加するために $ zip -0Xq SampleEpub.epub mimetype を実行
続いてmimetype以外のファイルをZIPに追加するために$ zip -Xr9Dq SampleEpub.epub *

EPUBファイルの名称

互換性の問題でEPUBの拡張子はすべて小文字で .epub とするのが良いそうです

チェッカーで確認してみる

EPUB Validator (beta) を使ってチェックしてみます

ここでエラーやワーニングが出たらGoogle翻訳先生に聞きながら直します

色々弄ったら、3.0.1 のファイルとして合格しました

右綴じ、縦書きのEPUBファイルにする

右綴じのEPUBの場合、opfファイルのspine要素に page-progression-direction 属性として rtl を記述します

縦書きの場合、各XHTMLファイルにCSSで writing-mode: vertical-rl; を適用することで縦書きになります

なお、筆者が不勉強のため各ビュワーの対応状況などについて把握していないのですが、-webkit- プレフィックス、-epub- プレフィックスを付けた writing-mode プロパティも併せて記述した方が良いようです (-webkit- の方は問題がないことを確認したら外したい)

writing-mode: vertical-rl;
-webkit-writing-mode: vertical-rl;
-epub-writing-mode: vertical-rl;

現時点ではざっくりこんな感じで

2018-09-01

2018年の抱負の進捗状況 (9月1日時点)

Life

この記事は自分向けの記事です

もうちょっと頻繁にblogを更新する

Twitterでつぶやいてそれきり、と言う話をもう少しblogに書くかな、と思っています

今のところは未だ思っているだけです

体重を60kgまで落とす、改め体重60kg前後を維持する

8月4日から8月6日の体重がそれぞれ59.90kg、59.35kg、59.95kgとなり、目標を達成しました

今は59kgから61kgの間で揺れている感じでこのままこの体重を定着させたいと思っています

もともと運動不足ではあるので、NHKのみんなで筋肉体操を録画して観ています

観ているだけです

HTML5.2の仕様書を一通り読む、改め HTML LS Developer's Editionを読む

3月ごろに一度中断したHTML5.2の仕様を読む企画ですが、どうしてもやる気が戻らず、やる気の問題で再開が困難なため、HTML5.2を読むのを辞めて改めて HTML: The Living Standard Developer's Edition を読み始めることにして準備中です

Developer's EditionはWEB開発者向けの仕様でブラウザなどUser Agent開発者向けの実装方法の情報などは省かれた版になります

自分としてはこのDeveloper's Editionの部分が大事で、HTML5.2のブラウザの実装の記述は面白く読める部分もあるのですが、本当に全く理解できない部分も多く精神的に苦痛なのでWHATWGのHTML LSのDeveloper's Editionに乗り換えます

もし、HTML5.2にもDeveloper's Editionがあればそちらを読んだと思うのですが、今回はこの違いは気にしないことにします

応用情報技術者試験に合格する、改め情報処理安全確保支援士を受験する

とりあえず情報処理安全確保支援士試験に申し込みました

肝心の勉強のですが、8月上旬はOctopath Travelerをずっとやっていて、今は7 Billion HumansをSTEAMで購入してやっています

さてはお前合格する気ないな

2018-08-28

HTML4.01文書 (XHTML1.x文書) を最新のHTML5 (HTML LS) 文書に換えるべきか

HTML

私の結論

建前としては、すべてのHTML文書は最新の仕様に準拠すべきと思いますが、HTML4.01/XHTML1.x (以下、「HTML4.01」のみの表記とする) をHTML5/HTML LS (以下、「HTML5」のみの表記とする) へは自動変換出来ないため人間が内容を理解して適切なマークアップに変換する必要があります

つまり、HTML4.01からXHTML1.0の時のような自動変換が可能だった時と違い、HTML5への変換はかなりの労力が必要になる行為になりますので、そのHTML4.01文書はHTML5に換える価値があるのかを個別に判断する必要が生じます

よって、本音としては、単に人間が読めればよいならHTML4.01文書のままでもよいと思います

ただし、HTML5の文字コードが実質utf-8のみになったことにより今後utf-8決め打ちでHTMLを解析するツールなどが増えると思いますし、HTML4.01をサポートしないUAの存在を想定した場合、マークアップはHTML4.01のままでも文字コードはutf-8にした方が良いと考えます

以下は蛇足です

HTML4.01文書はHTML5文書へは自動変換することができないということ

もし既存のHTML4.01文書をHTML5文書にツールなどで自動変換できるなら、HTML4.01文書をHTML5文書に換えるべきかなどと考える必要はなくサーバーやブラウザにでも任せればよい話でです

しかし、以下のHTMLの断片を考えてみます

<div class='section'>
  <h1>A</h1>
  <p>B</p>
  <div class='section'>
    <h2>C</h2>
    <p>D</p>
  </div>
</div>

<div class='section'> とあるので、HTML5のsection要素の様な気がしますが、内容を読んでみないとsection要素なのか、それともarticle要素やaside要素、header要素、footer要素なのか判断できません

他にもHTML4.01からHTML5になるにあたり同名要素だが要素の意味が変わっているものがあり、そのままの要素名でよいか別な要素としてマークアップすべきかは人間が個別に判断せざるをえない場合が多々あります

人間が読めればよいならそのままでも困らない

恐らく各browserは当面HTML4.01のサポートを辞めないと思いますし、辞めたとしてもHTML4.01文書として適切にマークアップされていればHTML5として処理されても人間が読む分には困らないと思われます

ただ、次善の状況としてHTML4.01文書がHTML5文書として処理されることを期待するならマークアップはHTML4.01文書のままでも文字コードだけはutf-8に変更した方が良いと考えます

不特定多数にWeb scraping対象として提供している場合、書き換えるべき

既存のHTML4.01文書が今後とも不特定多数にWeb scraping対象として解析されること期待するなら、内容を更新する予定がなくてもHTML5文書へ換えた方が良いでしょう

ただし、HTML4.01文書をWeb scraping対象としている利用者が具体的に想定できる場合、HTML4.01文書とHTML5文書を共存させる移行期間などが必要になるかもしれません

Web scrapingの対象という意味ではSEOも話に範疇に入りますが、特定の検索エンジンへの対応についてはその検索エンジンの運営者に聞いてください

2018-08-06

減量して分かったいくつかの事

Life

元日時点で74.30kgだったのですが、今年の目標として体重60kg (BMI 22.0) を目指して減量したところ8月4日から8月6日の3日間連続で60.0kg未満の体重になり、めでたく目標達成となりました

覚書として今回得られた知見をまとめておきます

一般的に言えること (将来の自分の体でも言えること)

個人差が大きい
標準体型の人向けの話と肥満体系の人向けの話を分ける
「バランスの良い食事」は健康的な人向けの話
毎日の体重、体脂肪率を食事や排便、運動と共に記録をつけて自分の体の動きを分析すべき
最初は「食べなければ太らない」レベルのところから
説明と検証ができないことは全部オカルト

私の体でやったこと

1日1食、カロリイ摂取は4時間以内に納める
基本的に食事の時間以外カロリイを摂らない
食事を「カロリイを摂取する行為」と考える
コーヒーやジュースを飲むのも食事
空腹感ではカロリイを摂取しない
完全にばててしまった時だけ、カフェオレの缶コーヒー程度のカロリイ (100kcal未満) を摂取する
食事では最初に食物繊維 (サラダ) を食べる
次に脂身の少ない赤身の肉や豆腐などを食べる
最後に満腹感が不十分なら炭水化物をデザートとして食べる
食べすぎたら翌日は少なめにするか抜く

今の私の体に言えること

空腹でもやる気は出る
1日1食でも頭は動く
食後、直ぐに寝ても太らない
1日1食で十分調子が良い
カロリイ摂取を全くしない時間が長いと痩せる
食事内容は翌々日の体重に反映される
意識して食物繊維と蛋白質多めの食事にした方が痩せる
1日1食で食物繊維多めの食事にすると便秘になるので対策が必要
満腹感が得られないときは、食後にお茶碗1杯位のお米を食べれば十分
1日1食にして以降、1か月に1度くらい発生していた謎の片頭痛がおこならなくなった (因果関係は不明。オカルト)

2018-08-01

2018年の抱負の進捗状況 (8月1日時点)

Life

この記事は自分向けの記事です

もうちょっと頻繁にblogを更新する

最近HTML5.2関連の記事を書いていないので、この月次報告とその他に記事を思いつきで1本、みたいな状態になっております

HTML5.2を読むのが止まっている方が問題なので、そちらを再開して何とかしたいと思っています

体重を60kgまで落とす

7月1日の朝が61.40kgで8月1日の朝が60.75kgでした

7月中旬は殆ど体重が減らず足踏み状態でしたが、1か月で見れば緩やかですが減少傾向にあり、リバウンドなども起こしていないので今のやり方のまま続ける予定です

ただ、無理な減量をして酷暑にやられては真の目的である健康的になるに対して本末転倒となるので、夏ばてで体調を崩しそうになったら減量を気にせず栄養補給はするつもりです

HTML5.2の仕様書を一通り読む

3月中旬に応用情報技術者試験の勉強の名目で作業を止めてからそのまま止まってしまっています

8月中旬まではコミックマーケットに参加するため忙しいので8月下旬から作業を再開したいところです

あと、なんとなくでは作業が進まなくなってしまっているので、もう少し小分けに目標を立て、期限を作って管理したい所存です

応用情報技術者試験に合格する、改め情報処理安全確保支援士を受験する

情報処理安全確保支援士を受けることに成りました

合格は厳しい見通しですが、知識は役に立つので勉強します

2018-07-10

GPD WIN2のSSD換装でいろいろ失敗したので覚書

Shopping

GPD WIN2を購入したのですが、その時色々失敗したので、失敗の経験の共有として覚書

SSD購入、しかし、精密ドライバがないから蓋が開けられない

先端サイズ+000の精密ドライバーが必要になるがなかった (持っていたはずだが失くしていることに気が付いた)

仕方がないので購入した……のだが、後にダブるのである

SSDを刺し込み損ねてリカバリを開始し、リカバリメディアをフォーマットする

後に気づくのだが、SSDがちゃんと刺さっていない状態で本体付属のリカバリUSBメディアを挿入しリカバリを開始した

SSDが刺さっていないのでリカバリ先のドライブがない

するとリカバリ用のブートプログラムは唯一のドライブであるUSBメモリのリカバリメディアをリカバリ先とみなしてUSBメモリをフォーマットするらしい (というか、フォーマットされた)

結果、当然リカバリには失敗するし、リカバリ用メディアも失う羽目になる

改めてリカバリメディアを作るためにドライバなどをダウンロードする

公式サイトの GPD WIN 2 Pocket WIN XD Laptop Game Console Game box Video Game Player Gamepad からリカバリメディア用のファイルを改めて取得する

これが9.33GBもあり、さらにダウンロード元のMEGAというストレージサービスはアカウント作らないと大きなファイルはダウンロードできない

仕方がないのでアカウント作ったのだが、無料ユーザーだと帯域制限があり、合計9.33GBに及ぶファイルをダウンロードするには金を払うか、5GBダウンロードする毎に数時間のインターバルが必要になる

と言う訳でここで半日程度かかる

無事SSDを換装できたので古いSSDをUSBメモリ化するケースを購入する

Amazon.co.jp： ELUTENG SSD M.2 ケース NGFF USB3.0 変換 5Gbps ps4 外付けhdd M.2 2280 SSD ポータブル UASP高速 B-Key/B+M Key SSD 対応アダプター M.2 外付けケース for 2230 2242 2260 2280 ドライブボックス大容量 2TB: パソコン・周辺機器

このUSBメモリ化するケースに精密ドライバーがついてくる

じゃあ最初に精密ドライバー買わずにこれ買えばよかったじゃん

ギャフン

2018-07-01

2018年の抱負の進捗状況 (7月1日時点)

Life

この記事は自分向けの記事です

もうちょっと頻繁にblogを更新する

個人的にはもう少しかけた方がよいと思っているのですが、今アウトプットよりもインプットの方が楽しくなっており、「これブログのネタになるかな」と思ってもなかなか記事を書かない、更新しないという状態になっています

無理に書こうとして、そもそも何もかも嫌になって投げ出すのが今までの自分のパターンなので、気が向いたらと言う事で

体重を60kgまで落とす

6月1日の朝が64.85kgで7月1日の朝が61.40kgでした

目標は60kgですが、現在体脂肪率が10から9%台となっており、大変ばて易い状態になっています

体重60kgは手段であって真の目的は健康になる事であり、その意味では既に目標を達成している状態なので、様子を見ながら過ごしています

HTML5.2の仕様書を一通り読む

3月中旬にいったん作業を中断してからそのまま止まってしまっています

また、年始の頃の勢いは昨年末からやっていての貯金あっての状態だったので、この後はスローペースで続けることになります

なお、HTML5.3の勧告の方が明らかに先なので、そうなったらHTML5.3へ移ることになる見込みです

……もしかして永久に終わらないのでは

応用情報技術者試験に合格する

受かりました

合格者の平均年齢は29歳前後なので42歳の自分が合格するのは順当なのですが、それはそれとして素直に嬉しいです

応用情報処理技術者試験の合格者は合格から2年の間、高度試験および支援士の試験の午前I免除というのがありますので今年の目標は達成とした上で秋にも何か受けてみよう思います

IPA 独立行政法人情報処理推進機構：情報処理技術者試験：高度試験等の一部（午前Ⅰ試験）免除制度

情報処理技術者試験の高度試験、情報処理安全確保支援士試験の一部免除対象となる条件（いずれか一つでも満たせばOK）

応用情報技術者試験（AP）に合格

情報処理技術者試験の高度試験、情報処理安全確保支援士試験のいずれかに合格

情報処理技術者試験の高度試験、情報処理安全確保支援士試験の午前Ⅰ試験で基準点以上の成績をとる

もうちょっとだけ続くんじゃ

仕様 (邦訳) とか参考文献とか資料とかツールとか

サンプルEPUBを作ってみる

ファイル名、フォルダ名

mimetype

META-INF/container.xml

Content/SampleEpub.opf

metadata 要素

Sample EpubのIDについて

manifest 要素

item 要素

spine 要素

itemref 要素

目次を記述する

ZIP化してみる

EPUBファイルの名称

チェッカーで確認してみる

右綴じ、縦書きのEPUBファイルにする

もうちょっと頻繁にblogを更新する

体重を60kgまで落とす、改め体重60kg前後を維持する

HTML5.2の仕様書を一通り読む、改め HTML LS Developer's Editionを読む

応用情報技術者試験に合格する、改め情報処理安全確保支援士を受験する

私の結論

HTML4.01文書はHTML5文書へは自動変換することができないということ

人間が読めればよいならそのままでも困らない

不特定多数にWeb scraping対象として提供している場合、書き換えるべき

一般的に言えること (将来の自分の体でも言えること)

私の体でやったこと

今の私の体に言えること

もうちょっと頻繁にblogを更新する

体重を60kgまで落とす

HTML5.2の仕様書を一通り読む

応用情報技術者試験に合格する、改め情報処理安全確保支援士を受験する

SSD購入、しかし、精密ドライバがないから蓋が開けられない

SSDを刺し込み損ねてリカバリを開始し、リカバリメディアをフォーマットする

改めてリカバリメディアを作るためにドライバなどをダウンロードする

無事SSDを換装できたので古いSSDをUSBメモリ化するケースを購入する

もうちょっと頻繁にblogを更新する

体重を60kgまで落とす

HTML5.2の仕様書を一通り読む

応用情報技術者試験に合格する

`metadata` 要素

`manifest` 要素

`item` 要素

`spine` 要素

`itemref` 要素