📃
Wz Editor 10で学ぶText-Cマクロ入門：フォルダ内HTMLの一括操作

2024/09/15に公開
マクロ
テキストエディタ
wzeditor
tech
 はじめにテキストエディタの「マクロ」という機能、聞いたことはあるけど、実際に使い始めるには少しハードルが高いように感じたことはありませんか？私もその一人でした。しかし、ある時、大量のHTMLファイルに対して同じ処理を繰り返す作業が発生し、その時に「これは手作業では無理だ」と実感しました。そこでWz Editor 10のマクロ機能に挑戦することにしたのです。
最初は設定の方法や仕組みが複雑で、何度も試行錯誤を繰り返しましたが、少しずつ慣れてくると、効率化の効果は絶大でした。この記事では、私が実際に体験したマクロの導入プロセスや、どうやってマクロを使って効率化を図ったのかを、具体的な例を交えながらご紹介します。これを読めば、あなたもマクロを使って作業を自動化する第一歩を踏み出せるはずです！

 Wz Editor 10のマクロとは？マクロとは、一言で言うと「一連の操作を自動化するためのスクリプト」です。特定の手作業を何度も繰り返す代わりに、マクロを使えば、あらかじめ設定した処理を自動的に実行してくれます。Wz Editor 10には、このマクロ機能が備わっており、繰り返し作業や面倒なテキスト処理を驚くほど簡単に自動化できます。
たとえば、ディレクトリ内の複数のファイルを一括で処理する場合、通常であれば1つ1つのファイルを手作業で編集する必要があります。しかし、Wz Editor 10のマクロを使うことで、その一連の作業を自動的に処理することが可能になります。私も、大量のHTMLファイルに対して同じ操作を繰り返す必要があったため、この機能を使い始めました。
最初は「マクロ」と聞くと難しそうに思えるかもしれませんが、実際に使い始めるとその便利さに驚くはずです。特にWz Editor 10では、比較的シンプルなコマンドから複雑な自動化まで対応しており、作業効率が大幅に向上します。

 実際にマクロを使ってみようそれでは、実際にWz Editor 10でマクロを使って、ディレクトリ内のindex.htmlファイルを一括で処理する方法を見ていきましょう。マクロの魅力は、テキストエディタの持つ強力なテキスト処理機能を活かしながら、繰り返し作業を自動化できる点にあります。具体的な手順を順を追って説明しますので、試しながら進めてみてください。

 マクロの準備Wz Editor 10のマクロ機能には、キーボード操作を記録する簡易なマクロだけでなく、C言語に似たプログラミング言語「Text-C」を使って、より複雑な処理を自動化することができます。今回は、この「Text-C」を使って外部ファイルを扱うマクロプログラムを作成する方法を紹介します。
まず、マクロプログラムファイルを作成するには、以下の手順を実行してください。

 マクロの新規作成メニューから「マクロ」→「マクロの新規作成」を選択すると、新規作成のダイアログが表示されます。ここで、以下の項目を入力します。

作者名: 自分の名前やIDを入力します。

ファイル名: マクロプログラムのファイル名を指定します。

関数名: メインとなる関数の名前を設定します。

 マクロプログラムファイルの保存場所マクロプログラムファイルは、Wz Editorが管理するフォルダ wzcfg://textc に自動的に保存されます。このフォルダは、エディタの設定ファイルやカスタマイズファイルが管理される場所です。

 基本的なマクロのひな形新規のマクロを生成する際に「サンプルなし」を指定しても、次のような基本的なひな形が自動的に生成されます。このコードは、開いているエディタのテキストハンドルと画面ハンドルを取得するための最低限のマクロです。
#include <windows.h>
#include <text.h>

ModifyAll {
    title: HTLM一括変更情報取得処理
    HTEXT text = getfocus();
    HVIEW v = text.v;
}
このマクロ自体は何も処理を行いませんが、保存後に「マクロ」→「コンパイル」を実行し、次に「マクロ」→「実行」を選択することで、マクロを実行できるようになります。

 ディレクトリ内のHTMLファイルを処理次に、基準となるフォルダを指定し、ディレクトリ内のHTMLファイルを処理するマクロの作成手順を見ていきましょう。このマクロでは、まず基準となるフォルダを指定し、そのフォルダ内のサブディレクトリを走査して、index.htmlファイルに対して特定の処理を行います。

 基準フォルダの指定最初に、基準となるフォルダを指定します。ユーザーにフォルダ選択ダイアログを表示し、選択されたフォルダのパスを取得します。
txstr szFolder = new();
uiSelectFolder(szFolder, "基準となるフォルダを指定");

 ディレクトリを走査し、ファイルを検索次に、基準フォルダを元に、OSの機能を利用してディレクトリ内のファイルやサブディレクトリを検索します。この部分は、典型的なディレクトリサーチのパターンですが、ファイル名の処理に癖があります。
