「カッコで囲う」を編集中 (節単位)

=== メニューの項目 ===
==== 任意の文字列で囲う ====
文字入力用のダイアログで「前につける文字列」と「後ろにつける文字列」を指定します。

* '''任意の文字列１'''
:: 選択範囲全体を '''一組の''' 指定文字列で前後を囲います。
* '''任意の文字列２'''
:: 選択範囲内の '''各行ごとに''' 指定文字列で前後を囲います。ソースコード冒頭の設定項目 '''''skip''''' フラグで、複数行選択のさいに空白行をスキップするか指定してください。「wiki 文字装飾タグ」以外のカッコ／記号で '''各行ごとに囲いたい場合は、「任意の文字列２」を使用してください。'''

改行コードとタブ文字は、それぞれ「'''\\\n'''」と「'''\\\t'''」で入力されたもの (注:￥記号３つ) を改行コードとタブ文字に置換するようにしてあります。

※「\n」、「\t」と入力するとそのままの文字列「\n」、「\t」を返します。

※ 文字コードでの入力には非対応です（入力されたままの文字列を返します）。

==== カッコ／記号 で囲う ====
選択範囲全体を指定したカッコ／記号で囲います。

選択範囲なしで実行した場合は、カーソル位置にカッコ一組を挿入します。

*  (半角丸カッコ) 、 <半角山カッコ> 、 [半角角カッコ] 、 {半角波カッコ}、 （全角丸カッコ） 、 「全角かぎカッコ」 、 『二重かぎカッコ』 、 【スミ付きカッコ】
: ⇒ 選択範囲をカッコで囲います。

* ␣(半角丸カッコ)␣ 、 ␣"半角二重引用符"␣
: ⇒ 選択範囲をカッコまたは引用符で囲い、さらに半角スペースで囲います。

* ␣半角スペース␣
: ⇒ 選択範囲を半角スペースで囲います。

*  - 半角ハイフン -  、 ――ダッシュ×２―― 、 ～チルダ～
: ※ 「半角ハイフン」は、半角ハイフン=マイナス記号 <code>-</code> の '''両側''' に各１つずつ半角スペースがつきます（片側で半角３文字分）。
: ※ このグループにかぎり、選択範囲なしで実行したときは、片側分だけ　"<span style="color:#c0c0c0;">␣</span>-<span style="color:#c0c0c0;">␣</span>"　"――"　"～"　記号を挿入します。

----
●以下の '''削除系の各コマンド''' は、選択範囲がないときにはポップアップメニューに表示されません。

==== ひとつ削除 ====
* 「[[カッコをはずす]]」マクロのコードを移植しました。'''選択範囲全体の先頭/末尾''' があらかじめ用意された「対になるカッコ・記号」のペアであれば、その一組のペアを削除します。

※ ポップアップメニューの "カッコの追加用の項目" にない多種多様な記号のペアに対応します。

※「カッコをはずす」マクロの "選択範囲の外側 (前と後) にあるカッコの削除" 機能はありません。

==== 任意の 文字列／文字数 を削除 ====
「任意の文字列２」や「wiki用 マークアップ」と同様に、選択範囲内の論理行の '''各行頭と行末にたいして''' 作用します。

※ 選択範囲を "論理行単位" で拡張しないので、先頭行と末行においては行頭/行末ではなく「選択範囲の先頭/末尾」にたいして作用します。

* '''任意の文字数を削除''' ではアラビア数字（半角/全角）以外で入力された文字列をすべて無視します。例えば「'''1a２あ'''」と入力された場合は、半角数字の「'''12'''」として扱います。
* '''任意の文字列を削除''' は簡易的な処理コードなので、正規表現を使用できません。また、タブ文字の扱いは「任意の文字列２（追加）」の場合とおなじく「'''\\\t'''」で入力されたもの (注:￥記号３つ) をタブ文字（'''\t'''）として処理します。

==== 先頭／末尾の空白を削除 ====
* '''先頭／末尾から空白を削除'''
* '''先頭の空白を削除'''
* '''末尾の空白を削除'''
: ⇒ 選択範囲内の論理行の '''各行頭と行末にたいして''' 作用します。
:: 削除対象の空白文字は、「半角スペース」「全角スペース」「タブ文字」の３種です。インデント（字下げ）の解除や、行末のムダな空白文字の削除に利用できます。

※ 選択範囲を "論理行単位" で拡張しないので、先頭行と末行においては行頭/行末ではなく「選択範囲の先頭/末尾」にたいして作用します。

※ 空白を削除するだけで、「空行を削除する」ものではありません。

==== ｎ文字ずつ前後を削除 ====
* '''１文字ずつ前後を削除'''
* '''２文字ずつ前後を削除'''
* '''３文字ずつ前後を削除'''
: ⇒ '''選択範囲全体の先頭/末尾から''' 指定の文字数ずつ削除します。

