ファイル整理で手戻りしない!EPUBの挿絵、Markdown記法で挿絵を入れる

原稿と挿絵を移動しても相対パスを保つアイキャッチ

挿絵は、原稿の中に「この位置にこの画像」と書く形で入れます。画像ファイルそのものは原稿とは別に置き、原稿からは置き場所を書いて指します。だから挿絵づくりで最初に決めるべきは、絵の内容ではなく画像フォルダの場所です。

この記事では、画像をどこに置き、原稿からどう指すか、後で整理し直しても壊れない置き方はどれかを扱います。画像が出ないときの調べ方や、記法の書き方そのものは別の記事に譲ります。

原稿と画像は別のファイル

電子書籍の中では、本文と画像は別のファイルとして入っています。本文の側に「ここに画像」と書いてあり、その画像がどこにあるかを示す道順が書き添えてあります。

道順の書き方は2通りあります。

rune Studioが扱うのは、原稿から見た道順です。../ を使って一つ上の階層へ戻る書き方にも対応します。

よくある置き方と、そのつまずき

いちばん多いのは、原稿と同じフォルダに画像を放り込む方法です。道順が短く済み、書き間違いも起きません。

もう一つは、画像だけをまとめたフォルダを作る方法です。数が増えても探しやすく、後から差し替えるのも楽です。

どちらも間違いではありません。問題が起きるのは、途中でどちらかからどちらかへ移すときです。

CLIのfile moveでは、原稿の道順を別に書き換える

ここから扱うのは、今回操作を完了できた開発版CLIの経路です。CLIの file move で画像を移したとき、原稿に書いた道順は自動では変わりませんでした。Mac版アプリやFinderで移動した場合の挙動は、この記事では断定しません。

実際に開発版を命令から動かして確かめました。原稿に次の記法を書いた状態で、画像を別のフォルダへ移動しました。

![港に並ぶ船](画像/挿絵1.png)

移動そのものは成功しましたが、原稿の中の道順は 画像/挿絵1.png のままでした。

このCLI経路では、原稿が存在しない場所を指したままです。CLIでの移動と原稿内の道順の書き換えは別の操作として扱います。

CLIで挿絵を20枚移し、それらが原稿内の20か所から参照されていれば、その20か所が確認対象になります。1枚ずつ原稿を開いて直すなら、どの原稿がどの画像を指すかを調べる作業も必要です。

挿絵の置き場所は、章より先に決める

CLIでフォルダを途中から整理し直す場合は、画像を移したあとに原稿内の参照を書き換える工程までを一組にします。最初は原稿の隣、後から画像用フォルダや章別フォルダへ、と場所を変えるほど、CLIで移動後に見直す参照は増えます。

決め方は、枚数の閾値ではなく、一覧で探しにくくなったか、同じ画像を複数章で使うか、置き場所を今後変える可能性があるかで選びます。画像用フォルダを1つにまとめれば再利用先を一本化できます。章別フォルダは、章ごとに素材を独立して管理したい本に向きます。

rune Studioは、書き換え対象を先に数える

rune Studioには、画像やリンクの道順を書き換える機能があります。書き換える前に、どの原稿の何か所が対象になるかを返します。

先ほどの状態で確かめました。移動前の場所と移動後の場所を指定して下見をかけたところ、対象は1ファイル・1か所と返りました。実行すると、原稿の中の 画像/挿絵1.png が 素材/挿絵1.png に書き換わりました。

先に件数が分かるので、思っていた数と違えば実行前に気づけます。 20枚あるはずなのに5か所しか返らないなら、残り15枚は別の書き方になっている、ということです。

画像を消す前に、使われているか分かる

ある画像が何か所から指されているかを数えることもできます。実際に調べたところ、1ファイル・1か所という結果が返りました。使っている画像をうっかり消す前に、使用の有無が分かります。

対象になるのは原稿ファイルだけ

この書き換えが対象にするのは、テキスト形式の原稿ファイル(txt・text・md・markdown)の中に書かれた画像とリンクの記法です。すべての形式のすべての記法を直すわけではありません。外部のURLは書き換えません。

向く人と、別の方法が向く人

向いているのは、画像を一覧で探しにくい本や、同じ画像を複数章で使う本を作る人です。 絵の多い実用書など、置き場所を整理し直す可能性がある場合にも役立ちます。

挿絵が数枚で、置き場所を最後まで動かさないなら、気にしなくて構いません。 原稿と同じフォルダに置いて終わりにするのがいちばん簡単です。

なお、今回のCLI検証では、画像の移動後に refs plan で対象を下見し、refs rewrite で明示的に書き換えました。ここで説明した結果は、このCLI経路に限ります。

まとめ

次の一歩として、いまの原稿で挿絵の道順の書き方が全部そろっているかを見てください。そろっていないなら、まとめて書き換えるより先に、置き場所を一か所に決めるほうが早く終わります。

Rune Studioの製品ページを見る