模块:Common/doc

概述

Common 提供中文百科 Lua 模块的基础通用能力，包括参数读取、JSON 数据页加载、文件存在判断和 LuaCache 辅助。

用法

local common = require('Module:Common')

local title = common.getCurrentTitleText()
local data = common.loadJsonData('数据:Item/item_mapping.json')
local key = common.normalizeKey(title)

示例

local common = require('Module:Common')

local cache_key = common.buildLuaCacheKey('demo', '1', 'example')
local cached = common.luaCacheGet(cache_key)
if cached == nil then
    cached = common.trim(' test ')
    common.luaCacheSet(cache_key, cached, 300)
end
return cached

函数

• trim：去除首尾空白。
• getArg：从 frame 与父级模板中读取参数。
• toText：将布尔值、数组或普通值转成文本。
• normalizeKey：统一键名格式。
• loadJsonData：安全读取数据页 JSON。
• getCurrentTitleText：返回当前页面标题。
• filePageExists：判断文件页是否存在。
• getFilePath：获取文件路径缓存值。
• buildLuaCacheKey、luaCacheGet、luaCacheSet：LuaCache 辅助函数。