秀丸マクロ - CloseTag.mac

Wisteria >
秀丸マクロ >

CloseTag.mac

HTML 終了タグ挿入マクロ

ダウンロード |
概要 |
使い方と動作 |
設定 |
仕様と制限事項 |
XHTML で使う場合 |
バージョン履歴 |
旧バージョン |
参考文献 |
フィードバック

ダウンロード

CloseTag.mac　Version 4.10　(2003/05/05)
readme.txt

概要

HTML の終了タグを書くマクロです。カーソル位置で閉じていない要素を見つけ、対応する終了タグを挿入します。

<A href="../">　戻る　| → <A href="../">　戻る　</A>|
（動作イメージ：縦線はカーソルを表す）
要素の入れ子関係をわりと厳密に解析します。

<TABLE> <TR><TD>　</TD></TR>| → <TABLE> <TR><TD>　</TD></TR> </TABLE>|

使い方と動作

終了タグを書きたい位置にカーソルを置いてマクロを実行します。

<STRONG>　強調　| → <STRONG>　強調　</STRONG>|

このように、基本的には　開始タグ→内容→終了タグ　の順で入力するスタイルを想定しています。
開始タグの直後またはタグ内で実行すると、開始タグと終了タグの間にカーソルが移動します。

<STRONG>| → <STRONG>|</STRONG>

開始タグ→終了タグ→内容　の順で入力するスタイルではこの方法が便利です。
終了タグ内で実行すると、そのタグを置換します。
範囲選択中に実行すると、選択範囲を置換します。
選択範囲がタグ内外にまたがる場合は範囲の先頭を基準として動作します。
その他の場合（BOX 選択中とか）の動作は仕様外です。気になる人はやってみてください。

設定

設定はマクロ本体の冒頭部分を書き換えることで行います。

終了タグが省略可能な要素について

// (1) 終了タグを省略する:
$OmitEndTag = "";
// (2) 終了タグなし:
$MustOmitted = "";
// (3) 終了タグ省略可:
$MightOmitted = "dt dd li p option td th tr colgroup tbody thead tfoot head body html";

(1) はこのマクロを使ってあなたが書くタグについての設定です。終了タグを（自分では）書かない要素があれば (1) に追加してください。追加するときは " " 内に要素名を半角小文字・半角スペース区切りで書き並べます。

`<UL> <LI> リストアイテム`\|	→	`<UL> <LI> リストアイテム </LI>`\|		`<UL> <LI> リストアイテム </UL>`\|
		デフォルト		`li` を追加したとき

(2), (3) は対象とする文書にすでに書かれているタグについての設定です。

終了タグが一つもないことがわかっている要素は (2) に追加してください。処理が速くなります。
終了タグが必ずあることがわかっている要素は (3) から削除してください。処理が速くなります。
終了タグがあるかどうかわからない要素は全部 (3) に入れておいてください。処理は速くなりませんが、安全です。

スマートインデント

#SmartIndent = yes;

インデントの深さを自動的に揃える機能です。 yes または no を指定します。 yes にすると C 言語用のインデントで "}" を入力したときと同じように振る舞います。

W3C HTML 4.01 で規定されている以外の要素を扱うには

終了タグがない要素を次の個所に追加してください。（たとえば bgsound spacer wbr など）

$OmitEndTag   = " br img hr col input area param basefont base meta link isindex frame " + $OmitEndTag  + " ";
$MustOmitted  = " br img hr col input area param basefont base meta link isindex frame " + $MustOmitted + " ";

また、 $AnyTag の正規表現がすべての要素名にマッチするようにしてください。

$AnyTag       = "</?[A-Za-z][A-Za-z0-9:_.-]*" + $Delimiter;

仕様と制限事項

秀丸エディタ Version 3.19 で動作確認しています。 Version 3.14 で追加されたマクロ関数を使っているので、それ以前のバージョンでは動かないでしょう。
W3C HTML 4.01 を基準に作っています。 HTML 3.2 や HTML 2.0 でもたぶん大丈夫でしょう。 XHTML 1.0 でも一応使えるようになっていますが、その他の DTD に基づく XML 文書は想定外です。（XHTML で使う場合を参照してください）　適切に設定すれば DNML など類似の言語でも使えるはずです。
要素の入れ子構造の解析にあたっては、 SGML における次の原則を適用します： An end tag closes, back to the matching start tag, all unclosed intervening start tags with omitted end tags. (the SGML standard, section 7.5.1)　つまり、入れ子の内側に閉じていない要素があっても無視しますよ、ということです。

<P>　<EM>　<BIG>　</EM>　| → <P>　<EM>　<BIG>　</EM>　</P>|
開始タグのみの省略には対応しません。終了タグがあるのに対をなす開始タグが見つからない場合、文頭まで全部がその要素の内部と見なされます。

<HTML> <TITLE>　</TITLE> （BODY 要素の開始タグを省略） </BODY>| → エラー
要素同士がオーバーラップしている場合は必ずエラーになります。このような書き方はそもそも SGML の原則に違反していますから相手にしません。

<DIV>　<P>　<EM>　</P>　</EM>| → エラー

要素の内容モデルに基づく判断はできません。次のような場合は「(2) 終了タグなし」に設定しておく必要があります。「(3) 終了タグ省略可」では対応できません。

