Another HTML-lint

ダウンロード

パッケージによって、Perlスクリプトの文字コード系が異なります。 *.zip が EUC/LF、*.sjis.zip が SJIS/CRLF です。 アクセス権限情報は含まれていません。 HTMLはすべてJISコードのままです。

Perl5.004以上が必要です。JPerlでは動作しません。ローカルマシンへのインストールについて参考となるサイトを紹介してあります。
CPAN からは、各プラットフォームのPerl処理系を含むすべてのPerl関係のリソースをダウンロードできます。

• CPAN (Comprehensive Perl Archives Network)
• ActivePerl (Perl for Win32)

標準でないPerlライブラリ等は、必要なら例えば以下からダウンロードしてください。

• Jcode.pm
  必要です。必ず入手してください。
  XS化される前の古い版から最近のXS化された版への更新で、NoXS版を使用する場合、Jcodeフォルダ下に不要なUnicode.pmが残る場合があります。そのときは削除してください。NoXS版のときにUnicode.pmがあるとうまく動作しません。
• jcode.pl
  現在 Another HTML-lint では、jcode.pl は使用していません。代わりにJcode.pmを使用しています。しかし、都合でJcode.pmがインストールされていない場合でも、jcode.plがあれば動作します。ただし、そのときはUTF-8は扱えません。
• CGI.pm
  CGIとして動作させるときに必要です。 標準ライブラリですが、ヴァージョンが古い場合があります。2.5xでない場合は最新版をダウンロードしてインストールしてください。古いCGI.pmは、sub parse_params 内で

  my(@pairs) = split('&',$tosplit);

  となっていますが、新しいもの(2.46あたりから)だと

  my(@pairs) = split(/[&;]/,$tosplit);

  となっています。
• cgi-lib.pl
  現在 Another HTML-lint では、cgi-lib.pl は使用していません。代わりにCGI.pmを使用しています。
  一部のユーザエージェントは、フォームの送出に際して、Content-Typeに

  application/x-www-form-urlencoded; charset=iso-2022-jp

  のようにCHARSETを付けるものがあるようです。cgi-lib.plは、これに対応していません。cgi-lib.pl 2.18ならば、82行目の判定を

  $type =~ m#^application/x-www-form-urlencoded(;|$)#

  のように修正すれば一応動作させることができます。
• LWP (libwww-perl)
  CGIとして動作させるときに必要です。 Perlのパッケージに標準で含まれていることもありますが、Perl5.8には含まれていません。URLからHTMLを取得するためには、httpreq.pl を使用することもできますが、これは、Perl for Win32 でLWPが使えなかった頃に、わたしがお手軽に書いた習作スクリプトで、secure server では動作しないことがわかっています。LWPを使うことをお勧めします。インストールしておくと何かと便利です。持っていて損はありません。
• Email::Valid
  現在 Another HTML-lint では、Email::Valid は使用していません。
• URL.pl, url_get
  現在 Another HTML-lint では、URL.pl、url_get は使用していません。
• wget
  現在 Another HTML-lint では、wget は使用していません。
• nkf / nkf Win32
  現在 Another HTML-lint では、nkf は使用していません。

htmllint.zip / htmllint.sjis.zip では、全ファイルがフラットな構造に展開されます。このままの状態でも利用できますが、ファイルの種類別にディレクトリを分けることもできます。ファイルは次のように分類できます。

• CGIスクリプト -- *.cgi、*.pm、*.pl、htmllint、htmllint.env などが含まれます。
• HTMLファイル -- *.html と *.css などが含まれます。
• 規則ファイル -- *.rul が含まれます。
• その他のファイル -- *.dtd や *.ent などの直接は利用されないファイルが含まれます。

htmllint の多くの動作環境は、htmllint.env に記述されています。htmllint.env はパッケージには含まれていないので、最初はサンプルの htmllintenv を htmllint.env に改名してください。そして htmllint.env 中の設定項目に目を通し、ディレクトリの指定など適宜書き換えてください。他のCGIの動作環境もこのファイルですべて調整します。
htmllint.env は他のCGIスクリプトと同じ場所に置いてください。CGIのアクセス権は、htmllint、htmllint.cgi、tagslist.cgi を 755 などにしておけば大丈夫です。htmllint.env 自身は、CGIからは読めるが外部から直接参照できないようにした方が安全です。例えば、Apacheでの .htaccess に AddType application/x-httpd-cgi .env を追加し、アクセス権を 744 にしておく、などです。ログファイルを作る場合は、それを置くディレクトリにも適切なアクセス権を与えます。
HTML中にも何個所か修正しなければならない場所があります。

• *.html の htmllint.cgi と tagslist.cgi のパス。

  s#\./(htmllint\.cgi|tagslist\.cgi)#anywhere/$1#g

• use-htmllintcgi.html のサンプル中のURL 3個所。

  s#http://openlab\.ring\.gr\.jp/k16/htmllint/(?!i)#http://anydomain/anywhere/#g

• 一部の *.html のイメージファイル top.gif のパス。

  s#\./(top\.gif)#anywhere/$1#g

Lynx を利用する場合は、lynx.cfg でCHARACTER_SETを Japanese(EUC) に設定してください。このとき、htmllint.cgiはEUC版である必要があります。Lynx は 2.7.1 でしか動作確認していないので、他のヴァージョンではオプション等の調整が必要かも知れません。Lynx の起動時オプションは htmllint.env の中に記述されています。

