This package contains emacs-w3m, an Emacs interface to w3m

1. Introduction

   w3m is a pager with WWW capability, developed by Akinori ITO.
   Although it is a pager, it can be used as a text-mode WWW browser.
   Visit the official w3m page for details:

       http://w3m.sourceforge.net/

   (See the next section `Requirements' for the place where you can get
    the latest w3m source.)

   Emacs-w3m is a simple Emacs interface to w3m.  Its official web page
   is available at:

        http://emacs-w3m.namazu.org/

   You can find more detailed version of the following explanations
   in the form of HTML'ized info:

        http://emacs-w3m.namazu.org/info/

   (But the info has not been being maintained for a long period,
    so some descriptions might have probably been obsolescent and
    the new features are not necessarily all described, sorry.)


2. Requirements

   Check whether your system meets the following requirements before
   installing emacs-w3m.

   Now emacs-w3m will work with Emacs 26, 27, and hopefully 28 (not
   released yet, though).  XEmacs support has been dropped.

   Emacs-w3m requires the latest version of w3m (version 0.3.1 and
   later).  Since this program is much sensitive to the version of w3m,
   you should confirm it with `w3m --version' if you already have w3m
   installed.  To get the latest source of w3m, visit this page:

       https://salsa.debian.org/debian/w3m

   If you want to use the shimbun library that is included in the
   emacs-w3m distribution, you have to install the APEL and the FLIM
   packages in order.  To get those latest sources, visit this page:

       https://github.com/wanderlust/


3. Installation

3.1. Installing emacs-w3m on UNIX-like systems

     At the first, run the `configure' script.

         % ./configure

     If you can't find the `configure' script, rus the `autoconf'
     command. It create this script.

         % autoconf

     If you've installed APEL, FLIM or something in non-standard
     directories other than the default `load-path', you must specify
     them using the --with-addpath option as follows (this is the case
     where you want to use the shimbun library):

         % ./configure --with-addpath=/opt/share/apel:/opt/share/flim

     Next, execute the following commands to install emacs-w3m to an
     appropriate directory.

         % make
         % make install

     You may as well install icon image files, too.  To do this:

         % make install-icons
     or
         % make install-icons30

     The latter will install the slightly larger icons with characters.

     The info files will also be installed by `make install'.

3.2. Installing on non-UNIX-like systems

     If you cannot execute the `configure' script on your system, or if
     no `make' command is available, execute the following command:

         % emacs -batch -q -no-site-file -l w3mhack.el NONE -f w3mhack-nonunix-install

     If APEL, FLIM (or any other library) aren't installed in the
     ordinary places, the installer will leave them out.  In such a
     case, it is necessary to tell those places to the installer as
     shown below:

         % emacs -batch -q -no-site-file -l w3mhack.el //c/share/apel://c/share/flim -f w3mhack-nonunix-install


4. Configuration

   When you want to twiddle some options referenced by emacs-w3m, use
   the ~/.emacs-w3m.el file (its base name is the default value of the
   `w3m-init-file' variable, the name ~/.emacs-w3m is also allowed).
   That is similar to Emacs' init file (~/.emacs, etc.) but is read
   when emacs-w3m starts.  Note that there are a few options, e.g.,
   `w3m-command', that should be put into Emacs' init file, rather than
   the ~/.emacs-w3m.el file.


4.1. Essential Configuration

     Put this line into your Emacs' init file (i.e., ~/.emacs, etc.):

         (require 'w3m-load)

4.2. mime-w3m.el

     In order to let SEMI MUAs, such as Wanderlust, render text/html
     parts in messages using emacs-w3m, put the following line in your
     Emacs' init file (i.e., ~/.emacs, etc):

         (require 'mime-w3m)

4.3. Proxy Gateway

     There are some ways to do this, one is to set the "http_proxy"
     environment variable globally in the shell something like:

         export http_proxy='http://proxy.hogege.com:8000/'

     Another way is to customize the `w3m-command-arguments' variable
     so to have the option:

         '("-o" "http_proxy=http://PROXY_SERVER_NAME:PORT/")

     This can be done in your ~/.emacs-w3m.el file as shown below:

     (setq w3m-command-arguments
           (nconc w3m-command-arguments
                  '("-o" "http_proxy=http://proxy.hogege.com:8000/")))

     To specify `no-proxy' hosts, that shouldn't be connected to with
     proxy gateways, you can set the "no_proxy" environment variable
     with the comma separated host names, or set the
     `w3m-no-proxy-domains' variable with a list of domain names (not
     host names) as follows:

         (setq w3m-no-proxy-domains '("local.com" "neighbor.com"))

     See also the documentation for the `w3m-command-arguments-alist'
     variable to use regexps to specify the `no-proxy' hosts.


5. Contact the emacs-w3m community

   To contact the emacs-w3m community for reporting bugs, contributing
   improvements, making a suggestion or asking us for help, send a mail
   to the open list <emacs-w3m@namazu.org>.  You can also send a bug
   report using the `report-emacs-w3m-bug' command or the `C-c C-b' key
   if you have set the `mail-user-agent' variable so to work properly.


6. Acknowledgments

   w3m, that is an essential part of this package, was written by
   Akinori ITO.  We'd like to address our thanks to him for his nice
   work.


Local Variables:
mode: indented-text
mode: outline-minor
outline-regexp: "[0-9]\\.[0-9]\\.[0-9]\\.\\|[0-9]\\.[0-9]\\.\\|[0-9]\\."
fill-column: 72
End:

このパッケージには w3m を Emacs 上で動かすためのプログラム emacs-w3m が
含まれています．

1. はじめに

   w3m は，伊藤彰則さんによって開発された World Wide Web に対応したペー
   ジャです．あくまでページャですが，テキストベース WWW ブラウザとしても
   使うことができます．詳細については，

       http://w3m.sourceforge.net/

   を参照してください (最新のソースの入手元については次章「動作環境」を
   参照してください)．

   emacs-w3m は，Emacs 上で動作する単なるインターフェースプログラムに過
   ぎません．公式 Web ページの URL は，

        http://emacs-w3m.namazu.org/

   です．以下の説明のもっと詳しいものを，HTML 化された Info の形で読むこ
   とができます．

        http://emacs-w3m.namazu.org/info/

   (しかし，すみませんが info は長期間維持されていないので，一部の説明
    はおそらく陳腐化しており，必ずしもすべての新機能が説明されているわ
    けではありません．)


2. 動作環境

   emacs-w3m をインストールする前に，必要な環境が整っているか調べてくだ
   さい．

   現在 emacs-w3m は Emacs 26，27，そしてうまくいけば 28 (まだリリースさ
   れていませんが) で動作するでしょう．XEmacs サポートは終了しました．

   emacs-w3m を動かすには最新の w3m (バージョン 0.3.1 以上) が必要です．
   このプログラムは w3m のバージョンに強く依存しているので，既に w3m を
   インストールしてある場合は，`w3m -version' でそれを確認してください．
   最新の w3m のソースを入手するには，このページに行ってください:

       https://salsa.debian.org/debian/w3m

   emacs-w3m に同梱して配布されている shimbun ライブラリを利用するために
   は，APEL と FLIM パッケージを順番にインストールしておく必要があります．
   それらの最新のソースを入手するには，このページに行ってください:

       https://github.com/wanderlust


3. インストール

3.1. UNIX 系の環境でインストールする場合

     最初に，configure スクリプトを実行してください．

         % ./configure

     もし， configure スクリプトが見つかられなければ， autoconf コマンド
     を実行してください．これは，configure スクリプトを作成します．

         % autoconf

     APEL や FLIM などの必要なモジュールが，標準的ではないディレクトリに
     インストールされている場合には，`--with-addpath' オプションを使って，
     そのディレクトリを指定する必要があります (これは shimbun ライブラリ
     を使いたい場合です)．

         % ./configure --with-addpath=/opt/share/apel:/opt/share/flim

     次に，emacs-w3m を適当なディレクトリにインストールするため，次のコ
     マンドを実行してください．

         % make
         % make install

     アイコン画像のファイルもインストールした方が良いでしょう．
     それを行なうには:

         % make install-icons
     または
         % make install-icons30

     後者はちょっと大きな，文字も入ったアイコン画像を使うためのものです．

     `make install' によって info ファイルもインストールされます．

3.2. 非 UNIX 系の環境でインストールする場合

     configure スクリプトを実行できない，または make コマンドが存在しな
     い環境の場合は，以下のコマンドを実行してください．

         % emacs -batch -q -no-site-file -l w3mhack.el NONE -f w3mhack-nonunix-install

     APEL や FLIM などの必要なモジュールが，標準的ではないディレクトリに
     インストールされている場合には，以下のようにそのディレクトリを指定
     する必要があります．

         % emacs -batch -q -no-site-file -l w3mhack.el //c/share/apel://c/share/flim -f w3mhack-nonunix-install


4. 設定

   Emacs-w3m が参照するいろんなオプションをいじるには ~/.emacs-w3m.el
   ファイルを使ってください (そのベース名は `w3m-init-file' 変数のデ
   フォルト値ですが ~/.emacs-w3m という名前も許容します)．これは Emacs
   の初期設定ファイル (~/.emacs など) に似ていますが，emacs-w3m の起動
   時に読み込まれます．~/.emacs-w3m.el ファイルではなく, Emacs の初期
   化ファイルに置かなければならないいくつかのオプション，例えば
   `w3m-command'，があることに注意してください．


4.1. 基本

     これを Emacs の初期設定ファイル (~/.emacs など) に加えてください．

         (require 'w3m-load)

4.2. mime-w3m

     Wanderlust などの SEMI MUA が emacs-w3m を使ってメッセージ中の
     text/html パートを使って表示できるようにするには，以下の行を
     Emacs の初期設定ファイル (~/.emacs など) に追加してください．

         (require 'mime-w3m)

4.3. Proxy Gateway

     これにはいくつかの方法があります．一つは環境変数 http_proxy を
     shell 上で，こんなふうにグローバルに設定することです:

         export http_proxy='http://proxy.hogege.com:8000/'

     他に，オプション `w3m-command-arguments' をカスタマイズして，次の
     オプションを追加する方法もあります:

         '("-o" "http_proxy=http://PROXY_SERVER_NAME:PORT/")

     これは ~/.emacs-w3m.el ファイルで以下のように行なうことができます．

     (setq w3m-command-arguments
           (nconc w3m-command-arguments
                  '("-o" "http_proxy=http://proxy.hogege.com:8000/")))

     環境変数 no-proxy にコンマで区分けされたホスト名を設定するか，また
     は以下のようにドメイン名 (ホスト名ではない) のリストをオプション
     `w3m-no-proxy-domains' に設定することによって，proxy ゲートウェイを
     使わずに接続するホストを指定することができます．

         (setq w3m-no-proxy-domains '("local.com" "neighbor.com"))

     no-proxy ホストの設定に正規表現を使うには，オプション
     `w3m-command-arguments-alist' のドキュメントを見てください．


5. 連絡先

   バグリポート，改善への貢献，提案，または助けを求めるには，メールを
   <emacs-w3m@namazu.org> 宛に送ってください．もし `mail-user-agent' を
   正しく動作するように設定してあれば，`report-emacs-w3m-bug' コマンドか
   `C-c C-b' キーを使ってバグリポートを送ることもできます．


6. 謝辞

   伊藤彰則さんによって開発された w3m がなければ，このプログラムは存在し
   ませんでした．最大の謝意を，伊藤さんに捧げたいと思います．


Local Variables:
mode: indented-text
mode: outline-minor
outline-regexp: "[0-9]\\.[0-9]\\.[0-9]\\.\\|[0-9]\\.[0-9]\\.\\|[0-9]\\."
use-kuten-for-period: nil
use-touten-for-comma: nil
fill-column: 72
End:

= emacs-w3m

[![Build Status](https://travis-ci.com/Boruch-Baum/emacs-w3m.svg?branch=bb_travis)](https://travis-ci.com/boruch-baum/emacs-w3m)

[//]: # License badges: https://gist.github.com/lukas-h/2a5d00690736b4c3a7ba

[![License: GPL
v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)