名 前
djvused − 多 目 的 DjVu 文 書 エ デ ィ タ 。
SYNOPSIS
djvused [options] djvufile
説 明
プ ロ グ ラ ム djvused は マ ル チ ペ ー ジ 文 書 を 作 成 し た り 、 ア ノ テ ー シ ョ ン チ ャ ン ク や テ キ ス ト レ イ ヤ の 編 集 、 サ ム ネ イ ル の 作 成 な ど を 行 う た め の 強 力 な コ マ ン ド ラ イ ン ツ ー ル で す 。 プ ロ グ ラ ム は djvufile に 指 定 さ れ た DjVu 文 書 を 読 み 込 み 、 djvused の 様 々 な コ マ ン ド を 実 行 し ま す 。
djvused の コ マ ン ド は 特 定 の フ ァ イ ル か ら 読 み 込 ん だ り (オ プ シ ョ ン -f が 指 定 さ れ て い る 場 合 )、 コ マ ン ド ラ イ ン か ら 読 み 込 ん だ り (オ プ シ ョ ン -e が 指 定 さ れ て い る 場 合 )、 標 準 入 力 か ら 読 み 込 む (デ フ ォ ル ト )こ と が 可 能 で す 。
オ プ シ ョ ン
|
-v |
djvused は コ マ ン ド を 読 み 込 む 前 に コ マ ン ド ラ イ ン プ ロ ン プ ト を 出 力 し 、 コ マ ン ド の 処 理 状 況 を 示 す メ ッ セ ー ジ を 出 力 し ま す 。 こ の オ プ シ ョ ン は djvused の ス ク リ プ ト を デ バ ッ グ し た り 、 djvused の コ マ ン ド を 標 準 入 力 か ら 入 力 し た り す る の に 非 常 に 便 利 で す 。 |
-f scriptfile
djvused は フ ァ イ ル scriptfile か ら コ マ ン ド を 読 み 込 み ま す 。
-e command
djvused は オ プ シ ョ ン 引 数 commands に 指 定 さ れ た コ マ ン ド を 実 行 し ま す 。 シ ェ ル が 不 必 要 に コ マ ン ド を 展 開 す る の を 防 ぐ た め に コ マ ン ド を シ ン グ ル ク ォ ー テ ー シ ョ ン で 囲 む こ と を お 勧 め し ま す 。
|
-s |
djvused は 指 定 さ れ た コ マ ン ド を 実 行 し た 後 、 フ ァ イ ル djvufile に 保 存 し ま す 。 こ れ は プ ロ グ ラ ム の 終 了 直 前 に save コ マ ン ド を 実 行 す る の と 同 じ で す 。 | ||
|
-n |
djvused は save コ マ ン ド を 無 視 し ま す 。 こ れ は ロ ー カ ル デ ィ ス ク の フ ァ イ ル を 上 書 き せ ず に |
djvused ス ク リ プ ト を デ バ ッ グ す る の に 便 利 で す 。
使 用 方 法
djvused の 使 い 方 は た く さ ん あ り ま す 。 以 下 の 例 で は い く つ か の 代 表 的 な 使 用 方 法 を ご 紹 介 し ま す 。
ペ ー ジ サ イ ズ の 取 得
コ マ ン ド size は HTML の よ う な 書 式 で 選 択 し た ペ ー ジ の 幅 と 高 さ を 返 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は myfile.djvu の 3
|
djvused myfile.djvu -e ’select 3; size’ |
テ キ ス ト の 書 き 出 し
コ マ ン ド print-pure-txt は ペ ー ジ ま た は 文 書 に 関 連 付 け ら れ た テ キ ス ト を 出 力 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は 文 書 全 体 の テ キ ス ト を 出 力 し ま す 。 行 や ペ ー ジ は 通 常 の コ ン ト ロ ー ル 文 字 で 区 切 ら れ ま す 。
|
djvused myfile.djvu -e ’print-pure-txt’ コ マ ン ド print-txt は テ キ ス ト コ ン ポ ー ネ ン ト の 構 造 や 位 置 を 示 す 情 報 を 持 っ た 拡 張 テ キ ス ト を 出 力 し ま す 。 書 式 は こ の man page の 後 半 で 解 説 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は myfile.djvu の 3 ペ ー ジ 目 の 拡 張 テ キ ス ト 情 報 を 出 力 し ま す 。 | |
|
djvused myfile.djvu -e ’select 3; print-txt’ |
ア ノ テ ー シ ョ ン の 書 き 出 し
ア ノ テ ー シ ョ ン デ ー タ は コ マ ン ド print-ant で 書 き 出 す こ と が 出 来 ま す 。 ア ノ テ ー シ ョ ン デ ー タ の 書 式 は こ の man page の 後 半 で 解 説 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は myfile.djvu の 最 初 の ペ ー ジ の ア ノ テ ー シ ョ ン デ ー タ を 出 力 し ま す 。
|
djvused myfile.djvu -e ’select 1; print-ant’ コ マ ン ド print-ant は 選 択 さ れ た コ ン ポ ー ネ ン ト フ ァ イ ル に 含 ま れ る ア ノ テ ー シ ョ ン だ け を 出 力 し ま す 。 コ マ ン ド print-merged-ant は 現 在 の ペ ー ジ が ( INCL を 使 用 し て )参 照 し て い る 全 て の コ ン ポ ー ネ ン ト フ ァ イ ル か ら ア ノ テ ー シ ョ ン を 取 得 し 、 マ ー ジ し た 情 報 を 返 し ま す 。 |
ア ノ テ ー シ ョ ン や テ キ ス ト の ダ ン プ と リ ス ト ア
3 つ の コ マ ン ド output-txt、 output-ant、 output-all は djvused ス ク リ プ ト を 生 成 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は djvused ス ク リ プ ト myfile.dsed を 生 成 し ま す 。 こ の ス ク リ プ ト は myfile.djvu に 含 ま れ る 全 て の テ キ ス ト と ア ノ テ ー シ ョ ン デ ー タ を 再 作 成 し ま す 。
|
djvused myfile.djvu -e ’output-all’ > myfile.dsed ス ク リ プ ト myfile.dsed は 簡 単 に 編 集 す る こ と が 出 来 る テ キ ス ト フ ァ イ ル で す 。 以 下 の コ マ ン ド は フ ァ イ ル myfile.djvu の テ キ ス ト と ア ノ テ ー シ ョ ン 情 報 を 再 作 成 し ま す 。 | |
|
djvused myfile.djvu -f myfile.dsed -s |
ペ ー ジ の 書 き 出 し
2 つ の コ マ ン ド save-page と save-page-with は 分 書 中 の 選 択 さ れ た コ ン ポ ー ネ ン ト フ ァ イ ル を 示 す DjVu フ ァ イ ル を 作 成 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は 文 書 myfile.djvu の 5 ペ ー ジ 目 を 含 む フ ァ イ ル p05.djvu
|
djvused myfile.djvu -e ’select 5; save-page p05.djvu’ 文 書 の 各 ペ ー ジ は 、 い わ ゆ る inclusion チ ャ ン ク ( INCL )を 使 用 し て 別 の コ ン ポ ー ネ ン ト フ ァ イ ル か ら の デ ー タ を イ ン ポ ー ト す る こ と が あ り ま す 。 そ し て 、 コ マ ン ド save-page は イ ン ポ ー ト さ れ た デ ー タ へ の 未 解 決 の 参 照 を 含 ん だ フ ァ イ ル を 作 成 し ま す 。 こ の よ う な フ ァ イ ル は 、 別 の コ ン ポ ー ネ ン ト フ ァ イ ル が 必 要 と す る デ ー タ を も つ マ ル チ ペ ー ジ 文 書 の 一 部 と し て 作 成 さ れ ま す 。 こ れ に 対 し て 、 コ マ ン ド save-page-with は 全 て の イ ン ポ ー ト さ れ た デ ー タ を 出 力 フ ァ イ ル に コ ピ ー し ま す 。 こ の フ ァ イ ル は 直 接 使 う こ と が 出 来 ま す 。 し か し 、 そ の よ う な フ ァ イ ル を 1 つ の マ ル チ ペ ー ジ 文 書 に 集 め る と 不 必 要 に デ ー タ を 複 製 し て し ま う 可 能 性 が あ り ま す 。 |
サ ム ネ イ ル の 作 成
コ マ ン ド set-thumbnails は DjVu ビ ュ ー ア が 表 示 に 使 用 す る サ ム ネ イ ル を 作 成 し ま す 。 た と え ば 、 以 下 の 例 は 、 フ ァ イ ル myfile.djvu の 全 て の ペ ー ジ に サ イ ズ 64x64 ピ ク セ ル で サ ム ネ イ ル を 作 成 し ま す 。
|
djvused myfile.djvu -e ’set-thumbnails 64’ |
コ マ ン ド
コ マ ン ド ラ イ ン に は 一 つ ま た は 複 数 の djvused コ マ ン ド や オ プ シ ョ ン コ メ ン ト が 含 ま れ て い た り 、 全 く 含 ま れ て い な い こ と も あ り ま す 。 複 数 の djvused コ マ ン ド は セ ミ コ ロ ン 「 ;」 で 区 切 り ま す 。 コ メ ン ト は 「 #」 に 続 け て 記 述 し 、 行 末 ま で コ メ ン ト と し て 認 識 さ れ ま す 。
選 択 コ マ ン ド
マ ル チ ペ ー ジ の DjVu 文 書 は 複 数 の コ ン ポ ー ネ ン ト フ ァ イ ル で 構 成 さ れ ま す 。 ほ と ん ど の コ ン ポ ー ネ ン ト フ ァ イ ル は 、 文 書 の 特 定 の ペ ー ジ に 相 当 し ま す 。 コ ン ポ ー ネ ン ト の 中 に は 共 有 画 像 デ ー タ や 共 有 ア ノ テ ー シ ョ ン 、 サ ム ネ イ ル の よ う に 複 数 の ペ ー ジ で 共 有 さ れ る も の も あ り ま す 。 多 く の djvused コ マ ン ド は 選 択 し た コ ン ポ ー ネ ン ト フ ァ イ ル に 有 効 で す 。 全 て の コ ン ポ ー ネ ン ト フ ァ イ ル は 最 初 は 選 択 さ れ て い ま す 。 以 下 の コ マ ン ド は 選 択 状 態 を 変 更 す る の に 使 用 し ま す 。
|
ls 文 書 中 の 全 て の コ ン ポ ー ネ ン ト フ ァ イ ル を 選 択 し ま す 。 各 行 は オ プ シ ョ ン の ペ ー ジ 番 号 や 、 コ ン ポ ー ネ ン ト フ ァ イ ル の タ イ プ を 示 す 文 字 、 コ ン ポ ー ネ ン ト フ ァ イ ル の サ イ ズ 、 コ ン ポ ー ネ ン ト フ ァ イ ル の 識 別 子 を 含 み ま す 。 コ ン ポ ー ネ ン ト フ ァ イ ル の タ イ プ を 示 す 文 字 |
P、
I、 A、 T は そ
れ ぞ れ ペ ー ジ
デ ー タ 、 共 有
画 像 デ ー タ 、
共 有 ア ノ テ ー
シ ョ ン デ ー タ
、 サ ム ネ イ ル
デ ー タ を 示 し
ま す 。 ペ ー ジ
番 号 は ペ ー ジ
デ ー タ を 含 む
コ ン ポ ー ネ ン
ト フ ァ イ ル に
の み リ ス ト さ
れ て い ま す 。
select [fileid] 引 数
fileid で 認 識 さ れ
た コ ン ポ ー ネ
ン ト を 選 択 し
ま す 。 引 数 fileid
は ペ ー ジ 番 号
ま た は コ ン ポ
ー ネ ン ト フ ァ
イ ル の 識 別 子
を 指 定 し ま す
。 select コ マ ン ド
は 引 数 fileid が 省
略 さ れ た 場 合
、 全 て の コ ン
ポ ー ネ ン ト フ
ァ イ ル を 選 択
し ま す 。
select-shared-ant 共 有 ア ノ
テ ー シ ョ ン を
含 む コ ン ポ ー
ネ ン ト フ ァ イ
ル を 選 択 し ま
す 。 現 バ ー ジ
ョ ン の DjVu ソ フ ト
ウ ェ ア で は こ
の よ う な フ ァ
イ ル は 一 つ だ
け サ ポ ー ト さ
れ て い ま す 。
こ の コ ン ポ ー
ネ ン ト フ ァ イ
ル は 通 常 特 定
の ペ ー ジ で は
な く 文 書 全 体
に 属 す る ア ノ
テ ー シ ョ ン を
保 持 し ま す 。
こ の コ ン ポ ー
ネ ン ト フ ァ イ
ル が 存 在 し な
い と エ ラ ー が
発 生 し ま す 。
create-shared-ant 共 有 ア ノ
テ ー シ ョ ン を
含 む コ ン ポ ー
ネ ン ト フ ァ イ
ル を 作 成 し て
選 択 し ま す 。
こ の コ マ ン ド
は 共 有 ア ノ テ
ー シ ョ ン コ ン
ポ ー ネ ン ト が
既 に 存 在 す る
場 合 は 共 有 ア
ノ テ ー シ ョ ン
コ ン ポ ー ネ ン
ト の み を 選 択
し ま す 。 存 在
し な い 場 合 は
、 新 し い 共 有
ア ノ テ ー シ ョ
ン コ ン ポ ー ネ
ン ト を 作 成 し
、 文 書 中 の 全
て の ペ ー ジ か
ら イ ン ポ ー ト
さ れ て い る こ
と を 確 認 し ま
す 。
様 々 な コ マ ン ド
|
help |
djvused が サ ポ ー ト す る 全 て の コ マ ン ド の ヘ ル プ メ ッ セ ー ジ を 表 示 し ま す 。 | ||
|
n |
文 書 中 の 総 ペ ー ジ 数 を 表 示 し ま す 。
|
dump 文 書 ま た は 選 択 さ れ た コ ン ポ ー ネ ン ト フ ァ イ ル の |
EA IFF 85 構 造 を 表 |
示 し ま す 。 同 様 の 機 能 は プ ロ グ ラ ム djvudump で も 提 供 さ れ て い ま す 。
|
size 選 択 さ れ た ペ ー ジ の 幅 と 高 さ を 表 示 し ま す 。 各 ペ ー ジ の サ イ ズ は |
<EMBED...></EMBED> タ グ で 直 接 挿 入 す る の に 適 し た 書 式 で 表 示 さ れ ま す 。
テ キ ス ト お よ び ア ノ テ ー シ ョ ン コ マ ン ド
print-pure-txt
選 択 し た ペ ー
ジ の テ キ ス ト
レ イ ヤ の テ キ
ス ト を 出 力 す
る 。 同 様 の 機
能 は プ ロ グ ラ
ム djvutxt も 提 供 し
て い ま す 。 構
造 化 情 報 は コ
ン ト ロ ー ル 文
字 で 表 さ れ る
こ と が あ り ま
す 。 ペ ー ジ 毎
の テ キ ス ト は
フ ィ ー ド 文 字
「 \f」 で 区 切 ら
れ ま す 。 行 は
改 行 コ ー ド 「
\n」 で 区 切 ら れ
ま す 。 カ ラ ム
や 、 領 域 、 パ
ラ グ ラ フ は そ
れ ぞ れ 、 タ ブ
文 字 「 \013」 、 グ
ル ー プ セ パ レ
ー タ 「 \035」 、 ユ
ニ ッ ト セ パ レ
ー タ 「 \037」 で 区
切 ら れ ま す 。
print-txt 選 択 さ れ た
ペ ー ジ の テ キ
ス ト 情 報 を 出
力 し ま す 。 こ
の 情 報 は 文 書
中 の ペ ー ジ の
テ キ ス ト 構 造
を 表 し 、 ペ ー
ジ 画 像 中 の 構
造 化 要 素 の 位
置 を 特 定 し ま
す 。 出 力 の 書
式 は 、 こ の man page
の 後 半 で 解 説
し ま す 。
remove-txt 選 択 さ れ た
コ ン ポ ー ネ ン
ト フ ァ イ ル か
ら テ キ ス ト 情
報 を 削 除 し ま
す 。 た と え ば
、 コ マ ン ド
selectお よ び remove-txt
を 実 行 す る と
、 DjVu 文 書 中 の 全
て の テ キ ス ト
情 報 が 削 除 さ
れ ま す 。
set-txt [djvusedtxtfile] 選 択
し た ペ ー ジ に
テ キ ス ト 情 報
を 挿 入 し ま す
。 オ プ シ ョ ン
引 数 djvusedtxtfile は テ
キ ス ト 情 報 を
含 む フ ァ イ ル
の 名 前 で す 。
こ の フ ァ イ ル
は コ マ ン ド
print-txt で 作 成 さ
れ る 内 容 と 同
じ で な け れ ば
な り ま せ ん 。
オ プ シ ョ ン 引
数 が 省 略 さ れ
た 場 合 、 プ ロ
グ ラ ム は ピ リ
オ ド か EOF が 見 つ
か る ま で djvused ス
ク リ プ ト か ら
テ キ ス ト 情 報
を 読 み 続 け ま
す 。
output-txt 選 択 し た ペ
ー ジ の テ キ ス
ト 情 報 を 再 構
築 す る djvused ス ク
リ プ ト を 出 力
し ま す 。 こ の
ス ク リ プ ト は
djvused プ ロ グ ラ ム
を -f オ プ シ ョ
ン 付 で 起 動 す
る こ と で 、 後
で 編 集 し た り
実 行 す る こ と
が 出 来 ま す 。
print-ant 選 択 さ れ た
コ ン ポ ー ネ ン
ト フ ァ イ ル の
ア ノ テ ー シ ョ
ン を 出 力 し ま
す 。 ア ノ テ ー
シ ョ ン デ ー タ
は 後 述 す る シ
ン プ ル な 書 式
で 出 力 さ れ ま
す 。
print-merged-ant 選 択 さ れ
た コ ン ポ ー ネ
ン ト フ ァ イ ル
に 保 存 さ れ た
ア ノ テ ー シ ョ
ン を 共 有 ア ノ
テ ー シ ョ ン フ
ァ イ ル な ど か
ら イ ン ポ ー ト
し た ア ノ テ ー
シ ョ ン へ マ ー
ジ し ま す 。 ア
ノ テ ー シ ョ ン
デ ー タ は 後 述
す る シ ン プ ル
な 書 式 で 出 力
さ れ ま す 。
remove-ant 選 択 さ れ た
コ ン ポ ー ネ ン
ト フ ァ イ ル か
ら ア ノ テ ー シ
ョ ン 情 報 を 削
除 し ま す 。 た
と え ば 、 コ マ
ン ド selectお よ び
remove-ant を 実 行 す
る と DjVu 文 書 か ら
全 て の ア ノ テ
ー シ ョ ン 情 報
を 削 除 し ま す
。
set-ant [djvusedantfile] 選 択
し た コ ン ポ ー
ネ ン ト フ ァ イ
ル の ア ノ テ ー
シ ョ ン を 設 定
し ま す 。 オ プ
シ ョ ン 引 数 の
djvusedantfile は ア ノ テ
ー シ ョ ン デ ー
タ を 含 む フ ァ
イ ル の 名 前 で
す 。 こ の フ ァ
イ ル は コ マ ン
ド print-ant が 出 力
す る 内 容 と 同
じ で な く て は
な り ま せ ん 。
オ プ シ ョ ン 引
数 が 省 略 さ れ
た 場 合 、 プ ロ
グ ラ ム は ピ リ
オ ド か EOF が 見 つ
か る ま で djvused ス
ク リ プ ト か ら
テ キ ス ト 情 報
を 読 み 続 け ま
す 。
output-ant 選 択 し た ペ
ー ジ の ア ノ テ
ー シ ョ ン 情 報
を 再 構 築 す る
djvused ス ク リ プ ト
を 出 力 し ま す
。 こ の ス ク リ
プ ト は djvused プ ロ
グ ラ ム を -f オ
プ シ ョ ン 付 で
起 動 す る こ と
で 、 後 で 編 集
し た り 実 行 す
る こ と が 出 来
ま す 。
print-meta 選 択 し た コ
ン ポ ー ネ ン ト
フ ァ イ ル の の
ア ノ テ ー シ ョ
ン か ら メ タ デ
ー タ の 部 分 を
出 力 し ま す 。
こ の コ マ ン ド
は print-ant コ マ ン
ド が 出 力 す る
情 報 の サ ブ セ
ッ ト を 異 な る
書 式 で 表 示 し
ま す 。 メ タ デ
ー タ は キ ー と
値 の ペ ア で 構
成 さ れ て い ま
す 。 各 行 は
author、 title な ど
の キ ー 名 を 含
み 、 そ の 後 に
タ ブ 文 字 「 \t」
と ダ ブ ル ク ォ
ー テ ー シ ョ ン
で 囲 ま れ た
UTF-8 エ ン コ ー
ド の メ タ デ ー
タ 文 字 列 が 続
き ま す 。
set-meta djvusedmetafile 選 択
し た コ ン ポ ー
ネ ン ト フ ァ イ
ル の ア ノ テ ー
シ ョ ン か ら メ
タ デ ー タ の 部
分 を 設 定 し ま
す 。 ア ノ テ ー
シ ョ ン の 他 の
部 分 は 変 更 さ
れ ま せ ん 。 オ
プ シ ョ ン 引 数
djvusedmetafile は メ タ デ
ー タ を 含 む フ
ァ イ ル の 名 前
で す 。 こ の フ
ァ イ ル は コ マ
ン ド print-meta が 出
力 す る 内 容 と
同 じ で な く て
は な り ま せ ん
。 オ プ シ ョ ン
引 数 が 省 略 さ
れ た 場 合 、 プ
ロ グ ラ ム は ピ
リ オ ド か EOF が 見
つ か る ま で djvused
ス ク リ プ ト か
ら テ キ ス ト 情
報 を 読 み 続 け
ま す 。
output-all 選 択 し た ペ
ー ジ の テ キ ス
ト お よ び ア ノ
テ ー シ ョ ン 情
報 を 再 構 築 す
る djvused ス ク リ プ
ト を 出 力 し ま
す 。 こ の ス ク
リ プ ト は djvused プ
ロ グ ラ ム を -f
オ プ シ ョ ン 付
で 起 動 す る こ
と で 、 後 で 編
集 し た り 実 行
す る こ と が 出
来 ま す 。
サ ム ネ イ ル コ マ ン ド
set-thumbnails
sz サ ム ネ イ ル
サ イ ズ szxsz ピ
ク セ ル を 計 算
し 文 書 に 挿 入
し ま す 。 DjVu ビ ュ
ー ア は 各 ペ ー
ジ の デ ー タ を
ダ ウ ン ロ ー ド
し な く て も 非
常 に 効 果 的 に
サ ム ネ イ ル を
表 示 す る こ と
が 出 来 ま す 。
通 常 サ ム ネ イ
ル サ イ ズ は 48 か
ら 128 の 間 で 指 定
し ま す 。
remove-thumbnails
DjVu 文 書 か ら サ ム ネ イ ル を 削 除 し ま す 。 コ マ ン ド set-thumbnails で 新 し い サ ム ネ イ ル を 作 成 す る こ と が 出 来 ま す 。
Save commands
上 記 の コ マ ン ド は メ モ リ 上 の DjVu 文 書 を 変 更 す る だ け で す 。 以 下 の コ マ ン ド は 変 更 し た デ ー タ を フ ァ イ ル シ ス テ ム に 保 存 す る 方 法 を 提 供 し ま す 。
|
save プ ロ グ ラ ム |
djvused の 引 数 に 指 定 さ れ た 入 力 フ ァ イ ル djvufile に 変 |
更 さ れ た DjVu 文 書 を 保 存 し な お し ま す 。 DjVu フ ァ イ ル が 変 更 さ れ な か っ た 場 合 は 何 も し ま せ ん 。 オ プ シ ョ ン -s を 指 定 す る の は プ ロ グ ラ ム 終 了 前 に コ マ ン ド save を 実 行 す る の と 同 じ で す 。
save-bundled
filename 現 在 の DjVu 文
書 を バ ン ド ル
ド 形 式 の DjVu 文 書
と し て filename に 指
定 さ れ た 名 前
で 保 存 し ま す
。 同 様 の 機 能
は プ ロ グ ラ ム
djvmcvt で も 提 供 さ
れ て い ま す 。
save-indirect filename 現 在 の
DjVu 文 書 を イ ン ダ
イ レ ク ト 形 式
の マ ル チ ペ ー
ジ 文 書 と し て
保 存 し ま す 。
イ ン ダ イ レ ク
ト 形 式 の イ ン
デ ッ ク ス フ ァ
イ ル 名 は filename で
す 。 同 様 の 機
能 は djvmcvt で も 提
供 さ れ て い ま
す 。
save-page filename 選 択 さ
れ た コ ン ポ ー
ネ ン ト フ ァ イ
ル を filename と い う
DjVu フ ァ イ ル に 保
存 し ま す 。 選
択 さ れ た コ ン
ポ ー ネ ン ト フ
ァ イ ル は い わ
ゆ る inclusion チ ャ ン
ク ( INCL )を 使 用
し て 他 の コ ン
ポ ー ネ ン ト フ
ァ イ ル か ら イ
ン ポ ー ト さ れ
た デ ー タ で あ
る 可 能 性 が あ
り ま す 。 こ の
コ マ ン ド は イ
ン ポ ー ト さ れ
た デ ー タ へ の
未 解 決 の 参 照
を 含 む フ ァ イ
ル を 作 成 し ま
す 。 こ の よ う
な フ ァ イ ル は
、 他 の コ ン ポ
ー ネ ン ト フ ァ
イ ル に 必 要 な
デ ー タ を 含 む
マ ル チ ペ ー ジ
文 書 の 一 部 に
し て お く 必 要
が あ り ま す 。
save-page-with filename 選 択
さ れ た コ ン ポ
ー ネ ン ト フ ァ
イ ル を filename と い
う DjVu フ ァ イ ル に
保 存 し ま す 。
別 の コ ン ポ ー
ネ ン ト フ ァ イ
ル か ら イ ン ポ
ー ト さ れ た 全
て の デ ー タ は
出 力 フ ァ イ ル
に も 同 様 に コ
ピ ー さ れ ま す
。 こ の コ マ ン
ド は 常 に 使 用
可 能 な DjVu フ ァ イ
ル を 作 成 し ま
す 。 一 方 、 こ
の よ う な ペ ー
ジ を マ ル チ ペ
ー ジ 文 書 内 に
複 数 集 め る こ
と と 、 不 必 要
に デ ー タ を 重
複 さ せ て し ま
う 可 能 性 が あ
り ま す 。
djvused フ ァ イ ル 形 式
djvused は ア ノ テ ー シ ョ ン や テ キ ス ト を あ ら わ す の に シ ン プ ル な 括 弧 付 の 書 式 を 使 用 し ま す 。
|
* こ の 書 式 は |
DjVu が ア ノ テ ー シ ョ ン を 保 存 す る の に 使 用 さ れ る 標 準 の 書 式 で |
す 。 プ ロ グ ラ ム djvused は 単 に bzz(1) ア ル ゴ リ ズ ム を 使 用 し て ア ノ テ ー シ ョ ン デ ー タ を 圧 縮 す る だ け で す 。
|
* こ の 書 式 は |
DjVu が テ キ ス ト を 保 存 す る の に 使 用 す る 書 式 と は 異 な り ま す 。 |
プ ロ グ ラ ム djvused は DjVu が 使 用 す る コ ン パ ク ト な バ イ ナ リ 形 式 と 編 集 が 容 易 な 括 弧 付 の 形 式 の 間 で 変 換 を 行 い ま す 。
一 般 的 な 書 式
djvused フ ァ イ ル は ASCII テ キ ス ト フ ァ イ ル で す 。 djvused フ ァ イ ル で 有 効 な 文 字 は 印 字 可 能 な ASCII 文 字 と ス ペ ー ス 、 タ ブ 、 cr、 nl 文 字 で す 。 こ れ 以 外 の 文 字 を 使 用 し た 場 合 の 結 果 は 見 て 意 義 で す 。
djvused フ ァ イ ル は 空 白 文 字 (文 字 、 ス ペ ー ス 、 タ ブ 、 cr、 nl)で 区 切 ら れ た 一 続 き の 式 で 構 成 さ れ ま す 。 式 に は 整 数 、 シ ン ボ ル 、 文 字 列 、 リ ス ト の 4 種 類 が あ り ま す 。
|
整 数 : 製 数 値 は 通 常 通 り 複 数 の 桁 で 表 現 さ れ ま す 。 シ ン ボ ル : シ ン ボ ル つ ま り 識 別 子 は 名 前 や キ ー ワ ー ド を 示 す 一 続 き の 印 刷 可 能 な 文 字 で す 。 使 用 で き る 文 字 は ア ル フ ァ ベ ッ ト お よ び 数 字 、 ア ン ダ ー ス コ ア 「 |
_」 、 マ イ ナ ス 「 -」 、 シ ャ ー プ 「 #」 (全 て 半 角 )で す 。 名 前 は 、 数 字 や マ イ ナ ス 記 号 で は じ め て は い け ま せ ん 。 文 字 列 : 文 字 列 は 任 意 の バ イ ト シ ー ケ ン ス 、 通 常 は S.SM UTF-8 エ ン コ ー ド の 文 字 と し て 認 識 さ れ る シ ー ケ ン ス を 表 示 し ま す 。 djvused フ ァ イ ル の 文 字 列 は C 言 語 の 文 字 列 に 似 て い ま す 。 文 字 列 は ダ ブ ル ク ォ ー テ ー シ ョ ン で 囲 ま れ た 文 字 で す 。 バ ッ ク ス ラ ッ シ ュ (「 \」 )で 始 ま る 文 字 シ ー ケ ン ス に は 特 別 な 意 味 が あ り ま す 。 1 か ら 3 桁 の 数 字 の 前 の バ ッ ク ス ラ ッ シ ュ は 、 バ イ ト 値 の 10 進 数 表 現 で す 。 a、 b、 t、 n、 v、 f、 r に 続 く バ ッ ク ス ラ ッ シ ュ は そ れ ぞ れ 文 字 コ ー ド 8 か ら 13 を 示 し て い ま す 。 そ の 他 の 文 字 の 前 の バ ッ ク ス ラ ッ シ ュ は そ れ ぞ れ の 文 字 を 示 し ま す 。 特 に 、 ダ ブ ル ク ォ ー テ ー シ ョ ン の 前 の バ ッ ク ス ラ ッ シ ュ は ダ ブ ル ク ォ ー テ ー シ ョ ン を 示 し 、 文 字 列 の 終 了 位 置 を 示 す も の で は あ り ま せ ん 。 リ ス ト : リ ス ト は ブ ラ ン ク と 括 弧 で 囲 ま れ た 一 続 き の 式 で す 。 全 て の タ イ プ の 式 を リ ス ト に 含 め る こ と が 可 能 で 、 サ ブ リ ス ト を 含 め る こ と も で き ま す 。
テ キ ス ト の 書 式
テ キ ス ト の 書 式 は 基 本 的 に は テ キ ス ト の 各 構 造 化 コ ン ポ ー ネ ン ト を 表 す リ ス ト で す 。 構 造 化 コ ン ポ ー ネ ン ト は 以 下 の 形 式 で す :
|
(type xmin xmax ymin ymax ... ) シ ン ボ ル type は 、 page、 column、 region、 para、 line、 word、 char (優 先 度 順 )の う ち の ど れ か 一 つ で な く て は な り ま せ ん 。 整 数 xmin、 xmax、 ymin、 ymax は 四 角 形 の 座 標 を 示 し 、 ペ ー ジ 中 の 構 造 化 コ ン ポ ー ネ ン ト の 位 置 を 表 し ま す 。 座 標 の 単 位 は ピ ク セ ル で 、 起 点 は ペ ー ジ の 左 下 隅 で す 。 リ ス ト 中 の 他 の 式 は 、 い ず れ も こ の 構 造 化 コ ン ポ ー ネ ン ト に 関 連 付 け ら れ た エ ン コ ー ド 済 み の テ キ ス ト を 表 す 一 つ の 文 字 列 か 、 よ り 順 位 の 低 い タ イ プ の 構 造 化 コ ン ポ ー ネ ン ト で す 。 各 ペ ー ジ の テ キ ス ト は 単 に タ イ プ page の 一 つ の 構 造 化 要 素 で 表 し ま す 。 様 々 な 構 造 化 情 報 の レ ベ ル が 使 用 可 能 で す 。 た と え ば 、 ペ ー ジ レ ベ ル の コ ン ポ ー ネ ン ト は ペ ー ジ レ ベ ル の 文 字 列 を 定 義 す る だ け か も し れ な い し 、 行 の リ ス ト か も し れ な い し 、 あ る い は 文 字 レ ベ ル ま で の 完 全 な ヒ エ ラ ル キ ー を 提 供 す る か も し れ ま せ ん 。 |
ア ノ テ ー シ ョ ン の 書 式
ア ノ テ ー シ ョ ン は 一 連 の ア ノ テ ー シ ョ ン 式 で 表 し ま す 。 以 下 の ア ノ テ ー シ ョ ン 式 が 有 効 で す :
(background color)
DjVu 画 像 の 周 り の 部 分 の 色 を 指 定 し ま す 。 色 は X11 の 16 進 数 表 記 #RRGGBB で 指 定 し ま す 。 た と え ば 、 #000000 は 黒 、 #FFFFFF は 白 。
(zoom
zoomvalue) 画 像 の 最
初 の 拡 大 率 を
指 定 し ま す 。
引 数 zoomvalue は
stretch、 one2one、
width、 page の い ず
れ か か 、 文 字
d に 続 け て 1 か
ら 999 間 で の 拡 大
率 を 示 す 数 字 (.BR
d300 "と か " d150 な ど )
を 指 定 し ま す
。
(mode modevalue) 画 像
の 初 期 表 示 モ
ー ド を 指 定 し
ま す 。 引 数
modevalue は color、
bw、 fore、 black の
う ち ど れ か 一
つ を 指 定 し ま
す 。
(align horzalign vertalign) ビ
ュ ー ア 上 で の
画 像 の ア ラ イ
ン メ ン ト を 指
定 し ま す 。 デ
フ ォ ル ト で は
画 像 は セ ン タ
ー に 表 示 さ れ
ま す 。 引 数
horzalign は left、
center、 right の う
ち の ど れ か 一
つ で す 。 引 数
vertalign は top、
center、 bottom の う
ち ど れ か 一 つ
で す 。
(maparea url comment area ...) 指
定 し た リ ン ク
先 へ の ハ イ パ
ー リ ン ク を 定
義 し ま す 。 引
数 url は 以 下 の
い ず れ か の 形
式 を 指 定 し ま
す :
|
href |
(url href target)
href は リ ン ク 先 を 示 す 文 字 列 で 、 target は HTML の ア ン カ ー タ グ <A> に 定 義 さ れ て い る ハ イ パ ー リ ン ク の タ ー ゲ ッ ト フ レ ー ム を 示 し ま す 。 リ ン ク 先 文 字 列 href は 任 意 の URL ま た は 、 シ ャ ー プ 記 号 「 #」 に 続 け て コ ン ポ ー ネ ン ト フ ァ イ ル の 識 別 子 、 ま た は ペ ー ジ 番 号 を 指 定 す る こ と が 出 来 ま す 。 ペ ー ジ 番 号 に は ペ ー ジ を 置 き 換 え る た め の オ プ シ ョ ン 記 号 を つ け る こ と が 出 来 ま す 。 た と え ば 、 "#-1" や "#+1" は 前 の ペ ー ジ ま た は 次 の ペ ー ジ を 表 し ま す 。 引 数 comment は ユ ー ザ が ビ ュ ー ア の ハ イ パ ー リ ン ク 上 を マ ウ ス で 動 か し た と き に 表 示 さ れ る 文 字 列 で す 。 引 数 area は ハ イ パ ー リ ン ク の 形 や 場 所 を 定 義 し ま す 。 以 下 の 形 式 が 使 用 出 来 ま す :
|
(rect xmin ymin width height) |
(oval xmin ymin width
height)
(polygon x0 y0 x1 y1 ... ) 全
て の パ ラ メ ー
タ は 座 標 を 示
す 数 字 で す 。
座 標 は ピ ク セ
ル で 指 定 し 、
起 点 は ペ ー ジ
の 左 下 隅 で す
。
maparea リ ス ト の そ の 他 の 式 は ハ イ パ ー リ ン ク に 関 連 付 け ら れ た 視 覚 効 果 を 表 し ま す 。 オ プ シ ョ ン の 最 初 の 部 分 は ハ イ パ ー リ ン ク エ リ ア の 境 界 線 の タ イ プ を 定 義 し ま す :
|
(xor) |
(border color)
(shadow_in [thickness])
(shadow_out [thickness])
(shadow_ein [thickness])
(shadow_eout [thickness]) パ
ラ メ ー タ color は
上 述 の よ う な
#RRGGBB 形 式 の 書 式
を 使 用 し 、 パ
ラ メ ー タ thickness
に は 1 か ら 32 の 整
数 を 指 定 し ま
す 。 最 後 の 4 つ
の 境 界 線 モ ー
ド は 四 角 形 の
ハ イ パ ー リ ン
ク で の み 使 用
で き ま す 。 ユ
ー ザ が ハ イ パ
ー リ ン ク の 上
を マ ウ ス で 動
か す と 境 界 線
が 表 示 さ れ ま
す 。 以 下 の オ
プ シ ョ ン を 指
定 す る と 境 界
線 は 常 に 可 視
に な り ま す :
|
(border-avis) 最 後 に 、 以 下 の オ プ シ ョ ン を 四 角 形 の エ リ ア に 使 用 出 来 ま す 。 指 定 し た 色 で 領 域 全 体 を ハ イ ラ イ ト さ せ ま す 。 | |
|
(hilite color) こ れ は 画 像 中 の 特 定 の 箇 所 を 強 調 表 示 す る た め に 空 の URL と と も に 使 う こ と が あ り ま す 。 |
(metadata ... (key value) ... ) メ タ デ ー タ エ ン ト リ を 定 義 し ま す 。 シ ン ボ ル key は メ タ デ ー タ エ ン ト リ の 性 質 を 示 し 、 エ ン ト リ は こ の シ ン ボ ル で 識 別 さ れ ま す 。 典 型 的 な キ ー に は year、 booktitle、 editor、 author な ど が あ り ま す 。 BibTeX 書 誌 シ ス テ ム と 同 じ キ ー 名 を 使 用 す る こ と が 提 案 さ れ て い ま す 。 文 字 列 value は 対 応 す る キ ー に 関 連 付 け ら れ た 値 を 示 し ま す 。
制 限
こ の バ ー ジ ョ ン の djvused は 一 つ ま た は 全 て の コ ン ポ ー ネ ン ト フ ァ イ ル の 選 択 の み を サ ポ ー ト し て い ま す 。 ペ ー ジ 一 部 を 選 択 す る 方 法 は あ り ま せ ん 。
ク レ ジ ッ ト
こ の プ ロ グ ラ ム は by Léon Bottou <leonb [AT] users.net> が 開 発 し 、 Yann Le Cun <profshadoko [AT] users.net> Florin Nicsa Bill Riemers <docbill [AT] sourceforge.net> そ の 他 の 方 々 に よ り 改 良 さ れ ま し た 。 こ の man page は Nobchika Morimoto <morimoto [AT] lizardtech.com> が 翻 訳 し ま し た 。