Wikipedia:列表格式指南

维基百科，自由的百科全书

本页被视为日文维基百科的一项格式指引。供中文维基百科参考。本指引以日文原文为准，所阐明的标准或行为，为许多维基编者原则接受。但本指导并非正式方针。本页的中文翻译尚未全部完成或未达成共识。除翻译外，请不要更改本指引。如果翻译完成，请在本页的讨论页讨论本指引是否可以成为中文维基百科的格式指引。

维基百科格式指导
格式手册
增补格式手册
縮寫传记命令行范例破折号日期和数字标题链接数学音樂音标文字格式题目商标撰寫有關小說條目
特殊頁面指導
消歧义页中国相关条目日本相关条目朝鮮相關條目醫學相關條目
其他指导
如何编辑页面版面指南题注分类人物分类引用來源行话解释註腳更优秀条目写作指南列表音樂樣本命名约定過度連結图片指南固有名称章节姊妹计划术语和定义避免使用的用詞
技術指導
图像圖像使用守則列表格式指南表格用戶樣式

如同Wikipedia:如何編輯頁面#版式所述，列表寫法的標記具有許多種寫法存在。但是其中有乍看之下為正常表示，但有些實際上在看不到的地方裡呈現並不理想的狀態，成為各式問題的原因。

您使用維基百科的標記所編輯的文章，在被閱覽時會透過名為MediaWiki的軟體，轉換成網頁瀏覽器能夠辨識的形式XHTML。此依標記的方式可能無法產生理想的XHTML格式。本條目頁面在此舉出被推薦的範例和非推薦的範例，來加以解說列表寫法的標記方式。

[编辑] 被推薦的範例

[编辑] 定義的列表寫法

如果打算要做的是，具有簡短詞彙（用語或人名之類）與相對說明組合而成的列表的話，全部依照定義的列表寫法編輯最為合理。尤其是「登場人物與其解說」等情況，是用定義的列表寫法來記述的理想典範。

表示結果	輸入內容輸入內容	XHTML	形象
用語1 用語1的說明用語2 用語2的說明	; 用語1 : 用語1的說明 ; 用語2 : 用語2的說明	<dl> <dt>用語1</dt> <dd>用語1的說明</dd> <dt>用語2</dt> <dd>用語2的說明</dd> </dl>	dl dt 用語1 dd 用語1的說明 dt 用語2 dd 用語2的說明

用定義的列表寫法所編輯的一個區塊（<dl>～</dl>）之中，用語（<dt>～</dt>）和其定義（<dd>～</dd>）將成對出現。這個是被推薦的寫法。

[编辑] 列表寫法

若是單純並不需要說明的列表，使用普通的列表寫法是比較理想的。而如果其順序是有意義的，使用帶有數字的列表寫法會更合適。

表示結果	輸入內容	XHTML	形象
foo bar hoge fuga piyo	* foo ** bar * hoge fuga piyo	<ul> <li>foo <ul> <li>bar</li> </ul> </li> <li>hoge <ul> <li>fuga</li> <li>piyo</li> </ul> </li> </ul>	ul li foo ul li bar li hoge ul li fuga li piyo
foo bar hoge fuga piyo	# foo ## bar # hoge ## fuga ## piyo	<ol> <li>foo <ol> <li>bar</li> </ol> </li> <li>hoge <ol> <li>fuga</li> <li>piyo</li> </ol> </li> </ol>	ol li foo ol li bar li hoge ol li fuga li piyo

表示結果

輸入內容

XHTML

形象

foo
- bar
hoge
- fuga
- piyo

* foo
** bar
* hoge
** fuga
** piyo

<ul>
  <li>foo
    <ul>
      <li>bar</li>
    </ul>
  </li>
  <li>hoge
    <ul>
      <li>fuga</li>
      <li>piyo</li>
    </ul>
  </li>
</ul>

li foo

li bar

li hoge

li fuga

li piyo

foo
1. bar
hoge
1. fuga
2. piyo

# foo
## bar
# hoge
## fuga
## piyo

<ol>
  <li>foo
    <ol>
      <li>bar</li>
    </ol>
  </li>
  <li>hoge
    <ol>
      <li>fuga</li>
      <li>piyo</li>
    </ol>
  </li>
</ol>

li foo

li bar

li hoge

li fuga

li piyo

[编辑] 常見到的不太好的例子

[编辑] 例1

