模板:Markup/doc

說明

{{Markup}}可以將代碼和其效果顯示在同一行裏。

使用方法

參數：

• 參數1：第1行第1格的內容
• 參數2：第1行第2格的內容

如此類推，直到

• 參數39：第20行第1格的內容
• 參數40：第20行第2格的內容
• t1：左面直欄的標題，預設為「代碼」
• t2：右面直欄的標題，預設為「效果」
• title、標題：表格標題，預設為置空
• notitle、無標題：賦值時會隱藏表格和直欄的標題
• margin：表格左邊的空位大小，單位為em

整個「代碼」欄已事先用<pre>格式化，內容會保留斷行和空格，同時亦會因應單元格的大小自動換行。通常最好用<nowiki>包圍着「代碼」欄裏的內容，這樣子便會顯示代碼本身。技術上無法將此功能添加進本模板內。

相反地，在「效果」一欄裏的內容通常直接複製自「代碼」欄，但並不以<nowiki>包圍着。不過在這些情況下則不一定：

• 假如第一行含有必須斷行後才生效的維基代碼，例如「#」、「*」、「;」，應在第一行之前使用{{crlf2}}。見以下例子。
• 諸如==的標題代碼會出現在頁面目錄裏；要避免的話應使用{{fake heading}}。
• 使用{{reflist}}但沒有指定其他參數時，用{{reflist|close}}確保參考資料列表已關閉。
• 有些模板會將頁面放入維護分類中，但這通常不是想要的效果：
  • 用{{fake citation needed}}代替{{citation needed}}。
• 有些模板可能有檢查錯誤機制，會將頁面放入維護分類中。可以的話應當防止分類：
  • 引文格式1系列模板可以用|template doc demo=true參數，防止將頁面放入該維護分類中。

技術限制

如果不用<nowiki>包圍着代碼欄的內容，而裏面又有任何模板代碼的話，這些代碼統統都會展開。

以下例子展示{{tl|tag}}的代碼：

效果	本來應顯示為
{{[[Template:tag|tag]]}}	{{tl|tag}}

代碼欄裏的HTML字符編碼也會被解析：

用「nowiki」包圍着的代碼顯示為	代碼本來應顯示為
–	 –

要避免出現這種情況的話，可以用「&」代替「&」，這樣子「 」會顯示為「 」。

範例

簡單示例：

原始碼	效果
'''粗體文字'''	粗體文字
''斜體文字''	斜體文字
<del>劃線文字</del>	劃線文字

複雜示例：注意{{markup}}的第二個參數用了{{fake heading}}和{{fake citation needed}}。

原始碼	效果
The quick brown fox jumps over the lazy dog.{{#tag:ref|這是腳註。<ref>這是腳註的參考資料。</ref>|group=nb}} The cow jumped over the moon.{{fact}} ==註釋== {{reflist|group=nb}} ==參考資料== {{reflist}}	The quick brown fox jumps over the lazy dog. The cow jumped over the moon.[來源請求] 註釋 參考資料

使用多行：

原始碼	效果
The quick brown fox jumps over the lazy dog.	The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.	The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.	The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.	The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.	The quick brown fox jumps over the lazy dog.

使用標題：

Foxes and dogs

原始碼	效果
The quick brown fox jumps over the lazy dog.	The quick brown fox jumps over the lazy dog.

用{{code}}包圍着模板時，會顯示所生成的HTML代碼：

原始碼	效果
{{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}	White, T. H. The Book of Merlyn. 1977.
{{code|{{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}}}	<cite class="citation book">White, T. H. The Book of Merlyn. 1977.</cite><span title="ctx_ver=Z39.88-2004&rfr_id=info%3Asid%2Fzh.wikipedia.org%3ATemplate%3AMarkup%2Fdoc&rft.aufirst=T.+H.&rft.aulast=White&rft.btitle=The+Book+of+Merlyn&rft.date=1977&rft.genre=book&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook" class="Z3988"><span style="display:none;">&nbsp;</span></span>