aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--doc-jp/README.func2
-rw-r--r--doc-jp/README.img253
-rw-r--r--doc/README.func2
-rw-r--r--doc/README.img189
4 files changed, 446 insertions, 0 deletions
diff --git a/doc-jp/README.func b/doc-jp/README.func
index 3987058..ad5d72e 100644
--- a/doc-jp/README.func
+++ b/doc-jp/README.func
@@ -10,6 +10,7 @@ COOKIE クッキー一覧を表示します
DELETE_PREVBUF 前のバッファを消去します(主に local-CGI 用)
DICT_WORD 入力した単語を辞書コマンドで調べます
DICT_WORD_AT カーソル位置の単語を辞書コマンドで調べます
+DISPLAY_IMAGE 画像の読込/表示を再開します
DOWN 画面を1行下にスクロールします
DOWNLOAD 文書のソースをファイルに保存します
EDIT ソースファイルをエディタで編集します
@@ -99,6 +100,7 @@ SHELL シェルコマンドを実行します
SHIFT_LEFT 画面全体を左にずらします
SHIFT_RIGHT 画面全体を右にずらします
SOURCE HTMLのソースを表示します
+STOP_IMAGE 画像の読込/表示を停止します
SUBMIT フォームにサブミットします
SUSPEND サスペンド
UP 画面を1行上にスクロールします
diff --git a/doc-jp/README.img b/doc-jp/README.img
new file mode 100644
index 0000000..175e1e4
--- /dev/null
+++ b/doc-jp/README.img
@@ -0,0 +1,253 @@
+
+w3m でインライン画像を表示
+ 2002/01/31
+ 坂本 浩則
+
+はじめに
+
+ w3m でインライン画像を表示する拡張です。以下に置いてあります。
+
+ http://www2u.biglobe.ne.jp/~hsaka/w3m/index-ja.html#img
+ patch/w3m-0.2.4-img-2.2.patch.gz
+ patch/README.img-ja
+
+機能
+
+ ・X11 上の端末(xterm,kterm,rxvt,...)上に画像(GIF,PNG,JPEG 等)を表示します。
+ ・img タグで指定されたインライン画像を表示できます。
+ width,height 属性に応じて必要な領域を確保してレンダリングします。
+ align 属性に対応しています。
+ ・Content-type: image/* な画像ファイルを直接表示できます。
+ ・map タグに対応しています。
+ area タグの shape, coords 属性を認識し、メニュー表示から選択できます。
+ ・img タグの ismap 属性に対応しています。
+ 座標値を ?<x>,<y> として URL に追加して送ります。
+ ・input タグの type=image 属性で指定されたインライン画像を表示できます。
+ 座標値を <name>.x=<x>&<name>.y=<y> として送ります。
+ ・非同期に画像を読み込みます。
+ ・画像をキャッシュできます。
+
+キー操作
+
+ DISPLAY_IMAGE
+ 画像の読込/表示を再開します。
+ STOP_IMAGE
+ そのバッファの画像の読込/表示を停止します。
+ SET_OPTION display_image=toggle
+ 画像の読込/表示を切替えます。
+
+ デフォルトのキーマップはありませんので、~/.w3m/keymap に
+ keymap X DISPLAY_IMAGE
+ keymap C-c STOP_IMAGE
+ keymap t SET_OPTION display_image=toggle
+ の様に記述して使用してください。
+
+コマンドラインオプション
+
+ -ppc <pixel>
+ 一文字あたりの幅(pixel 値)を指定します。デフォルトは自動設定。
+ 正しく設定されない場合は端末の font の大きさに必ず合わせてください。
+ -ppl <pixel>
+ 一行あたりの幅(pixel 値)を指定します。デフォルトは自動設定。
+ 正しく設定されない場合は端末の font の大きさに必ず合わせてください。
+
+オプションパネル
+
+ pixel_per_char
+ 一文字あたりの幅(pixel 値)を指定します。デフォルトは自動設定。
+ 正しく設定されない場合は端末の font の大きさに必ず合わせてください。
+ pixel_per_line
+ 一行あたりの幅(pixel 値)を指定します。デフォルトは自動設定。
+ 正しく設定されない場合は端末の font の大きさに必ず合わせてください。
+ display_image
+ インライン画像を表示します。デフォルトは ON。
+ auto_image
+ インライン画像を自動で読み込みます。デフォルトは ON。
+ OFF の場合は、コマンド DISPLAY_IMAGE で読み込みを開始します。
+ ext_image_viewer
+ コマンド VIEW_IMAGE('I')の場合や Content-type: image/* である
+ 画像ファイルを外部ビューワで表示します。デフォルトは ON。
+ OFF の場合は、インライン画像として直接表示します。
+ image_scale
+ 画像のスケールを指定します。デフォルトは 100(%)。
+ 小さい font と共に使う場合には値を小さくすると有用。
+ imgdisplay
+ インライン画像を表示するためのコマンド。デフォルトは w3mimgdisplay。
+ 下記の "w3mimgdisplay の設定" を参考にしてオプション設定してください。
+ imgsize
+ インライン画像の大きさを得るためのコマンド。デフォルトは w3mimgsize。
+
+必要なもの
+
+ * w3m-0.2.4.tar.gz
+ http://w3m.sourceforge.net/
+ http://sourceforge.net/projects/w3m/
+ http://prdownloads.sourceforge.net/w3m/
+ * Imlib-1.9.8 (1.9.10 以上推奨)
+ libungif-4.1.0b1 推奨
+
+インストール
+
+ gunzip -c DIST/w3m-0.2.4.tar.gz | tar -xvf -
+ cd w3m-0.2.4
+ gunzip -c DIST/w3m-0.2.4-img-2.2.patch.gz | patch -p1
+ configure
+ # Inline image support (you need Imlib library)
+ # と聞かれますので y と答えてください。
+ # menu は有効にしてください。
+ make
+ # w3mimgdisplay, w3mimgsize を make する時に Imlib が必要です。
+ make install
+ # w3mimgdisplay, w3mimgsize は必ず $LIB(PREFIX/lib/w3m) へ
+ # install してください。
+
+w3mimgdisplay の設定
+
+ w3mimgdisplay は以下のオプションを受け付けますので端末に合わせて
+ オプション設定パネルで(または -o オプションで)設定してください。
+
+ -x <offset_x>
+ 端末上に画像を表示する X 方向の原点。デフォルトは 2 ですが、
+ xterm や kterm ではスクロールバーの幅を計算して加えようとします。
+ (正しく出来ないかもしれません。)
+ Eterm では 5 にすべきかもしれません。
+ -y <offset_y>
+ 端末上に画像を表示する Y 方向の原点。デフォルトは 2。
+ Eterm では 5 にすべきかもしれません。
+ -bg <background>
+ 端末の背景色。デフォルトは自動設定。
+ #RRGGBB で指定する場合は # をエスケープして設定してください。
+
+ 例)
+ w3m -o 'imgdisplay=w3mimgdisplay -x 5 -bg "#cccccc"'
+
+更新記録
+
+2002/01/31 w3m-0.2.4-img-2.2
+ * w3m-0.2.4+cvs-1.278 ベース。
+
+2002/01/29 w3m-0.2.4-img-2.1
+ * w3m-0.2.4+cvs-1.268 ベース。
+
+2002/01/28 w3m-0.2.4-img-2.0
+ * w3m-0.2.4+cvs-1.265 ベース。
+ * pixel_per_char, pixel_per_line を自動設定するようにした。
+ * 端末の背景色を自動設定するようにした。
+ * 画像処理関係のソースを image.c に分離。
+
+2002/01/08 w3m-0.2.4-img-1.18
+ * w3m-0.2.4 ベース。
+
+2001/12/29 w3m-0.2.3.2-img-1.17
+ * w3m-0.2.3.2+cvs-1.196 ベース。
+
+2001/12/25 w3m-0.2.3.2-img-1.16.1
+ * [w3m-dev 02698] Thanks > かずひこ@kondara.org さん
+
+2001/12/22 w3m-0.2.3.2-img-1.16
+ * w3m-0.2.3.2 ベース。
+
+2001/12/20 w3m-0.2.3.1-img-1.15
+ * w3m-0.2.3.1 ベース。
+ * Content-Transfer-Encoding で送られて来た画像を表示可能にした。
+
+2001/11/29
+ * ChangLog 1.71 時点の CVS ソースに対してマージ開始
+
+2001/11/17 w3m-0.2.2-img-1.14
+ * w3m-0.2.2 ベース。
+
+2001/11/14 w3m-0.2.1-inu-1.6-img-1.13
+ * w3m-0.2.1-inu-1.6 ベース。
+
+2001/11/05 w3m-0.2.1-inu-1.5-img-1.12
+ * w3m-0.2.1-inu-1.5 ベース。
+ * <area><map> が使えなくなっていたバグの修正。
+ * kterm 上で xwnmo を使った場合に対応。
+
+2001/10/03 w3m-0.2.1-inu-1.4-img-1.11
+ * w3m-0.2.1-inu-1.4 ベース。
+ * 標準入力から読み込む時に落ちるバグの修正。
+ * configure の修正。Thanks > 深川さん。
+
+2001/08/01 w3m-0.2.1-img-1.10
+ * 画像の位置の微調整。
+ * スケールのバグ修正。
+
+2001/07/31 w3m-0.2.1-img-1.9
+ * initImgdisplay() の修正。Thanks > David.
+
+2001/07/29 w3m-0.2.1-img-1.8
+ * configure の修正。Thanks > 坂根さん。
+
+2001/07/28 w3m-0.2.1-img-1.7
+ * configure, XMakefile が patch に入って無かった。
+ * 画像を表示しない場合の処理をオリジナルに近づけた。
+ * [w3m-dev 02121] に対応。
+
+2001/07/27 w3m-0.2.1-img-1.6
+ * README.img を doc-jp へ移動。doc/README.img を作成。
+ * インライン画像対応部分を USE_IMAGE マクロで分離。
+ * configure でインライン画像対応を選択できる様にした。
+ * configure で Imlib をチェックする様にした。
+
+2001/07/26 w3m-0.2.1-img-1.5
+ * w3mimgdisplay は必要になるまで立ち上げない様にした。
+ * w3mimgdisplay が落ちた時に、w3mimgdisplay を再立ち上げできる様にした。
+ * <img align=middle の場合の計算間違いの修正。
+ * [w3m-dev 02118] に対応。
+ * funcname.tab が間違っていたので修正。
+
+2001/07/25 w3m-0.2.1-img-1.4
+ * w3mimgdisplay を環境変数 WINDOWID を見る様に改良。
+ また、text window の推量部分も改良。
+ * image タグを img タグと同じものとして追加。
+ * [w3m-dev 02090], [w3m-dev 02097] に対応。
+
+2001/07/14 w3m-0.2.1-img-1.3
+ * ext_image_viewer が OFF の場合は画像を直接フレーム表示可能にした。
+ * Option Panel が SEGV するバグの修正。
+
+2001/07/13 w3m-0.2.1-img-1.2
+ * 画像のスケールを指定出来る様にした。
+ * SIGUSR1 のブロックに関する修正。
+
+2001/07/12 w3m-0.2.1-img-1.1
+ * キー入力中以外は SIGUSR1, SIGWINCH をブロックする様にした。
+ * バグ修正。
+
+2001/07/11 w3m-0.2.1-img-1.0
+ * MGL 版の画像読み込みを採用。
+
+2001/07/10 w3m-0.2.1-img-0.5
+ * 描画の高速化。w3mimgdisplay で不要な XSync() を止めた。
+ 不要な drawImage() を止めた。
+
+2001/07/08 w3m-0.2.1-img-0.4
+ * w3mimgdisplay での Window の取得や offset_x のデフォルト値の改良。
+ * <img align=middle の場合の計算間違いの修正。
+ * <img align=left|center|right では <div>〜</div> を使う様にしてみた。
+ * w3mimgdisplay では SIGINT を無視する様にした。
+ * w3mimgsize もオプション設定できる様にした。
+
+2001/07/07 w3m-0.2.1-img-0.3
+ * kterm に限らず、X11 上の端末では画像を描画できる様にした。
+
+2001/07/06 w3m-0.2.1-img-0.2
+ * README.img を作成。
+ * kterm-6.2.0-img-0.2.patch を w3m-0.2.1-img-0.2.patch に含める様にした。
+ * コードの整理、安全側への修正
+
+2001/07/04 w3m-0.2.1-img-0.1
+ * バージョン管理開始。
+ * Imlib 対応版。
+
+2001/06/30
+ * XPM 版でほぼ実装完了。
+
+2001/06/19
+ * MGL 版に刺激を受けて img への対応のテストを開始。
+
+-----------------------------------
+坂本 浩則 <hsaka@mth.biglobe.ne.jp>
+ http://www2u.biglobe.ne.jp/~hsaka/
diff --git a/doc/README.func b/doc/README.func
index 23a2f3e..024cfc1 100644
--- a/doc/README.func
+++ b/doc/README.func
@@ -10,6 +10,7 @@ COOKIE View cookie list
DELETE_PREVBUF Delete previous buffer (mainly for local-CGI)
DICT_WORD Execute dictionary command (see README.dict)
DICT_WORD_AT Execute dictionary command for word at cursor
+DISPLAY_IMAGE Restart loading and drawing of images
DOWN Scroll down one line
DOWNLOAD Save document source to file
EDIT Edit current document
@@ -99,6 +100,7 @@ SHELL Execute shell command
SHIFT_LEFT Shift screen left
SHIFT_RIGHT Shift screen right
SOURCE View HTML source
+STOP_IMAGE Stop loading and drawing of images
SUBMIT Submit form
SUSPEND Stop loading document
UP Scroll up one line
diff --git a/doc/README.img b/doc/README.img
new file mode 100644
index 0000000..569c612
--- /dev/null
+++ b/doc/README.img
@@ -0,0 +1,189 @@
+
+Inline image support of w3m
+ 2002/01/31
+ H. Sakamoto
+
+Introduction
+
+ This is the extension for w3m to support inline image.
+ The patch for w3m-0.2.4 is available on the following site.
+
+ http://www2u.biglobe.ne.jp/~hsaka/w3m/index.html#img
+ patch/w3m-0.2.4-2.2.patch.gz
+ patch/README.img
+
+Support
+
+ * Display inline image (GIF,PNG,JPEG, etc.) on terminals
+ (xterm,rxvt, etc.) of X11.
+ * Support inline image of <img> tag.
+ Support of attributes "width", "height", and "align".
+ * Direct display of image file which header is "Content-type: image/*"
+ * Support of <map> tag.
+ Support of attributes "shape" and "coords" of <area> tag.
+ * Support of an attribute "ismap" of <img> tag.
+ "w3m" adds coordinate of the cursor as ?<x>,<y> to url, and sends url.
+ * Support of an attribute "type=image" of <input> tag.
+ "w3m" sends coordinate of the cursor as <name>.x=<x>&<name>.y=<y>.
+ * Asynchronous loading of image files.
+ * Using cache of image file as pixmap.
+
+Key functions
+
+ DISPLAY_IMAGE
+ Restart loading and drawing of images.
+ STOP_IMAGE
+ Stop loading and drawing of images in the current buffer.
+ SET_OPTION display_image=toggle
+ Toggle loading and drawing of images.
+
+ These functions are not keybinded as default.
+ Specify the following keymaps in ~/.w3m/keymap.
+ keymap X DISPLAY_IMAGE
+ keymap C-c STOP_IMAGE
+ keyamp t SET_OPTION display_image=toggle
+
+Comandline options
+
+ -ppc <pixel>
+ # of pixels per character. The default value is automatically
+ detected. Must fit the width of font of terminal.
+ -ppl <pixel>
+ # of pixels per character. The default value is automatically
+ detected. Must fit the height of font of terminal.
+
+Option panel
+
+ pixel_per_char
+ # of pixels per character. The default value is automatically
+ detected. Must fit the width of font of terminal.
+ pixel_per_line
+ # of pixels per character. The default value is automatically
+ detected. Must fit the height of font of terminal.
+ display_image
+ Display of inline image. The default is ON.
+ auto_image
+ Automatic loading of inline image. The default is ON.
+ If it is OFF, loading starts with a command DISPLAY_IMAGE.
+ ext_image_viewer
+ Use external image viewer, when a command VIEW_IMAGE or
+ view of image file which header is "Content-type: image/*".
+ The default is ON. If it is OFF, the image is directly displaied.
+ image_scale
+ Scale of image (%). The default value is 100(%).
+ imgdisplay
+ External command to display image". The default value is "w3mimgdisplay".
+ See "Setting w3mimgdisplay".
+ imgsize
+ External command to get size of image. The default value is "w3mimgsize".
+
+Required programs
+
+ * w3m-0.2.4
+ http://w3m.sourceforge.net/
+ http://sourceforge.net/projects/w3m/
+ http://prdownloads.sourceforge.net/w3m/
+ * Imlib-1.9.8 (1.9.10 is recommendable.)
+ libungif-4.1.0b1 is recommendable.
+
+Install
+
+ gunzip -c DIST/w3m-0.2.4.tar.gz | tar -xvf -
+ cd w3m-0.2.4
+ gunzip -c DIST/w3m-0.2.4-img-2.2.patch.gz | patch -p1
+ configure
+ # When you are asked "Inline image support (you need Imlib library)",
+ # answer "y".
+ # Select menu.
+ make
+ # To make "w3mimgdisplay" and "w3mimgsize", Imlib is required.
+ make install
+ # Must install "w3mimgdisplay" and "w3mimgsize" to $LIB(PREFIX/lib/w3m).
+
+Setting w3mimgdisplay
+
+ "w3mimgdisplay" has the following options. Set options to fit terminal.
+
+ -x <offset_x>
+ The X origin of display of image on terminal. The default value is 2.
+ If the terminal is "xterm", the width of scroll bar is added.
+ If the terminal is "Eterm", it may be better to specify 5.
+ -y <offset_y>
+ The Y origin of display of image on terminal. The default value is 2.
+ If the terminal is "Eterm", it may be better to specify 5.
+ -bg <background>
+ Background color of terminal. The default value is automatically
+ detected. When the color is specified as #RRGGBB, escape '#'.
+
+ ex.)
+ w3m -o 'imgdisplay=w3mimgdisplay -x 5 -bg "#cccccc"'
+
+Change log
+
+2002/01/31 w3m-0.2.4-img-2.2
+ * Based on w3m-0.2.4+cvs-1.278.
+
+2002/01/29 w3m-0.2.4-img-2.1
+ * Based on w3m-0.2.4+cvs-1.268.
+
+2002/01/28 w3m-0.2.4-img-2.0
+ * Based on w3m-0.2.4+cvs-1.265.
+ * pixel_per_char and pixel_per_line are automatically detected.
+ * The bckground color of terminal is automatically detected.
+ * The source code to display images is moved to image.c
+
+2002/01/08 w3m-0.2.4-img-1.18
+ * Based on w3m-0.2.4
+
+2001/12/29 w3m-0.2.3.2-img-1.17
+ * Based on w3m-0.2.3.2+cvs-1.196.
+
+2001/12/25 w3m-0.2.3.2-img-1.16.1
+ * [w3m-dev 02698] Thanks > Kazuhiko-san
+
+2001/12/22 w3m-0.2.3.2-img-1.16
+ * Based on w3m-0.2.3.2.
+
+2001/12/20 w3m-0.2.3.1-img-1.15
+ * Based on w3m-0.2.3.1.
+ * Support display of image with Content-Transfer-Encoding.
+
+2001/11/29
+ * Start merge against CVS source (ChangeLog 1.71)
+
+2001/11/17 w3m-0.2.2-img-1.14
+ * Based on w3m-0.2.2.
+
+2001/11/14 w3m-0.2.1-inu-1.6-img-1.13
+ * Based on w3m-0.2.1-inu-1.6.
+
+2001/11/05 w3m-0.2.1-inu-1.5-img-1.12
+ * Based on w3m-0.2.1-inu-1.5.
+ * Fixed the bug for <area>, <map>.
+ * Fixed the problem with xwnmo on kterm.
+
+2001/10/03 w3m-0.2.1-inu-1.4-img-1.11
+ * Based on w3m-0.2.1-inu-1.4.
+ * Fixed bug when reading from stdin.
+ * Fixed "configure". Thanks > Fukagawa-san.
+
+2001/08/01 w3m-0.2.1-img-1.10
+ * Adjust image position.
+ * Fixed scaling image.
+
+2001/07/31 w3m-0.2.1-img-1.9
+ * Fixed initImgdisplay(). Thanks > David.
+
+2001/07/29 w3m-0.2.1-img-1.8
+ * Fixed "configure".
+
+2001/07/28 w3m-0.2.1-img-1.7
+ * Sorry, w3m-0.2.1-img-1.6 is not complete.
+ * Added "configure" and "Makefile" to the patch.
+
+2001/07/27 w3m-0.2.1-img-1.6
+ * Created doc/README.img.
+
+-------------------------------------------
+Hironori Sakamoto <hsaka@mth.biglobe.ne.jp>
+ http://www2u.biglobe.ne.jp/~hsaka/