LLWiki:模板指引

本指引描述LLWiki的模板頁面普遍遵循的格式。

LLWiki的模板（Template）頁面一般分為三個組成部分，依次為（1）模板文檔、（2）以分類為主的其他不可見的<noinclude>內容和（3）模板代碼。前兩項總是包裹在<noinclude>標籤內，模板引用時會被忽略。

文檔

模板文檔總是通過{{Documentation}}呈現。簡短的文檔可以使用{{Documentation}}的content參數直接書寫在當前頁面內，較長的文檔則應單獨置於模板文檔頁。模板文檔頁的頁面名稱應為「模板頁面名稱 + /doc」，如Template:Lyrics的文檔頁位於Template:Lyrics/doc。多個模板共用同一個文檔頁時，頁面名稱不對應的模板頁需使用{{Documentation}}的1參數（可以使用匿名寫法）。Template:Documentation頁面給出了幾個簡單的用法示例。

以下是一個模板文檔頁（{{doc|Template:AS song/doc}}）的實際例子。

文檔

這個文檔嵌入自Template:AS song/doc。

此模板用於列出LoveLive!學園偶像祭ALL STARS中的歌曲資訊。

若模板下的文字的排版走了樣，請在本模板下方加上{{clear|left}}。

使用時若沒有對應難度請直接刪去對應行。

參數

{{AS song
|歌名=
|Image=
|属性=
|初级LIVE力=
|初级体力=
|初级S分数=
|中级LIVE力=
|中级体力=
|中级S分数=
|上级LIVE力=
|上级体力=
|上级S分数=
|上级+属性=
|上级+LIVE力=
|上级+体力=
|上级+S分数=
|Challenge属性=
|Challenge LIVE力=
|Challenge体力=
|Challenge S分数=
|配信时间=
}}

示例

Love U my friends
		建議	LIVE力	體力	S等級分數
		初級	3200	24300	700000
		中級	6700	51300	2205000
		上級	12000	90000	7874000
		上級+	19000	144000	29280000
		Challenge	22000	171000	48000000
配信時間： 開服（1章Stage1）

{{AS song
|歌名=Love U my friends
|Image=Love U my friends.png
|屬性=smile
|初級LIVE力=3200
|初級體力=24300
|初級S分數=700000
|中級LIVE力=6700
|中級體力=51300
|中級S分數=2205000
|上級LIVE力=12000
|上級體力=90000
|上級S分數=7874000
|上級+屬性=smile
|上級+LIVE力=19000
|上級+體力=144000
|上級+S分數=2928000
|Challenge屬性=natural
|Challenge LIVE力=22000
|Challeng體力=171000
|Challenge S分數=48000000
|配信時間=開服（1章Stage1）
}}{{clear|left}}

Fantastic Departure!
		建議	LIVE力	體力	S等級分數
		初級	1450	10800	371000
		中級	3650	27900	1309000
		上級	6700	51300	4280000
	-	上級+	-	-	-
	-	Challenge	-	-	-
配信時間： 2020年07月22日15:00至今

{{AS song
|歌名=Fantastic Departure!
|Image=Fantastic Departure!.png
|屬性=elegant
|上級+屬性=
|初級LIVE力=1450
|初級體力=10800
|初級S分數=371000
|中級LIVE力=3650
|中級體力=27900
|中級S分數=1309000
|上級LIVE力=6700
|上級體力=51300
|上級S分數=4280000
|配信時間=2020年{{0}}7月22日15:00至今
}}

模板文檔通常包含以下全部內容：（1）用途描述、（2）參數列表和說明，以及（3）各種用法示例。必要的時候還需要添加特別注意事項。以上這些要素在上面的實際例子中都可以找到。如果模板引用自其他版權協議兼容的網站，還需要在外部連結章節中使用{{CCnotice}}模板說明。

繁簡轉換

由於LLWiki處理模板文檔繁簡轉換的方式特殊，這裡單獨列為一個章節。

模板文檔繁簡轉換的需求來自於兩個方面，其一是模板使用的中文參數都需配備簡體和繁體兩個互為替代的等效參數（詳見#代碼章節），其二是在說明參數或是展示示例時用到的中文表達。一般情況下MediaWiki會對中文自動進行繁簡轉換，但使用<code>和<pre>標籤（或行首空格）時，內部文本通常不會執行繁簡轉換。如果需要讓標籤內的文本實現繁簡轉換，可以在開頭添加-{}-，如<pre>-{}-內容</pre>。<code>標籤內的文本繁簡轉換還可以通過給標籤加上任意的語言屬性來實現，如<code lang="mw">字體</code>，但注意這隻適用於<code>標籤內沒有額外套<nowiki>的情形。