* '''１文字ずつ前後を削除（外側）'''
: ⇒ '''選択範囲全体の前と後ろの''' 各１文字を削除します。
※ 選択範囲が先頭行の行頭から始まっている場合や、最終行の行末で終わっている場合は、選択範囲内の先頭または末尾の１文字が削除されます。

----

==== JS / XML コメントアウト ====
３種類の '''挿入型コメントアウト''' のメタ記号で選択範囲の文字列をコメントアウトできます。また、アンコメント用のコマンドでコメントアウト状態を解除できます。
* '''/* JavaScript 挿入型コメントアウト１ */'''
: ⇒ 選択範囲全体を '''<code>/* </code>''' と ''<code>' */</code>''' で囲います。

* '''/* *JavaScript コメントアウト２（ブロックコメント） */'''
:: /* <br>  * （複数行の）選択範囲全体を　"'''<code>/* \n</code>'''"　と　"'''<code>\n */</code>'''"　で囲い、<br>  * 範囲内の各行の行頭に　"'''<code> * </code>'''"　を付けます。<br>  */

* '''<nowiki><!-- XML 挿入型コメントアウト --></nowiki>'''
: ⇒ 選択範囲全体を　'''<syntaxhighlight lang="javascript" inline><!-- </syntaxhighlight>'''　と　'''<syntaxhighlight lang="javascript" inline> --></syntaxhighlight>'''　で囲います。

* '''JS アンコメント'''
* '''XML アンコメント'''
: ⇒ 上の３種のコメントアウトのメタ記号を削除してアンコメントします。

※ <u>先頭と末尾のコメントマークは選択範囲の両端でなければ削除されません</u>（選択範囲の先頭/末尾に半角スペース×１が付いていても、コメントマークといっしょに削除できます）。また、選択範囲内に２組以上のコメントがあると、正常にアンコメントできません。

※ "JS アンコメント" は中間行の行頭記号（アスタリスクと全角/半角中黒）とその前後の半角スペースを削除します。これらの行頭記号を使用した'''箇条書き'''を範囲選択して実行すると、同様に行頭記号を削除します。

※ プログラミングをしない人には使いみちがないとおもいますので、ZIP のソースでは初期状態でコメントアウトしてあります。

==== Wiki用 マークアップ ====
５種類の wiki用 文字列装飾タグ（[https://www.mediawiki.org/wiki/Help:Formatting/ja テキスト整形マークアップ]）を挿入できます。

選択範囲内の '''各行ごとに''' 指定のタグで前後を囲います。ソースコード冒頭の設定項目 '''''skip''''' フラグで、複数行選択のさいに空白行をスキップするか指定してください。

* '''太字'''
: ⇒ 選択範囲全体を '''<syntaxhighlight lang="javascript" inline>'''</syntaxhighlight>'''（シングルクオート×３） で囲います。

* ''斜体（Italic）''
: ⇒ 選択範囲全体を '''<syntaxhighlight lang="javascript" inline>''</syntaxhighlight>'''（シングルクオート×２） で囲います。

* <u>下線</u>
: ⇒ 選択範囲全体を　'''<syntaxhighlight lang="javascript" inline><u></syntaxhighlight>'''　と　'''<syntaxhighlight lang="javascript" inline></u></syntaxhighlight>'''　で囲います。

* <nowiki>[[内部リンク]]</nowiki>
: ⇒ 選択範囲全体を　'''<code>[[</code>'''　と　'''<code>]]</code>'''　で囲い、<nowiki>[[リンク|ラベル]]</nowiki> 型の [https://www.mediawiki.org/wiki/Help:Links/ja#Internal_links 内部リンク] にします。

* <nowiki>マークアップ回避</nowiki>
: ⇒ 選択範囲全体を　'''<code><nowiki></code>'''　と　'''<code></nowiki></code>'''　で囲います。

※ wiki用 文字列装飾タグのままでは使いみちがないとおもいますので、HTML タグ <nowiki><a> </a></nowiki> などに書き換えてしまうか、ポップアップメニュー項目をコメントアウトしてしまうとよいでしょう（ZIP のソースでは初期状態でコメントアウトしてあります）。

==== Mery マクロ用 ====
選択範囲の文字列をコピーし、"二重引用符" つきにして、以下の各種の構文で囲います。

※選択文字列のある行の '''ひとつしたの行''' に各構文を挿入します。

※選択範囲が複数行の場合は　'''+ "\n" +'''　でつなぎ合わせます。

* '''アウトプット'''
: ⇒ <code>Outputbar.Writeln( "..." );</code>　の構文にしてアウトプットバーを表示状態にします。
* '''アラート'''
: ⇒ <code>Alert( "..." );</code>　の構文にします。
* '''コンファーム'''
: ⇒ <code>Confirm( "..." );</code>　の構文にします。
* '''ステータス'''
: ⇒ <code>Status = "...";</code>　の構文にします。

※ マクロのプログラミングをしない人には使いみちがないとおもいますので、ZIP のソースでは初期状態でコメントアウトしてあります。