`<DIV> <P> <HR>`\|	→	`<DIV> <P> <HR> </DIV>`\|		`<DIV> <P> <HR> </DIV>`\|		`<DIV> <P> <HR> </P>`\|
		正しい実行結果		p が (2) に含まれているとき（正）		p が (2) に含まれていないとき（誤）

P 要素はブロック要素を含むことができないので、上の例では HR 要素の前で P 要素が暗黙的に閉じて（＝終了タグが省略されて）います。したがってカーソル位置には </DIV> を挿入するのが正当ですが、このマクロは「P 要素はブロック要素を含むことができない」なんてことは知らないので、「(2) 終了タグなし」の設定に p が含まれていないとカーソル位置に </P> が挿入されてしまいます。もうひとつ騙されそうな例を挙げておきましょう。

`<DL> <DT> <DD>　</DD>`\|	→	`<DL> <DT> <DD>　</DD> </DL>`\|		`<DL> <DT> <DD>　</DD> </DL>`\|		`<DL> <DT> <DD>　</DD> </DT>`\|
		正しい実行結果		dt が (2) に含まれているとき（正）		dt が (2) に含まれていないとき（誤）

コメントは認識しません。コメント内も地の文と同様に扱います。^*1

<P>  | → <P>  </EM>|

同様に、文字列リテラル・埋め込みスクリプトなどの中にあるタグ（のような文字列）も、地の文に書かれている（本物の）タグと区別できません。「<」「>」は、文字列リテラル中では文字参照を使って「<」「>」と書きましょう。埋め込みスクリプト中では比較演算子の両側にスペースを入れるようにしましょう。要は「<」とアルファベットが密着しないようにすれば大丈夫です。スクリプト中の文字列リテラルは……どうしましょうね？ (^^;

*1: カラーコードを見てコメント色だったら無視するとか、やろうと思えばどうにかできます。が、コメント内で実行したときはどうしようとか、選択範囲がコメント内外にまたがってたらどうしようとか、いろいろと面倒になるので実装してません。

XHTML で使う場合

空要素タグは簡略終了タグを使って <br/>, <br /> のように書きます。「/」の前にスペースがあってもなくてもかまいません。簡略終了タグを使わず <br></br> のように書く場合は、 br を $OmitEndTag と $MustOmitted から削除してください。
終了タグを挿入するかしないかはあくまで要素名によって判断されます。簡略終了タグを書いてもその要素が閉じていると判断されるわけではありません。

<div>　<a name="section1" />　| → <div>　<a name="section1" />　</a>|

バージョン履歴

Version 4.10 (2003/05/05)

スマートインデント機能を実装

Version 4.03 (2003/04/12)

エラー発生時カーソルを最初の位置へ

Version 4.02 (2002/12/31)

終了タグ内で実行したとき文頭まで消えるバグ修正
初期化と後始末を手抜き（不要だった設定変更処理を省略）
サブルーチン共通化（DeleteTag.mac と同じ SeekPairUp を使用）

Version 4.01 (2002/11/26)

終了タグを省略する設定が利いてなかったバグ修正

Version 4.0 (2002/11/18)

正式版
単独タグの直後で実行したときはカーソルをタグ間に移さない

Version 4 beta 1 (2002/11/08)

範囲選択時の処理を実装

Version 4 alpha 1 (2002/10/19)

スクラッチから書き直し
「終了タグ省略可」に対応
タグ内の改行と区切り文字に関する制限を撤廃

Version 3.3 (2002/07/26)

範囲選択時とタグ内実行時の動作を変更
検索バッファを保存

Version 3.2 (2001/10/13)

検索での表示を自動設定

Version 3.1 (2001/10/12)

範囲選択時とタグ内実行時の動作を工夫

Version 3.0 (2001/10/12)

高速化：ネスト内をスキャンしない
マーク宣言にはヒットさせない

Version 2.1 (2001/10/11)

実行時間計測機能を付加

Version 2.0 (2001/10/02)

要素名の照合ロジックを前方一致から完全一致へ
XHTML に対応

Version 1.4 (2001/10/01)

要素名の大文字／小文字を保持

Version 1.3 (2001/09/12)

高速化？：単独タグの数と文字数を先に取得

Version 1.2 (2001/07/01)

省略するはずの終了タグがあった場合に対応

Version 1.1 (2001/01/23)

ほぼ初版

旧バージョン

CloseTag33.mac　Version 3.3　(2002/07/26)　6,591バイト
closetag33.shtml　ドキュメント

参考文献

フィードバック

バグ報告・提案・質問・ツッコミなどは談話室へどうぞ。

`<DIV> <P> <HR>`\|	→	`<DIV> <P> <HR> </DIV>`\|		`<DIV> <P> <HR> </DIV>`\|		`<DIV> <P> <HR> </P>`\|
		正しい実行結果		p が (2) に含まれているとき（正）		p が (2) に含まれていないとき（誤）

`<DL> <DT> <DD>　</DD>`\|	→	`<DL> <DT> <DD>　</DD> </DL>`\|		`<DL> <DT> <DD>　</DD> </DL>`\|		`<DL> <DT> <DD>　</DD> </DT>`\|
		正しい実行結果		dt が (2) に含まれているとき（正）		dt が (2) に含まれていないとき（誤）