Help:列表格式

From semantic-mediawiki.org
Jump to: navigation, search
列表格式
逗号分隔型列表,且带有括在英文圆括号当中的额外输出
进一步的信息
提供方: Semantic MediaWiki
最低版本: 0.7
最高版本: 依然支持
要求:
格式名称: list
作者: Markus Krötzsch
类别: misc
目录

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

参数

参数 类型 默认 说明
sep 文本 空白 取值分隔符
template 文本 空白 输出显示模板的名称
template arguments 文本 空白 Sets how the named arguments are passed to the template
named args 布尔值 no 请指定传递给该模板的变量
userparam 文本 空白 使用模板时,向模板调用所传递的取值
introtemplate 文本 空白 用于在查询结果前显示内容的模板的名称
outrotemplate 文本 空白 用于在查询结果后显示内容的模板的名称
import-annotation 布尔值 no 额外的带注释数据在解析主题期间都会被复制

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

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

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

示例

{{#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 (人口数量 3,520,061, 面积(km²) 891.85 km²
344.343 sqmi
), Cologne, Frankfurt (人口数量 679,664, 面积(km²) 248.31 km²
95.872 sqmi
), Munich (人口数量 1,353,186, 面积(km²) 310.43 km²
119.857 sqmi
), Stuttgart (人口数量 606,588, 面积(km²) 207.36 km²
80.062 sqmi
), Würzburg

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

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

实际运行结果:

Berlin (3,520,061, 891.85 km²
344.343 sqmi
), Cologne, Frankfurt (679,664, 248.31 km²
95.872 sqmi
), Munich (1,353,186, 310.43 km²
119.857 sqmi
), Stuttgart (606,588, 207.36 km²
80.062 sqmi
), Würzburg

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

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

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

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

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

评注

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

人员姓名 <email@example.com>

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



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

Help:List format zh-hans 1.7.0