2.3 Things required to run emacs-w3m

Depending on the Emacs version you’re using, third party packages may be required. This section provides resources to help you find and install them.

‘APEL’

Indispensable to XEmacs. You should install APEL before building emacs-w3m. APEL is available at:

http://kanji.zinbun.kyoto-u.ac.jp/~tomo/lemi/dist/apel/

Note that you must not use the APEL XEmacs package (which is contained in SUMO) of the versions older than 1.32. If you have already installed such a version, you should upgrade it or use the following directives to replace it with APEL which is linked above (you can also use the same directives in order to newly install APEL):

% rm -fr /usr/local/lib/xemacs/xemacs-packages/lisp/apel % cd apel-10.7 % make install-package XEMACS=xemacs-21.4.x\ PACKAGEDIR=/usr/local/lib/xemacs/xemacs-packages

‘gifsicle’

Indispensable to XEmacs. There is a known bug in all XEmacs 21.x series that won’t let it display optimized animated gifs correctly or may make it crash when some kind of an interlaced gif image is displayed. Emacs-w3m uses the ‘gifsicle’ program to convert gif data in order to make it possible to be handled by XEmacs 21.x. It is available at:

http://www.lcdf.org/gifsicle/

‘ImageMagick’

If the ‘convert’ program bundled with the ImageMagick package is available on your system, emacs-w3m will use it to resize images or to convert ‘favicon’ images into a format Emacs can handle. Emacs-w3m will work without ImageMagick, but installing it will improve your surfing experience. You can get the ImageMagick package from:

ftp://ftp.imagemagick.org/pub/ImageMagick/

To manipulate ‘favicon’ images, we recommend version 5.4.0-5 and later, previous versions may work but we didn’t check them thoroughly.

‘FLIM’

The FLIM package is required to use the ‘shimbun’ library. The ‘shimbun’ library is a collection of tools for reading web newspapers, you can use it with Gnus, Mew or Wanderlust. See section A tool for reading a newspaper.

Note that the FLIM package requires the APEL package regardless of the version of Emacs you are using. Therefore, you must install both APEL and FLIM if you would like to use the ‘shimbun’ library. The FLIM package is available at:

http://kanji.zinbun.kyoto-u.ac.jp/~tomo/lemi/dist/flim/flim-1.14/

‘Mule-UCS’

If you use XEmacs 21.4, or need to read Chinese text, Japanese text, Korean text, etc. using Emacs 21, we recommend you install the Mule-UCS Emacs Lisp package so as to enable emacs-w3m to display pages encoded by UTF-8, which is the typical coding system of the Unicode system. Note that Emacs 21 supports the Unicode system partially (e.g., for Latin text) and Emacs 22 or greater fully supports it. The Mule-UCS Emacs Lisp package is available at:

http://unit.aist.go.jp/itri/itri-gist/ftp.m17n.org/pub/mule/Mule-UCS/test/Mule-UCS-current.tar.gz

(The official page for Mule-UCS will open in the near future in http://www.meadowy.org/.)

If you use it with Emacs 21.2, it is necessary to apply this patch before installation.

If you are an XEmacs 21.4 user, the compiled package is here:

ftp://ftp.xemacs.org/xemacs/packages/mule-ucs-1.14-pkg.tar.gz

(You don’t need to install it in addition to Mule SUMO, that contains it.)

‘codepage-ex’

Some web sites in Europe specify a ‘charset=ISO-8859-1’ encoding, but really use windows-1252. Since iso-8859-1 is insufficient to decode that, emacs-w3m uses windows-1252 as a superset of iso-8859-1 if it is available. The windows-1252 coding system is built-in since Emacs 22. Even in Emacs 21, you can enable to use it using the module called codepage-ex. See the following page:

http://nijino.homelinux.net/emacs/codepage-ex.html

‘rfc2368.el’

Install it if you’d like to enable emacs-w3m running with XEmacs to parse ‘mailto’ urls properly. You can find the ‘rfc2368.el’ module which can be used with XEmacs in the ‘attic’ directory in the emacs-w3m distribution. To install it, copy the ‘rfc2368.el’ file to the directory belonging to the load-path, and perform the following command:

% xemacs -batch -vanilla -f batch-byte-compile rfc2368.el

This document was generated by TSUCHIYA Masatoshi on January 30, 2019 using texi2html 1.82.