模組:萌點/doc

簡介

本模塊用於實現Template:萌點的主要功能：將輸入的萌點參數按照相應的轉換規則，轉換為帶格式的連結並添加分類。本模塊使用的具體對應規則請見Module:萌點/data。

此文檔主要面向需要對模塊本身進行修改的編輯者。若需要增加新的連結/分類對應規則，請於Module:萌點/data處進行修改。

模塊結構

依賴模塊

• Module:Arguments - 獲取參數
• Module:萌点/data - 萌點連結/分類轉換規則數據
• Module:Split2 - 用於字符串分割

核心函數

p.trim(x)

• 用於去除萌點名稱末尾的括號內容
  • 使用正則表達式 pattern = "[%s]*[(][^）)\n]*[)][%s]*$"
  • 示例: "女王(身份)" → "女王"

p.proc(str1, control, frame)

• 應用文本格式化控制
• 支持的格式控制符:

控制符	效果	示例
黑幕/heimu	黑幕效果	文本
del	刪除線	文本
加粗/b	加粗	文本

p.proc2(str)

• 用於確定萌點的連結部分（即「[[A|B]]」中「A」的部分）
• 處理優先級：
  1. data.link_rules.direct_mapping (直接映射規則)
  2. data.link_rules.suffix_mapping (是否需要添加後綴)
  3. data.link_rules.special_professions (職業類型萌屬性單獨區分，後加「(萌屬性)」)
  4. 若不符合上述規則，默認返回原始字符串

p.proc3(name, rawname, link, frame)

• 用於生成萌點分類
• 處理規則:
  1. 檢查是否需要添加「需要檢查」維護分類（當原始名稱包含括號，但不在「免檢」範圍時）
  2. 特殊規則處理：
     • 能力者類萌點自動添加「者」後綴（但於data.ability_exceptions處排除一些以「能力」結尾的萌屬性）
     • 使用data.category_rules.direct_mapping和data.category_rules.suffix_mapping進行匹配
  3. 最終通過ac模板生成分類

p._main(args, frame)

• 用於主處理邏輯
• 參數格式:
• 輸入萌點支持三種格式：
  1. 呆毛 → 基本格式
  2. 眼镜,黑幕 → 帶格式控制
  3. 黑色过膝袜,黑丝,del → 自定義顯示名稱+格式

• 處理流程:
  1. 用逗號/中文逗號分割參數
  2. 應用連結規則(proc2)和格式(proc)
  3. 添加分類(proc3)
  4. 若有多個萌點參數，則用頓號連接

需要注意的是，如果某個參數由三部分組成（即「link, name, control」），那麼雖然分類會按照對應規則進行處理，但條目名及連結名不會進行處理。這是由於本模塊認為用戶在此種情形下希望自行決定連結轉換方法，而不是按照已有規則進行轉換。