Manpages

名 前

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 の 使 い 方 は た く さ ん あ り ま す 。 以 下 の 例 で は い く つ か の 代 表 的 な 使 用 方 法 を ご 紹 介 し ま す 。

ペ ー ジ サ イ ズ の 取 得

コ マ ン ド sizeHTML の よ う な 書 式 で 選 択 し た ペ ー ジ の 幅 と 高 さ を 返 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は myfile.djvu3

djvused myfile.djvu -e ’select 3; size’

テ キ ス ト の 書 き 出 し

コ マ ン ド print-pure-txt は ペ ー ジ ま た は 文 書 に 関 連 付 け ら れ た テ キ ス ト を 出 力 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は 文 書 全 体 の テ キ ス ト を 出 力 し ま す 。 行 や ペ ー ジ は 通 常 の コ ン ト ロ ー ル 文 字 で 区 切 ら れ ま す 。

djvused myfile.djvu -e ’print-pure-txt’ コ マ ン ド print-txt は テ キ ス ト コ ン ポ ー ネ ン ト の 構 造 や 位 置 を 示 す 情 報 を 持 っ た 拡 張 テ キ ス ト を 出 力 し ま す 。 書 式 は こ の man page の 後 半 で 解 説 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は myfile.djvu3 ペ ー ジ 目 の 拡 張 テ キ ス ト 情 報 を 出 力 し ま す 。

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-txtoutput-antoutput-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-pagesave-page-with は 分 書 中 の 選 択 さ れ た コ ン ポ ー ネ ン ト フ ァ イ ル を 示 す DjVu フ ァ イ ル を 作 成 し ま す 。 た と え ば 、 以 下 の コ マ ン ド は 文 書 myfile.djvu5 ペ ー ジ 目 を 含 む フ ァ イ ル 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 文 書 中 の 全 て の コ ン ポ ー ネ ン ト フ ァ イ ル を 選 択 し ま す 。 各 行 は オ プ シ ョ ン の ペ ー ジ 番 号 や 、 コ ン ポ ー ネ ン ト フ ァ イ ル の タ イ プ を 示 す 文 字 、 コ ン ポ ー ネ ン ト フ ァ イ ル の サ イ ズ 、 コ ン ポ ー ネ ン ト フ ァ イ ル の 識 別 子 を 含 み ま す 。 コ ン ポ ー ネ ン ト フ ァ イ ル の タ イ プ を 示 す 文 字

PIAT は そ れ ぞ れ ペ ー ジ デ ー タ 、 共 有 画 像 デ ー タ 、 共 有 ア ノ テ ー シ ョ ン デ ー タ 、 サ ム ネ イ ル デ ー タ を 示 し ま す 。 ペ ー ジ 番 号 は ペ ー ジ デ ー タ を 含 む コ ン ポ ー ネ ン ト フ ァ イ ル に の み リ ス ト さ れ て い ま す 。
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 コ マ ン ド が 出 力 す る 情 報 の サ ブ セ ッ ト を 異 な る 書 式 で 表 示 し ま す 。 メ タ デ ー タ は キ ー と 値 の ペ ア で 構 成 さ れ て い ま す 。 各 行 は authortitle な ど の キ ー 名 を 含 み 、 そ の 後 に タ ブ 文 字 「 \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 進 数 表 現 で す 。 abtnvfr に 続 く バ ッ ク ス ラ ッ シ ュ は そ れ ぞ れ 文 字 コ ー ド 8 か ら 13 を 示 し て い ま す 。 そ の 他 の 文 字 の 前 の バ ッ ク ス ラ ッ シ ュ は そ れ ぞ れ の 文 字 を 示 し ま す 。 特 に 、 ダ ブ ル ク ォ ー テ ー シ ョ ン の 前 の バ ッ ク ス ラ ッ シ ュ は ダ ブ ル ク ォ ー テ ー シ ョ ン を 示 し 、 文 字 列 の 終 了 位 置 を 示 す も の で は あ り ま せ ん 。 リ ス ト : リ ス ト は ブ ラ ン ク と 括 弧 で 囲 ま れ た 一 続 き の 式 で す 。 全 て の タ イ プ の 式 を リ ス ト に 含 め る こ と が 可 能 で 、 サ ブ リ ス ト を 含 め る こ と も で き ま す 。

テ キ ス ト の 書 式