除了上述方法外，LLWiki還設立了{{code}}和{{pre}}兩個模板作為對應的HTML標籤的代用品，模板的參數仍會自動執行繁簡轉換。這兩個模板都只有一個匿名參數，且參數一般需要使用<nowiki>標籤包裹。

{{code}}和{{pre}}模板和對應的HTML標籤有一個極大的區別，模板參數中的Wikitext仍舊會被執行，而且即使使用轉義的字符實體也往往無效（特例見附表）。例如：

{{code|<nowiki>&lt;span style="font-style:italic"&gt;&#39;&#39;&#39;{{color|red|文本}}&#39;&#39;&#39;&lt;/span&gt;</nowiki>}}

的效果為{{color|red|文本}}。注意與此同時被<nowiki>標籤包裹的模板仍舊不會被展開。為了解決這一問題，一般需要在Wikitext語法的內部插入-{}-進行破壞。下表給出了常用Wikitext作為{{code}}和{{pre}}模板的參數時的對應寫法。

描述	Wikitext	{{code}}和{{pre}}的模板參數	說明
狀態開關	__TOC__	_-{}-_TOC__	在任意位置插入-{}-破壞。
斜體文本	''斜體''	''斜體''或 '-{}-'斜體'-{}-'	使用字符實體'或用-{}-將'分隔開，注意不要出現任意連續的兩個'。這裡'不能使用'替代。
粗體文本	'''粗體'''	'''粗體'''或 '-{}-'-{}-'粗體'-{}-'-{}-'
粗斜體文本	'''''粗斜體'''''	'''''粗斜體'''''或 '-{}-'-{}-'-{}-'-{}-'粗斜體'-{}-'-{}-'-{}-'-{}-'
章節標題	====4級標題====	-{}-====4級標題====	只有位於行首時才生效，此種情況下在開頭加上一個-{}-即可。
分割線	----	-{}-----
無序列表	*無序列表	-{}-*無序列表
有序列表	#有序列表	-{}-#有序列表
定義	;定義	-{}-;定義
縮進文本	:縮進	-{}-:縮進
預格式化文本（行首空格）	預格式化	-{}- 預格式化或  預格式化
段落	第一段 第二段	第一段<br> 第二段	其中一次換行需使用<br>標籤代替。
HTML標記	例如<!-- -->	<!-{}--- -->或 &amp;lt;!-- --&amp;gt;	在左半部分標記中插入-{}-破壞。
特殊符號	&copy;	&-{}-amp;copy;	將&轉義為&amp;，並在&後插入-{}-破壞。
內部連結和跨維基連結	[[首頁]]	[-{}-[首頁]]	在左側的[[中間插入-{}-破壞。
插入圖片	[[File:Bg1.png]]	[-{}-[File:Bg1.png]]
分類	[[Category:文件]]	[-{}-[Category:文件]]
外部連結	[//llwiki.org 首頁]	[-{}-//llwiki.org 首頁]	在協議之後（如果有的話）//之前插入-{}-破壞。
繁簡轉換	-{zh-hans:繁體; zh-hant:简体}-	--{}-{zh-hans:-{繁體}-; zh-hant:-{简体}-}-	在左側的-{中插入-{}-破壞。
防轉換	東京	-{東京}-	有時本不應轉換的內容（如日語）需要手動添加-{}-防轉換。注意上例中也使用了這一技巧。
表格	{|class="wikitable" ! 列標題 |- | 內容 |}	-{}-{|class="wikitable" -{}-! 列標題 -{}-|- -{}-| 內容 -{}-|}	穩妥起見，可以在每一行的開頭都插入-{}-破壞。

最後通過兩組示例來展示使用{{pre}}、{{code}}模板或不使用模板時如何實現繁簡轉換，實際上方法並不唯一。

HTML標籤	Wikitext	不使用模板	使用模板
pre	{| class="wikitable" ! 內容 |- | ;定義 :縮進 小節 小節 |}	<pre>-{}- {| class="wikitable" ! 內容 |- | ;定義 :縮進 小節 小節 |}</pre>	{{pre|<nowiki> -{}-{| class="wikitable" -{}-! 內容 -{}-|- -{}-| -{}-;定義 -{}-:縮進 小節<br> 小節 -{}-|} </nowiki>}}
code	{{pre|''[[首頁]]''<sup>&copy;</sup>}}	<code lang="mw">&#123;{pre|&apos;'[-{}-[首頁]]{{ce|''<sup>&amp;copy;</sup>}}}}</code>	{{code|<nowiki>{{pre|'-{}-'[-{}-[首頁]]'-{}-'<-{}-sup>&-{}-amp;copy;<-{}-/sup>}}</nowiki>}}

分類

按功能分類

所有模板都一定有至少一個（一般也只有一個）功能分類。LLWiki現共有以下14種功能分類：

以下分類的優先級較高。

• 輔助模板：這些模板用於輔助Wikitext的書寫，如用{{=}}代替=等。
• 授權協議：這些模板用於標註LLWiki存儲的文件的授權協議，如{{Copyright}}等。
• 用戶頁模板：這些模板用於用戶頁面的自我展示，不可用於主空間，如{{用戶信息}}和各類AS稱號。
• 信息框模板：所有使用infoboxtemplate類的表格寫成的模板，置於頁面最上方，如{{角色信息}}。
• 元模板：這些模板僅用於構建其他模板，由濫用過濾器禁止在模板空間以外使用，如{{ArticleCategory}}。
• 討論模板：這些模板用於討論頁，如{{編輯請求}}和{{Unsigned}}。
• 資料模板：這些模板預置了LoveLive!系列相關的資料，如各種角色連結模板、聲優連結模板和團體連結模板。注意由於分類優先級，這些模板不被劃分為內部連結模板。
• 內容模板：這些模板自身構成頁面的重要內容，如各種歌曲模板、LoveLive!學園偶像祭模板和{{Documentation}}。

以下分類的優先級較低，僅在不滿足前述分類的情形下考慮。

• 內部連結模板：這些模板用於生成內部連結，如各種消歧義模板和{{Tl}}。
• 外部連結模板：這些模板用於生成外部連結，如{{plainlinks}}和{{Bili-link}}。
• 語言模板：這些模板用於標註語言屬性，如{{Lang}}和{{Ruby}}。
• 提示模板：這些模板用於生成各類提示信息，如各種Info模板和{{BK}}。
• 格式模板：這些模板用於調整頁面格式，如各種表格模板和列表模板。
• 功能模板：這些模板用於執行特定功能，如各種導航模板、繁簡轉換模板和字符串模板。

這些分類往往還會進一步細分，請根據已有分類體系和類似模板添加到合適的分類級別。

特殊分類

LLWiki現共有2種特殊分類，分別為使用Widget的模板和需要替換引用的模板。

代碼

有使用次數上限的解析器函數

部分解析器函數在同一個頁面內有使用次數限制，如#loop和#regex。如果一個模板需要反覆調用這些解析器函數，或是一個用到這些解析器函數的模板可能會在同一個頁面內反覆引用，此時應當將模板改寫為Lua模塊。

代碼展示

LLWiki在模板頁面直接展示模板代碼，且可以通過CodeMirror擴展（需要開啟「高亮模板代碼」小工具）進行語法高亮，方便用戶查閱。為了防止在模板引用時錯誤地嵌入<pre>標籤，在模板實際代碼之前添加

<includeonly><!--</includeonly><pre class="wiki-highlight">-->

在代碼之後添加

<!--</pre><includeonly>--></includeonly>

但需要注意的是，<pre>標籤內的-{}-和<nowiki>仍會被執行，可能造成看到的代碼和實際代碼不符。如果遇到這種情況，應當考慮首先將代碼中的<nowiki>全部改寫為等效的形式（如-{}-、<nowiki/>和{{ce}}等），然後將外層的<pre class="wiki-highlight"> + </pre>更換為<code class="wiki-highlight"><nowiki> + </nowiki></code>。

結語

為方便模板頁面遵照既定格式編寫，LLWiki在快速編輯工具中添加了模板頁面的格式框架，請參考本指引和預加載的框架填入模板文檔、分類和代碼這三項主要內容。如有進一步的疑問或遇到技術困難，歡迎隨時在Help:互助客棧提問，將會有管理員或是其他有經驗的用戶提供幫助和解答。也歡迎各位用戶點擊站內公告的連結加入官方編輯群，在群內實時提問交流。