模組: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 輔助函數。