手動整理 HTML 的縮排是件枯燥差事。HoTMetaL 提供了 Layout() 方法,只要呼叫它,就能依據預先定義的規則把整份文件或選取區塊重新排得整整齊齊。要注意的前提是:必須先在「工具 → 定制」中關閉 Enable Source Layout(允許來源程式版面配置)按鈕,否則編輯器會在你打字時自動排版,看不出宏的效果。
這個宏只在 HoTMetaL 啟動的那一刻被呼叫,唯一任務是定義三個代表視圖模式的常數,供後續的宏使用。
<MACRO name="On_Application_Open" lang="JScript"><![CDATA[ var viewWYSIWYG = 0; var viewTagsOn = 1; var viewSource = 2; ]]></MACRO>
這三個數字對應編輯視窗左上角那排切換鈕:所見即所得(WYSIWYG)、標籤顯示(TagsOn)以及原始碼檢視(Source)。
下面的宏會先確認目前是否處於原始碼檢視,若是就排版整份文件;若不是,則彈出提示要求使用者先切換視圖。
<MACRO name="Format Current Document" lang="JScript" id="153"
desc="Apply source layout to entire document">
<![CDATA[
if (ActiveDocument.ViewType == viewSource) {
ActiveDocument.Layout();
}
else {
Application.Alert("Applying source layout only works in source view.\nSwitch to source view and try again.");
}
]]></MACRO>
這裡用到了兩個 HoTMetaL 物件:ActiveDocument 代表目前文件,它的 Layout() 方法負責排版;Application 的 Alert() 方法則負責跳出警告方塊。
在 HoTMetaL 中開一份文件並切到原始碼檢視,可以從 ProgGuide 目錄挑一段來試。接著從「工具」菜單開啟宏對話框,你會看到 HotMetal.mcr 裡定義的宏清單;先執行 Refresh Macros 讓剛編輯的宏被載入,就能找到 Format Current Document 了。執行它,原本被你用空白往右推的那一行就會自動回到應有的位置。
接著測試 Alert():把視圖切到 TagsOn 模式再執行同一個宏,就會看到類似下圖的提示:

(圖1)
如果不想動到整份文件,只整理目前選取的區塊,宏幾乎一模一樣,差別只在 Layout() 是呼叫在 Selection 物件而非 ActiveDocument 上:
<MACRO name="Format Current Selection" lang="JScript" id="53"
desc="Apply source layout to the current selection">
<![CDATA[
if (ActiveDocument.ViewType == viewSource) {
Selection.Layout();
} else {
Application.Alert("Applying source layout only works in source view.\nSwitch to source view and try again.");
}
]]></MACRO>
假設文件中有兩行被我們刻意縮進,一行以「does not specify」開頭,另一行以「referred to in this ma:」開頭:

(圖2)
接著選取包含「does not specify:」那三行:

(圖3)
最後點擊視窗左上角那個綠色箭頭,從下拉選單中挑選 Format Current Selection:

(圖4)
結果很有意思:被選取的那幾行已經依段落邊界重新排好了,而落在選取範圍之外、同樣被縮進的「referred to in this ma」那一行則完全沒被更動。這正好驗證了 Selection 與 ActiveDocument 的作用範圍差異。