bibi/src/w3m.html

227 行
9.9 KiB
HTML

<title>w3mの紹介 - 美々蝶々</title>
<h1>w3mの紹介</h1>
<ul>
<li>2023-07-02 (陰暦05月15日) たかし</li>
<li>「OpenBSD 7.3」「w3m/0.5.3+git20230121」</li>
</ul>
<h2></h2>
<p>w3m はターミナル上で動作する<a href="https://wiki.froth.zone/wiki/%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%83%96%E3%83%A9%E3%82%A6%E3%82%B6?lang=ja">テキストブラウザー</a>です。筆者は w3m を每日使用してゐます。</p>
<p>w3m の特徴は次の通りです。</p>
<ul>
<li>CSS、JS、音聲、動畫には非對應</li>
<li>畫像を見るには外部ビューワーが必要 (nsxiv、display など)</li>
<li>畫像對應版の w3m-img もあるが動作は不安定</li>
<li>タブブラウズは不便。HTML の讀み込み中に別タブを表示できない (w3m を複數起動すれば良い)</li>
<li>ブックマークは單純な HTML 形式で保存される</li>
</ul>
<p>以下の説明は原則として<strong>初期設定のままの狀態</strong>を前提にしてゐます。</p>
<h2>1. 基本的な使用方法</h2>
<p>詳しくは、<a href="https://w3m.sourceforge.net/MANUAL.ja.html">w3m manual</a> に書いてあります。</p>
<h3>1.1. コマンドラインからの起動</h3>
<dl>
<dt>通常起動</dt>
<dd><samp>$ <kbd>w3m -v</kbd></samp></dd>
<dt>URL を開く</dt>
<dd><samp>$ <kbd>w3m https://example.com/</kbd></samp></dd>
<dt>ブックマークを開く</dt>
<dd><samp>$ <kbd>w3m -B</kbd></samp></dd>
<dd><strong>* ファイル「<code>~/.w3m/bookmark.html</code>」が必要</strong></dd>
</dl>
<h3>1.2. 基本操作</h3>
<p>完全な一覽は「<kbd>q</kbd>」を入力して表示される「w3m help page」を確認してください。また<strong><kbd>Alt</kbd>」は「<kbd>Esc</kbd>」で代用できます。</strong></p>
<ul>
<li><kbd>カーソルキー</kbd>」 -- <strong>カーソルを移動する</strong></li>
<li><kbd>Tab キー</kbd>」 -- カーソルを次のリンクに移動する</li>
<li><kbd>Shift + Tab キー</kbd>」 -- カーソルを前のリンクに移動する</li>
</ul>
<ul>
<li><kbd>エンターキー</kbd>」 -- <strong>リンクを開く</strong>/フォーム入力を開始する/ボタンをクリックする
<li><kbd>u</kbd>」 -- リンク先のURLを確認する</li>
<li><kbd>I</kbd>」(IMG要素上) -- 畫像を外部ビューワーで開く</li>
<li><kbd>i</kbd>」(IMG要素上) -- 畫像の URL を確認する</li>
</ul>
<ul>
<li><kbd>Shift + U</kbd>」 -- <strong>URL の入力を開始する</strong></li>
<li><kbd>Ctrl + u</kbd>」(URL の入力中) -- URL を空にする</li>
</ul>
<ul>
<li><kbd>Shift + B</kbd>」 -- <strong>もどる</strong></li>
<li><kbd>Ctrl + l (エル)</kbd>」 -- 再描畫する (表示の崩れを直す)</li>
</ul>
<ul>
<li><kbd>Alt + a</kbd>」 -- 表示中の文書をブックマークに追加する</li>
<li><kbd>Alt + b</kbd>」 -- ブックマーク畫面を表示する</li>
</ul>
<ul>
<li><kbd>/</kbd>」 -- <strong>文書内檢索 (前方)</strong></li>
<li><kbd>?</kbd>」 -- ページ内檢索 (後方)</li>
</ul>
<ul>
<li><kbd>Shift + H</kbd>」 -- w3m の操作方法を表示する (w3m help page)</li>
<li><kbd>o</kbd>」 -- w3m の設定畫面を表示する (Option Setting Panel)</li>
<li><kbd>v</kbd>」 -- HTML のソースコードを表示する</li>
<li><kbd>q</kbd>」の後に「<kbd>y</kbd>」 -- <strong>w3m を終了する</strong></li>
</ul>
<h2>2. 設定</h2>
<h3>2.1. 設定畫面の項目</h3>
<p>個人的におすすめな設定を紹介します。</p>
<dl>
<dt>テキストエディターを指定 (ブックマーク編輯などに使用)</dt>
<dd>「Editor」 → 「<kbd>nano -S</kbd></dd>
<dt>履歴を無效化</dt>
<dd>「Use URL history」 → 「<kbd>NO</kbd></dd>
<dd>「Save URL history」 → 「<kbd>NO</kbd></dd>
<dt>HTTPヘッダーをFirefox風に (お好みで)</dt>
<dd>「User-Agent identification string」 → 「<kbd>Mozilla/5.0 (Windows NT 10.0; rv:<strong>109.0</strong>) Gecko/20100101 Firefox/<strong>115.0</strong></kbd></dd>
<dd>「Accept-Language header」 → 「<kbd>en-US,en;q=0.5</kbd></dd>
<dd>「Accept-Encoding header」 → 「<kbd>gzip, deflate</kbd></dd>
<dd>「Accept header」 → 「<kbd>text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8</kbd></dd>
<dt>Refererを無效化</dt>
<dd>「Suppress `Referer:' header」 → 「<kbd>YES</kbd></dd>
<dt>一部のドメインだけでCookieを許可</dt>
<dd>「Enable cookie processing」 → 「<kbd>YES</kbd></dd>
<dd>「Accept cookies」 → 「<kbd>YES</kbd></dd>
<dd>「Domains to reject cookies from」 → 「<kbd>.</kbd></dd>
<dd>「Domains to accept cookies from」 → 「<kbd>social.076.moe,www.gnu.org</kbd>」(カンマ區切りで複數指定可能)</dd>
</dl>
<h3>2.2.外部ビューワー</h3>
<p>テキスト以外のファイルを開くための外部ビューワーはファイル「<code>~/.w3m/mailcap</code>」で指定します。ファイルが無ければ作成してください。</p>
<p>構文は「<code><strong>MIMEタイプ</strong>; <strong>コマンド</strong></code>」です。コマンド内の「<var>%s</var>」はファイル名に置換されます。改行すれば複數の設定を記入できます。</p>
<dl>
<dt>mailcapの例 (nsxivで開く)</dt>
<dd><code><strong>image/*</strong>; <strong>nsxiv</strong> <var>%s</var></code></dd>
</dl>
<h2>3. TorやI2Pへの接續</h2>
<p>事前に次の daemon を導入して有效にします。</p>
<ul>
<li>tor</li>
<li>torsocks</li>
<li>i2pd (HTTP プロキシーを有效化、ポートを4444に設定)</li>
</ul>
<dl>
<dt>Torに接續</dt>
<dd><samp>$ <kbd>torsocks w3m -v</kbd></samp></dd>
<dt>I2Pに接續</dt>
<dd><samp>$ <kbd>w3m -o http_proxy=http://127.0.0.1:4444/ -o https_proxy=http://127.0.0.1:4444/ -v</kbd></samp></dd>
<dd><strong>* この狀態で設定畫面から設定を變へると、プロキシサーバーの設定値が上書きされる</strong></dd>
</dl>
<p>alias を設定すると便利です。</p>
<dl>
<dt>.kshrc、.bashrc、.zshrcなどに追記</dt>
<dd><code>alias tsw3m='torsocks w3m'<br>
alias w3m-i2p='w3m -o http_proxy=http://127.0.0.1:4444/ -o https_proxy=http://127.0.0.1:4444/'</code></dd>
</dl>
<h2>4. ブックマーク管理</h2>
<ul>
<li>ブックマーク登録時の項目は「Section」「URL」「Title」
<ul>
<li>「Section」が未指定だと「Miscellaneous」に分類される</li>
<li>新しい section を作るには「New Section」欄に名前を入力する</li>
</ul>
</li>
<li><strong>w3m 自體ではブックマークの編輯や削除ができない</strong></li>
<li>ブックマークを編輯するには、ブックマークの HTML (<code>~/.w3m/bookmark.html</code>)を直接編修する</li>
<li>ブックマークの表示中に「<kbd>Alt + e</kbd>」で、上記ファイルをテキストエディターで開ける</li>
</ul>
<h2>5. 文字化けの直し方</h2>
<p>w3m はエンコーディングを自動判別しないのか、日本語の文字化けが多いです。直し方は次の通りです。</p>
<ol>
<li><kbd>+</kbd>」を入力 -- 「Information about current page」が開く</li>
<li>「Document Charset」を「Japanese (Shift_JIS, CP932)」とか「Japanese (EUC-JP)」とかに變更する</li>
<li>「Change」にカーソルを乘せて「<kbd>エンターキー</kbd></li>
</ol>
<h2>6. 隱し機能</h2>
<p>w3m のデフォルトのキーバインドでは使用できない機能があります。「w3m help page」の中で、「&lt;NOT ASSIGNED&gt;」と書かれた物がそれです。</p>
<p><kbd>Alt + c</kbd>」の後に機能名を<strong>大文字で</strong>入力すると、その機能を呼び出せます。例をいくつか擧げます。</p>
<dl>
<dt><kbd>SUBMIT</kbd></dt>
<dd>フォームを送信する (送信ボタンの無いフォームにも有效)</dd>
<dt><kbd>CHARSET <strong>cp932</strong></kbd></dt>
<dd>現在のページのエンコーディングを <strong>cp932</strong> にする</dd>
</dl>
<h2>細かい注意點</h2>
<ul>
<li>A 要素の中にブロック要素 (DIV、LI など) が入ると正しく解釈されない</li>
<li>DD 要素の閉ぢタグが省略された場合に正しく解釈されない (ディストロ次第?)</li>
<li>HTML に繪文字が含まれると表示が崩れる?</li>
<li>TITLE 要素が存在しない、または、内容が空の場合、その文書をブックマークに登録できない
<ul>
<li>ブックマークを登録する際、タイトルを手動で入力すれば登録できる</li>
</ul>
</li>
</ul>
<h2>參考</h2>
<p>「w3m keymap」「w3m local CGI」などの文言で檢索すると色々な情報が見つかります。</p>
<ul>
<li><a href="https://w3m.sourceforge.net/index.ja.html">W3M HomePage</a></li>
<li><a href="http://w3m.rocks/">W3M Rocks</a> - 英語の分りやすい解説</li>
<li><a href="https://userweb.mnet.ne.jp/tnomura/">I love CUI</a> - 「w3mを使ったHTML文書作成統合環境」のコーナーあり</li>
<li><a href="https://dandydot.no-ip.biz/~dot/presen/hack20091225/">DOT's PRESENTATION - HACK 2009/12/25</a> - local CGI の解説</li>
<li><a href="https://hozon.site/archive/1688300582/ayu-mushi.github.io/article/w3m.html">自分が使ってるw3mの設定と拡張 (hozon.site)</a></li>
<li><a href="https://hozon.site/archive/1688299533/hymd3a.hatenablog.com/entry/2021/05/09/210025">w3mで快適ブラウジング - ひゃまだのblog (hozon.site)</a></li>
</ul>
<h2>關聯</h2>
<ul>
<li>w3m の紹介</li>
<li><a href="./w3m-keymap.html">w3mのkeymap (コマンド追加)</a></li>
<li><a href="./w3m-env.html">w3mの環境變數</a></li>
</ul>
<h2>改版履歴</h2>
<ol>
<li>2023-07-08 (陰暦05月21日) -- 文章を推敲、基本操作を追記</li>
<li>2024-03-17 (陰暦02月08日) -- User-Agent をTor Browser 115に合せて變更</li>
</ol>