睇模組ぐみ:Citation/CS1/doc嘅程式しき碼

== 概論 ==

《'''CS1|2'''》係維基百科引用系統嘅骨幹。維基百科嘅主要[[:Category:引模|引模]]基本上都依賴呢堆 Lua 模組，而呢啲引模係通過 [[Wikipedia:VisualEditor|VisualEditor]] 同維基數據等等工具喺唔同維基百科版本之間流通嘅。《CS1|2》呢個名嘅出現係因為曾經有分 CS1 同 CS2 ('''C'''itation '''S'''tyle 1/2)，但後來兩批模組合併咗，而家淨係有 CS1。

《CS1|2》系列有八個模組加一張 [[CSS]]。更新嘅時候要全組一齊更新：
{| class="wikitable" style="margin: 1em auto 1em auto;"
|-
! 模組名 !! 本地化備註
|-
| [[Module:Citation/CS1]] || 有本地化，修正用其他方法修正唔到嘅嘢（第xx年版→xx年版；正確處理例如zh-hk、cmn之類嘅語文名）、中文姓名之間唔加逗號。用「END LOCAL」關鍵字可以搵到。
|-
| [[Module:Citation/CS1/Configuration]] || 有本地化，要譯晒啲訊息字串，但係維修分類名就由佢留返英文。
|-
| [[Module:Citation/CS1/Whitelist]] || 照抄英維
|-
| [[Module:Citation/CS1/Date validation]] || 有本地化，同中維一樣加咗額外程式碼去處理漢字日期格式。用「END LOCAL」關鍵字可以搵到。
|-
| [[Module:Citation/CS1/Identifiers]] || 照抄英維
|-
| [[Module:Citation/CS1/Utilities]] || 有本地化，修正用其他方法修正唔到嘅嘢（中文書名唔用斜體）。用「END LOCAL」關鍵字可以搵到。
|-
| [[Module:Citation/CS1/COinS]] || 照抄英維
|-
| [[Module:Citation/CS1/Suggestions]] || 照抄英維
|-
| [[Module:Citation/CS1/styles.css]] || 有本地化。用「END LOCAL」關鍵字可以搵到。
|}

由於以下四個模係直接靠 Module:Citation/CS1 生成嘅，而 [[Wikipedia:VisualEditor|VisualEditor]] 同 [[User:InternetArchiveBot|InternetArchiveBot]] 又會靠佢哋嘅 TemplateData 嚟自動處理引用內容，所以每次更新嘅時候要更新埋呢四個模嘅 TemplateData：
*[[Template:Cite web]]
*[[Template:Cite news]]
*[[Template:Cite book]]
*[[Template:Cite journal]]

而家用開嘅版本係2020年3月引入嘅。源碼基本上抄英文；本地化內容方面，日期部分已經喺2022年改咗用同中文版唔同嘅方法處理，其他本地化亦都同中文版無關。

<!--
<code><nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}|''function_name''}}</code>
-->

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:CS1]]
}}</includeonly>