WIN32_FIND_DATA ffd;  // ファイル情報を格納する構造体
// 基準ディレクトリ内を走査するためのパスに変更する
pathsetdir(szFolder, TRUE);
pathsetfile(szFolder, "*");
// 最初のファイルまたはディレクトリを検索
HANDLE hfind = filefindfirst(szFolder, &ffd);
if (hfind == INVALID_HANDLE_VALUE) {
    iprintf("can not open %s\n", szFolder);
    return;
}
do {
    // ディレクトリのみを対象とする
    if (ffd.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
        // 現在のディレクトリ（"."）および親ディレクトリ（".."）をスキップ
        if (!ffdisdotdir(&ffd)) {
            // サブディレクトリのフルパスを構築
            txstr htFindFileName = new();
            insertw(htFindFileName, ffd.cFileName);  // 文字列をSJISに変換して挿入
            // 処理対象のディレクトリ名に特徴がある場合の例
            if (txSearchEx(htFindFileName, "^\\w{3}_", SEARCH_ALL|SEARCH_REWZ)) {
                txstr htSubDirName = dup(szFolder);
                pathsetfile(htSubDirName, htFindFileName);
                // ここが本来させたい処理になり、htFindFileNameが対象のディレクト名を保持している
                iprintf("Target File = %s\n", htFindFileName);  // for DEBUG
                procIndexHtml(htSubDirName);  // index.htmlの処理を呼び出す
                delete(htSubDirName);
            } else {
                // パターンに一致しない場合は処理をスキップ
                iprintf("unmatch = %s\n", htFindFileName);
            }
            delete(htFindFileName);
        }
    }
} while (filefindnext(hfind, &ffd));  // 次のファイルまたはディレクトリを検索

// ハンドルを閉じる
filefindclose(hfind);
このコードでは、ディレクトリ内のサブディレクトリを走査し、ディレクトリ名が特定のパターンに一致する場合に、そのディレクトリ内のindex.htmlファイルを処理するようにしています。

 index.htmlファイルを処理実際の処理は、procIndexHtml関数内で行います。この関数では、指定されたディレクトリ内のindex.htmlファイルを開き、その内容を読み込んで特定の処理を施します。
void procIndexHtml(HTEXT htSubDirName) {
    // 受け取ったディレクトリ名に \index.html を付加する
    HTEXT htFileName = dup(htSubDirName);
    pathsetdir(htFileName, TRUE);
    pathsetfile(htFileName, "index.html");
    iprintf("FILE: %s\n", htFileName);  // for DEBUG

    // 対象の index.html をテキストに読み込む
    HTEXT htTemp = new();
    if (load(htTemp, htFileName)) {
        tosjis(htTemp, detectkc(htTemp));  // 文字コードを自動判定し、SJISに変換する
        // TODO: ここで htTemp テキストに対してやりたい処理を施す
    }

    // 後処理
    clear(htTemp);
    delete(htTemp);
    delete(htFileName);
}
この処理により、指定されたindex.htmlファイルの内容を取得し、必要に応じて文字コードを変換したり、特定の操作を実行できます。

 試行錯誤とトラブル対処マクロを作成する際に最も苦労したポイントは、検索時のパターンマッチが正しく動作しなかったことです。ファイル名やテキストを検索する際、正規表現を使用する必要がありましたが、正しくマッチさせるために試行錯誤した結果、事前にSJISへ変換しておくことが鍵となりました。マルチバイト文字が含まれるファイルやテキストでは、エンコードが影響し、SJISに変換しないとうまく動作しないケースが多かったのです。
この方法がうまくいった例として、HTMLドキュメントを対象にしたprocIndexHtml関数を以下のように修正しました。この関数では、index.htmlファイルからタイトルを抜き出す処理を行っています。
void procIndexHtml(HTEXT htSubDirName) {
	HTEXT htFileName = dup(htSubDirName);
	pathsetdir(htFileName,TRUE);
	pathsetfile(htFileName,"index.html");
	HTEXT htContents = new();
	if (load(htContents, htFileName)) {

		tosjis(htContents, detectkc(htContents));	// 文字コードを自動判定し、SJISに変換する

		// このサンプルではHTMLドキュメントからタイトルを抜き出してくる
		int len;
		if (len = txSearchEx(htContents, "<title>", 0)) {   // SJIS変換していないとなぜかマッチしない
			HTEXT htGet = new();
			txRightBytes(htContents, len - 1);  // 検索できた文字数を元にカーソル移動する
			txGetParaRear(htContents, htGet);   // タイトルタグが一文で書かれている前提
			txReplaceEx(htGet, "</title>", "", SEARCH_ALL); // タグ削除
			information("TITLE:%s", htGet);		// 結果をダイアログ表示する
			delete(htGet);
		}

	}
	clear(htContents);
	delete(htContents);
	delete(htFileName);
}
もう一つのポイントは、文字単位・単語単位・段落（行）単位を使い分けることです。特に、文字単位での操作や検索結果に基づくカーソル移動は、意図通りに動作させるのが難しく、どうしても試行錯誤が必要です。操作対象によって、単語単位や行単位の処理も柔軟に使い分けることがポイントです。

 まとめWz Editor 10の「Text-C」マクロを使って、ディレクトリ内のHTMLファイルを処理する自動化の手法を紹介しました。マクロを使うことで、手作業では時間がかかる複雑な作業を効率的に処理できるようになります。特に、今回はパターンマッチのためにSJISへの事前変換が重要であることや、文字単位・単語単位・段落単位を使い分ける必要があるという試行錯誤を経て、マクロを実用化することができました。
最初は慣れない部分もあるかもしれませんが、一度基本を押さえれば、日常の作業の大幅な効率化を実感できるはずです。小さなマクロから始めてみて、少しずつ自分のワークフローに合わせた自動化を進めていくことで、さらなる時間短縮や作業の最適化が実現します。
ぜひ、この記事を参考に、あなたもWz Editor 10のマクロで自分だけの効率化ツールを作り上げてください。
GitHubで編集を提案
Wz Editor 10で学ぶText-Cマクロ入門：フォルダ内HTMLの一括操作

はじめに

Wz Editor 10のマクロとは？

実際にマクロを使ってみよう

マクロの準備

マクロの新規作成

マクロプログラムファイルの保存場所

基本的なマクロのひな形

ディレクトリ内のHTMLファイルを処理

基準フォルダの指定

ディレクトリを走査し、ファイルを検索

`index.html`ファイルを処理

試行錯誤とトラブル対処

まとめ

Discussion