ダウンロードした htmllint.zip / htmllint.sjis.zip には、以下のようなファイルが含まれています。

htmllint

コマンドラインから起動し、htmllint.pmを呼び出して構文チェックするためのPerlスクリプトです。MacPerl版ではドロップレットですが、MPWで利用するときはプレーンテキストにする必要があります。

htmllint.pm

チェッカ本体のPerlスクリプトパッケージモジュールです。

common.rul

共通規則ファイルです。他の規則ファイルの不備を補うもので、htmllint.pm、htmllint.cgi、tagslist.cgiが読み込みます。

charsets.rul

IANAのCHARACTER SETSを元にして作った連想配列で、htmllint.pmが読み込みます。

colortable.rul

色名と色コードの対応表です。htmllint.pmが読み込みます。

*.rul

各種HTMLに対応した規則ファイルです。htmllint、tagslist.cgiが読み込みます。

*.dtd/ent

それぞれの規則ファイルの元になったDTDです。RFCなどからの抜粋ですが、MozillaやMSIEのものはリファレンスからの捏造品です。htmllintは使用しません。

tagslist.cgi、tagslist.html

規則ファイルからタグ一覧HTMLを生成するPerlスクリプトと、それへの目次の含まれるHTMLです。

parsedtd.pl

DTDから、htmllintが読み込む規則ファイルの原形を生成するPerlスクリプトです。htmllintは使用しません。

htmllint.cgi

htmllint.htmlとhtmllint.pmの間を仲介するためのゲートウェイ用のPerlスクリプトです。

htmllintenv

htmllint.pm、htmllint.cgi、tagslist.cgiが使用する環境ファイルのサンプルです。このファイルからhtmllint.envを作ってください。htmllint.envをhtmllint.pm、htmllint.cgi、tagslist.cgiが読み込みます。

htmllintrc

htmllintのための設定ファイルのサンプルです。使用しません。

htmllint.history.txt

htmllint.cgiとhtmllint.pmの更新履歴です。

htmllint.html

htmllint.cgiをCGIとして呼び出すHTMLです。

htmllintl.html

htmllint.htmlの簡易版です。

htmllinte.html

MSIE4以上用のDynamicHTMLを利用したものです。

explain.html、explain-wai.html、explain-score.html、explain-omake.html

チェックの結果の解説などが述べられたHTMLです。

colors.html、colorsbk.html

名前付き色見本です。

index.html、introduction.html、notice.html、use-htmllintcgi.html、use-htmllint.html、download.html、rulefile.html、reference.html、faq.html

この能書きの書かれたHTMLファイル群です。

htmllint.css

スタイルシートがちょっとだけ定義されているファイルです。background-image などをお好みに調整してください。

*.gif

「よくできました」などのイメージファイルです。

httpreq.pl

簡単な HTTP アクセスライブラリです。htmllint.env の設定によっては htmllint.cgi が使用します。htmllint.cgi と同じディレクトリに置くか、Perlのライブラリディレクトリに入れてください。

RFC2396.pm

RFCに記述されているURIの構文則を正規表現で表わしたPerlスクリプトパッケージモジュールです。htmllint.pm が使用します。htmllint.pm と同じディレクトリに置くか、Perlのライブラリディレクトリに入れてください。

Another HTML-lint をファイアウォール内へインストールする場合は、変数の設定が必要かも知れません。htmllint.env で、$HTTP_PROXY と @HTTP_NOPROXY の設定を適切に行なってください。

UNIXの場合、環境変数HOMEで示されるディレクトリに、.htmllintrc というファイルがあると、チェックの初期状態として読み込みます。htmllintrc というサンプルを好みに編集し、ファイル名を変更して使ってください。

Another HTML-lint を自分のサーバやローカル環境で動作させるための手引きが、以下のようなサイトにあります (順不同、敬称略、無断紹介)。 なお、これらのリンクは生きていない可能性がありますが、積極的には保守しません。

• Another HTML-lint を win32 上で使う (橋本純一)
• Another HTML-lintを使おう (えいさあ)
• Mac OS XでAnother HTML-lintを使おう (森俊之)
• Another HTML-lint 導入ガイド (水無月 ばけら)

• Another HTML-lint on MacOS

バナーアイコンの要望がいくらかあります。4種類あります。ご自由にお使いください。素人がちょちょいと作ったのであまり奇麗ではありませんけど。

PNG GIF	PNG GIF	PNG GIF	PNG GIF

なんと、本庄伴行さんが5つも作ってくださいました。ありがとうございます。こっちのが、ずっとすっきりしていていいですね。(1998/07/22)

PNG GIF	PNG GIF	PNG GIF	PNG GIF	PNG GIF

M.畑さんも2つ作ってくださいました。(1999/11/03)

PNG GIF	PNG GIF

河本孝之さんも作ってくださいました。(2001/08/19)

PNG GIF

青山尚樹さんも。(2003/06/10)

PNG	PNG

坂本衛さんも。(2003/07/03)

PNG GIF	PNG GIF

岡本剛さんも。(2004/01/07)

PNG GIF	PNG GIF	PNG GIF	PNG GIF

A.Takenaka さんも。(2004/02/11)

PNG GIF	PNG GIF

kaz さんも。(2004/05/14)

PNG