本页不属于有兽档案馆的条例或规则;若本页内容与相关条例不一致的,以条例内容为准。
列表写法的标记具有许多种写法存在。但是其中有乍看之下为正常表示,但有些实际上在看不到的地方里呈现并不理想的状态,成为各式问题的原因。
您使用有兽档案馆的标记所编辑的文章,在被阅览时会透过名为MediaWiki的软体,转换成网页浏览器能够辨识的HTML格式。本页面举出被推荐的范例和非推荐的范例,来加以解说列表写法的标记方式。
推荐范例
定义的列表写法
如果打算要做的是,具有简短词条(用语或人名之类)与相对说明组合而成的列表的话,全部依照定义的列表写法编辑最为合理。尤其是“登场人物与其解说”等情况,是用定义的列表写法来记述的理想典范。
表示结果 | 输入内容 | XHTML | 形象 |
---|---|---|---|
|
; 用语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 |
<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 |
<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
|
常见不良范例
例1
表示结果 | 输入内容 | XHTML | 形象 |
---|---|---|---|
|
* 用语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的说明 |
<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的行和用语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 (各行之间夹空白行) |
<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 (各行之间夹了一个空白行) |
<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的说明 |
<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 | 形象 |
---|---|---|
|
<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 #* 内容11 #* 内容12 # 内容2 ## 内容21 ## 内容22
效果:
- 内容1
- 内容11
- 内容12
- 内容2
- 内容21
- 内容22
其他
说明部分如果相当地短,惯例上常用以下的形式。
表示结果 | 输入内容 |
---|---|
|
* 用语1 - 用语1的说明 * 用语2 - 用语2的说明 |
不要拘泥于门面
有时候会有,对标记方法理解不足、或是因为“这样子比较好看”的理由,而使用不被推荐的标记方法。比方说在定义的列表写法,有人会讨厌把用语强制改成粗体字,也有人会讨厌在列举事项时前面多了个点。
但是请别忘了,每个人对好看的感觉不同,以及在您的使用环境下所看到的样子不见得和其他人一样。当改变使用环境,即使再怎么调整版面的样貌也是没有意义的。
结果是使用被推荐的写法来标记,会是符合最多人的阅览方式(包含声音浏览器)的最佳捷径。
不要拘泥于标记法
若是搞不懂、记不住在此所解说的内容的话,请先忽略它。与其烦恼怎么标记,不如把心力花在记述优良的条目上。即使标记错误,以后也会有某个人帮忙修正(这是Wiki系统的一大优点)。看了其他人修改的方法,迟早也能学会更好的写法吧。
发现有不被推荐的标记法时
当发现用被推荐的写法改过的文章,被回复成不被推荐的写法时,请教导出这个页面的存在,说明修改的理由。因为做出回复的大多是新手,请不要强硬逼迫,亲切地做出说明。