表示結果	輸入內容	XHTML	形象
用語1 用語1的說明用語2 用語2的說明	* 用語1 : 用語1的說明 * 用語2 : 用語2的說明	<ul> <li>用語1</li> </ul> <dl> <dd>用語1的說明</dd> </dl> <ul> <li>用語2</li> </ul> <dl> <dd>用語2的說明</dd> </dl>	ul li 用語1 dl dd 用語1的說明 ul li 用語2 dl dd 用語2的說明

像這個樣子用列表寫法所製作出的區塊（<ul>～</ul>）和定義的列表寫法所製作出的區塊（<dl>～</dl>）交互出現，造成區塊被切斷了。

[编辑] 例2

比上面好一點的例子。

表示結果	輸入內容	XHTML	形象
用語1 用語1的說明用語2 用語2的說明	* 用語1 : 用語1的說明用語2 *: 用語2的說明	<ul> <li>用語1 <dl> <dd>用語1的說明</dd> </dl> </li> <li>用語2 <dl> <dd>用語2的說明</dd> </dl> </li> </ul>	ul li 用語1 dl dd 用語1的說明 li 用語2 dl dd 用語2的說明

雖然列表寫法的區塊（<ul>～</ul>）只有一個，但是列表寫法的各個構成（<li>～</li>）之中每次都產生一個定義的列表寫法的區塊（<dl>～</dl>）。另外一般在<dl>～</dl>之中，用語（<dt>～</dt>）和其定義（<dd>～</dd>）成對出現是最理想的，只出現<dd>～</dd>的<dl>～</dl>用法是不太好的。

[编辑] 例3

使用了定義的列表寫法結果卻失去了使用的意義。

表示結果	輸入內容	XHTML	形象
用語1 用語1的說明用語2 用語2的說明	; 用語1 : 用語1的說明 ; 用語2 : 用語2的說明（用語1的列和用語2的列之間，只有換行而夾了一列空白列）	<dl> <dt>用語1</dt> <dd>用語1的說明</dd> </dl> <dl> <dt>用語2</dt> <dd>用語2的說明</dd> </dl>	dl dt 用語1 dd 用語1的說明 dl dt 用語2 dd 用語2的說明

中間夾了空白列（只有換行沒寫任何東西）結果造成定義的列表寫法所產生的區塊被分隔為兩個。這樣子看似是為了方便編輯，遺憾的是得到了反效果。

表示結果	輸入內容	XHTML	形象
用語1 用語2 用語3	* 用語1 * 用語2 ** 用語3 （各列之間只有換行而夾了一列空白列）	<ul> <li>用語1</li> </ul> <ul> <li>用語2</li> </ul> <ul> <li> <ul> <li>用語3</li> </ul> </li> </ul>	ul li 用語1 ul li 用語2 ul li ul li 用語3
用語1 用語2 用語3	# 用語1 # 用語2 ## 用語3 （各列之間只有換行而夾了一列空白列）	<ol> <li>用語1</li> </ol> <ol> <li>用語2</li> </ol> <ol> <li> <ol> <li>用語3</li> </ol> </li> </ol>	ol li 用語1 ol li 用語2 ol li ol li 用語3

普通的列表寫法與帶有數字的列表寫法雖然可以說是相同的情形，但是問題更加嚴重。尤其是帶有數字的時候會造成數字不連續的悲慘狀況，和普通的列表寫法一樣會破壞版面的顯示。

[编辑] 為什麼不可以？

「說什麼XHTML，太過複雜讓人搞不懂，看起來漂亮不就好了？」的確這種想法是存在的。不過要注意那是偏重於明眼人（沒有視覺障礙的人）的思考方式。

具有視覺障礙的人使用聲音讀出瀏覽器來閱覽維基百科。這時若遇到上述的例2會怎麼讀出呢。

<以下是列表>
用語1、
<以下是定義列表>
<以下是剛剛的定義詞彙的說明>用語1的說明<說明結束>
<定義列表結束>
用語2、
<以下是定義列表>
<以下是剛剛的定義詞彙的說明>用語2的說明<說明結束>
<定義列表結束>
<列表結束>

如何。明明沒有讀出定義詞彙卻突然跑出個「剛剛的定義詞彙」，意思說不通。那麼在正確範例中又是如何呢。

<以下是定義列表>
<以下是定義詞彙>用語1、<定義詞彙結束>
<以下是剛剛的定義詞彙的說明>用語1的說明<說明結束>
<以下是定義詞彙>用語2、<定義詞彙結束>
<以下是剛剛的定義詞彙的說明>用語2的說明<說明結束>
<定義列表結束>

這樣就可以了。

另外還有傳輸資料量的問題。請將例1與例2所產生的XHTML，和正確範例的情況做比較。變得更加簡潔了。只有一兩個雖然沒有太大差別在，當重複10次20次時就會出現明顯的差異。

