模組:Conversion rule extractor/doc

此頁面為 Module:Conversion rule extractor 的說明文件

此頁面是Module:Conversion rule extractor的模組文件。
此頁面可能包含了模板的使用說明、分類和其他內容。

此模組文件已評為alpha版，可接受第三方輸入，並可用於少量頁面以檢查是否存在問題，但需要受到檢查。歡迎提供新功能或修改其輸入輸出機制的建議。

此模組使用Lua語言：

本模組用於提取指定頁面的字詞轉換規則（包括手動規則和公共轉換組規則），並根據需要篩選出能在特定目標頁面或標題上匹配使用的規則，最終以不同格式輸出。

子模組

獲取指定來源頁面的所有內容轉換規則（手動+公共組），並篩選出能在目標頁面內容中匹配到的規則。

調用方式： {{#invoke:Conversion_rule_extractor|getRules|from=来源页面|to=目标页面|flag=输出格式}}

參數：

from 或匿名參數 1: (必須) 字串，規則來源頁面的標題。
to: (可選) 字串，用於匹配規則的目標頁面標題。預設為調用模組的當前頁面。
flag: (可選) 字串，指定輸出規則的旗標。
- H (預設): 輸出為-{H|规则;}-格式。
- raw: 直接輸出規則文本，每條規則占一行。
- 其他值 (如 A, D): 輸出為-{值|规则;}-格式。

返回值： 字串，格式化後的、能在目標頁面匹配到的內容轉換規則。如果來源頁不存在或無匹配規則，返回空字串。如果缺少 from 參數，返回錯誤提示資訊。

獲取應用於指定來源頁面標題的轉換規則。

調用方式： {{#invoke:Conversion_rule_extractor|getTitleRule|from=来源页面|flag=输出格式|type=输出类型}}

參數：

from 或匿名參數 1: (必須) 字串，規則來源頁面的標題。
flag: (可選) 字串，指定輸出規則的旗標（當type不為context時生效）。
- H (預設): 輸出為-{H|规则;}-格式。
- raw: 直接輸出規則文本，每條規則占一行。
- 其他值: 輸出為-{值|规则;}-格式。如果規則來源於內容規則匹配，即使指定flag='T'，也會強制使用H。
type: (可選) 字串，指定輸出類型。
- context: (特殊模式) 如果存在顯式T規則，輸出為-{T规则;}-。如果不存在顯式T規則，但有內容規則匹配標題，輸出為-{H|匹配的内容规则;}-原始标题。
- 其他值或省略: 按flag參數指定的格式輸出規則本身。

返回值： 字串，格式化後的標題轉換規則或帶規則的標題文本。如果來源頁不存在或無適用規則，返回空字串。如果缺少from參數或來源頁不存在，返回錯誤提示資訊。