テ キ ス ト の 書 式 は 基 本 的 に は テ キ ス ト の 各 構 造 化 コ ン ポ ー ネ ン ト を 表 す リ ス ト で す 。 構 造 化 コ ン ポ ー ネ ン ト は 以 下 の 形 式 で す :

(type xmin xmax ymin ymax ... ) シ ン ボ ル type は 、 pagecolumnregionparalinewordchar (優 先 度 順 )の う ち の ど れ か 一 つ で な く て は な り ま せ ん 。 整 数 xminxmaxyminymax は 四 角 形 の 座 標 を 示 し 、 ペ ー ジ 中 の 構 造 化 コ ン ポ ー ネ ン ト の 位 置 を 表 し ま す 。 座 標 の 単 位 は ピ ク セ ル で 、 起 点 は ペ ー ジ の 左 下 隅 で す 。 リ ス ト 中 の 他 の 式 は 、 い ず れ も こ の 構 造 化 コ ン ポ ー ネ ン ト に 関 連 付 け ら れ た エ ン コ ー ド 済 み の テ キ ス ト を 表 す 一 つ の 文 字 列 か 、 よ り 順 位 の 低 い タ イ プ の 構 造 化 コ ン ポ ー ネ ン ト で す 。 各 ペ ー ジ の テ キ ス ト は 単 に タ イ プ page の 一 つ の 構 造 化 要 素 で 表 し ま す 。 様 々 な 構 造 化 情 報 の レ ベ ル が 使 用 可 能 で す 。 た と え ば 、 ペ ー ジ レ ベ ル の コ ン ポ ー ネ ン ト は ペ ー ジ レ ベ ル の 文 字 列 を 定 義 す る だ け か も し れ な い し 、 行 の リ ス ト か も し れ な い し 、 あ る い は 文 字 レ ベ ル ま で の 完 全 な ヒ エ ラ ル キ ー を 提 供 す る か も し れ ま せ ん 。

ア ノ テ ー シ ョ ン の 書 式

ア ノ テ ー シ ョ ン は 一 連 の ア ノ テ ー シ ョ ン 式 で 表 し ま す 。 以 下 の ア ノ テ ー シ ョ ン 式 が 有 効 で す :

(background color)

DjVu 画 像 の 周 り の 部 分 の 色 を 指 定 し ま す 。 色 は X11 の 16 進 数 表 記 #RRGGBB で 指 定 し ま す 。 た と え ば 、 #000000 は 黒 、 #FFFFFF は 白 。

(zoom zoomvalue) 画 像 の 最 初 の 拡 大 率 を 指 定 し ま す 。 引 数 zoomvaluestretchone2onewidthpage の い ず れ か か 、 文 字 d に 続 け て 1 か ら 999 間 で の 拡 大 率 を 示 す 数 字 (.BR d300 "と か " d150 な ど ) を 指 定 し ま す 。
(mode
modevalue) 画 像 の 初 期 表 示 モ ー ド を 指 定 し ま す 。 引 数 modevaluecolorbwforeblack の う ち ど れ か 一 つ を 指 定 し ま す 。
(align
horzalign vertalign) ビ ュ ー ア 上 で の 画 像 の ア ラ イ ン メ ン ト を 指 定 し ま す 。 デ フ ォ ル ト で は 画 像 は セ ン タ ー に 表 示 さ れ ま す 。 引 数 horzalignleftcenterright の う ち の ど れ か 一 つ で す 。 引 数 vertaligntopcenterbottom の う ち ど れ か 一 つ で す 。
(maparea
url comment area ...) 指 定 し た リ ン ク 先 へ の ハ イ パ ー リ ン ク を 定 義 し ま す 。 引 数 url は 以 下 の い ず れ か の 形 式 を 指 定 し ま す :

href

(url href target)

href は リ ン ク 先 を 示 す 文 字 列 で 、 targetHTML の ア ン カ ー タ グ <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 は メ タ デ ー タ エ ン ト リ の 性 質 を 示 し 、 エ ン ト リ は こ の シ ン ボ ル で 識 別 さ れ ま す 。 典 型 的 な キ ー に は yearbooktitleeditorauthor な ど が あ り ま す 。 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> が 翻 訳 し ま し た 。

参 照

djvu(1)djvutxt(1)djvmcvt(1)djvudump(1)bzz(1)