[编辑] 各種變化

[编辑] 在用語後換行

定義的列表寫法也可以用下面的方式來寫。

表示結果	輸入內容	XHTML	形象
用語1 用語1的說明用語2 用語2的說明	; 用語1 : 用語1的說明 ; 用語2 : 用語2的說明	<dl> <dt>用語1</dt> <dd>用語1的說明</dd> <dt>用語2</dt> <dd>用語2的說明</dd> </dl>	dl dt 用語1 dd 用語1的說明 dt 用語2 dd 用語2的說明

像這樣在用語後面換列結果和被推薦的範例是完全一樣的。說明部分變長的時候用這種方式編輯應該會比較容易觀看原始檔。

[编辑] 比較長的說明

說明部分變長而想要分隔段落的時候，用以下的方法。

輸入內容

; 用語1
: 用語1的繁長說明用語1的繁長說明用語1的繁長說明用語1的繁長說明
: 用語1的繁長說明的下個段落用語1的繁長說明的下個段落用語1的繁長說明的下個段落
; 用語2
: 用語2的繁長說明用語2的繁長說明用語2的繁長說明
: 用語2的繁長說明的下個段落用語2的繁長說明的下個段落

表示結果	XHTML	形象
用語1 用語1的繁長說明用語1的繁長說明用語1的繁長說明用語1的繁長說明用語1的繁長說明的下個段落用語1的繁長說明的下個段落用語1的繁長說明的下個段落用語2 用語2的繁長說明用語2的繁長說明用語2的繁長說明用語2的繁長說明的下個段落用語2的繁長說明的下個段落	<dl> <dt>用語1</dt> <dd>用語1的繁長說明...</dd> <dd>用語1的繁長說明的下個段落...</dd> <dt>用語2</dt> <dd>用語2的繁長說明...</dd> <dd>用語2的繁長說明的下個段落...</dd> </dl>	dl dt 用語1 dd 用語1の長い説明... dd 用語1の長い説明の次の段落... dt 用語2 dd 用語2の長い説明... dd 用語2の長い説明の次の段落...

用語（<dt>～</dt>）和其定義（<dd>～</dd>）沒有1對1的成對，雖然不能說是最理想的狀態，不過只用維基百科的標記方式無法在<dd>～</dd>之中產生段落，為了方便起見而採用這個方式。

若是說明部分太長的話，也請檢討使用標題分出一個章節來寫。

[编辑] 其他

說明部分如果相當地短，慣例上常用以下的形式。

表示結果	輸入內容
用語1 - 用語1的說明用語2 - 用語2的說明	* 用語1 - 用語1的說明 * 用語2 - 用語2的說明

[编辑] 別拘泥於門面

有時候會有，對標記方法理解不足、或是因為「這樣子比較好看」的理由，而使用不被推薦的標記方法。比方說在定義的列表寫法，有人會討厭把用語強制改成粗體字，也有人會討厭在列舉事項時前面多了個點。

但是請別忘了，每個人對好看的感覺不同，以及在您的使用環境下所看到的樣子不見得和其他人一樣。雖然多數人使用著標準的MonoBook面版，也可能有人使用cairn blue，或是使用獨創的用戶CSS。當改變使用環境，即使再怎麼調整版面的樣貌也是沒有意義的。

結果是使用被推薦的寫法來標記，會是符合最多人的閱覽方式（包含聲音瀏覽器）的最佳捷徑。

[编辑] 別拘泥於標記法

若是搞不懂、記不住在此所解說的內容的話，請先忽略它。與其煩惱怎麼標記，不如把心力花在記述優良的條目上。即使標記錯誤，以後也會有某個人幫忙修正（這是Wiki系統的一大優點）。看了其他人修改的方法，遲早也能學會更好的寫法吧。

[编辑] 發現有不被推薦的標記法時

當發現用被推薦的寫法改過的文章，被回復成不被推薦的寫法時，請教導出這個頁面的存在，說明修改的理由。因為做出回復的大多是新手，請不要強硬逼迫（本指引不是規則），親切地做出說明。也請參考Wikipedia:不要傷害新手。

[编辑] 關連項目

来自“http://zh.wikipedia.org../../../%E5%88%97/%E8%A1%A8/%E6%A0%BC/Wikipedia%7E%E5%88%97%E8%A1%A8%E6%A0%BC%E5%BC%8F%E6%8C%87%E5%8D%97.html”

页面分类: 维基百科格式指导方针 | 维基百科提议