PDFにしおりを追加するソフト

はじめに

　これはPDFファイルにしおりを追加するプログラムです。しおりの内容は テキストファイルで指定します。会話的にしおりは指定できません。雑誌を自 炊してできたPDFファイルに目次をしおりとして追加する事により、単体でも そこそこ読めるものになると思います。雑誌は、普通の本が頭から順番に読ま れるのに対して、あの連載記事のところが読みたいと言う感じの読まれ方をさ れがちなので、ぱっとそこに行けると便利です。

ダウンロードとインストール

　次のリンクをクリックしてダウンロードしてください。解凍するといく つかのファイルが出てきますが、ソフトの本体である「PDFabmk.jar」だけが 実行に必要で、残りは説明やソースコードです。しおりの指定ファイルを自分 で作成する必要があります。解凍すると出てくる「しおり.txt」の内容を参考 に作成してください。

　不要になった場合は、解凍して出てきたファイルを削除すれば終わりで す。レジストリなどは使用していません。

使用の際に必要な環境

　Javaで作られていますので、「PDFabmk.jar」と言うファイルをダブルク リックすると起動します。ただパソコンにJRE (Java Runtime Environment)が インストールされている必要があります。多分、ここからダウ ンロードしてインストールできると思います。約100MBぐらいになりますので、 ネットワーク接続環境によっては大変かもしれません。

使用方法

　起動すると次のようなWindowが出てきます。

　一番簡単な使い方は、PDFファイルのアイコンをドラッグして「元PDFファ イル」の横の空欄の上でドロップ、しおりの設定の入ったファイルをその下の 空欄にドラッグ＆ドロップ、保存先ファイルを指定してから「しおり追加」ボ タンをクリックする方法です。保存先のPDFファイルも空欄にドラッグ＆ドロッ プで指定可能ですが、その場合は保存先ファイルの以前の内容は失われる事に なります。

　画面でできる設定は一つだけです。「起動時にしおりを表示させる」を 設定すると、できたPDFファイルを開いた時に最初からしおりが表示されるよ うになります。あまりしおりは使わないだろうと言う場合は設定しない方が良 いでしょう。

しおり設定ファイルの内容

　次のような内容の「しおり.txt」ファイルが添付されています。 まさにこの通りなのですが。。。

#
#    しおりデータのサンプル　　by K.Miki  2011/01/28
#
# 何か適当な記号で始めるとその行はコメントになる。空行は無視される。
#

#
#  PDFファイルのプロパティの設定
#　　　　　指定しなければ元のPDFのものが設定される
#

#　tで始まると、空白の後の残りが「タイトル」になる
t しおりデータのサンプル

#　sで始まると、空白の後の残りが「サブタイトル」になる
s てすとてすと

#　aで始まると、空白の後の残りが「作成者」になる
a おらがつくった

#　kで始まると、空白の後の残りが「キーワード」になる
k iText, しおり

#　cで始まると、空白の後の残りが「作成アプリケーション」になる
c PDFabmk ver.1.01

#  oで始まる行があると「起動時にしおりを表示させる」設定になる。
#　　　この設定はコマンドラインで実行時のみ有効になる。
o

#
#　しおりのデータ
#　　　ページ番号　スペースいくつか　しおりの見出し
#　　　スペースの数が多いほど小見出しになる
#　　　Tabもスペースとして数えるので最初の空きに使うとページ番号の桁数が
#　　　　変わっても見易い。行の先頭にはスペースを入れないこと。
#
1	大見出し
3	 中見出しの一 ... $
5	 中見出しの二 ... $
7	  小見出しの一 ... $=100
9	  小見出しの二 ... $
11	 中見出し三 $$

　この設定ファイルでは、次のようなしおりが追加されます。

　注意点は次のようなものがあります。

• しおりの設定ファイルは、内容がテキストファイルであれば、拡張子は何 でも構いません。テキストファイルで無いファイルを与えた場合は、多分動か ないでしょう。
• 「#」で始まるコメント行や空行は全て削除していただいても動作に変わ りはありません。コメント行の先頭は「//」でも「;」でもO.K.です。数字と 「tsakco」以外はなんでもありです。
• 「tsakco」で始まる行の設定は省略可能です。その場合は元のpdfファイ ルの設定を引き継ぎます。先頭に「tsakco」の一文字だけの行があるとそこで 処理が終わってしまうと言うバグがありました。ご指摘いただいた川口俊雄さ んに感謝いたします。ver.1.02で修正しました。
• ページ番号はPDFファイルをAcrobat Readerで表示した際にメニューバー のすぐ下に「3/27」と言うような感じで表示される番号の事です。表示されて いる本のページではありません。
• ページ番号の後は最低一つの空白またはTabが必要です。その後に空白か Tabをレベルに応じた数だけ入れます。(低いレベルほど多く入れる)Excelで元 のデータを作成し、「メモ帳」に貼り付けてもできます。
• 中間のレベルを飛ばした低レベルの指定をするとエラーになります。
• 数字や空白は全角文字には、今のところ対応していませんのでご注意くだ さい。全角数字ならば多分無視されます。
• ver.1.01よりしおりの内容に「$」を入れると、この記号がページ番号に 置き換わって出るようになりました。置き換わって欲しくない場合は、「$$」 にすれば、一つだけ「$」が出ます。さらに「$=数値」を入れるとその数値か ら数えるようになります。一つのものを複数のPDFファイルに分けた際に使え るのではないかと思います。

コマンドラインによる使用方法

　わざわざバッチファイルを作成する人は居ないと思いますが、コマンド ラインで使用することも可能です。

   C:\>PDFabmk.jar 元ファイル名 しおり設定ファイル名 先ファイル名

ソースコードについて

　PDFabmkの肝心な部分は全てiTextライブラリによっています。このライブラリは無料 版と有料版があり、無料版には「GNU Affero General Public License ver.3」 と言うしばりがあります。ソースを付けて、他の人が改変しても怒らなければ 良いのだろう、と適当に解釈しています。という事で、上の方にありましたダ ウンロードにはソースファイルなどが入っています。

• PDFabmk.jar : これがプログラムの本体です。99%はiTextのライブラリ (iText-5.0.5.jar)です。
• しおり.txt : しおり設定ファイルのサンプルです。
• PDFabmk.java : 私が書いたソースコードです。実はJavaでまとも？なプ ログラムを書いたのはこれが2つ目です。(1つ目はPDF2on1) 1つ目は開発環境のインストールから完成 まで1週間かかりましたが、こちらは大半を流用したので2日ほどでできました。 元が悪いのでこれも、悪い見本や、お笑いのネタにしてください。GPLはヘボ プログラマを笑いものにするためのライセンスかもしれません。
• Manifest.txt : Javaのコンパイルした結果やライブラリをjar形式でまと めた際に、エントリーポイントとなるクラスやライブラリの指定をするための ファイルです。
• m.bat : jar形式でまとめるためのバッチファイルです。