EPUBファイルの中身を確認する

EPUBファイルの実体は、EPUBの仕様に沿って配置されたファイル・フォルダをzipで圧縮したものなので、解凍することによりその中身を確認することができる。

『Pandocを使ってMarkdownからEPUBを作成する』で作成したEPUBファイルの拡張子をzipに変更してzipで解凍すると、以下のようなファイル・フォルダで構成されていることがわかる。

ch001.xhtml
ch002.xhtml
content.opf
mimetype
nav.xhtml
stylesheet.css
title_page.xhtml
toc.ncx
META-INF
├─com.apple.ibooks.display-options.xml
└─container.xml

なお、解凍されたファイル・フォルダを単純に圧縮しなおしてもEPUBファイルとは認識されない点に注意。これは、EPUB内に含まれているファイルであるmimetypeが、zipの先頭エントリに無圧縮で追加されている必要があるため。Windowsの標準機能でこの要件を満たすには、mimetypeのみを右クリックしてzip圧縮し、できたzipファイルに他のファイル・フォルダを追加すればよいらしい。詳細は、下記リンクを参照。

関連リンク

• 電子書籍フォーマットの本命、「EPUB」をいまのうちに理解しておく － Publickey
• 日本語Epubブックサンプル - 横浜工文社
  • EPUBファイルとしてzip圧縮する方法について詳細な説明あり

Pandocを使ってMarkdownからEPUBを作成する

前提

• PandocをWindowsにインストールする
• Adobe Digital Editionsのインストール

手順

Pandocを使ってMarkdownからEPUBを作成する手順は、以下の通り。

任意のディレクトリに、以下のmybook.md（Markdown形式のファイル）を作成する。

% タイトル\
% 作者

---
language: ja-JP
---

# 見出し１

見出し１です。試しに書いてみます。

# 見出し２

見出し２も書いてみます。

1-2行目はtitle blockと呼ばれるPansocの拡張Markdown記法。1行目がタイトル、２行目が著者名として認識される。タイトルブロックは必ずファイルの先頭に記述する必要がある。

4-6行目もPandocの拡張Markdown記法でYAML metadata blockと呼ばれるもの。EPUB生成時に必要となるメタデータを指定することができる。ここでは、EPUBで使用する言語として日本語(ja-JP)を指定している。なお、この指定がないと、Adobe Digital Editionsで日本語が正しく表示されない。

8行目以降は、通常のMarkdown記法で見出しと本文を記述している。

このmybook.mdからPandocを使ってEPUBを生成するには、mybook.mdが含まれているディレクトリで以下のコマンドを実行する。

pandoc mybook.md -o mybook.epub

mybook.mdが入力ファイル、oオプションで指定したmybook.epubが出力ファイルとなる。入出力のフォーマットは拡張子から自動的に判断される（コマンドラインオプションで明示的に指定することも可能）。

生成されたEPUBを、Adobe Digital Editionsで表示した結果は、以下の通り。mybook.mdの内容をもとに、表紙や目次が自動的に生成されていることがわかる。

Adobe Digital Editionsのインストール

WindowsまたはMac OSX上で動作するEPUBリーダーであるAdobe Digital Editionsをインストールする手順は、以下の通り。

Adobe Digital Editions のダウンロードページから、該当OSのインストーラーをダウンロードする。

ダウンロードしたインストーラーはウィザード形式になっている。基本的にデフォルトのままインストールすれば問題はない。

PandocをWindowsにインストールする

Pandocをwin7にインストールする手順は、以下の通り。

まず、Pandoc – Installingからリンクをたどってダウンロードページに移動し、Windows用のインストーラーをダウンロードする。

ダウンロードしたインストーラーはウィザード形式になっているが、インストールのオプションなどは特に用意されていない。ライセンスに同意しInstallボタンをクリックするとインストールが完了する。

なお、Pandocのインストール先ディレクトリは、C:\Users\UserName\AppData\Local\Pandoc（UserNameはインストールを実行したユーザのアカウント名）になる。

WindowsでJenkins 1.540が起動しない

最近PCをWin7にアップデートしたのに合わせ、Jenkinsをインストールしようとしたが、Jenkins起動時にJava VMが強制終了してしまう。どうも、Jenkins 1.540にはWindows上で起動しないという致命的な問題があるようで、JenkinsのJIRAにも既に報告が上がっている。

• [#JENKINS-20630] Jenkins fails to start – Jenkins JIRA

現時点の最新版である 1.541でもこの問題は解消していない。上記JIRAにある川口さんのコメントによると、1.542でこの問題が修正される予定とのこと。

修正版がリリースされるまでは、Windows上でJenkinsを動かす際には、1.539以前のバージョンを使用するか、あるいはLTS版（Long-Term Support Release）の使用を検討したほうがよいかも。

Windows7でコマンドプロンプトを管理者モードで実行する

Win7で、コマンドプロンプトを管理者モードで実行する手順は、以下の通り。

• Winキーを押す
• “cmd”を入力
  • 「プログラムとファイルの検索」に“cmd”と入力される
• Shift + Ctrl + Enter を入力
  • 「ユーザー アカウント制御」のダイアログが表示される
• Alt + y を入力
  • 「ユーザー アカウント制御」のダイアログで、「はい」を選択することに相当

やや手数は多いが、マウスを使わずにコマンドプロンプトを管理者モードで実行できる。

• 関連リンク
  • ワンクリックでコマンド・プロンプトを管理者モードで実行する － ＠IT

GradleからJSmoothを呼び出して実行可能jarをexe化する

GradleからJSmoothを呼び出して実行可能jarをexe化する手順は、以下の通り。

前提

• JSmoothがインストールされている

手順

以下のbuild.gradleを用意する。


６行目に、JSmoothのインストールディレクトリを指定する。JSmoothのAntタスクを呼び出すために、jsmoothという名前のconfigurationを定義し（８行目）、そのconfigurationにJSmoothのantタスクのjarを指定（16行目）する。

jarタスク（19行目）で、依存関係のあるjarをlibフォルダにコピー（20-23行目）した上で、実行可能jarを作成している。実行可能jarの作成については、下記サイトの内容をもとにしている。

• javaのビルドをgradleで行う：実践編6：高速に実用的な実行可能jarを生成する - treeのメモ帳

jsmoothタスク（42行目）で、JSmoothのAntタスクを呼び出し、実行可能jarをexe化している。Antタスク呼び出すjsmoothの設定ファイルは、あらかじめjsmoothを使って保存しておく必要がある。jsmoothの設定については、下記を参照。

• Jarファイルをexeに変換する（JSmoothの使い方）｜普通に仕事しながら趣味でソフト開発する３７歳いろいろメモ

なお、この例で使用したjsmoothの設定ファイルは以下の通り。


jsmoothタスクを実行すると、実行可能jarがexe化される。なお、このexeはlibフォルダとともに配布する必要がある点に注意。

関連リンク

• 2013-03-01 - a-sanの日記
• dev-xconnecting: GradleでカスタムAntタスクを使用する