w3m マニュアル

伊藤 彰則
aito@fw.ipsj.or.jp

もくじ

  • はじめに
  • 起動オプション
  • 文書の表示内容
  • 起動後の使いかた(オリジナル)
  • 起動後の使いかた(Lynx風)
  • マウス操作
  • キーの定義
  • Local CGI

    • はじめに

    w3m は，テキストベースのページャ/WWWブラウザです．これを使うと，kterm などのキャラクタ 端末上で，ローカルファイルを見たり，WWWの内容を見たりすることができます．

    起動オプション

    起動時の引数は次の通りです． 

        w3m [options] [file|URL]

    引数にファイル名を指定すればそのファイルを表示し，URLを指定すればその内容を表示します． 何も指定しなければ，標準入力の内容を表示します．ただし，標準入力が tty である場合には， 何もせずに終了します．

    オプションは次の通りです．

    +番号
    起動後，指定の行番号に移動する．
    -t 幅
    タブの幅を指定する．デフォルトは 8 ．
    -r
    text/plain の文書を表示する場合，重ね打ちによる強調文字を表示しない． このオプションを付けない場合，``A^H_''はAのアンダーラインとして表示され， ``A^HA''はAのボールドとして表示される．
    -l 行数
    標準入力の内容を表示するときに保存される最大行数を指定す る．デフォルトは 10000．
    -O 文字コード
    表示に用いる文字コードを指定する．
    -I 文字コード
    入力文書の文字コードを指定する．
    -T タイプ
    表示する文書のタイプを指定する．この指定がない場合，ファイル 名の拡張子によって自動判別される．判別できない場合は text/plain とみなされる．

    例：
    標準入力から HTML ファイルを読んで表示する 

       cat hoge.html | w3m -T text/html

    HTMLファイルのソースを表示する 

       w3m -T text/plain hoge.html
    -m
    Internet message モードで表示する．Internet messageモードの場合， ヘッダの内容を見て，Content-Type: があればそれを参考にする．電子メールや ネットニュースの記事を読むときに便利．
    -v
    スタートアップページを表示する．
    -B
    Bookmark を表示する．
    -bookmark file
    Bookmarkのファイルを指定する．
    -M
    カラー表示をしない．
    -F
    フレームを自動表示する．
    -s
    連続する空行を1行にまとめて表示する．
    -X
    w3m終了時に，以前の画面に戻らない．
    -W
    折り返しサーチを使うかどうかを切りかえる．
    -o option=value
    オプションを指定する． オプションの名前や値は，~/.w3m/config で指定するものと同じ．
    -no-proxy
    プロキシを利用しない．
    -no-mouse
    マウスを利用しない．
    -cookie
    クッキーを処理する．
    -no-cookie
    クッキーを処理しない．
    -num
    行番号を表示する．
    -dump
    URLの内容を読みこみ，整形されたバッファの内容を標準出力に書き出す． 文書の幅は80桁と仮定される．この幅は，次の -cols オプションで変更可能．
    -cols 幅
    -dump オプションを使う場合に，文書の幅を指定する．
    -ppc ピクセル数
    文字の幅を指定する．デフォルトはウインドウの大きさから自動的に計算する．
    -ppl ピクセル数
    文字の縦幅を指定する．デフォルトはウインドウの大きさから自動的に計算する．
    -dump_source
    URLの内容を読みこみ，整形せずに標準出力に書き出す． 漢字コード変換もされない．
    -dump_head
    URLにアクセスし，ヘッダ情報を出力する．
    -dump_both
    URLにアクセスし，ヘッダ情報とHTMLソースを出力する．
    -dump_extra
    URLにアクセスし，拡張情報とヘッダ情報とHTMLソースを出力する．
    -post file
    ファイルの内容をPOSTする．
    -header string
    HTTP要求ヘッダを追加する．
    -config file
    configのファイルを指定する．

    文書の表示内容

    HTML文書を表示しているときには，次のような表示になります．
    カラー表示時白黒表示時
    リンク青色下線
    インライン画像緑色反転表示
    FORMの入力部分赤色反転表示
    カラー表示時の色は，オプション設定パネル "o" で変更することができます．

    起動後の使いかた(オリジナル)

    起動した後は，1文字のコマンドをキーボードから入力することでw3mを操作します． コマンドには次のようなものがあります．以下の記述では，C-x はコントロールx を表します．また，SPC はスペースバー，RET はリターンキー，ESC はエスケープキーです．

    ここで書いてあるのは，オリジナル版のキー操作です．Lynx風のキー操作用に コンパイルしてあるものについては，起動後の使い方(Lynx風) をごらんください．

    ページ/カーソル移動

    SPC,C-v次のページを表示します．
    b,ESC v前のページを表示します．
    l,C-f,右矢印キーカーソルを右に移動します．
    h,C-b,左矢印キーカーソルを左に移動します．
    j,C-n,下矢印キーカーソルを下に移動します．
    k,C-p,上矢印キーカーソルを上に移動します．
    J画面を1行上にスクロールします．
    K画面を1行下にスクロールします．
    ^,C-a行頭に移動します．
    $,C-e行末に移動します．
    w次の単語に移動します．
    W前の単語に移動します．
    >画面全体を右にずらします．(表示内容を左にずらす)
    <画面全体を左にずらします．(表示内容を右にずらす)
    .画面全体を1文字右にずらします．(表示内容を左にずらす)
    ,画面全体を1文字左にずらします．(表示内容を右にずらす)
    g,M-<文書のいちばん上の行に移動します．
    G,M->文書のいちばん下の行に移動します．
    ESC g画面下で行番号を入力し，そこで指定した行に移動します． ここで $ を入力すると，最終行に移動します．
    Zカーソルのある位置を行の中央に移動します．
    zカーソルのある行を画面の中央に移動します．
    TAB次のリンクに移動します．
    C-u, ESC TAB前のリンクに移動します．
    [最初のリンクに移動します．
    ]最後のリンクに移動します．

    ハイパーリンク操作

    RET現在カーソルがあるリンクが指す先の文書を読みこみます．
    a, ESC RET現在カーソルがあるリンクが指す先の文書をファイルに保存します．
    u現在カーソルがあるリンクが指す先のURLを表示します．
    iリンクに関連付けられた画像へのURLの表示します．
    I現在カーソルがあるリンクに対応する画像を表示します．
    ESC I現在カーソルがあるリンクが指す 画像をファイルに保存します．
    :URL風の文字列をリンクにします．この機能は，HTMLでない文書を 読んでいるときにも有効です．
    ESC :Message-ID風の文字列を，news: のリンクにします．この機能は，HTMLでない文書を 読んでいるときにも有効です．
    c現在の文書のURLを表示します．
    =現在の文書に関する情報を表示します．
    C-gページ中での現在位置を表示します．
    C-hURL履歴を表示します．
    F<FRAMESET>を含む文書を表示しているときに，<FRAME> タグの指す複数の文書を1つの文書に変換して表示します．
    M現在見ているページを，外部ブラウザを使って表示します． 2M, 3M, ..., 9M で2番目，3番目，9番目のブラウザを使います．
    ESC M現在のリンク先を，外部ブラウザを使って表示します． 2ESC M, 3ESC M, ..., 9ESC M で2番目，3番目，9番目のブラウザを使います．

    ファイルとURL関係の操作

    UURLを指定して開きます．
    Vローカルファイルを指定して開きます．
    @コマンドを実行し，結果を全部読んでから表示します．
    #コマンドを実行し，結果を読みこみながら表示します．

    バッファ操作

    B現在見ているバッファを削除し，一つ前のバッファを表示します．
    vHTMLのソースを表示します．
    sバッファ選択モードに入ります．
    E現在見ているバッファがローカルファイルの場合，そのファイルをエディタ で編集します．エディタを終了した後，そのファイルを再度読み込みます．
    C-l画面を再描画します．
    Rバッファを再度読み込みます．
    Sバッファの表示内容をファイルに保存します．
    ESC sHTMLのソースをファイルに保存します．v でソースを表示して S で 保存するのとほぼ同じですが，ESC s で保存したファイルは漢字コードがオリジナルの ままであるのに対して，v S で保存すると現在表示に使っている漢字コードに変換され て保存されます．
    ESC e現在表示されているバッファを，表示されている形式のまま エディタで編集します．

    バッファ選択モード

    "s" でバッファ選択モードに入ったときのキー操作です．
    k,C-p一つ上のバッファを選択します．
    j,C-n一つ下のバッファを選択します．
    D現在選択しているバッファを削除します．
    RET現在選択しているバッファを表示します．

    ブックマーク操作

    ESC bブックマークを読み込みます．
    ESC a現在見ているページをブックマークに追加します．

    検索

    /,C-s現在のカーソル位置からファイル末尾に向かって正規表現を検索します．
    ?,C-r現在のカーソル位置からファイルの先頭に向かって正規表現を検索します．
    n次を検索します．
    N前を検索します．
    C-w折り返し検索モードを切り換えます．

    マーク操作

    C-SPCマークを設定／解除します．マークは反転表示されます．
    ESC p一つ前のマークに移動します．
    ESC n一つ後のマークに移動します．
    "正規表現で指定された文字列を全てマークします．

    その他

    !シェルコマンドを実行します．
    Hヘルプファイルを表示します．
    oオプション設定パネルを表示します．
    C-kクッキー一覧を表示します．
    C-c文書の読み込みを中断します．
    C-zサスペンド
    qw3mを終了します．オプションの設定によって，終了するかどうか確認します．
    Q確認せずにw3mを終了します．

    行編集

    画面の最下行で文字列を入力する場合に有効なキー操作です．
    C-fカーソルを右に移動します．
    C-bカーソルを左に移動します．
    C-hカーソルの直前の文字を削除します．
    C-dカーソル位置の文字を削除します．
    C-kカーソル位置から後を削除します．
    C-uカーソル位置から前を削除します．
    C-a文字列の先頭に移動します．
    C-e文字列の最後に移動します．
    C-pヒストリから一つ前の文字列を取り出します．
    C-nヒストリから次の文字列を取り出します．
    TAB,SPCファイル名入力時に，ファイル名を補完します．
    RETURN入力を終了します．

    起動後の使いかた(Lynx風)

    Lynx風キーバインドでコンパイルした場合の使いかたです．

    ページ/カーソル移動

    SPC,C-v,+次のページを表示します．
    b,ESC v,-前のページを表示します．
    lカーソルを右に移動します．
    hカーソルを左に移動します．
    jカーソルを下に移動します．
    kカーソルを上に移動します．
    J画面を1行上にスクロールします．
    K画面を1行下にスクロールします．
    ^行頭に移動します．
    $行末に移動します．
    >画面全体を右にずらします．(表示内容を左にずらす)
    <画面全体を左にずらします．(表示内容を右にずらす)
    C-a文書のいちばん上の行に移動します．
    C-e文書のいちばん下の行に移動します．
    G画面下で行番号を入力し，そこで指定した行に移動します． ここで $ を入力すると，最終行に移動します．
    Zカーソルのある位置を行の中央に移動します．
    zカーソルのある行を画面の中央に移動します．
    TAB, C-n, 下矢印次のリンクに移動します．
    ESC TAB, C-p, 上矢印前のリンクに移動します．
    C-gページ中での現在位置を表示します．

    ハイパーリンク操作

    RET, C-f, 右矢印現在カーソルがあるリンクが指す先の文書を読みこみます．
    d, ESC RET現在カーソルがあるリンクが指す先の文書をファイルに保存します．
    u現在カーソルがあるリンクが指す先のURLを表示します．
    i現在カーソルがあるリンクを含む画像そのもののURLを表示します．
    I現在カーソルがあるリンクに対応する画像を表示します．
    ESC I現在カーソルがあるリンクが指す画像をファイルに保存します．
    :URL風の文字列をリンクにします．この機能は，HTMLでない文書を 読んでいるときにも有効です．
    ESC :Message-ID風の文字列を，news: のリンクにします．この機能は，HTMLでない文書を読んでいるときにも有効です．
    c現在の文書のURLを表示します．
    =現在の文書に関する情報を表示します．
    C-hURL履歴を表示します．
    F<FRAMESET>を含む文書を表示しているときに，<FRAME> タグの指す複数の文書を1つの文書に変換して表示します．
    M現在見ているページを，外部ブラウザを使って表示します． 2M, 3M, ..., 9M で2番目，3番目，9番目のブラウザを使います．
    ESC M現在のリンク先を，外部ブラウザを使って表示します． 2ESC M, 3ESC M, ..., 9ESC M で2番目，3番目，9番目のブラウザを使います．

    ファイルとURL関係の操作

    g, UURLを指定して開きます．
    Vローカルファイルを指定して開きます．
    @コマンドを実行し，結果を全部読んでから表示します．
    #コマンドを実行し，結果を読みこみながら表示します．

    バッファ操作

    B, C-b, 左矢印現在見ているバッファを削除し，一つ前のバッファを表示します．
    \HTMLのソースを表示します．
    sバッファ選択モードに入ります．
    E現在見ているバッファがローカルファイルの場合，そのファイルをエディタで編集します．エディタを終了した後，そのファイルを再度読み込みます．
    C-l, C-w画面を再描画します．
    R, C-rバッファを再度読み込みます．
    S, pバッファの表示内容をファイルに保存します．
    ESC sHTMLのソースをファイルに保存します．v でソースを表示して S で 保存するのとほぼ同じですが，ESC s で保存したファイルは漢字コードがオリジナルの ままであるのに対して，v S で保存すると現在表示に使っている漢字コードに変換され て保存されます．
    ESC e現在表示されているバッファを，表示されている形式のまま エディタで編集します．

    バッファ選択モード

    "s" でバッファ選択モードに入ったときのキー操作です．
    k,C-p一つ上のバッファを選択します．
    j,C-n一つ下のバッファを選択します．
    D現在選択しているバッファを削除します．
    RET現在選択しているバッファを表示します．

    ブックマーク操作

    v, ESC bブックマークを読み込みます．
    a, ESC a現在見ているページをブックマークに追加します．

    検索

    /,C-s現在のカーソル位置からファイル末尾に向かって正規表現を検索します．
    n次を検索します．
    w折り返し検索モードを切り換えます．

    マーク操作

    C-SPCマークを設定／解除します．マークは反転表示されます．
    P一つ前のマークに移動します．
    N一つ後のマークに移動します．
    "正規表現で指定された文字列を全てマークします．

    その他

    !シェルコマンドを実行します．
    H, ?ヘルプファイルを表示します．
    oオプション設定パネルを表示します．
    C-kクッキー一覧を表示します．
    C-c文書の読み込みを中断します．
    C-zサスペンド
    qw3mを終了します．オプションの設定によって，終了するかどうか確認します．
    Q確認せずにw3mを終了します．

    行編集

    画面の最下行で文字列を入力する場合に有効なキー操作です．
    C-fカーソルを右に移動します．
    C-bカーソルを左に移動します．
    C-hカーソルの直前の文字を削除します．
    C-dカーソル位置の文字を削除します．
    C-kカーソル位置から後を削除します．
    C-uカーソル位置から前を削除します．
    C-a文字列の先頭に移動します．
    C-e文字列の最後に移動します．
    SPCファイル名入力時に，ファイル名を補完します．
    RETURN入力を終了します．

    マウス操作

    マウス機能をONにしてコンパイルしてあれば，マウスを使って w3mを操作することができます．マウスが使えるのは，xterm/kterm/rxvt を使っている場合(この場合には，環境変数TERMを xterm か kterm に 設定する必要があります)，または GPM が動いている環境を使っている場合 です．

    左クリック カーソルをマウスカーソルの位置に移動します． もしカーソルとマウスカーソルの位置が同じで，カーソルが リンクの上にあったときは，そのリンクをたどります．
    中クリック 前のバッファに戻ります．
    右クリック メニューを開きます．メニューの項目もマウスで選ぶことができます．
    左ドラッグ ページをスクロールします．デフォルトの動作では， マウスのドラッグに合わせて文書の方をスクロールします． オプション設定パネルの設定で，この動作を逆にすること ができます(マウスのドラッグに合わせて，ウィンドウの方を スクロールする)．

    キーの定義

    ~/.w3m/keymap を記述すると，キーの割りあてを変えることができます (行編集のキー定義を除く)．例えば， 
    
   keymap C-o NEXT_PAGE
    と記述すると，NEXT_PAGE機能(通常スペースと C-v)に割りあてられて いるもの)を C-o に割りあてることができます． 利用可能な機能と，その名前については， README.funcを参照してください． 例として，オリジナルとLynx風のキー定義ファイル (keymap.default とkeymap.lynx)が置いてあります．

    Local CGI

    w3mを使えば，HTTPサーバなしでCGIスクリプトを起動することができます． このとき，w3mがサーバのふりをしてスクリプトを起動し，その出力を 読みこんで表示するわけです． ブックマークの登録と外部ビューアの編集 は，local CGIのスクリプトとして実現されています． local CGIを使えば，w3mを汎用のフォーム入力インタフェースとして 使うことができます．

    セキュリティ上の理由により，起動するCGIスクリプトは，次のどれかの ディレクトリにある必要があります．

    Local CGIとして使われるスクリプトでは，w3mをコントロールするために， 特殊なヘッダ `w3m-control:' を使うことができます．このヘッダには， w3mの任意の機能 (README.func参照)を書く ことができます．文書が表示された後，その機能が呼び出されます． 例えば， 

    
Content-Type: text/plain
W3m-control: BACK
    というヘッダを出力した場合，w3mは空のページを表示し，その直後に そのバッファを削除します．これは，CGIを実行した後で，何もページを 表示したくない場合に有効です．また， 
    
Content-Type: text/plain
W3m-control: DELETE_PREVBUF

contents.....
    は，新しいバッファで直前のバッファを置きかえます．

    一つの w3m-control: ヘッダには，一つの機能だけを指定することができます． ただし，HTTPレスポンスの中に複数の w3m-control: を入れることができ， そこで指定された機能は順番に実行されます． さらに，GOTO には引数を指定することができます． 

    
Content-Type: text/plain
W3m-control: GOTO http://www.yahoo.com/
    この例は，Location: を使った次の例と同じように動作します． 
    
Content-Type: text/plain
Location: http://www.yahoo.com/
    ただし，w3m-control: ヘッダはw3mがスクリプトを直接呼びだした時だけに 有効です．同じスクリプトを HTTPサーバ経由で呼びだした場合， w3m-control: ヘッダは無視されます．