.\" -*- coding: euc-jp -*- .\" Copyright (c) 2001 Leon Bottou, Yann Le Cun, Patrick Haffner, .\" AT&T Corp., and Lizardtech, Inc. .\" .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" published by the Free Software Foundation; either version 2 of .\" the License, or (at your option) any later version. .\" .\" The GNU General Public License's references to "object code" .\" and "executables" are to be interpreted as the output of any .\" document formatting or typesetting system, including .\" intermediate and printed output. .\" .\" This manual is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public .\" License along with this manual. Otherwise check the web site .\" of the Free Software Foundation at http://www.fsf.org. .TH NSDEJAVU 1 "10/19/2002" "DjVuLibre-3.5" "DjVuLibre-3.5" .de SS .SH \\0\\0\\0\\$* .. .SH 名前 nsdejavu \- DjVu ブラウザプラグイン .SH 書式 .B LIBDIR/netscape/plugins/NSDEJAVUSO .SH 説明 共有ライブラリ .B NSDEJAVUSO はポピュラーな WEB ブラウザに DjVu ファイルを 表示させるために Netscape ブラウザプラグイン .SM API を採用しています。 様々な WEB ブラウザが独自に Netscape プラグインをサポートしています。 DjVu ブラウザプラグインを有効にする方法については 「ブラウザの互換性」の項目をご覧ください。 スタンドアロンビューア .B djview および DjVu ブラウザプラグイン .B NSDEJAVUSO は同様な機能を提供します。 DjVu ブラウザプラグインは実際にはスタンドアロンのビューを リモートコントロールモードで実行するラッパープログラムです。 このドキュメントではブラウザプラグイン固有の機能について解説します。 追加の情報については .BR djview (1) のドキュメントをご覧ください。 .SH MIME タイプおよび拡張子 既知の DjVu 文書の .SM URL をブラウザに入力すると、自動的に DjVu ブラウザプラグインが起動します。 ブラウザは、 .SM URL が本当に DjVu ファイルかどうか判断するのに様々な方法を用います。 WEB サーバは通常 .SM MIME タイプをブラウザへ送信します。 DjVu 文書の正式な MIME タイプは .BR image/vnd.djvu です。 旧バージョンの DjVu ビューアとの互換性を維持するために、 .BR image/x-djvu を使用することも出来ます。 WEB サーバは正しい MIME タイプを送信するよう設定する必要があります。 詳細については、DjVu のチュートリアルをご覧ください。 ( .B http://www.djvuzone.org/support/tutorial/ ). たいていの WEB ブラウザは .B .djvu または .B .djv の拡張子を持つファイルを DjVu ファイルとして開くことが出来ます。 .SH CGI スタイルのフラグ DjVu ブラウザプラグインの動作は .SM CGI に似た書式を使用して .SM URL を拡張することで指定することが出来ます。 この書式は以下のような形式です: .IP "" 3 .BI "http://server/dir/file.djvu?djvuopts&" "keyword=value" "&" "keyword=value" "&" "..." .PP DjVu ブラウザプラグインは .BR djvuopts の後に現れるキーワードのみ認識します。 認識できないキーワードは無視されます。 以下のキーワードを認識します: .TP .BI passive 通常の WEB 画像の用にブラウザ内に表示させます。デフォルトの拡大率は「ページに合わせる」です。 ツールバー、ポップアップメニュー、スクロールバーおよびキーボードショートカットは無効です。 デフォルト値は無効です。 .TP .BI scrollbars=(yes|no) 画像サイズがプラグインのウィンドウサイズより大きい場合スクロールバーを 表示または非表示にします。デフォルトは有効です。 .TP .BI menu=(yes|no) ポップアップメニューを有効または向こうにします。 デフォルトは有効です。 .TP .BI keyboard=(yes|no) DjVu プラグインのキーボードショートカットを有効または無効にします。 キーボードショートカットはデフォルトでは有効です。 .TP .BI frame=(yes|no) DjVu 画像の周囲に細いグレーの枠の描画を有効または無効にします。 フレームはデフォルトでは有効です。 .TP .BI links=(yes|no) DjVu 画像中のハイパーリンクを有効または向こうにします。 ハイパーリンクはデフォルトでは有効です。 .TP .BI logo=(yes|no) プラグインがデータをダウンロードしている間、DjVu ロゴの表示を有効 または無効にします。デフォルトは有効です。 .TP .BI page= pagenum 最初に表示するページ番号を指定します。 ページ番号は 1 から順に指定します。 .TP .BI zoom= zoomfactor 初期拡大率を指定します。 ツールバー、ポップアップメニュー、キーボードが有効になっている場合は、 ユーザが拡大率を変更することが出来ます。 .I zoomfactor の有効な値は以下のとおりです: .br .TS center,box; lfI l lfB l lfB l lfB l lfB l . 数字 拡大率: 10% 〜 999% one2one 「1:1」モードを選択します。 width 「幅に合わせる」モードを選択します。 page 「ページに合わせる」モードを選択します。 stretch プラグインのウィンドウサイズに合わせて画像を収縮させます。 .TE .PP .TP .BI mode= modespec 初期表示モードを設定します。 ツールバー、ポップアップメニュー、キーボードが有効になっている場合は、 ユーザが初期表示モードを変更することが出来ます。 .I modespec の有効な値は以下のとおりです: .br .TS center,box; lfB l lfB l lfB l lfB l . color カラーで表示します。 bw 白黒マスクレイヤのみを表示します。 fore 前景レイヤのみを表示します。 back 背景レイヤのみを表示します。 .TE .PP .TP .BI hor_align= keyword ビューアウィンドウに表示するページの水平方向の位置を指定します。 .I keyword には .BR left、 .BR center、 .BR right のいずれかを指定します。 .TP .BI ver_align= keyword ビューアウィンドウに表示するページの垂直方向の位置を指定します。 .I keyword には .BR top、 .BR center、 .BR bottom のいずれかを指定します。 .TP .BI toolbar= keyword {(,|+|-) keyword } ツールバーの表示方法とボタンの内容をコントロールします。 オプション .B toolbar はカンマ、プラスおよびマイナス記号で区切られた複数の キーワードで構成されています。 ツールバーの表示方法は、最初に現れるプラスやマイナス記号の 前にあるキーワードでコントロールします。この場合以下の キーワードが使用できます: .br .TS center,box; lfB l lfB l lfB l lfB l lfB l . no ツールバーを無効にします。 always 「自動的に隠す」モードを無効にします。 auto 「自動的に隠す」モードを有効にします。 top ツールバーをウィンドウ上部に表示します。（実装されていません） bottom ツールバーをウィンドウ下部に表示します。 .TE .IP "" ツールバーボタンの内容は、最初に現れるプラスやマイナス記号の 後にあるキーワードでコントロールします。 各キーワードは特定のツールバーボタンまたはボタングループを 追加(プラス記号)または削除(マイナス記号)します。 ツールバーの初期ボタンは最初に現れるプラスまたはマイナス記号で 決まります。 プラス記号の場合、ツールバーの初期ボタンは空です。 マイナス記号の場合は、全てのボタンが表示されています。 以下のキーワードが利用出来ます: .br .TS center,box; lfB l lfB l lfB l lfB l lfB l lfB l lfB l lfB l lfB l lfB l lfB l lfB l lfB l . fore,back,color,bw ディスプレイモード選択ツール rescombo 拡大率の選択ツール zoom 拡大ボタン pan パンボタン。 zoomsel 選択領域拡大ボタン textsel テキスト選択ボタン rotate 回転ボタン search テキスト検索ボタン save 保存ボタン print 印刷ボタン pagecombo ページ選択ツール firstlast 最初のページ、最後のページボタン prevnext 前のページ、次のページボタン backforw 戻る、進むボタン .TE .PP .TP .BI highlight= x , y , w , h [, color ] 四角形のハイライト領域を指定した座標に指定した色で表示します。 座標 .IR x "、 " y "、 " w "、 " h は文書中の画像の座標です(スクリーンの座標系ではありません)。 基点は画像の左下隅です。 .I color は 16 進表記の .SM RRGGBB 形式で記述します。 カラーオプションを省略すると .SM XOR 形式のハイライトを使用します。複数のハイライト領域を指定することが出来ます。 .TP .BI rotate=(0|90|180|270) DjVu 画像を指定した角度で時計回りに回転させます。 .TP .BI print=(yes|no) DjVu 画像の印刷を有効または無効にします。 デフォルトでは有効です。 .TP .BI cache=(yes|no) 文書のデコード済みページのキャッシュを有効または無効にします。 デフォルトでは有効です。拡張子 .BR .djvu " または " .djv を持たない .SM URL の文書のキャッシュはデフォルトでは無効です。 .SH DjVu 画像の埋め込み DjVu を WEB ページへ統合させるには .SM HTML の .SM EMBED タグを使用するのが良いでしょう。 この方法の利点は、WEB サーバが DjVu の .SM MIME タイプをサポートしていなくてもファイルを配信できることです。 さらに .SM CGI スタイルのフラグを .SM EMBED タグの属性として使用することが出来ます。 例: .IP "" 3 .B " .B .PP .SH ブラウザの互換性 DjVu ブラウザプラグインはポピュラーな WEB ブラウザで動作確認されています: .SS Netscape 4 .PP DjVu ブラウザプラグインは通常以下のディレクトリにインストールされています。 .BR /usr/local/lib/netscape/plugins Netscape 4 はこのディレクトリでプラグインを検索するため DjVu ブラウザプラグインをすぐに利用することが出来ます。 以前のバージョンの DjVu ブラウザプラグインをインストールしている場合は あらかじめ削除しておく必要があります。 .B Netscape のメニュー .B "Help->About Plugins" を選択すると現在インストールされているプラグインがリストされます。 以前のバージョンの DjVu ブラウザプラグインは以下ディレクトリのうち いずれかにインストールされています: .IP "" 2 .B "$HOME/.netscape/plugins/NSDEJAVUSO" .br .B "/usr/lib/netscape/plugins/NSDEJAVUSO" .br .B "/opt/netscape/plugins/NSDEJAVUSO" .PP 個人用のプラグインディレクトリにシンボリックリンクを 作成することでもっと簡単にインストールすることが出来ます: .IP "" 2 .B "cd $HOME/.netscape/plugins" .br .B "ln -s LIBDIR/netscape/plugins/NSDEJAVUSO ." .PP .B NSDEJAVUSO をコピーせずにシンボリックリンクを作成します。 これは .B NSDEJAVUSO がシンボリックリンクにしたがって最初に元のインストール先ディレクトリを 検索するために必要です。Netscape プラグインの検索規則は Netscape の .B README に記述されています。 .BR djview . プログラムの .B -fix オプションもご覧ください。 .PP .SS Netscape 6 .PP DjVu プラグインは Netscape 6.1 以上で動作します。 Netscape 6 は独自のプラグインディレクトリの中にあるプラグインのみを 認識するようです。これはシンボリックリンクを利用して実現しています。 Netscape 6 が .IR /usr/local/netscape6 にインストールされているとします。 以下のコマンドでプラグインを認識させることが出来ます: .IP "" 2 .BI "cd " "/usr/local/netscape6" "/plugins" .br .B "ln -s LIBDIR/netscape/plugins/NSDEJAVUSO ." .PP .SS Mozilla .PP DjVu プラグインは Mozilla 0.9.5 以上で動作します。 Mozilla のプラグインディレクトリからリンクを確立する必要があります。 Mozilla が .IR /usr/lib/mozilla-1.1 二インストールされているとすると: .IP "" 2 .BI "cd " "/usr/lib/mozilla-1.1" "/plugins" .br .B "ln -s LIBDIR/netscape/plugins/NSDEJAVUSO ." .PP その後、 .B Mozilla を再起動して メニュー .B "Help->About Plugins" を選択して DjVu プラグインが正しく認識されているか確認します。 .PP .SS Galeon .PP Galeon は内部的に Mozilla 描画エンジンを使用しています。 プラグインを Mozilla にインストールすれば、Galeon でも動作します。 .PP .SS Konqueror .PP DjVu プラグインは .SM KDE-2.2 以上で動作します。 WEB ページに埋め込まれた DjVu 画像で不具合が報告されています。 はじめに .B Konqueror が DjVu プラグインを正しく認識しているかどうか確認してください。 Konqueror で .BR "Settings->Configure Konqueror" を選択します。 ダイアログが表示されたら .BR "Netscape Plugins" . のアイコンを選択します。 ディレクトリ .B "LIBDIR/netscape/plugins" がプラグインディレクトリのリストにあることを確認します。 .BR "Scan for new plugins" ボタンを押します。 .B "Plugins" タブボタンをクリックして認識されたプラグインのリストを表示させます。 リストに .B "NSDEJAVUSO" があることを確認します。 .PP .SS Opera .PP DjVu プラグインは Opera-6 以上で動作します。 Opera のソフトウェアサポートページで解説しているとおり、 OpenMotif ライブラリをインストールしておく必要があります。 .SH クレジット このプログラムは Andrei Erofeev が開発し、 Bill Riemers および L\('eon Bottou が改良しました。 このプログラムおよび man page は Nobchika Morimoto が翻訳しました。 .SH 参照 .BR djvu (1)、 .BR ddjvu (1)、 .BR djview (1)