列表格式

From semantic-mediawiki.org
< Help:List format(Redirected from 列表格式)
List format列表格式
List format/zh-hans
逗号分隔型列表,且带有括在英文圆括号当中的额外输出
更多信息
提供者: 语义MediaWiki
添加版本: 0.7
移除版本: 依然支持
需求:
格式名称: list
启用?表明安装相应扩展时是否默认启用该结果格式。
作者: Markus Krötzsch
分类: misc
目录

列表格式list用于采取逗号分隔型列表的形式对查询结果加以格式编排。 列表格式list对没有额外打印输出语句的所有查询的查询结果进行格式编排的默认方式。 类似的结果格式有编号列表格式'ol'项目符号列表格式'ul'

参数[edit]

参数 别名 类型 默认 说明
propsep - 文本 , 结果记录的属性之间的分隔符
valuesep - 文本 , 用于结果属性值之间的分隔符
template - 文本 空白 输出显示模板的名称
named args namedargs 布尔值 no 请指定传递给该模板的变量
userparam - 文本 空白 使用模板时,向模板调用所传递的取值
class - 文本 空白 为列表设置的额外CSS类
introtemplate - 文本 空白 用于在查询结果前显示内容的模板的名称
outrotemplate - 文本 空白 用于在查询结果后显示内容的模板的名称
sep - 文本 , 结果之间的分隔符

此格式额外引入了下列参数:

  • columns(列数):将结果所要拆分成的列数(默认值为1)
  • sep(分隔符):用于对条目进行分隔的文本
  • template(模板):用于基于模板的格式编排的模板的名称

Help:结果模板页面当中对模板用于格式编排进行了解释。

示例[edit]

{{#ask: [[Category:City]] [[located in::Germany]] }}

实际运行结果: Berlin, Cologne, Frankfurt, Munich, Stuttgart, Würzburg

如果要提供更多的打印输出,则必须对该格式加以明确的请求:

{{#ask: [[Category:City]] [[located in::Germany]] 
| ?population = 人口数量
| ?area#km² = 面积(km²)
| format=list
}}

实际运行结果: Berlin (人口数量The number of inhabitants of some geographical place.: 3,520,061, 面积(km²): 891.85 km²344.34 sqmi <br />), Cologne (人口数量The number of inhabitants of some geographical place.: 1,080,394, 面积(km²): 405.02 km²156.38 sqmi <br />), Frankfurt (人口数量The number of inhabitants of some geographical place.: 679,664, 面积(km²): 248.31 km²95.87 sqmi <br />), Munich (人口数量The number of inhabitants of some geographical place.: 1,353,186, 面积(km²): 310.43 km²119.86 sqmi <br />), Stuttgart (人口数量The number of inhabitants of some geographical place.: 606,588, 面积(km²): 207.35 km²80.06 sqmi <br />), Würzburg (人口数量The number of inhabitants of some geographical place.: 126,635, 面积(km²): 87.63 km²33.83 sqmi <br />)

给予空标签时可隐藏相应的标题:

{{#ask: [[Category:City]] [[located in::Germany]] 
| ?population =
| ?area#km² = 
| format=list
}}

实际运行结果: Berlin (3,520,061, 891.85 km²344.34 sqmi <br />), Cologne (1,080,394, 405.02 km²156.38 sqmi <br />), Frankfurt (679,664, 248.31 km²95.87 sqmi <br />), Munich (1,353,186, 310.43 km²119.86 sqmi <br />), Stuttgart (606,588, 207.35 km²80.06 sqmi <br />), Würzburg (126,635, 87.63 km²33.83 sqmi <br />)

采用headers=hide亦可获得相同的效果。

如果采用sep加以指定的话,亦可采用除«,»之外的分隔符,如«and»:

{{#ask: [[Category:City]] [[located in::Germany]] | sep =  &nbsp;and&nbsp; }}

实际运行结果: Berlin and Cologne and Frankfurt and Munich and Stuttgart and Würzburg

HTML代码&nbsp;(不间断空格,即non-breaking space)在此用于创建空格,而这种空格在MediaWiki读取参数时不会被删除。

评注[edit]

将列表格式list与模板配合使用,具有可在结果之间放置正确数量分隔符(如«,»)的优点。 例如,我们可以备有用于对电子邮件地址列表进行格式编排的模板,从而可将这些列表复制并粘贴到电子邮件客户端当中。 其中,每个条目分别具有下列形式:

人员姓名 <email@example.com>

sep=,&nbsp;设置成为,让一张列表对所有的分隔符都采用逗号,而不是让最后一个分隔符为«and»,乃是合理的做法。



本文档页面适用于SMW从1.7.0版到最新版本的所有版本。
      其他语言: defr

Help:List format zh-hans 1.7.0