======================================================================== * doc-jp/README ======================================================================== w3m: WWW wo Miru Tool version 0.5.3 Jan 15, 2011 (C) Copyright by Akinori ITO Hironori SAKAMOTO Fumitoshi UKAI 1. はじめに w3m は，World Wide Web に対応したページャです．あくまでページャですが， テキストベース WWW ブラウザとしても使うことができます． w3m は，fm というページャをベースとして作られました．fm についての詳細 は，STORY.html をお読みください．w3m のページャとしての基本的な特徴は，fm とほとんど同じです． w3m 独自の特徴としては，次のようなものがあります． ・WWW 対応なので，HTML の文書を読んでいる時には，その中のリンクを辿った り，画像を見ることができる． ・Internet message 表示のためのモードがある．この時，Content-Type: が text/html の場合は，自動的に HTML の文書として表示する．また，自力で MIME header のデコードをする． ・見ている plain text 文書中に URL 表記があった場合，その部分からリンク をたどることができる． 現在の問題点は以下のようなものです． ・オンラインマニュアルが貧弱．簡単な使い方については，MANUAL.html をお読み ください． 現在動作が確認されている OS は以下の通りです． SunOS 4.1.x HP-UX 9.x, 10.x Solaris 2.5.x, 2.6, 8, 9 Linux 2.0.*/2.2.*/2.4.*/2.6.* FreeBSD 2.2.8, 3.1, 3.2, 4.6 NetBSD/macppc, m68k EWS4800 Rel.12.2 Rev.A Digital UNIX: v3.2D, v4.0D IRIX 5.3, IRIX 6.5 OS/2 with emx Windows 9x/NT with Cygwin b20.1, 1.1.x, 1.3.x MS-DOS with DJGPP and WATT32 packet driver MacOS X Server MacOS X 10.1, 10.2, 10.3, 10.4 2. インストール インストールをするには，次のようにします． - GC library (6.1より新しいもの?)をインストールしておきます。 GC library は http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/ から入手できます。 GC library 6.1を使っている場合は gc.h を PREFIX/include に インストールしておく必要があります。 # cp gc-6.1/include/gc.h PREFIX/include - configure を実行する． % ./configure - make を実行 % make - make install を実行 # make install 以上でインストールは終わりです． 機種ごとの注意点： HP-UX HP の C コンパイラ(gccでなく)でコンパイルする場合， configure の Input your favorite C-compiler. (Default: cc) に，cc -Aa -D_HPUX_SOURCE と答えてください．cc だけだとコンパイルが通りません．gcc なら普通に 通りますが，バージョン古めの場合は -g を付けな いでください． OS/2 emx を使うことで w3m をコンパイルすることができます． まず最初に cd gc make -f EMX_MAKEFILE を実行して GC ライブラリをコンパイルしておいてから，w3m 本体をコンパイルします．なお，カラー表示が変になるらしい ので，モノクロ用にコンパイルした方が良いでしょう． Windows Windows で w3m を動かすためには，Windows 上の UNIX互換環境 である Cygwin(開発環境付き)が必要です． 詳細は README.cygwin を参照してください． 3. 著作権 w3m の著作権は，伊藤彰則に属しています． (C) Copyright 1994-2002 by Akinori Ito (C) Copyright 2002-2011 by Akinori Ito, Hironori Sakamoto, Fumitoshi Ukai 4. 配布条件 このソフトウェアによって利用者または第三者が何らかの被害を受けた 場合，作者はその責任を一切負いません．この事を承諾する限りにおい て，このソフトウェアは，誰でも作者に断りなく利用・改変・配布でき ます． 5. 作者 伊藤 彰則 東北大学大学院工学研究科 aito@fw.ipsj.or.jp 現在のメンテナ 佐藤 大 東北大学病院 satodai@w3m.jp ご意見，ご感想をお寄せください． http://w3m.sourceforge.net/ https://sourceforge.net/projects/w3m/ ======================================================================== * doc-jp/README.SSL ======================================================================== SSL サポートについて (2000/11/07) 岡部克也 okabek@guitar.ocn.ne.jp (2001/12/27) 鵜飼文敏 ukai@debian.or.jp ・ OpenSSL ライブラリを通じて, SSL をサポートしています. あらかじめインストールしておいてください. ・ OpenSSL ライブラリがインストールされていれば configure スクリプト実行時に自 動的に検出されて利用可能となります. もしうまく動かないときは, config.h をチェックしてみてください. SSL を利用す るためには, config.h で, USE_SSL マクロが定義されている必要があります. さらに, SSL 認証サポートを利用する場合は, USE_SSL_VERIFY マクロもチェックし てみてください. コンパイルでエラーが出る場合は, リンカフラグに `-lssl -lcrypto', コンパイラ フラグに '-I(SSLeay/OpenSSL のヘッダがあるディレクトリ)' があるか確認してく ださい. SSL サポートが有効になっているかどうかは, Option Setting Panel に「SSLの設 定」が含まれているかどうかで確認できます. ・ SSL に関して以下の設定が可能になってます: ssl_forbid_method 使わないSSLメソッドのリスト(2: SSLv2, 3: SSLv3, t: TLSv1) (デフォルトは2, 3). ssl_verify_server ON/OFF SSLのサーバ認証を行う(デフォルトはON). ssl_cert_file ファイル名 SSLのクライアント用PEM形式証明書ファイル(デフォルトは). ssl_key_file ファイル名 SSLのクライアント用PEM形式秘密鍵ファイル(デフォルトは). ssl_ca_path ディレクトリ名 SSLの認証局のPEM形式証明書群のあるディレクトリへのパス (デフォルトは). ssl_ca_file ファイル名 SSLの認証局のPEM形式証明書群のファイル(デフォルトは). ただし「SSLEAY_VERSION_NUMBER >= 0x0800」な環境でないと無駄なコードが増 えるだけなので, configure時にdisableしておいたほうがよいでしょう. また実際に認証を行う場合, ssl_ca_pathまたはssl_ca_fileで, サーバの鍵に 署名している認証局の証明書を (ssl_verify_serverのON/OFFに関係無く) 指定 しないとサーバ認証は成功しません。 通常使われている認証局の証明書は以下のところなどから入手できます。 * mozillaのソースに含まれている mozilla/security/nss/lib/ckfw/builtins/certdata.txt から添付の ruby script で *.pemファイルとしてとりだしたもの % ruby certdata2pem.rb < certdata.txt でカレントディレクトリに *.pemファイルをとりだし opensslの c_rehash コマンドで hash symlink を作成します。 このディレクトリを ssl_ca_path に設定することができます。 もしくは、*.pem をまとめた一つのファイルを作成しておけば それを ssl_ca_file に設定することができます。 * mod_sslのソースに含まれている pkg.sslcfg/ca-bundle.crt これは PEMなので、このファイルのフルパス名を ssl_ca_file に 設定することができます。 ・ バージョン 0.9.5 以降の OpenSSL ライブラリは, 乱数を初期化するために幾つか のシードを設定する必要があります. デフォルトでは /dev/urandom があればそれを利用しますが, 無ければ w3m 内部 で生成します. もし, EGD (Entropy Gathering Daemon) または PRNGD (Pseudo Random Number Generator Daemon) が利用できる環境でこれを使いたい場合は, USE_EGD マクロをチェックしてみてください. ・ URL OpenSSL - http://www.openssl.org/ PRNGD - http://www.aet.tu-cottbus.de/personen/jaenicke/postfix_tls/prngd.html ---------------------------------------------------------------- #!/usr/bin/ruby # Copyright (c) 2001 Fumitoshi UKAI # All rights reserved. # This is free software with ABSOLUTELY NO WARRANTY. # # You can redistribute it and/or modify it under the terms of # the Ruby's licence. # # certdata2pem.rb if RUBY_VERSION>="1.9" Encoding.default_external="UTF-8" end while line = $stdin.gets next if line =~ /^#/ next if line =~ /^\s*$/ line.chomp! if line =~ /CKA_LABEL/ label,type,val = line.split(' ',3) val.sub!(/^"/, "") val.sub!(/"$/, "") fname = val.gsub(/\//,"_").gsub(/\s+/, "_").gsub(/[()]/, "=") + ".pem" next end if line =~ /CKA_VALUE MULTILINE_OCTAL/ data='' while line = $stdin.gets break if /^END/ line.chomp! line.gsub(/\\([0-3][0-7][0-7])/) { data += $1.oct.chr } end open(fname, "w") do |fp| fp.puts "-----BEGIN CERTIFICATE-----" fp.puts [data].pack("m*") fp.puts "-----END CERTIFICATE-----" end puts "Created #{fname}" end end system("c_rehash", ".") ======================================================================== * doc/README ======================================================================== w3m: WWW wo Miru Tool version 0.5.3 Jan 15, 2011 (C) Copyright Akinori ITO Hironori SAKAMOTO Fumitoshi UKAI 1. Introduction w3m is a pager with WWW capability. It IS a pager, but it can be used as a text-mode WWW browser. The features of w3m are as follows: * When reading HTML document, you can follow links and view images (using external image viewer). * It has 'internet message mode', which determines the type of document from header. If the Content-Type: field of the document is text/html, that document is displayed as HTML document. * You can change URL description like 'http://hogege.net' in plain text into link to that URL. Current problems are: * Online manuals are poor. w3m is known to work on these platforms. SunOS 4.1.x HP-UX 9.x, 10.x Solaris 2.5.x, 2.6, 8, 9 Linux 2.0.*/2.2.*/2.4.*/2.6.* FreeBSD 2.2.8, 3.1, 3.2, 4.6 NetBSD/macppc, m68k EWS4800 Rel.12.2 Rev.A Digital UNIX: v3.2D, v4.0D IRIX 5.3, IRIX 6.5 OS/2 with emx Windows 9x/NT with Cygwin b20.1, 1.1.x, 1.3.x MS-DOS with DJGPP and WATT32 packet driver MacOS X Server MacOS X 10.1, 10.2, 10.3, 10.4 2. Installation Follow these instructions to install w3m. - You need latest version of GC library (at least 6.1?). You can get GC library from http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/ Note: if you're using GC library 6.1, you should install gc.h to PREFIX/include: # cp gc-6.1/include/gc.h PREFIX/include - Run configure. % ./configure - do make % make - do make install # make install MACHINE/OS specific notices: HP-UX If you want to use HP C compiler, answer Input your favorite C-compiler. (Default: cc) cc -Aa -D_HPUX_SOURCE If you use just 'cc' without options, you can't compile w3m. If you are using gcc, no option is needed. OS/2 You can compile w3m using emx. First you have to do is to compile GC library with cd gc make -f EMX_MAKEFILE then compile w3m. I heard that OS/2 console can't display color, you had better compile w3m without color capability. Windows To compile w3m on MS-Windows, you have to use Cygwin with development tools. Read README.cygwin for more details. 3. Copyright (C) Copyright 1994-2002 by Akinori Ito (C) Copyright 2002-2011 by Akinori Ito, Hironori Sakamoto, Fumitoshi Ukai 4. License Use, modification and redistribution of this software is hereby granted, provided that this entire copyright notice is included on any copies of this software and applications and derivations thereof. This software is provided on an "as is" basis, without warranty of any kind, either expressed or implied, as to any matter including, but not limited to warranty of fitness of purpose, or merchantability, or results obtained from use of this software. 5. Author Initial author: Akinori Ito Faculty of Engineering, Tohoku University aito@fw.ipsj.or.jp Current Maintainer Dai Sato Tohoku University Hospital satodai@w3m.jp Feel free to send your opinion to: http://w3m.sourceforge.net/ https://sourceforge.net/projects/w3m/