模块:Conversion rule extractor

模块文档[查看] [编辑] [历史] [清除缓存]

本模块用于提取指定页面的字词转换规则（包括手动规则和公共转换组规则），并根据需要筛选出能在特定目标页面或标题上匹配使用的规则，最终以不同格式输出。

子模块

• Module:Conversion_rule_extractor/Extractor – 用于提取规则
• Module:Conversion_rule_extractor/Matcher – 用于匹配规则

函数

getRules

获取指定来源页面的所有内容转换规则（手动+公共组），并筛选出能在目标页面内容中匹配到的规则。

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

参数：

• from 或匿名参数 1: (必须) 字符串，规则来源页面的标题。
• to: (可选) 字符串，用于匹配规则的目标页面标题。默认为调用模块的当前页面。
• flag: (可选) 字符串，指定输出规则的旗标。
  • H (默认): 输出为-{H|规则;}-格式。
  • raw: 直接输出规则文本，每条规则占一行。
  • 其他值 (如 A, D): 输出为-{值|规则;}-格式。

返回值： 字符串，格式化后的、能在目标页面匹配到的内容转换规则。如果来源页不存在或无匹配规则，返回空字符串。如果缺少 from 参数，返回错误提示信息。

getTitleRule

获取应用于指定来源页面标题的转换规则。

• 如果来源页面有显式的标题 (T) 规则，则使用该规则。
• 如果没有显式标题规则，则尝试将来源页面的所有内容规则与其标题文本进行匹配，使用匹配到的规则。

调用方式： {{#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参数或来源页不存在，返回错误提示信息。

参见

• {{NoteTA-lite}}

上述文档嵌入自Module:Conversion rule extractor/doc。 (编辑 | 历史)
编者可以在本模块的沙盒 (创建 | 镜像)和测试样例 (创建)页面进行实验。
本模块的子页面。

-- Module:Conversion_rule_extractor
-- 主模块：处理调用参数，协调子模块，格式化输出

local p = {}

local Extractor = require('Module:Conversion_rule_extractor/Extractor')
local Matcher = require('Module:Conversion_rule_extractor/Matcher')
local WikitextLC = require('Module:WikitextLC')
local Arguments = require('Module:Arguments')

-- 格式化输出规则列表 (确保使用规范化的规则)
local function formatRules(rules, flag)
    flag = flag or 'H' -- 默认 H
    local output = {}

    -- 输入的 rules 应该已经是 Extractor.normalizeRuleString 处理过的

    if flag == 'raw' then
        -- 直接连接，每条规则已包含分号
        return table.concat(rules, "\n")

    elseif flag == 'H' then
        for _, rule in ipairs(rules) do table.insert(output, WikitextLC.hidden(rule)) end -- 输出 -{H|rule;}-

    elseif flag == 'T' then
        -- 理论上只应在显式 T 规则存在且请求 flag=T 时使用
        -- 注意：WikitextLC.title 输出 -{T|rule;}-
        for _, rule in ipairs(rules) do table.insert(output, WikitextLC.title(rule)) end

    else -- 其他 flag，例如 A, D 等，直接用作旗标
        local pattern = '-{' .. flag .. '|%s}-'
        for _, rule in ipairs(rules) do
            if rule and rule ~= '' then
                table.insert(output, string.format(pattern, rule))
            end
        end
    end
    return table.concat(output)
end

-- 用于 type=context 且有 T 规则时的基本转换格式 -{rule;}-
local function formatRawContextRule(rule)
    if rule and rule ~= '' then
        return '-{' .. rule .. '}-'
    else
        return ''
    end
end

-- 获取并过滤内容规则
function p.getRules(frame)
    local args = Arguments.getArgs(frame)
    local fromPage = args.from or args[1]
    local toPage = args.to or mw.title.getCurrentTitle().prefixedText -- 默认为当前页面
    local flag = args.flag or 'H'

    if not fromPage then
        return '<span class="error">错误：未指定规则来源页面（需要 "from" 或匿名参数 1）。</span>'
    end

    local fromTitleObj = mw.title.new(fromPage)
    if not fromTitleObj or not fromTitleObj.exists then
        -- 来源页不存在时，Extractor 返回空规则，最终输出空字符串
    end

    local allRules = Extractor.getAllRules(fromPage)
    if not allRules then return '' end

    local applicableContentRules = Matcher.filterRules(allRules.contentRules, toPage)

    return formatRules(applicableContentRules, flag)
end

-- 获取标题转换规则 (type=context 无 T 规则时恢复为 H 旗标 + 原始文本)
function p.getTitleRule(frame)
    local args = Arguments.getArgs(frame)
    local fromPage = args.from or args[1]
    local flag = args.flag or 'H'
    local typeParam = args.type

    if not fromPage then
        return '<span class="error">错误：未指定规则来源页面（需要 "from" 或匿名参数 1）。</span>'
    end

    local titleObj = mw.title.new(fromPage)
    if not titleObj or not titleObj.exists then
         return '<span class="error">错误：来源页面 "' .. fromPage .. '" 不存在。</span>'
    end

    local allRules = Extractor.getAllRules(fromPage)
    if not allRules then return '' end

    local finalTitleRules = {}

    if allRules.titleRule and allRules.titleRule ~= '' then
        finalTitleRules = { allRules.titleRule }
    else
        finalTitleRules = Matcher.filterRulesAgainstTitleText(allRules.contentRules, fromPage)
    end

    if #finalTitleRules == 0 then
        return ""
    end

    if typeParam == 'context' then
        local output
        if allRules.titleRule and allRules.titleRule ~= '' then
            -- Case 1: 显式 T 规则，使用 -{rule;}- 格式
            output = formatRawContextRule(allRules.titleRule)
        else
            -- Case 2: 内容规则匹配标题，输出 -{H|...}- 规则 + 原始标题文本
            local hiddenRules = formatRules(finalTitleRules, 'H') -- 使用 H 旗标格式化规则
            output = hiddenRules .. titleObj.text -- 附加原始标题文本
        end
        return output
    else
        -- 常规处理：根据 flag 输出规则本身
        local outputFlag = flag
        if not allRules.titleRule and outputFlag == 'T' then
            outputFlag = 'H' -- 如果规则来自内容，不允许 T 旗标，强制 H
        end
        return formatRules(finalTitleRules, outputFlag)
    end
end

return p