查看“︁帮助:SMW”︁的源代码

{{施工提示}}
{{翻译提示}}
{{ambox
| image = [[File:ConstructionClock.svg|50px]]
| text  = '''本页面正在施工'''，余下内容将陆续补完。<br />与SMW有关的扩展、函数、规则等，将放置在本页上。
}}
{{ambox
| image = [[File:Translate_en_zh.svg|50px]]
| text  = '''本页面为译文'''，原文为英文，页面[https://www.semantic-mediawiki.org/wiki/Help:Introduction_to_Semantic_MediaWiki 见此]。<br />如有发现翻译有误或语句不通顺，请进行修正。
}}
{{ambox
| type  = content
| image = [[File:TestCaution.svg|50px]]
| text  = '''本页面部分代码请勿随意测试'''，否则可能会影响本维基的稳定。<br />如需进行测试，请使用[[:分类:测试属性|专门用于测试的属性]]，具体用法见本页[[#代码测试说明|代码测试说明]]。
}}
{{Navbox
| state  = uncollapsed
| name   = Semantic MediaWiki 用户手册
| title  = Semantic MediaWiki 用户手册
| image  = [[File:smw.png|142px]]
| group1 = 概述
| list1  = [[#简介|简介]] &bull; [[#代码测试说明|代码测试说明]]
| group2 = [[#属性与类型|属性与类型]]
| list2  = [[#文本注释|文本注释]] &bull; [[#比较分类与属性|比较分类与属性]] &bull; [[#属性命名|属性命名]] &bull; [[#属性声明|属性声明]] &bull; [[#数据类型|数据类型]] &bull; [[#特殊属性|特殊属性]] &bull; [[#反向属性|反向属性]]
| group3 = [[#单位|单位]]
| list3  = [[#单位转换|单位转换]] &bull; [[#自定义单位|自定义单位]]
| group4 = [[#解析函数|解析函数]]
| list4  = {{Navbox subgroup
    |group1 = [[#语义注释函数|语义注释函数]]
    |list1  = [[#set]] &bull; [[#subobject]] &bull; [[#set_recurring_event]] &bull; [[#declare]]
    |group2 = [[#行内查询函数|行内查询函数]]
    |list2  = [[#ask]] &bull; [[#show]]
    |group3 = [[#其他用途函数|其他用途函数]]
    |list3  = [[#concept]] &bull; [[#info]] &bull; [[#smwdoc]]
    }}
| group5 = [[#语义搜索|语义搜索]]
| list5  = [[#检索页面|检索页面]]（''[[#比较器注意事项|比较器注意事项]]''） &bull; [[#显示信息|显示信息]] &bull; [[#结果格式|结果格式]] &bull; [[#行内查询|行内查询]]（''[[#查询子对象|查询子对象]]'' &bull; ''[[#对查询行为的查询|对查询行为的查询]]''） &bull; [[#概念|概念]] &bull; [[#推理|推理]]
| group6 = [[#语义模板|语义模板]]
| list6  = [[#信息框格式语义模板|信息框格式语义模板]] &bull; [[#行内语义模板|行内语义模板]] &bull; [[#语义模板应用规则|语义模板应用规则]]
| group7 = [[#浏览界面|浏览界面]]
| list7  = [[#特殊页面“问”|特殊页面“问”]] &bull; [[#特殊页面“浏览”|特殊页面“浏览”]]
}}
[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki Semantic MediaWiki]（SMW）是一个免费、开源的MediaWiki扩展。它可以帮助wiki进行搜索、组织、标记、浏览、计算和共享数据。<br />
传统wiki只包含文本信息，计算机无法对其进行理解和计算。SMW为wiki添加了语义注释（Semantic Annotations）数据，从而使wiki具有数据库的功能。

SMW首次发布于2005年，目前有超过十名开发者，数以百计的站点使用了SMW。另外，目前已有许多[https://www.semantic-mediawiki.org/wiki/Help:SMW_extensions 相关扩展]可以扩充SMW的编辑、显示和浏览数据的功能。<br />
Semantic MediaWiki有时也指整个SMW和其相关扩展系列。

==简介==
;为什么要使用SMW

:比如你需要查找“在{{CM|1|91}}上发布的Jpop风格同人专辑”，如果是在非SMW平台wiki上，你可能需要翻阅大量专辑页面才能收集。
:而使用了SMW后，你只需使用下面这个语句：
:{{pre|<nowiki>
{{#ask:
[[分类:同人专辑]]
[[发售展会名称::Comic Market 91]]
[[专辑风格::Jpop]]
| ?制作方
| limit =10
}}
</nowiki>}}
:便可以得到搜索结果列表，此处限制显示10项：
:{{#ask:
[[分类:同人专辑]]
[[发售展会名称::Comic Market 91]]
[[专辑风格::Jpop]]
| ?制作方
| limit =10
}}
:从而使wiki起到类似数据库的作用，方便查询。

==代码测试说明==
<div class="bg-color-neutral-30 bd-color-neutral-30" style="margin-bottom:1em; padding-left:1em; padding-right:1em; border:1px solid;">
如果某段说明上方'''没有任何标志或警示'''，<br />
则该段落的功能/函数不会影响本维基正常运行。<br />
请在测试时使用[[沙盒]]，或自己的用户页面“用户:''你的用户名''”。
</div>

<div class="bg-color-warning-10 bd-color-warning-30" style="margin-bottom:1em; padding-left:1em; padding-right:1em; border:1px solid;">
如果某段说明上方'''有如下警示：'''
{{帮助SMW-测试警告-小}}
请仔细阅读并遵循本段内测试说明来进行测试，并在测试后及时删除测试代码。

;请不要随意创建属性

:使用[[#文本注释|文本注释]]和[[#set|set]]函数等功能时，可能会创建新的属性。这不利于有序地管理SMW属性。
:如需测试以上功能，请只使用[[:分类:测试属性|专门用于测试的属性]]来进行测试。

:测试用属性有：
:*[[:属性:测试number]]，数字类型测试用属性
:*[[:属性:测试page]]，页面类型测试用属性
:*[[:属性:测试string]]，文字类型测试用属性

:使用的方法：
:{{pre|<nowiki>[[测试string::用于说明Semantic MediaWiki的使用方法]]</nowiki>}}
:效果：
::<tt>[[测试string::用于说明Semantic MediaWiki的使用方法]]</tt>
:前往[[:属性:测试string]]查看效果。
:使用后，如果不是必须保留（例如在本页面中作为例子存在的测试代码），请将测试代码删除。

[[文件:帮助SMW-页面所具备的属性.png|thumb|200px|页面事实框]]
;如果需要测试[[:分类:常用属性|已有的属性]]

:请在测试后，将测试用的代码'''删除'''。
:否则该测试定义的属性值将出现在该属性列表中，可能会造成部分wiki页面使用查询功能时得到错误的结果。

;保存页面之前的检查

:点击“显示预览”按钮（在保存页面按钮的右侧）。
:在页面的末尾会出现“关于''页面名称''的事实”区域，里面写着当前页面所具备的属性和值。
:以本页面为例，前文使用了[[:属性:测试string]]，此项属性便写在该区域里，见右图。
:请在检查属性使用无误后保存。

:另，预览页面末尾还有所用模板、映射方案、解析器运作信息等，都十分有用。
</div>

<div class="bg-color-success-10 bd-color-success-30" style="margin-bottom:1em; padding-left:1em; padding-right:1em; border:1px solid;">
如果某段说明上方'''有如下标志：'''
{{帮助SMW-测试部分允许-小}}
则该段落内<b class="bg-color-success-10">绿色部分</b>的代码可以自由测试，其余代码请勿随意测试。

;语义搜索及相关函数测试

:[[#语义搜索|语义搜索]]功能，如函数[[#ask|ask]]和[[#show|show]]，可以自由使用。
:可以更改这些代码内部的参数，关于这些函数和功能的使用方法，请参看各自段落。

:测试请在[[沙盒]]中进行，或者使用自己的用户页面“用户:''你的用户名''”。
</div>

==属性与类型==
{{帮助SMW-测试警告-小}}
属性和类型是在SMW中输入语义数据的基本方式。<br />
属性可以认为是“页面数据的分类”。<br />
它们可以用很简单的方式来标注，语法格式与MediaWiki的链接很类似：
<pre>[[属性名::属性值]]</pre>
上面这个语句给名称为“属性名”的属性定义了“属性值”。<br />
写了这个语句的页面将只会显示“属性值”，而不会把这个标注显示出来。

本段落下文中介绍了属性的基本用法，和属性的类型。

===文本注释===
{{帮助SMW-测试警告-小}}
举一个简单的例子：如本维基上的[[博丽灵梦]]页面，你可能需要为它添上标签：
<pre>
[[人类]]
</pre>
在该页面上，这个标签被称为“种族属性”。

但在SMW中，你可以这样来写：
<pre>
[[种族::人类]]
</pre>
在括号内部，将属性名称放在<code>::</code>前面，将属性值放在其后。<br />
则在该页面上，这个链接仍显示为“人类”。增加的文字<code>种族</code>是一个'''属性'''的名字，它将页面归为与“人类”相关。其他类似的角色页面中，也可以应用这样的标注。

和分类类似，每个属性都有自己的页面，页面以<code>属性:</code>开头，方便用户统一使用这些属性。你可以直接在顶部搜索框中搜索已有的属性。属性页面可以为空，但强烈建议写明属性用途。

文本注释和[[#属性声明|属性声明]]都是大小写敏感的，因此建议启用MediaWiki的一些环境设置（如<code>$wgCapitalLinks</code>，[https://www.mediawiki.org/wiki/Manual:$wgCapitalLinks 详见]）。<br />
任意更改这些环境设置可能导致查询的内容有误或不可查询。

;将链接转换为属性

:有许多方法能将链接转换为属性：
:{|{{PrettyTable}}
!{{hl1}}|显示效果
!{{hl1}}|代码
!{{hl1}}|注意事项
|---
|
:<tt>将值[[人类]]添加到属性“种族”中。</tt>
|<pre>将值[[种族::人类]]添加到属性“种族”中。</pre>
|
|---
|
:<tt>让链接显示为[[人类|种族为人类]]。</tt>
|<pre>让链接显示为[[种族::人类|种族为人类]]。</pre>
|
|---
|
:<tt>如果不需要显示属性，则在链接显示文字中输入空格。</tt>
|<pre>如果不需要显示属性[[种族::人类| ]]，则在链接显示文字中输入空格。</pre>
|管道符<code><nowiki>|</nowiki></code>后的空格是必要的。如果略去空格，则会触发[https://en.wikipedia.org/wiki/Help:Pipe_trick 管道符技巧]（Pipe trick）。即使输入空格，SMW也不会输出任何字符。如果需要输出空格，应使用转义字符<code>&amp;nbsp;</code>代替空格。<br />
'''这种情况建议使用[[#set|set]]函数。'''
|---
|如果需要使用<code>::</code>写一个指向某属性值的链接，而不是要创建属性，则在开头增加冒号。如：<br />
:<tt>[[:种族::人类]]</tt>
|<pre>[[:种族::人类]]</pre>
|
|---
|从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.3.0 SMW 2.3.0]版本起，属性值可以包含<code>::</code>，而不会导致多创建一个属性。如：<br />
:<tt>IPv6地址是fc00:123:8000::/%6。</tt>
|<pre>IPv6地址是[[IPv6地址::fc00:123:8000::/%6]]。</pre>
|用这种方法时，属性值不可以包含方括号<code>[</code>、维基链接<code>[[...]]</code>、四冒号<code>::::</code>。<br />
'''这种情况建议使用[[#set|set]]函数。'''<br />
{{color:red|'''警告：'''}}此功能'''本维基不适用'''，本地SMW版本2.1.1
|---
|可以将一个值赋给多个属性，使用<code>::</code>分隔属性名称。如：<br />
:<tt>[[人类]]</tt>
|<pre>[[种族::外观::人类]]</pre>
|从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.3.1 SMW 2.3.1]版本起需要禁用[https://www.semantic-mediawiki.org/wiki/Help:$smwgEnabledInTextAnnotationParserStrictMode 严格模式]设置，才可使用本功能。<br />
'''这种情况建议使用[[#set|set]]函数。'''<br />
{{color:red|'''警告：'''}}此功能'''本维基直接启用'''，本地SMW版本2.1.1
|}

;将文本中的值转换为属性

:除了指向其他页面的链接，维基页面上也有其他有用的信息。比如[[博丽灵梦]]页面给出了她的能力。你可以这样写：
:<pre>主要拥有在空中飞翔程度的能力</pre>
:如果读完上文，你应该能想到，这应该是“能力”属性的值。你可以这样写以添加属性：
:<pre>[[能力::主要拥有在空中飞翔程度的能力]]</pre>
:一般你并不想把上面这个能力变为一个链接，这时你需要对“能力”属性定义'''类型'''（关于各种类型，见[[#数据类型|数据类型]]）。
:此处，将“能力”属性类型定义为'''文字'''（Type Text），则上面的代码将不会变为链接，而是显示为文字：
::<tt>主要拥有在空中飞翔程度的能力</tt>

;同时使用分类和属性进行归档

:见[[#比较分类与属性|比较分类与属性]]。

;使用<code>#set</code>进行静默注释

:见[[#set|set]]函数。

===比较分类与属性===
MediaWiki提供了<code><nowiki>[[分类:...]]</nowiki></code>的注释，可以对各个页面进行归类整理。<br />
Semantic MediaWiki则增加了一项归档用的功能——'''属性'''（Property）。

;分类与属性

:划分一块领域的事物时，分类非常有用，比如划分[[:分类:同人志|同人志]]和[[:分类:同人专辑|同人专辑]]。
:而对于同一分类下的各个成员，则可以用不同的属性来描述它们，比如[[:属性:制作方|制作方]]、[[:属性:发售展会名称|发售展会]]等。

:*分类用于划分特性相同的事物到同一个组：
::*相同性质的一类事物，如[[:分类:官方游戏]]；
::*相同性质的分类，会形成层次结构：如[[:分类:官方作品]]，里面包含了[[:分类:官方游戏]]、[[:分类:官方音乐]]等。
:*属性用于描述分类里各个事物的特性：
::*属于某组织，如[[:属性:制作方]]，描述作品的制作社团；
::*有某种特性，如[[:属性:会场售价]]，描述了同人作品在会场售卖的价格；
::*是某类事物，如[[:属性:社团地区]]，描述了同人社团所属的国家/地区；
::*是某组织的成员，如[[:属性:参与社团]]，描述了制作人员所属/参与的社团；
::*有另一种广泛的称呼，如[[:属性:专辑译名]]，描述了专辑翻译为中文/英文的名字。

;层次结构

:[https://en.wikipedia.org/wiki/Wikipedia:Categorization#Subcategorization 子分类]用于细分分类内的事物，另外，“'''所属的子分类'''”（Subcategory of）是SMW[[#特殊属性|特殊属性]]中的一种。
:“'''所属的子属性'''”（Subproperty of）也为特殊属性。详见本页[[#特殊属性|特殊属性]]段落对其的描述。

;如何进行归档

:没有一刀切的规定来限制你如何使用分类和属性。但你可以参照以下经验：
:*最广泛的分类是主题名字空间，比如本页面名称前面的“帮助”，它可以将所有页面划分为几类。
:*分类可以将相近事物划为一组，也可以在一组里再进行细分，或者使子分类有一定程度的交叉或重叠。
:*属性可以直接描述事物的特性。
:具体的归档方式要根据需要来进行。如果只需划分大类，可只用分类。如果想要划分细致并且便于检索详细特性，则需使用属性。

;属性无法做到的事

:无法查询某页面是否“不存在某属性”。

:解决方法为：
:*使用模板方式编写，每项属性对应模板的一个输入参数；
:*使用[[帮助:解析函数#if|if]]函数来检查模板输入参数是否存在；
:*将某项输入参数不存在的页面分类到“分类:没有''某项参数''的页面”。
:即可在该分类下检查不存在某项属性的页面，如[[:分类:没有首发展会的同人作品]]。

===属性命名===
{{帮助SMW-测试警告-小}}
属性命名十分重要。属性名称需要避免出现歧义和混乱。<br />
这里是一个简单的命名属性的例子：
<pre>
灵梦是一个[[种族::人类]]。
</pre>

;不要使用数据类型的名字

:数据类型的名字见[[特殊:类型]]，关于数据类型的详细介绍见[[#数据类型|数据类型]]。

;不要使用保留符号

:保留符号不能出现在属性名称里，因为它们在语义查询时有特殊的语法作用，如果用于属性名称会造成查询时逻辑错误。
:比如：
:*<code>::</code>（半角双冒号）：单个冒号则不会有问题。
:*<code>-</code>（连字符）：连字符不可作为首字母，因为它是[[#反向属性|反向属性]]的操作符号。
:*<code>.</code>（点）：用于链接级联属性。
:*<code>|</code>（管道符）
:*<code>#</code>（数字符）：在'''页面'''类型中，用于声明子对象。

===属性声明===
{{帮助SMW-测试警告-小}}
Semantic MediaWiki内置了若干[[#数据类型|数据类型]]，用户可以根据需要为属性选择合适的数据类型。<br />

为了能为属性定义类型，SMW还内置了一个[[#特殊属性|特殊属性]]——[[:属性:设有类型]]（Has type）。<br/ >
还是灵梦的例子。对于她的“能力”属性，我们需要定义它为'''文字'''类型。<br />
只需到[[:属性:能力]]页面，添加下面这行代码：
<pre>[[设有类型::文字]]</pre>

SMW有内置若干种类似“设有类型”这样的[[#特殊属性|特殊属性]]，不论这些特殊属性是否有属性页面，它们都能起作用，并且与一般的属性作用不同。<br />

数据类型在属性判定时十分重要。<br />
首先，数据类型决定工具如何处理给出的属性值。比如如何显示这些值、查询时如何排序这些值。<br />
其次，数据类型能够帮助工具理解哪些值是相等的，比如“1234567”、“1,234,567”、“1.234567e6”都表示同一个数值。<br />
最后，一些数据类型具有特殊的行为，在下方有详细描述。<br />
由于以上原因，每个属性都应被定义合适的数据类型。

之前段落内举的例子之所以没有特别声明数据类型（如灵梦的“种族”），是因为这个属性使用的就是默认数据类型'''页面'''，显示为一个链接。<br />
但即使'''页面'''类型是默认类型，最好也在属性页上声明一下，以免在万一更改了默认类型时出现混淆。<br />
SMW管理员可以[https://www.semantic-mediawiki.org/wiki/Help:Configuration#smwgPDefaultType 改变默认类型]。

[[#数据类型|数据类型]]的声明与显示效果如下：
{|{{PrettyTable}}
!{{hl1}}|作用
!{{hl1}}|代码
|---
|将值“主要拥有在空中飞翔程度的能力”赋给属性“能力”。
|<pre>灵梦的能力为[[能力::主要拥有在空中飞翔程度的能力]]。</pre>
|---
|赋一个'''数字'''类型的值，但在文章中显示成别的文字。
|<pre>紫的年龄为[[年龄::1200|十七]]岁。</pre>
|---
|在属性页面中，指定属性的数据类型。
|<pre>这个属性是[[设有类型::数字]]类型的。</pre>
|---
|用'''URL'''类型来显示网页链接。
|<pre>欢迎来到[[主页链接::https://thwiki.cc]]。</pre>
|---
|用'''Email'''类型来显示一个发邮件的链接。
|<pre>你可以通过[[邮件地址::admin@thwiki.cc]]联系本站站长[[囧仙]]。</pre>
|}

;数据类型列表

:往下滚动一点查看下面一个段落，[[#数据类型|数据类型]]。

===数据类型===
给属性使用不同的数据类型，就可以用来描述不同的类型的值。下面为本维基内全部'''18'''种数据类型的说明：
{|{{PrettyTable}}
!{{hl1}}|本维基名称（页面）
!{{hl1}}|英文名称
!{{hl1}}|说明
!{{hl1}}|来源
|---
!{{hl2}} colspan="4"|按[[特殊:类型]]页面上的顺序排列
|---
|[[特殊:类型/Email|Email]]
|Email
|用于存储电子邮件地址。
|Semantic MediaWiki
|---
|[[特殊:类型/URI的注解|URI的注解]]
|Annotation URI
|用于存储URI，导出时与'''URL'''类型有不同。
|Semantic MediaWiki
|---
|[[特殊:类型/URL|URL]]
|URL
|用于存储URI、URN或URL。
|Semantic MediaWiki
|---
|[[特殊:类型/代码|代码]]
|Code
|用于存储各类代码，与'''文字'''类型类似，但显示时会出现代码框，并使用等宽字体。
|Semantic MediaWiki
|---
|[[特殊:类型/价格|价格]]
|Price
|（待描述）
|[[用户:Arumi|Arumi]]（本维基自定义）
|---
|[[特殊:类型/地理学的座标|地理学的座标]]
|Geographic coordinate
|用于存储描述地理学位置的坐标，使用经纬度表示。
|Semantic Maps
|---
|[[特殊:类型/布尔|布尔]]
|Boolean
|用于存储布尔值（真/假值）。
|Semantic MediaWiki
|---
|[[特殊:类型/搜索|搜索]]
|Search Key
|（待描述）
|[[用户:Arumi|Arumi]]（本维基自定义）
|---
|[[特殊:类型/数字|数字]]
|Number
|用于存储十进制整数，可使用指数符号<code>e</code>。
|Semantic MediaWiki
|---
|[[特殊:类型/数量|数量]]
|Quantity
|用于存储描述数量的值，包含一个数字和一个单位。
|Semantic MediaWiki
|---
|[[特殊:类型/文字|文字]]
|Text
|用于存储任意长度的文字。
|Semantic MediaWiki
|---
|[[特殊:类型/日期|日期]]
|Date
|用于存储一个特定的时间点。
|Semantic MediaWiki
|---
|[[特殊:类型/时长|时长]]
|Duration
|（待描述）
|[[用户:Arumi|Arumi]]（本维基自定义）
|---
|[[特殊:类型/温度|温度]]
|Temperature
|用于存储温度值。与'''数量'''类型类似，由一个数字和一个单位组成。
|Semantic MediaWiki
|---
|[[特殊:类型/电话号码|电话号码]]
|Telephone number
|用于存储符合[https://tools.ietf.org/html/rfc3966 RFC 3966]标准的国际电话号码。
|Semantic MediaWiki
|---
|[[特殊:类型/记录|记录]]
|Record
|允许存储 具有 固定数据类型 和 顺序 的值 组成的小列表，这是一个复合属性值。
|Semantic MediaWiki
|---
|[[特殊:类型/链接|链接]]
|Link
|（待描述）
|[[用户:Arumi|Arumi]]（本维基自定义）
|---
|[[特殊:类型/页面|页面]]
|Page
|用于存储维基页面的名字，并显示为链接。
|Semantic MediaWiki
|}

;各数据类型的显示格式样例

:由于展示时有必要创建新属性，而为了本维基内属性管理的有序，不便于创建大量测试用属性，此处不做展示。
:各数据类型的显示格式请见[https://www.semantic-mediawiki.org/wiki/Help:List_of_datatypes#Example_Values_and_Formatting SMW官方页面]上的说明。

;枚举“允许值”属性

:除了给属性指定数据类型，你还可以指定属性允许接受的值的范围（可以理解为属性输入值的白名单）。
:这可以通过使用[[#特殊属性|特殊属性]]中的[[:属性:允许值]]来完成。此功能可用于所有数据类型。

;单位

:数据类型'''数量'''允许在数字值后面增加一个单位，来避免混淆各个数值（比如“17岁”和“380000公里”）。
:你需要按照[[#单位|单位]]段落中说明的方式，给属性声明它所支持的单位以及换算关系。
:声明之后，属性值可以自动地在不同的单位之间换算，每个页面中，用户都可以按照需求选择合适的单位，不会影响到其他页面的查询和比较。

===特殊属性===
本段落描述了本维基SMW内置的'''24种特殊属性'''。系统需要它们才能正常运行。<br />
特殊属性在页面事实框（详见[[#浏览界面|浏览界面]]）、特殊页面“属性:...”和特殊页面“[[特殊:浏览]]”中显示为斜体字。<br />
从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.4.0 SMW 1.4.0]版本起，[[#浏览界面|浏览界面]]和[[#行内查询|行内查询]]可以像一般属性一样使用特殊属性。

与SMW类似的扩展可能也会提供一些特殊属性，如[https://www.mediawiki.org/wiki/Extension:Semantic_Extra_Special_Properties Semantic Extra Special Properties]和[https://www.semantic-mediawiki.org/wiki/Extension:Semantic_Cite Semantic Cite]扩展等。<br />
此处的说明不会包含这些特殊属性。

特殊属性的名称和别名是保留的，不能用于其他属性。'''特殊属性只能按下方说明的方法使用。'''<br />
没必要给特殊属性创建属性页面。即使维基内没有特殊属性的页面，它们也会照常工作。

下面的表格给出了特殊属性的概括性说明：
{|{{PrettyTable}}
!{{hl1}}|本维基名称（页面）
!{{hl1}}|英文名称
!{{hl1}}|别名
!{{hl1}}|概括性说明
!{{hl1}}|详细说明
!{{hl1}}|是否为可选
!{{hl1}}|标签
|---
|[[:属性:允许值|允许值]]
|Allows value
|{{color:gray|（无）}}
|用于列出属性允许输入的一个值。
|见[[#允许值|允许值]]段落
|否
|_PVAL
|---
|[[:属性:符合于|符合于]]
|Corresponds to
|{{color:gray|（无）}}
|用于给出某个'''数量'''类型属性的其他可选单位和换算系数。
|见[[#符合于|符合于]]段落
|否
|_CONV
|---
|[[:属性:显示单位|显示单位]]
|Display units
|Display unit、[[:属性:显示计量单位|显示计量单位]]
|用于给出一列显示时使用的单位或格式，用半角逗号隔开。
|见[[#显示单位|显示单位]]段落
|否
|_UNIT
|---
|[[:属性:对应的URI|对应的URI]]
|Equivalent URI
|{{color:gray|（无）}}
|用于给页面添加一个外部URI，来说明此词条在维基外的众所周知的含义。
|见[[#对应的URI|对应的URI]]段落
|否
|_URI
|---
|[[:属性:设有类型|设有类型]]
|Has type
|{{color:gray|（无）}}
|用于为属性指定类型。
|见[[#设有类型|设有类型]]段落
|否
|_TYPE
|---
|[[:属性:输入来源|输入来源]]
|Imported from
|{{color:gray|（无）}}
|允许用户在维基内直接重用外部词汇元素。
|见[[#输入来源|输入来源]]段落
|否
|_IMPO
|---
|[[:属性:提供服务|提供服务]]
|Provides service
|{{color:gray|（无）}}
|用于为属性添加服务链接。
|见[[#提供服务|提供服务]]段落
|否
|_SERV
|---
|[[:属性:所属的子属性|所属的子属性]]
|Subproperty of
|{{color:gray|（无）}}
|用于指定一个属性是另一个属性的子属性。
|见[[#所属的子属性|所属的子属性]]段落
|否
|_SUBP
|---
|[[:属性:修改日期|修改日期]]
|Modification date
|{{color:gray|（无）}}
|用于存储一个固定值，该值表示页面的最后编辑时间。
|见[[#修改日期|修改日期]]段落
|'''是'''
|_MDAT
|---
|[[:属性:有无不正确的值|有无不正确的值]]
|Has improper value for
|{{color:gray|（无）}}
|用于在给属性指定一个不允许输入的值时，发出警告。
|见[[#有无不正确的值|有无不正确的值]]段落。
|否
|_ERRP
|---
|[[:属性:有无字段|有无字段]]
|Has fields
|{{color:gray|（无）}}
|用于给'''记录'''类型定义一个固定类型和顺序的字段小列表。
|见[[#有无字段|有无字段]]段落
|否
|_LIST
|---
|[[:属性:所属的子分类|所属的子分类]]
|Subcategory of
|{{color:gray|（无）}}
|用于指定一个分类是另一个分类的子分类。
|见[[#所属的子分类|所属的子分类]]段落
|否
|_SUBC
|---
|[[:属性:创建日期|创建日期]]
|Creation date
|{{color:gray|（无）}}
|用于存储一个固定值，该值表示页面的首次编辑时间。
|见[[#创建日期|创建日期]]段落
|'''是'''
|_CDAT
|---
|[[:属性:有无子对象|有无子对象]]
|Has subobject
|{{color:gray|（无）}}
|用于存储页面上设定的子对象。
|见[[#有无子对象|有无子对象]]段落
|否
|_SOBJ
|---
|[[:属性:是否为新页面|是否为新页面]]
|Is a new page
|{{color:gray|（无）}}
|用于标记页面是不是新页面。
|见[[#是否为新页面|是否为新页面]]段落
|'''是'''
|_NEWP
|---
|[[:属性:最后编辑者是|最后编辑者是]]
|Last editor is
|{{color:gray|（无）}}
|用于存储页面最后编辑者的用户页面名字。
|见[[#最后编辑者是|最后编辑者是]]段落
|'''是'''
|_LEDT
|---
|[[:属性:有无查询|有无查询]]
|Has query
|{{color:gray|（无）}}
|用于给页面创建一个链接，指向由查询创建的子对象。
|见[[#有无查询|有无查询]]段落
|否
|_ASK
|---
|[[:属性:查询深度|查询深度]]
|Query depth
|{{color:gray|（无）}}
|用于存储查询属性的深度。
|见[[#查询深度|查询深度]]段落
|否
|_ASKDE
|---
|[[:属性:查询格式|查询格式]]
|Query format
|{{color:gray|（无）}}
|用于存储查询结果的格式名称。
|见[[#查询格式|查询格式]]段落
|否
|_ASKFO
|---
|[[:属性:查询大小|查询大小]]
|Query size
|{{color:gray|（无）}}
|用于存储查询条件的数目。
|见[[#查询大小|查询大小]]段落
|否
|_ASKSI
|---
|[[:属性:查询字符串|查询字符串]]
|Query string
|{{color:gray|（无）}}
|用于以字符串的形式存储查询条件。
|见[[#查询字符串|查询字符串]]段落
|否
|_ASKST
|---
|[[:属性:查询时长|查询时长]]
|Query duration
|{{color:gray|（无）}}
|用于存储执行查询的耗时。
|见[[#查询时长|查询时长]]段落
|'''是'''
|_ASKDU
|---
|[[:属性:Mime类型|Mime类型]]
|MIME type
|{{color:gray|（无）}}
|用于存储上传文件的MIME类型。
|见[[#Mime类型|Mime类型]]段落
|'''是'''
|_MIME
|---
|[[:属性:媒体类型|媒体类型]]
|Media type
|{{color:gray|（无）}}
|用于存储上传文件的媒体类型。
|见[[#媒体类型|媒体类型]]段落
|'''是'''
|_MEDIA
|}

====允许值====
{{帮助SMW-测试警告-小}}
特殊属性“允许值”用于列出属性能够接受的值，这个特殊属性是给属性页面使用的。<br />
你可以给任何[[#数据类型|数据类型]]的属性使用，来限制该属性能接受的值。<br />

;例子

:如前文中提到的“种族”属性，可能包含如下的代码：
:{{pre|<nowiki>
[[允许值::人类]]
[[允许值::妖怪]]
[[允许值::阎魔]]
[[允许值::亡灵]]
...
</nowiki>}}

;有序属性

:照前文例子中那样枚举几个允许值，并不会按照代码的顺序来放置可用的值。
:属性总是会按照[[#数据类型|数据类型]]中指定的自然顺序来排列。
:如果要指定顺序，可以使用前缀，例如'''文字'''类型的属性“跑步速度”，可以按照下面这种方式来指定排列顺序：
:{{pre|<nowiki>
[[允许值::A 跑的比谁都快]]
[[允许值::B 运动健将]]
[[允许值::C 常人速度]]
[[允许值::D 慢]]
</nowiki>}}
:如果照上面的方式写，你就可以使用比较器来执行[[#语义搜索|语义搜索]]了。
:比如查询条件可以写为<code><nowiki>[[跑步速度::>C 常人速度]]</nowiki></code>，含义是大于等于常人速度（详见[[#比较器注意事项|比较器注意事项]]），即查询A、B、C三项。

;对错误值的处理

:当你为页面定义了属性<code><nowiki>[[种族::两栖类]]</nowiki></code>，而“种族”属性不接受这种值，则会显示警告标识。
:但如果你使用<code><nowiki>{{#set: 种族=两栖类 }}</nowiki></code>这种方式来定义属性，则这种错误会被静默忽略。
:你可以使用“[[#有无不正确的值|有无不正确的值]]”属性来寻找使用错误值的页面。

====符合于====
{{帮助SMW-测试警告-小}}
特殊属性“符合于”用于给出一个物理量的单位和换算系数。<br />
关于单位和本属性的详细用法请见[[#单位|单位]]段落，此处仅作简单说明。

你可以对[[#数据类型|数据类型]]为'''数量'''和'''数字'''的属性使用本特殊属性。<br />
假设有“体重”属性，在属性页面上可能包含如下代码：
<pre>
[[符合于::1 公斤, 千克, kg]]
[[符合于::2 斤, 市斤]]
[[符合于::20 两]]
[[符合于::1000 克, g]]
</pre>
（'''注意应使用半角逗号'''）<br />
对于如上方代码所示的比例换算，属性会被设定为'''数量'''类型。<br />
如果为非比例换算（如y=5*x+10），只能用于'''数字'''类型。如果需要使用单位，则需额外使用一种[[#数据类型|数据类型]]。<br />
目前，只有'''温度'''类型使用了额外的数据类型。

====显示单位====
{{帮助SMW-测试警告-小}}
特殊属性“显示单位”，别名“显示计量单位”，用于指定属性的单位。<br />
指定时，用半角逗号隔开各个单位。

在[[#数据类型|数据类型]]为'''数量'''、'''数字'''或'''温度'''的属性页面上使用本特殊属性时，效果为所有显示值都只会显示为给出的单位，并且只会显示为给出的顺序（单位在前还是数字在前）。<br />
如果一个属性没有特别指定显示的单位，则会转换为该属性的[[#数据类型|数据类型]]所支持的单位。<br />
你可以为属性页面添加“显示单位”来规定显示格式，或者规定显示该单位的何种称呼（如显示为“分”还是“分钟”）。<br />
在工具提示（鼠标停留在页面的属性文本上会显示）、页面事实框（详见[[#浏览界面|浏览界面]]）和一些查询结果中，会显示转换为附加单位的值。

注意，即使你规定了单位的显示格式，属性赋值时却不一定要按显示格式定义。<br />
你仍可以用[[#数据类型|数据类型]]本身带有的，或者你使用“[[#符合于|符合于]]”规定的单位来给属性赋值。

仍假设有“体重”属性，在属性页面上可能包含如下代码：
<pre>
[[显示单位::斤]]
</pre>
则所有注释为“体重”属性的值都会显示为斤作单位。

====对应的URI====
{{帮助SMW-翻译提示-小
|原文链接=https://www.semantic-mediawiki.org/wiki/Help:Special_property_Equivalent_URI
}}
（不常用的属性，后期将补完。）

====设有类型====
{{帮助SMW-测试警告-小}}
特殊属性“设有类型”用于指定属性的[[#数据类型|数据类型]]。

比如上文中的例子“能力”属性，灵梦的“能力”是“主要拥有在空中飞翔程度的能力”，应使用'''文字'''类型。<br />
则在“能力”的属性页面上，应指定：
 <nowiki>这个属性是[[设有类型::文字]]类型的。</nowiki>

在1.0到1.4.3版本的SMW中，一个属性可以由多个值，且可以为每个值定义不同的类型。<br />
从1.5.0版本开始，多值属性被'''记录'''类型代替，详见[[#数据类型|数据类型]]。<br />
（'''本维基SMW版本2.1.1'''）

====输入来源====
{{帮助SMW-翻译提示-小
|原文链接=https://www.semantic-mediawiki.org/wiki/Help:Special_property_Imported_from
}}
（不常用的属性，后期将补完。）

====提供服务====
{{帮助SMW-翻译提示-小
|原文链接=https://www.semantic-mediawiki.org/wiki/Help:Special_property_Provides_service
}}
（不常用的属性，后期将补完。）

====所属的子属性====
{{帮助SMW-测试警告-小}}
{{帮助SMW-测试部分允许-小}}
特殊属性“所属的子属性”用于指定属性之间的从属关系。<br />
这意味着，在进行[[#语义搜索|语义搜索]]时，如果查询父属性，其子属性也会被查询。

举个本维基内的例子，在[[:分类:同人专辑]]下属的页面上，有[[:属性:曲目人员]]。该属性有以下几个子属性：
*[[:属性:作曲]]
*[[:属性:作词]]
*[[:属性:剧本]]
*[[:属性:演唱]]
*[[:属性:演奏]]
*[[:属性:编曲]]
*[[:属性:配音]]
为了使“作曲”成为“曲目人员”的子属性，你需要在“作曲”属性的页面上写下面的代码：
<pre>[[所属的子属性::曲目人员]]</pre>
则在“曲目人员”属性页面上，将看到它具有子属性“作曲”。

;父属性用于查询时

:下面这行代码将会查询所有具有“曲目人员”属性的页面，具有其子属性“作曲”等的页面也会显示在结果中：
:{{帮助SMW-绿代码|<nowiki>
{{#ask: [[曲目人员::+]] }}
</nowiki>}}
:效果（此处限制显示前十条曲目）：
::<tt>{{#ask: [[曲目人员::+]] |limit = 10}}</tt>

;父属性用于显示时

:但如果你在在[[#语义搜索|语义搜索]]时使用了参数，规定了要显示的属性（详见[[#显示信息|显示信息]]），则此时父属性栏里不会出现子属性的值：
:{{帮助SMW-绿代码|<nowiki>
{{#ask: [[曲目人员::+]]
|?曲目人员
|?作曲
|?作词
|?剧本
|?演唱
|?演奏
|?编曲
|?配音
}}
</nowiki>}}
:效果（此处限制显示前十条曲目）：
:{{#ask: [[曲目人员::+]]
|?曲目人员
|?作曲
|?作词
|?剧本
|?演唱
|?演奏
|?编曲
|?配音
|limit =10
}}
:如上方所示，由于曲目没有被直接定义“曲目人员”属性，所以该项为空。<br />
:（本维基内用于编写曲目的[[模板:同人曲目信息]]把编写时输入的值赋给“曲目人员”属性的子属性，如“编曲”等。）

;父属性同时用于查询和显示时

:但是在查询的条件区域，父属性的值是包含子属性的。<br />
:如下面这个例子，查询的是“曲目人员”及其子属性中，值包含“[[溝口ゆうま]]”的曲目名及其各属性值。
:{{帮助SMW-绿代码|<nowiki>
{{#ask: [[曲目人员::溝口ゆうま]]
|?曲目人员
|?作曲
|?作词
|?剧本
|?演唱
|?演奏
|?编曲
|?配音
|limit =10
}}
</nowiki>}}
:结果为（此处限制显示前十条曲目）：
:{{#ask: [[曲目人员::溝口ゆうま]]
|?曲目人员
|?作曲
|?作词
|?剧本
|?演唱
|?演奏
|?编曲
|?配音
|limit =10
}}
:可以看出，“[[溝口ゆうま]]”不论出现在哪个子属性里，查询都能查到该曲目。但“曲目人员”属性依旧为空。

关于查询与显示结果的方法，详见[[#语义搜索|语义搜索]]段落。

====修改日期====
特殊属性“修改日期”用于存储页面的最后修改时间。<br />
此特殊属性从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.4.0 SMW 1.4.0]版本开始出现，从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.7.0 SMW 1.7.0]版本开始可以设置是否使用本特殊属性。<br />
关于如何设置是否使用，请见[https://www.semantic-mediawiki.org/wiki/Help:$smwgPageSpecialProperties $smwgPageSpecialProperties]设置帮助页面，里面介绍了如何设置SMW的特殊页面相关属性。

本属性可在[[#行内查询|行内查询]]时用于查询页面的修改日期，其[[#数据类型|数据类型]]为'''日期'''。<br />
'''请勿手动给本特殊属性赋值。'''SMW会自动更新本属性的值。从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0 SMW 2.2.0]版本起，将不能手动为本特殊属性赋值。<br />
（'''本维基SMW版本2.1.1'''）

本属性内存储的值是基于维基服务器内部的时间推算出的，所以此时间可能与用户所在的时区不一致。<br />
由于这些值是存储于数据库内的，它不会随着用户设定的时区而变化，所以建议维基服务器将时区设为[https://en.wikipedia.org/wiki/en:Coordinated_Universal_Time UTC]时区，以免在当地时间变化时（如迁移维基服务器时）出现问题。

;查询本属性

:如查询本页的“修改日期”属性：
:<pre>{{#show: 帮助:SMW | ?修改日期 }}</pre>
:效果：
::<tt>{{#show: 帮助:SMW | ?修改日期 }}</tt>

:[[#show|show]]函数的详细使用方法见其自己的段落和[[#行内查询|行内查询]]段落。

====有无不正确的值====
{{帮助SMW-测试警告-小}}
{{帮助SMW-测试部分允许-小}}
特殊属性“有无不正确的值”用于追踪一些属性的无效输入值。<br />
一般会检查输入的值是否符合该属性的[[#数据类型|数据类型]]，数据类型使用特殊属性“[[#设为类型|设为类型]]”来规定。<br />
同时也检查是否符合特殊属性“[[#允许值|允许值]]”规定的输入值。

对于有错误输出值的页面，其页面的“有无不正确的值”属性的值即为有错误输入值的属性名。<br />
所以本属性可在[[#行内查询|行内查询]]或使用[[特殊:按属性搜索]]页面时，用于寻找有错误输入的页面。<br />
另外需要注意，使用SMW特殊属性时出现的错误也会被记录于本属性内。<br />

“有无不正确的值”属性在维护维基时十分有用，某属性数据类型更改后，SMW也使用本属性来自动修复记录。

'''请勿手动给本特殊属性赋值。'''SMW会自动更新本属性的值。从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0 SMW 2.2.0]版本起，将不能手动为本特殊属性赋值。<br />
（'''本维基SMW版本2.1.1'''）

;查询有错误的输入

:如查询[[:分类:同人专辑]]中所有有错误输入值的页面，并显示有错误输入值的属性名：
:{{帮助SMW-绿代码|<nowiki>
{{#ask:
[[分类:同人专辑]]
[[有无不正确的值::+]]
|?有无不正确的值
}}
</nowiki>}}
:效果：
:{{#ask:
[[分类:同人专辑]]
[[有无不正确的值::+]]
|?有无不正确的值
}}
:搜索结果中显示了页面名和有错误输入的属性。

:[[#ask|ask]]函数详细用法见其自己的段落。

;有错误输入时在页面上的提示

:具有错误输入的属性，在页面上会有标记。下面举一个例子。
:[[:属性:测试number]]的[[#数据类型|数据类型]]为'''数字'''，我们在这里为它赋一个非数字的值：
:<pre>[[测试number::帮助SMW例子-测试有错误的输入]]</pre>
:则显示在页面上时，就会出现一个黄色的警告标记，鼠标停留在标记上，有相应的说明：
::<tt>帮助SMW例子-测试有错误的输入{{#info:"帮助SMW例子-测试有错误的输入"不是数字。|warning}}</tt>

====有无字段====
{{帮助SMW-翻译提示-小
|原文链接=https://www.semantic-mediawiki.org/wiki/Help:Special_property_Has_fields
}}
（不常用的属性，后期将补完。）

====所属的子分类====
特殊属性“所属的子分类”用于指定分类之间的从属关系。<br />
则在对父分类进行[[#语义搜索|语义搜索]]时，[[#推理|推理]]功能会将子分类将作为子类（Subclass）归进搜索范围内。<br />
本属性在[https://www.semantic-mediawiki.org/wiki/Help:$smwgUseCategoryHierarchy $smwgUseCategoryHierarchy]（决定SMW是否使用MW分类层次关系的参数）设置为<code>false</code>时十分有用，此时子分类关系必须用本属性明确声明才起作用，没有被明确声明的MW分类层次关系会被忽略。

;设置本特殊属性

:仅在[https://www.semantic-mediawiki.org/wiki/Help:$smwgUseCategoryHierarchy $smwgUseCategoryHierarchy]被设为<code>false</code>时，本属性的声明才有效。
:在默认情况下，该参数为<code>true</code>，则SMW会自动识别MW的分类层次结构，并对所有子分类自动设定“所属的子分类”属性。
:'''本维基此参数为<code>true</code>'''。

:下面举一个例子：
:比如在本维基中，[[:分类:官方作品]]下面有三个子分类：
:*[[:分类:官方出版物]]
:*[[:分类:官方游戏]]
:*[[:分类:官方音乐]]
:则当查询“官方作品”时，返回的结果也应包含“官方出版物”等子分类中的页面。
:并且也会查询子分类的子分类中的页面，查询的深度由[https://www.semantic-mediawiki.org/wiki/Help:$smwgQSubcategoryDepth $smwgQSubcategoryDepth]参数定义，默认为10层。
:另可参见[[#推理|推理]]段落的说明。

;查询页面举例

:仍使用上方的[[:分类:官方作品]]的例子，你可以通过查询父分类来查询子分类中的页面：
:{{pre|<nowiki>
{{#ask:
[[分类:官方作品]]
[[发售方::黄昏边境]]
}}
</nowiki>}}
:结果为：
::<tt>{{#ask:
[[分类:官方作品]]
[[发售方::黄昏边境]]
}}</tt>
:由[[:分类:官方作品]]查到了[[:分类:官方游戏]]中的内容。

;查询分类有哪些子分类

:无论[https://www.semantic-mediawiki.org/wiki/Help:$smwgUseCategoryHierarchy $smwgUseCategoryHierarchy]被设定为何值，你都可以用“所属的子分类”属性来查询分类的子分类。

:比如你想知道[[:分类:官方作品]]下面有哪些子分类，就可以用如下代码：
:{{pre|<nowiki>
{{#ask:
[[所属的子分类::官方作品]]
}}
</nowiki>}}
:（在查询条件中，可以不输入<code>分类:</code>）
:效果为：
::<tt>{{#ask:
[[所属的子分类::官方作品]]
}}</tt>

:;应注意：

::在查询分类有哪些子分类时，子分类的子分类，如[[:分类:官方音乐]]的子分类[[:分类:官方音乐CD]]，是不包含在结果里的。
::目前还不能查询下属层次的所有子分类。

与[[#ask|ask]]函数有关的用法详见其函数段落与[[#语义搜索|语义搜索]]段落。

====创建日期====
特殊属性“创建日期”用于用于存储页面的首次编辑时间。<br />
此特殊属性从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.7.0 SMW 1.7.0]版本开始出现，并可以设置是否使用本特殊属性。<br />
默认本属性是不启用的。关于如何设置是否使用，请见[https://www.semantic-mediawiki.org/wiki/Help:$smwgPageSpecialProperties $smwgPageSpecialProperties]设置帮助页面，里面介绍了如何设置SMW的特殊页面相关属性。

'''本维基不启用“创建日期”特殊属性。'''

本属性可在[[#行内查询|行内查询]]时用于查询页面的修改日期，其[[#数据类型|数据类型]]为'''日期'''。<br />
'''请勿手动给本特殊属性赋值。'''SMW会自动更新本属性的值。从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0 SMW 2.2.0]版本起，将不能手动为本特殊属性赋值。<br />
（'''本维基SMW版本2.1.1'''）

本属性内存储的值是基于维基服务器内部的时间推算出的，所以此时间可能与用户所在的时区不一致。<br />
由于这些值是存储于数据库内的，它不会随着用户设定的时区而变化，所以建议维基服务器将时区设为[https://en.wikipedia.org/wiki/en:Coordinated_Universal_Time UTC]时区，以免在当地时间变化时（如迁移维基服务器时）出现问题。

====有无子对象====
特殊属性“有无子对象”用于存储页面中设置的子对象。<br />
关于子对象的说明详见[[#subobject|subobject]]函数的段落。

'''请勿手动给本特殊属性赋值。'''SMW会自动更新本属性的值。从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0 SMW 2.2.0]版本起，将不能手动为本特殊属性赋值。<br />
（'''本维基SMW版本2.1.1'''）

====是否为新页面====
特殊属性“是否为新页面”用于标记页面是否为新。<br />
新页面指刚被创建，只经过一次编辑，即只有一个版本的页面。<br />
此特殊属性从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.7.1 SMW 1.7.1]版本开始出现，并可以设置是否使用本特殊属性。<br />
默认本属性是不启用的。关于如何设置是否使用，请见[https://www.semantic-mediawiki.org/wiki/Help:$smwgPageSpecialProperties $smwgPageSpecialProperties]设置帮助页面，里面介绍了如何设置SMW的特殊页面相关属性。

'''本维基不启用“是否为新页面”特殊属性。'''

本属性可在[[#行内查询|行内查询]]时用于查询页面是否为新，其[[#数据类型|数据类型]]为'''布尔'''。<br />
'''请勿手动给本特殊属性赋值。'''SMW会自动更新本属性的值。从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0 SMW 2.2.0]版本起，将不能手动为本特殊属性赋值。<br />
（'''本维基SMW版本2.1.1'''）

====最后编辑者是====
特殊属性“最后编辑者是”用于存储页面最后编辑者的用户页面名字。<br />
此特殊属性从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.7.1 SMW 1.7.1]版本开始出现，并可以设置是否使用本特殊属性。<br />
默认本属性是不启用的。关于如何设置是否使用，请见[https://www.semantic-mediawiki.org/wiki/Help:$smwgPageSpecialProperties $smwgPageSpecialProperties]设置帮助页面，里面介绍了如何设置SMW的特殊页面相关属性。

'''本维基不启用“最后编辑者是”特殊属性。'''

本属性可在[[#行内查询|行内查询]]时用于查询页面的最后编辑者，其[[#数据类型|数据类型]]为'''页面'''。<br />
'''请勿手动给本特殊属性赋值。'''SMW会自动更新本属性的值。从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0 SMW 2.2.0]版本起，将不能手动为本特殊属性赋值。<br />
（'''本维基SMW版本2.1.1'''）

====有无查询====
特殊属性“有无查询”用于链接页面到[[#行内查询|行内查询]]所创建的子对象。<br />
这个子对象中存储了与本次查询有关的信息。<br />
包括[[#查询深度|查询深度]]、[[#查询格式|查询格式]]、[[#查询大小|查询大小]]和[[#查询字符串|查询字符串]]。<br />
关于本属性的用法详见[[#对查询行为的查询|对查询行为的查询]]段落。

'''请勿手动给本特殊属性赋值。'''SMW会自动更新本属性的值。从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0 SMW 2.2.0]版本起，将不能手动为本特殊属性赋值。<br />
（'''本维基SMW版本2.1.1'''）

====查询深度====
特殊属性“查询深度”用于存储[[#行内查询|行内查询]]时，[[#推理|推理]]出的属性深度。<br />
关于本属性的用法详见[[#对查询行为的查询|对查询行为的查询]]段落。

====查询格式====
特殊属性“查询格式”用于存储[[#行内查询|行内查询]]时，[[#结果格式|结果格式]]的名字。<br />
关于本属性的用法详见[[#对查询行为的查询|对查询行为的查询]]段落。

====查询大小====
特殊属性“查询大小”用于存储[[#行内查询|行内查询]]时，[[#检索页面|检索页面]]的查询条件个数。<br />
关于本属性的用法详见[[#对查询行为的查询|对查询行为的查询]]段落。

====查询字符串====
特殊属性“查询字符串”用于存储[[#行内查询|行内查询]]时，[[#检索页面|检索页面]]的查询条件文本，本属性[[#数据类型|数据类型]]为'''代码'''。<br />
关于本属性的用法详见[[#对查询行为的查询|对查询行为的查询]]段落。

====查询时长====
特殊属性“查询时长”用于存储[[#行内查询|行内查询]]时，执行查询所使用的时间。<br />
关于本属性的用法详见[[#对查询行为的查询|对查询行为的查询]]段落。

默认本属性是不启用的。关于如何设置是否使用，请见[https://www.semantic-mediawiki.org/wiki/Help:$smwgQueryProfiler $smwgQueryProfiler]设置帮助页面。

'''本维基不启用“查询时长”特殊属性。'''

====Mime类型====
特殊属性“Mime类型”用于存储上传文件的[https://en.wikipedia.org/wiki/en:Media_type MIME类型]。<br />
因此，本属性仅对名字空间为<code>文件</code>的页面起作用。<br />
此特殊属性从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.9.1 SMW 1.9.1]版本开始出现，并可以设置是否使用本特殊属性。<br />
默认本属性是不启用的。关于如何设置是否使用，请见[https://www.semantic-mediawiki.org/wiki/Help:$smwgPageSpecialProperties $smwgPageSpecialProperties]设置帮助页面，里面介绍了如何设置SMW的特殊页面相关属性。

'''本维基不启用“Mime类型”特殊属性。'''

本属性的使用方式同其他[[#数据类型|数据类型]]为'''文字'''的属性类似。<br />
'''请勿手动给本特殊属性赋值。'''SMW会自动更新本属性的值。从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0 SMW 2.2.0]版本起，将不能手动为本特殊属性赋值。<br />
（'''本维基SMW版本2.1.1'''）

====媒体类型====
特殊属性“媒体类型”用于存储上传文件的[https://en.wikipedia.org/wiki/en:Media_type 媒体类型]。<br />
因此，本属性仅对名字空间为<code>文件</code>的页面起作用。<br />
此特殊属性从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.9.1 SMW 1.9.1]版本开始出现，并可以设置是否使用本特殊属性。<br />
默认本属性是不启用的。关于如何设置是否使用，请见[https://www.semantic-mediawiki.org/wiki/Help:$smwgPageSpecialProperties $smwgPageSpecialProperties]设置帮助页面，里面介绍了如何设置SMW的特殊页面相关属性。

'''本维基不启用“媒体类型”特殊属性。'''

本属性的使用方式同其他[[#数据类型|数据类型]]为'''文字'''的属性类似。<br />
'''请勿手动给本特殊属性赋值。'''SMW会自动更新本属性的值。从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0 SMW 2.2.0]版本起，将不能手动为本特殊属性赋值。<br />
（'''本维基SMW版本2.1.1'''）

===反向属性===
{{帮助SMW-测试警告-小}}
{{帮助SMW-测试部分允许-小}}
从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.5.0 SMW 1.5.0]版本起，在进行[[#语义搜索|语义搜索]]（包括[[#行内查询|行内查询]]和[[#概念|概念]]）与在[[#浏览界面|浏览界面]]上查询时，[[#数据类型|数据类型]]为'''页面'''的属性可以进行反向查询。

在任何SMW功能中，只需在属性名字前加连字符<code>-</code>，即可反向查询属性。<br />
在使用反向属性时，“具有属性的页面”和“该属性的值（也为页面）”相互交换位置。<br />

;逻辑关系

:为了便于理解，这里举一个逻辑上的例子：
:<pre>Parent是Child的家长。</pre>
:反过来说应该是：
:<pre>Child的家长是Parent。</pre>
:或者：
:<pre>Child是Parent的孩子。</pre>
:这两种说法都没有问题。

;注意两种说法的区别

:下面这个例子就容易理解错误：
:<pre>蕾米是芙兰的姐姐。</pre>
:反过来说应该是：
:<pre>芙兰的姐姐是蕾米。</pre>
:你可能觉得也可以这么说：
:<pre>芙兰是蕾米的妹妹。</pre>
:但这是错误的，因为第一句话并没有给出芙兰的性别。
:在应用反向属性时，就应该注意这种逻辑上的区别。

;与普通属性的区别

:SMW不支持给反向属性命名，也不能给反向属性赋值。反向属性仅限用于查询数据。
:反向属性在[[#浏览界面|浏览界面]]、[[#语义搜索|语义搜索]]和查询输出指令时有效。

:用于[[#行内查询|行内查询]]时，仅对[[#数据类型|数据类型]]为'''页面'''的属性有效。

;使用举例

:如前文中使用过的例子，假设在[[博丽灵梦]]页面上有下面的语句：
:<pre>灵梦的种族是[[种族::人类]]。</pre>
:则你可以在其他页面上，通过反向属性来查询灵梦的种族：
:{{帮助SMW-绿代码|<nowiki>
{{#ask:
[[-种族::博丽灵梦]]
}}
</nowiki>}}
:结果为：
::<tt>[[人类]]</tt>

:应注意，要使用反向属性查询，“种族”属性的[[#数据类型|数据类型]]应为'''页面'''。
:反向属性对'''数字'''、'''日期'''等类型不起作用。

==单位==
本段落描述如何控制[[#数据类型|数据类型]]为'''数量'''的属性在页面中显示和转换单位。<br />
此功能可以使注释更加灵活方便：用户可以用自己习惯的单位来输入数据，且相互之间都能不受限制地理解数据内容。<br />
举个例子，对于距离的单位，一些人可能习惯用“英里”，而另一些人习惯用“公里（千米）”。<br />
而在一些文章中，距离可能小到最好用“微米”表示，此时若显示为“千米”则不合适。

===单位转换===
{{帮助SMW-测试警告-小}}
SMW内置了一些可以处理单位的[[#数据类型|数据类型]]（如'''温度'''）。<br />
支持单位的数据类型可以接受若干不同单位、在各个单位之间转换、以不同单位来显示值。<br />
由于本维基内没有'''数量'''类型的属性，可以参看[https://www.semantic-mediawiki.org/wiki/Demo:Berlin SMW:演示:柏林]页面，其最下方的事实框中有土地面积转换的例子。<br />
本维基内使用了经过修改的，类似'''数量'''类型的'''价格'''和'''时长'''类型。

为了实现以上功能，SMW需要了解如何将值从某单位转换到另一单位。<br />
在大多数情况下，转换方式非常简单，但有时也会遇到具有复杂计算的情况。我们对两种情况作如下区分：
#两个单位之间的转换是''“成比例”''的。即转换只需乘一个系数就可以完成。如在公斤和斤之间、米与千米之间的换算。
#两个单位之间的转换是''“不成比例”''的，需要更加复杂的计算。比如'''温度'''类型就有这样的问题，摄氏度与华氏度之间的转换大约是<code>F = 32+1.8*C</code>。
对于第1种情况的单位转换，可以使用[[#数据类型|数据类型]]'''数量'''来定义属性的单位和单位间的转换系数。<br />
对于第2种情况，我们在下方讨论了一些可能的处理方式。

;成比例的单位转换

:为了声明由数字和单位组成的属性值，SMW提供了[[#数据类型|数据类型]]'''数量'''。
:“单位”可以是一个非数字开头的文本标签，如“英里”、“km”、“平方千米”、“m/s”等。
:要使用一个单位，或者是同一单位的不同称呼（如公里和千米），必须先按照下面的说法，在属性的页面声明它。
:只可使用声明过的单位，否则会被当作错入出入而拒绝接受。
:因此，只有当在'''数量'''类型的属性中，声明了至少一个单位后，这个属性才真正有作用。
:如此严格的系统使得即使输入的单位都不同，SMW也可以比较它们的值的大小。
:每个输入都确切地指定了“数量”的大小（如时长、距离等），即使输入的方式不同。
:'''数量'''类型的属性值是真实按照数量（一个数字与一个单位）来存储的，而不是按照文本来存储。文本存储无法知晓值的大小，也不能区分单位。
:在其他[[#数据类型|数据类型]]中也有类似的行为。如对于“2”或“2.0”，SMW把它们视为相等，不论它们写成何种形式。

:要使用SMW中的单位转换，首先你需要创建一个合适的属性。
:按照惯例，首先你需要使用维基搜索功能，或者到[[特殊:属性]]页面查看是否已有你想用的属性。如果没有，则创建一个新的属性页面。
:比如我们来创建一个[[属性:质量]]，来说明物理量[https://en.wikipedia.org/wiki/Mass 质量]。
:在这个新页面上，你首先需要写上这个新属性的用途。在本例中，可以写“类型为数量，物质的三种属性之一，通常用千克来度量物理量。”
:这样写能帮助其他用户寻找和使用你定义的此项属性，搜索时可以搜到这句话中的关键词。
:要指定[[#数据类型|数据类型]]，你需要写：
:<pre>[[设有类型::数量]]</pre>
:在属性页的任意位置写都可以，但推荐在上面的句子里写这个注释。
:要声明支持的单位，你需要使用[[#特殊属性|特殊属性]]“'''符合于'''”。比如你需要指定“质量”属性的''“主单位”''，就要写上：
:<pre>[[符合于::1 千克]]</pre>
:“1 千克”说明了以下两件事：
:#属性具备单位“千克”；
:#“千克”是主单位（由系数为1得来）。
:显示[[#数据类型|数据类型]]为'''数量'''的值时，默认选择主单位作为显示单位。当用户在声明属性值时只用数字不带单位，系统就假定单位为主单位。
:指定其他单位的方法很简单，如：
:{{pre|<nowiki>
[[符合于::0.001 吨]]
[[符合于::1000 克]]
</nowiki>}}
:这说明此属性还可使用单位“吨”和“克”。你可以写成句子，并将上面的声明注释在句子里：
:“1千克等于0.001吨，也等于1000克。”
:以此方法，该属性就可以支持任意单位，只要它们能与主单位进行简单的比例换算。

:在许多情况下，对同一单位可能有好几种称呼。比如你可以说“千克”，也可以说“公斤”或者“kg”。
:处理这种情况的简便方法为：用半角逗号<code>,</code>隔开各个称呼，不用对换算系数相同的单位使用“符合于”。
:比如在本例中，可写为：
:{{pre|<nowiki>
[[符合于::1 千克,公斤,kg]]
[[符合于::0.001 吨,t]]
[[符合于::1000 克,g]]
</nowiki>}}
:在本例中，主单位为“符合于”声明中，系数为1的第一个单位，此处为“千克”。
:属性能够理解所有由“符合于”声明的单位，并且会显示它们之间的转换（但不重复，即不会同时显示“千克”和“公斤”）。

:在系统内部，属性值会被转换为主单位，[https://www.semantic-mediawiki.org/wiki/Help:RDF_export RDF导出]也只会显示主单位下的值。
:不带单位的输入值一概当作主单位下的值。
:这就意味着，单位转换是一个简单的前处理（对于用户输入）和后处理（对于显示），从而使用户能够更方便地使用单位。
:在维基页面中显示的单位可以非常自由的选择，且无需涉及主单位，具体用法见下文[[#自定义单位|自定义单位]]。

:;提示：
::如果有许多属性具备相同的单位声明语句（比如“属性:长度”、“属性:高度”等表示距离的属性），可以将这些语句写进模板里，在属性页面上用模板即可。
::这样可以保证相同类型测量量的属性总是支持相同的单位。

:;注意：
::在本维基的SMW 2.1.1版本下，单位必须写在数字的后面，不支持前置的单位，如“$100”等。

;不成比例的单位转换

:若使用[[#数据类型|数据类型]]为'''数量'''的属性，你只能指定一个比例换算系数。
:所以你不能按照对数转换，也不能对不同单位使用不同底数，等等。
:举一个例子：你不能自定义一个可以从摄氏度转换到华氏度的属性，这个转换不仅需要乘法，还需要加法。
:对于温度，SMW已经提供了一个内置的[[#数据类型|数据类型]]'''温度'''，它可以处理温度的转换，但其他的非比例转换就没有这么幸运了。

:SMW不允许在维基里自定义一个不成比例的单位。
:一种处理方式是使用[[#数据类型|数据类型]]'''数字'''，省略对单位的语义标注，直接将单位作为文本写在维基页面上。
:这种方法放弃了使用对于单位转换的前后处理支持，但是其他的大多数功能还能照常使用（如[[#语义搜索|语义搜索]]和导出等）。
:用户也可以通过在模板中使用[[帮助:解析函数|解析函数]]的方法来实现单位转换，但这一般会导致在编写页面文本时更加复杂，且会降低处理效率。

:如果确实需要一种新的单位，有一个更好的解决方法。可以写一个PHP脚本来实现单位转换。
:用这种方式来扩展SMW并不困难，并且你也可以参考'''温度'''类型的代码（仅100多行代码，包括注释）。
:在编写了这种新类型以后，就可以将[[#数据类型|数据类型]]为'''数字'''的现有属性直接改为新定义的类型，且不会对已有的页面产生影响。
:当面对不支持的单位时，自定义类型会表现为简单的'''数字'''类型。

:本维基中就有由管理员自定义的[[#数据类型|数据类型]]，与'''数量'''类型相近的有：
:*[[特殊:类型/价格|'''价格''']]类型
:*[[特殊:类型/时长|'''时长''']]类型

===自定义单位===
{{帮助SMW-测试警告-小}}
一个属性可以支持非常多个单位。比如长度单位可以从光年支持到纳米。<br />
即使这个属性只需要几个单位就够用，但如果你按照上面的方法，用模板给它声明单位，就可能出现可用单位非常多的情况。<br />
比如你用“属性:海拔高度”来指定山的高度，肯定不会用光年和纳米作为单位显示。<br />

SMW允许你在所有属性支持的单位中，指定哪几个用于显示。<br />
如果不指定显示单位，则属性会在换算时显示所有它支持的单位（比如在工具提示和页面事实框中）。

要指定显示的单位，需要给属性页面添加[[#特殊属性|特殊属性]]“'''显示单位'''”。<br />
在其中说明你想要显示的单位，用半角逗号<code>,</code>隔开。<br />
如，还是上文“属性:质量”的例子，你想只用字母缩写格式的单位，就写上：
<pre>
[[显示单位::kg,t,g]]
</pre>
上方代码可以使页面事实框在显示“属性:质量”的时候，只显示这三个单位，即使它支持十几个单位。<br />
在工具提示（鼠标停留在页面的属性文本上会显示）中，也只会显示这三种单位的换算。<br />
“显示单位”声明对任何支持单位的[[#数据类型|数据类型]]都有效，如'''温度'''、'''数量'''等类型。

特殊属性“显示单位”声明的第一个单位会作为默认显示单位。<br />
但SMW存储数据时，还是按照[[#特殊属性|特殊属性]]“符合于”声明的第一个单位（主单位）来存储。<br />
所以建议在声明“显示单位”时，将主单位也声明一下，这样用户就能看到存储的属性值是多少。

;单位名称

:本维基SMW 2.1.1版本下，单位名称中出现的空格会被忽略，不会被记录与显示。

==解析函数==
{{帮助SMW-测试警告-小}}
解析函数，或称解析器钩（Parser hook），是一种特殊语法，可以与页面上的其他维基元素交互，并可以处理输出生成的内容。<br />
对于全站可用的解析函数，请见[[帮助:解析函数]]页面，对于解析函数的概念说明，请见[https://www.mediawiki.org/wiki/Manual:Parser_functions MediaWiki上的说明]。

下面说明的解析函数为Semantic MediaWiki特有的。

;避免出现空格

:在页面上使用解析函数时，可能会在文章中出现空格，可以使用<code>&lt;div&gt;</code>元素来限制显示：
:{{pre|<nowiki>
<div style="display:none;">
{{#subobject:...}}
{{#set:...}}
...
</div>
</nowiki>}}

===语义注释函数===
本段落说明的函数用于语义注释，主要用途为给页面定义属性，给属性赋值等。<br />
包含以下四种函数：
*[[#set|set]]，用于给页面指定属性与值。
*[[#subobject|subobject]]，用于给页面指定子对象，给子对象指定属性与值。
*[[#set_recurring_event|set_recurring_event]]，用于给页面声明周期发生的事件，比如定期展会、周年纪念日等。
*[[#declare|declare]]，用于在模板页面中，将模板的输入参数值赋给属性，方便模板编写。

====set====
{{帮助SMW-测试警告-小}}
解析函数<code>#set</code>允许用户注释数据，即给属性赋值。<br />
这样做就可以无需使用<code><nowiki>[[属性名::属性值]]</nowiki></code>这样的声明。<br />
从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.9.0 SMW 1.9.0]版本起，<code>#set</code>函数还提供了特殊参数（见下文），来实现更多功能。

还是[[博丽灵梦]]的例子，若要给她的页面声明“种族”和“能力”属性，写成下面的样子：
<pre>
{{#set:
种族=人类
|能力=主要拥有在空中飞翔程度的能力
}}
</pre>
此解析函数不返回任何值，只将属性值作为数据存储起来。<br />
上面代码的作用相当于使用如下的[[#文本注释|文本注释]]：
<pre>
[[种族::人类| ]]
[[能力::主要拥有在空中飞翔程度的能力| ]]
</pre>
不必再使用这样的文本注释了，你可以使用上方的<code>#set</code>函数来替代。

你还可以给能接受多个值的属性赋多个值，这里假设“能力”属性能接受多值：
<pre>
{{#set:
能力=主要拥有在空中飞翔程度的能力
|能力=操纵灵气的能力
|能力=在天空飞行的能力
}}
</pre>

从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.9.0 SMW 1.9.0]版本起，你可以使用分隔符参数来给一个属性赋多个值，详见下文。

;使用“分隔符”参数

:[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.9.0 SMW 1.9.0]给<code>#set</code>函数引入了<code>|+sep=...</code>参数。
:此参数用于声明一个分隔符，这个分隔符用于分隔给一个属性赋的多个值。
:本维基SMW 2.1.1版本可以使用此功能。

:;语法格式：

::{{pre|<nowiki>
{{#set:
|属性名1=值1，值2|+sep=，
|属性名2=值1；值2；值3；|+sep=；
...
}}
</nowiki>}}
::此处举例使用的是全角标点作为分隔符，在中文页面上较为方便。

:;例子：

::仍然使用灵梦的“能力”属性为例：
::{{pre|<nowiki>
{{#set:
|能力=主要拥有在空中飞翔程度的能力，操纵灵气的能力，在天空飞行的能力|+sep=，
}}
</nowiki>}}

::事实上，不声明<code>|+sep=...</code>，也可以用管道符<code>|</code>来分隔。
::声明了<code>|+sep=</code>，或者<code>|+sep</code>，但没有指明分隔符的情况下，默认使用半角逗号<code>,</code>来分隔。
::如下面这些声明都是允许的：
::{{pre|<nowiki>
{{#set:
|登场作品=红魔乡,妖妖梦,萃梦想,|+sep=
|登场作品=永夜抄,花映冢,文花帖|+sep
|登场作品=风神录|绯想天|地灵殿
|登场作品=星莲船
}}
</nowiki>}}
::一串值末尾的分隔符不会起作用。
::像上面这样分好几行声明的话，“登场作品”会包括上述声明的所有值，与一行只声明一个值时相同。

====subobject====
{{帮助SMW-测试警告-小}}
解析函数<code>#subobject</code>允许用户注释与子对象有关的内容。<br />
子对象类似于页面，它也有自己的属性及属性的值，但子对象在维基中没有词条页面。<br />
子对象可以用于给页面的众多属性及值“分组”，而不用新建辅助页面。<br />
使用[[#特殊属性|特殊属性]]“'''有无子对象'''”，可以查找使用了本函数来指定属性值的页面。

解析函数<code>#set_recurring_event</code>会使用子对象来存储属性值（详见[[#set_recurring_event|set_recurring_event]]函数段落）。

;语法格式

:{{pre|<nowiki>
{{#subobject:子对象名称
|属性1=值
|属性2=值1，值2，值3|+sep=，
|属性3=值1|值2|值3
|...
}}
</nowiki>}}
:和<code>#set</code>函数一样，对于多值的属性，可以使用分隔符来分隔多个值。
:你可以参看[[#set|set]]函数的“使用‘分隔符’参数”部分。本段落后文中有分隔符发展的过程介绍。

:对于上方示例代码，解释如下：
:可以用<code>+sep=</code>来指定分隔符（如上方代码的“属性2”使用了全角逗号<code>，</code>作为分隔符，在中文页面上较为方便）。
:在使用了<code>+sep=</code>后若指定分隔符留空，则默认使用半角逗号<code>,</code>作为分隔符。
:在不使用<code>+sep=</code>的情况下，可以直接使用管道符<code>|</code>作为分隔符。

:;说明：

::与<code>#set</code>函数类似，<code>#subobject</code>函数也是一种静默注释，它为属性赋值时不对页面输出任何字符。

;给相同属性指定多值

:;多行书写：

::{{pre|<nowiki>
{{#subobject:子对象名
属性1=值1
属性1=值2
属性2=值1
属性2=值2
...
}}
</nowiki>}}

:;一行书写，使用管道符分隔：

::从[https://www.semantic-mediawiki.org/wiki/SMW_1.8.0 SMW 1.8.0]版本起，可以使用管道符<code>|</code>来分隔多个值。
::添加此规定不会给属性值的输入增加限制，且大大方便了多值的输入，下面这些代码和上面的例子作用一样：
::{{pre|<nowiki>
{{#subobject:子对象名
属性1=值1|值2
属性2=值1|值2
...
}}
</nowiki>}}

:;一行书写，使用指定分隔符：

::从[https://www.semantic-mediawiki.org/wiki/SMW_1.9.0 SMW 1.9.0]版本起，加入了<code>|+sep=...</code>来指定分隔符：
::{{pre|<nowiki>
{{#subobject:子对象名
|属性1=值1；值2|+sep=；
|属性2=值1，值2|+sep=，
...
}}
</nowiki>}}

;指定标识符

:可以给子对象命名一个“标识符”，用来直接说明一组属性值是哪种类型的数据。

:;命名标识符：

::比如，这个子对象给[[博丽灵梦]]页面说明她在作品中的登场信息，用<code>登场信息</code>来标识这个子对象：
::{{pre|<nowiki>
{{#subobject:登场信息
|红魔乡登场=自机
|妖妖梦登场=自机
|萃梦想登场=自机
|永夜抄登场=自机，四面BOSS A|+sep=，
|花映冢登场=自机|敌机
...
}}
</nowiki>}}

::命名标识符的前五个字符里不允许出现半角句点<code>.</code>，这种带点的命名是留给一些扩展用的。

:;无名标识符：

::[https://www.semantic-mediawiki.org/wiki/SMW_1.8.0 SMW 1.8.0]支持给没有命名的子对象分配无名标识符（哈希编号）。
::如果两个子对象实体在同一页面中，且内容相同，则它们的哈希值也相同，所以只有一个子对象实体会被存储并可用于查询。

::{{pre|<nowiki>
{{#subobject:|
...
}}
</nowiki>}}

::标识符开头带有：

::*<code>_QUERY...</code>标记查询元容器；
::*<code>_ERR...</code>标记错误容器；

;指定排序值

:[https://www.semantic-mediawiki.org/wiki/SMW_2.0 SMW 2.0]版本引入了<code>|@sortkey=...</code>，允许给子对象指定一个任意的排序值。
:排序值是大小写敏感的，也就是说，排序值被当作“字符串”来存储，但不会显示出来。
:子对象的排序值可以像其他维基页面的排序值一样，用作排序。

:比如还是上方灵梦登场信息的例子：
:{{pre|<nowiki>
{{{{#subobject:登场信息
|红魔乡登场=自机
|妖妖梦登场=自机
|萃梦想登场=自机
|永夜抄登场=自机，四面BOSS A|+sep=，
|花映冢登场=自机|敌机
...
|@sortkey=A
}}
</nowiki>}}
:此处的排序值就是“A”。

;概念说明

:;使用属性：

::如果两个子对象内的声明相同，则它们就会被当作同一个子对象，技术上使用哈希值来比较两者。
::但如果它们描述的内容不一致，如使用了命名标识符，则会被视为不同。
::给内容相同的两个子对象指定不同的名字，会创建两个独立的子对象实体。

::比如假设当前页面用于记录各个角色的基本信息，有可能出现：
::{{pre|<nowiki>
{{#subobject:
|种族=人类
}}
{{#subobject:
|种族=人类
}}
</nowiki>}}
::这两个子对象就是相同的。

::然而：
::{{pre|<nowiki>
{{#subobject:灵梦
|种族=人类
}}
{{#subobject:魔理沙
|种族=人类
}}
</nowiki>}}
::这两个子对象虽然在声明内容上相同，但命名不同，一个表示的是<code>当前标题#灵梦</code>，另一个是<code>当前标题#魔理沙</code>。

::另一种区分方式是使用<code>|@sortkey=...</code>给两个子对象指定排序值：
::{{pre|<nowiki>
{{#subobject:
|种族=人类
|@sortkey=灵梦
}}
{{#subobject:
|种族=人类
|@sortkey=魔理沙
}}
</nowiki>}}
::这两个子对象会被当作不同的实体，可以分别查询。

:;使用分类：

::对于[https://www.semantic-mediawiki.org/wiki/SMW_2.3 SMW 2.3]，可以使用<code>|@category=...</code>来给子对象指定分类。
::指定了分类的子对象，在查询该分类时可以找到，但是不会出现在“分类:...”的页面上，因为子对象是SMW引入的概念，与MW无关。
::由于本地维基SMW版本为2.1.1，无法使用上述分类功能，但可以只用属性功能来实现：
::*使用属性来代替分类，创建一个类似分类名称的属性，比如“属性:主角二人组”。
::*这里不考虑这个属性的值。
::*使用[[#特殊属性|特殊属性]]“'''所属的子属性'''”，可以将这些类似分类的属性建立一个嵌套层次结构，比如“属性:主角二人组”是“属性:新作角色”的一员，“属性:新作角色”又是“属性:官方角色”的一员。使用这种方式来模仿分类的层次结构。
::*对分类的查询使用<code><nowiki>[[分类:新作角色]]</nowiki></code>，可以查询分类和其子分类的内容；对于此处，我们可以使用<code><nowiki>[[新作角色::+]]</nowiki></code>来查询，也能查询属性和其子属性中的页面和子对象。

;查询子对象

:此处仅作简单描述，详见[[#查询子对象|查询子对象]]。

:子对象可以当作页面来使用。
:查询子对象的简单方法是查询子对象中包含的独一无二的属性，如：
:{{pre|<nowiki>
{{#ask:
[[红魔乡登场::+]]
|?永夜抄登场
|?风神录登场
...
}}
</nowiki>}}
:这里例子用到的是角色的登场信息，在本段落上文中有描述。
:此处查询的是在红魔乡中有登场的角色，在其他几作中的登场情况。
:（本例为虚构，所以测试此段代码是不会有结果的，故不标记为绿色代码。）

:为了在查询时更加方便，你可以给子对象添加“伪”属性。
:比如给所有具有登场信息的角色子对象添加“有登场信息=1”，则查询<code><nowiki>[[有登场信息::1]]</nowiki></code>，即可找到所有具备登场信息的子对象。

:关于[[#ask|ask]]函数的用法请见其自己的说明段落。

====set_recurring_event====
{{帮助SMW-测试警告-小}}
解析函数<code>#set_recurring_event</code>用于给维基页面设置重复事件。<br />
重复事件表示按照预先规划的时间，发生不止一次的事件，比如每周会议，周年纪念日和生日等。<br />
也可以是时长为好几天的一个事件，比如展会等。

在SMW中，重复事件的日期可以使用<code>#set_recurring_event</code>函数来定义，只需将代码写在该事件的页面上即可。<br />
此函数创建的属性与值都在一个特殊的子对象里。关于子对象，可以参看[[#subobject|subobject]]函数的解释。

此函数使用以下参数，函数中参数输入的顺序没有限制：
{|{{PrettyTable}}
!{{hl1}}|参数名
!{{hl1}}|说明
|---
|{{color:gray|''无名称''}}（在<code>:</code>后）
|属性的名称，它用于连接子对象和页面。这个属性属于子对象，属性的值为页面。具体例子见下文。此参数需在函数的半角冒号<code>:</code>后输入。
|---
|property
|属性的名称，用于记录事件发生的日期，[[#数据类型|数据类型]]为'''日期'''。
|---
|start
|系列事件的开始日期，可以包括时刻。
|---
|end
|系列事件的结束日期，可以包括时刻。此参数是可选的。
|---
|unit
|事件发生间隔时间的单位，可以是<code>year</code>（年）、<code>month</code>（月）、<code>week</code>（周）或<code>day</code>（日）。此参数是可选的，默认为<code>day</code>（日）。
|---
|period
|事件发生间隔几个时间单位。此参数是可选的，默认为<code>1</code>。
|---
|limit
|创建重复事件的总数。如果使用了<code>end</code>参数，此参数会被忽略。此参数是可选的，默认为100，默认值由[https://www.semantic-mediawiki.org/wiki/Help:$smwgDefaultNumRecurringEvents $smwgDefaultNumRecurringEvents]参数控制。
|---
|week number
|事件发生在每月的第几周。当间隔时间的单位被设为<code>month</code>（月）时有效。可接受负值，负值表示每月的倒数第几周。星期几是由开始日期决定的。
|---
|include
|需要额外增加的事件发生日期，使用半角分号<code>;</code>分隔。此参数是可选的。
|---
|exclude
|需要从系列事件中除去的日期，使用半角分号<code>;</code>分隔。此参数是可选的。
|---
|{{color:gray|''自定义''}}
|用户在函数中还可以自定义一些属性与值，这些属性与值都会赋给子对象。
|}
如果没有用<code>end</code>指定结束日期，也没有用<code>limit</code>指定总数限制，则创建的事件日期总数将由[https://www.semantic-mediawiki.org/wiki/Help:$smwgDefaultNumRecurringEvents $smwgDefaultNumRecurringEvents]参数控制，此参数默认值为100。<br />
如果用<code>end</code>指定了结束日期，则可以超过100，但还有一个[https://www.semantic-mediawiki.org/wiki/Help:$smwgMaxNumRecurringEvents $smwgMaxNumRecurringEvents]参数限制此函数能够创建的最大事件日期数。<br />
不论用<code>start</code>和<code>end</code>指定的开始和结束日期为何值，最大的事件日期数都由该参数限制，默认为500。<br />
这两个控制参数都可以在LocalSettings.php中修改。

;例子

:下面这个例子使用了[[Comic Market]]的规则，冬季展会为每年12月29日举办。
:则在[[Comic Market]]页面上应写：
:{{pre|<nowiki>
{{#set_recurring_event:展会
|property=展会日期
|start=December 29, 2007 10:00 am
|end=December 29, 2017 5:00 pm
|unit=year
|period=1
|include=December 28, 2008 10:00 am;December 28, 2014 10:00 am
|exclude=December 29, 2008 10:00 am;December 29, 2014 10:00 am
}}
</nowiki>}}
:此段代码创建了一系列子对象，这些子对象都有“展会”属性，值为[[Comic Market]]。
:每个子对象都有“展会日期”属性，值分别为2007年的12月29日到2017年12月29日之间的所有12月29日。
:还执行了例外，将2008年和2014年的“展会日期”改为了12月28日。

:下面这个例子使用[[东方灵异传]]的发售日期，以确定每年的东方首作发行纪念日。
:假设该页面有“发售日期”属性，则在纪念日的页面上应写：
:{{pre|<nowiki>
{{#set_recurring_event:发行纪念日
|property=纪念日期
|start={{#show:东方灵异传|?发售日期}}
|unit=month
|period=12
}}
</nowiki>}}
:此段代码创建了一系列子对象，这些子对象都有“发行纪念日”属性，值为[[东方灵异传]]。
:每个子对象都有“纪念日期”属性，值分别为1997年的8月15日以来的所有8月15日，由于没有指定<code>limit</code>，最多创建100个纪念日。

:如果想把上面的“发行纪念日”推广给全部作品用，可以将它写在模板里。
:模板使用<code>|发售日期=...</code>参数来输入发售日期，则应写：
:{{pre|<nowiki>
{{#set_recurring_event:发行纪念日
|property=纪念日期
|start={{{发售日期|}}}
|unit=month
|period=12
}}
</nowiki>}}

;使用带时刻的日期时需注意

:<code>#set_recurring_event</code>函数在没有说明时刻的情况下才会指定为日期。
:你可以在重复事件中指定时刻，但使用时要注意两点：
:*用<code>exclude</code>排除日期时也需指定时刻。当<code>#set_recurring_event</code>函数执行时，它会比较排除日期的数组和计算得到的重复日期，计算的日期此时包含时刻。如果指定了开始日期为下午7:00，则排除时也要写上这个时刻。如果使用自动表单填写，则最好在单独的字段中输入时刻，然后将其自动添加到开始日期和排除日期。或者使用额外的自定义属性。
:*结束日期也需要时刻，重复事件将在该时刻结束，而不是当天午夜。

====declare====
{{帮助SMW-测试警告-小}}
解析函数<code>#declare</code>允许用户将模板参数声明为属性值。

如果你在用[[模板:官方角色信息]]写[[博丽灵梦]]页面，则应写：<br />
{{pre|<nowiki>
{{官方角色信息|
|人物名=博丽灵梦
|日文名=博麗　霊夢（はくれい　れいむ）
|英文名=Hakurei Reimu 
|种族=人类
|职业=巫女
|能力=主要拥有在空中飞翔程度的能力
}}
</nowiki>}}
在模板页面，你可以使用<code><nowiki>[[角色中文名::{{{人物名}}}]]</nowiki></code>这样的注释来给“角色中文名”属性赋值。<br />
但这会让已经十分复杂的模板语法变得更加复杂。

现在，可以使用下面的方法在模板中集中声明属性值，如：
{{pre|<nowiki>
{{#declare:角色中文名=人物名
|角色日文名=日文名
|角色英文名=英文名 
|种族=种族
|角色职业=职业
|能力=能力
}}
</nowiki>}}
等号<code>=</code>的左边是属性名称，右边是模板的参数名称。

这个函数的原本想法是允许在模板中声明模板参数，就像使用编程语言时，声明函数的变量一样。<br />
从长远来看，这既能提高页面内容的质量，又可以简化用户界面。此函数的出现简化了模板的代码。

===行内查询函数===
本段落说明的函数用于[[#行内查询|行内查询]]，主要用途为检索所需的页面，并显示所需的属性值。<br />
包含以下两种函数：
*[[#ask|ask]]，可按[[#检索页面|检索页面]]的条件查询多个页面，可指定[[#显示信息|显示信息]]，可按多种[[#结果格式|结果格式]]显示。
*[[#show|show]]，只可查询单个页面的单个属性，直接显示属性值。

====ask====
解析函数<code>#ask</code>用于基本[[#行内查询|行内查询]]，可以指定查询的条件，并按照给定的格式显示。

此处仅说明函数的结构，关于查询条件的写法，见[[#检索页面|检索页面]]；关于显示格式的写法，见[[#显示信息|显示信息]]与[[#结果格式|结果格式]]。

下面是一个简单的使用<code>#ask</code>函数的例子：
<pre>
{{#ask:
[[分类:同人专辑]]
[[发售展会名称::Comic Market 91]] 
|?会场售价 = 会场售价
|?专辑类型 = 专辑类型
|limit = 10
|mainlabel = 专辑页面
}}
</pre>
此处我们查询了[[:分类:同人专辑]]中，所有[[属性:发售展会名称]]为<code>Comic Market 91</code>的专辑。<br />
显示效果为列出它们的[[属性:会场售价]]和[[属性:专辑类型]]，并限制显示10项，第一列的标题为“专辑页面”：
{{#ask:
[[分类:同人专辑]]
[[发售展会名称::Comic Market 91]] 
|?会场售价 = 会场售价
|?专辑类型 = 专辑类型
|limit = 10
|mainlabel = 专辑页面
}}

查询条件放在<code>#ask:</code>的后面，作为第一个参数，其他控制显示的参数用管道符<code>|</code>隔开。<br />
虽然并不需要严格按照上方那样写，但分行书写更易读，对其他编辑者更友好。<br />
在日常编写中，不论是本功能还是其他模板，每个参数起一行，每行从管道符<code>|</code>开始，是一个好习惯。

请注意，<code>#ask</code>函数中输入的所有参数都会在页面解析时被忽略。<br />
也就是说，照上文例子那样写，并不会使本页被分到[[:分类:同人专辑]]里面。<br />

还需要注意以下几点：
*管道符<code>|</code>用于分隔查询条件和输出参数。
*<code>#ask</code>函数中的全部查询条件被当作一个参数，所以不要用管道符<code>|</code>分隔它们。
*可以在<code>#ask</code>函数中可以自由使用空格和换行，SMW是一个灵活的扩展。
*当查询多个属性时，显示的格式可能会依据属性自动更改。SMW会给查询的结果使用合适的默认格式，但你也可以精确控制查询结果的格式。

只要知道[[#检索页面|检索页面]]（查询条件）、[[#显示信息|显示信息]]与[[#结果格式|结果格式]]（输出参数）的基础用法，就可以执行非常多种查询了。<br />
但是在一些情况下，显示成表格并不是最好的选择，所以我们需要指定更多的参数来控制。<br />
上文的例子中我们就添加了两项简单的控制，限制了显示的条数，更改了第一列（页面标题列）的名字。<br />
为了实现对显示结果的惊喜控制，[[#行内查询|行内查询]]的<code>#ask</code>函数可以使用非常多参数。<br />

<code>#ask</code>函数的一般语法结构如下：
<pre>
{{#ask:
第一个参数
|第二个参数
|第三个参数
|...
}}
</pre>
通常第一个参数用来指定查询条件，之后的参数用来指定显示的信息和格式。<br />
关于查询条件的写法，见[[#检索页面|检索页面]]；关于显示格式的写法，见[[#显示信息|显示信息]]与[[#结果格式|结果格式]]。<br />
这两个段落中详细说明了[[#行内查询|行内查询]]中会用到的多种参数。

====show====
解析函数<code>#show</code>用于直接显示单个页面的单个属性。

经常需要用到对某页面的某个属性的查询，而且只需查询一个页面，显示一个属性值。<br />
比如你想要在其他页面上显示[[东方红魔乡]]的“发售价格”属性，你可以使用查询，而不是直接复制粘贴。<br />
SMW提供一种方法来执行这种简单的查询，比如：<br />
<pre>{{#show: 东方红魔乡 | ?发售价格 }}</pre>
上方查询的结果为：
:<tt>{{#show: 东方红魔乡 | ?发售价格 }}</tt>

这个函数和[[#行内查询|行内查询]]的[[#ask|ask]]函数类似，且可用于[[#ask|ask]]的参数也同样可用于<code>#show</code>，如果有必要的话。

如果把上面的查询写成<code>#ask</code>函数，就是这样：
<pre>
{{#ask:
[[东方红魔乡]]
|?发售价格=
|mainlabel=-
}}
</pre>
上方的查询结果为：
:<tt>{{#ask:
[[东方红魔乡]]
|?发售价格=
|mainlabel=-
}}</tt>
此处在查询的属性<code>?发售价格</code>后加等号<code>=</code>，可以去除属性标签的显示；<br />
参数<code>mainlabel=</code>后面的连字符<code>-</code>可以去除显示结果的第一列，即查询到的页面名。<br />
使用了以上参数，最终达到了与<code>#show</code>一致的效果，如果没有指定上面两个参数：
<pre>{{#ask: [[东方红魔乡]] | ?发售价格 }}</pre>
则效果为：
{{#ask: [[东方红魔乡]] | ?发售价格 }}
所以在查询单个属性时，<code>#show</code>相比<code>#ask</code>要方便得多。

===其他用途函数===
本段落说明的函数起辅助作用，提供一些方便的功能。<br />
包含以下三种函数：
*[[#concept|concept]]，用于创建[[#概念|概念]]，将符合查询条件的页面放在一个“概念”页面上，类似分类页面。
*[[#info|info]]，用于添加工具提示，在页面上显示为小图标，鼠标在上面停留会显示工具提示框。
*[[#smwdoc|smwdoc]]，用于介绍[[#行内查询|行内查询]]的[[#ask|ask]]、[[#show|show]]函数的各种参数。可以显示各种[[#结果格式|结果格式]]支持的参数，以及这些参数的输入值类型、默认值和说明。

====concept====
解析函数<code>#concept</code>允许用户创建一套查询条件，并将查询到的页面放置在“概念”页面上。<br />
这些页面名称以“概念:”开头，具备与“分类:”页面类似的功能，但是会自动进行动态更新。<br />
此查询方法称为概念查询，概念查询的结果也可以作为查询条件给[[#行内查询|行内查询]]函数[[#ask|ask]]使用。

关于此函数的用法，请见[[#概念|概念]]段落，此处不作重复。

====info====
解析函数<code>#info</code>用于创建工具提示。<br />
工具提示在页面上显示为一个精致的信息图标，在图标上悬停时会弹出预先设定好的信息。<br />

;语法格式

:<pre>{{#info: 文本 | 图标类型 }}</pre>

;参数

:下面分别说明两个参数的用法和注意事项。

:;文本：

::此函数的第一个参数为显示在提示框里的文本，只能使用'''行内'''HTML元素。
::提示框文本只能接受部分维基语句，如加粗、斜体、内部链接等。
::不接受任何块元素，比如段落、表格、列表等。

::在输入文本参数时，还需避免出现空行，因为空行会结束一个段落，并开启一个新段落。
::等号<code>=</code>也不允许出现，因为函数中出现等号一般会被系统认为是给参数赋值的操作。
::你可以使用转义字符<code>&amp;#61;</code>代替等号，在页面上会显示为<code>&#61;</code>。

::如果不遵循上面的说明，可能会导致HTML代码错误和显示错误。
::比如出现空行，则空行后面的文字会直接显示在页面上，而不是提示框里。

:;图标类型：

::此函数的第二个参数控制显示的图标类型。
::如果给此参数输入了错误的值，则会被忽略，然后默认显示为<code>info</code>格式。

::此参数可接受的输入值：
::{|{{PrettyTable
|width=auto
}}
!{{hl1}}|图标类型
!{{hl1}}|说明
!{{hl1}}|效果
|---
|info
|蓝色圆形和问号，默认显示为此格式
|{{#info:这是一个信息图标。|info}}
|---
|note
|橙色圆形和叹号。
|{{#info:这是一个提示图标。|note}}
|---
|warning
|黄色三角和叹号。
|{{#info:这是一个警告图标。|warning}}
|}

;例子

:下面是一些应用举例：
:{|{{PrettyTable
|width=auto
}}
!{{hl1}}|代码
!{{hl1}}|结果
!{{hl1}}|说明
|---
|<pre>外面的文字{{#info:提示框内的文字|info}}</pre>
|外面的文字{{#info:提示框内的文字|info}}
|鼠标悬停就可以看到这个信息。
|---
|<pre>偷偷告诉你{{#info:灵梦是预知梦的意思哦|note}}</pre>
|偷偷告诉你{{#info:灵梦是预知梦的意思哦|note}}
|从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.9.0 SMW 1.9.0]起可用。
|---
|<pre>咦，发生啥事{{#info:紫老hsfthngsjst|warning}}</pre>
|咦，发生啥事{{#info:紫老hsfthngsjst|warning}}
|从[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.7.0 SMW 1.7.0]起可用。
|}

====smwdoc====
解析函数<code>#smwdoc</code>用于显示各种[[#结果格式|结果格式]]的控制参数用法。<br />
[[#ask|ask]]函数等[[#行内查询|行内查询]]功能，或[[#特殊页面“问”|特殊页面“问”]]等[[#浏览界面|浏览界面]]功能中会用到这些参数。<br />
显示的表格中说明了参数名，参数输入值的类型，默认值和说明。<br />
请注意，表格里可能有一些说明没有被翻译，另有一些说明缺失。

<code>#mapsdoc</code>函数有类似的用法，它用于显示Maps扩展提供的[[#结果格式|结果格式]]的控制参数用法。

;语法格式

:<pre>{{#smwdoc: 格式名 | parameters=参数类型 | language=语言代码 }}</pre>

:各参数可用的输入值：
:*格式名：请从[[#结果格式|结果格式]]中选取一个。
:*参数类型<code>parameters=</code>：可用的类型有<code>specific</code>（特殊）、<code>base</code>（基本）和<code>all</code>（全部），效果见下方的例子。
:*语言代码<code>language=</code>：请从[https://en.wikipedia.org/wiki/ISO_639-1 ISO 639-1]标准规定的语言代码中挑选，具体显示效果取决于本地维基提供哪几种语言。

;例子

:;“参数类型”参数：

::如果只需查看该[[#结果类型|结果类型]]特有的控制参数，则可用下方代码。
::此处使用<code>table</code>，即表格类型为例：
::<pre>{{#smwdoc:table}}</pre>
::或者这么写也可以：
::<pre>{{#smwdoc:table|parameters=specific}}</pre>
::效果为：
<div>
::{{#smwdoc:table|parameters=specific}}
</div>
::如果只需查看所有[[#结果类型|结果类型]]都支持的基本控制参数，则可使用下方代码。
::此处仍使用<code>table</code>，即表格类型为例：
::<pre>{{#smwdoc:table|parameters=base}}</pre>
::效果为：
<div>
::{{#smwdoc:table|parameters=base}}
</div>
::如果需要查看该[[#结果类型|结果类型]]支持的所有控制参数，则可使用下方代码。
::此处仍使用<code>table</code>，即表格类型为例：
::<pre>{{#smwdoc:table|parameters=all}}</pre>
::效果为：
<div>
::{{#smwdoc:table|parameters=all}}
</div>
:;“语言代码”参数：

::如需查看英文版的说明，则可使用下方代码：
::<pre>{{#smwdoc:table|language=en}}</pre>
::效果为：
<div>
::{{#smwdoc:table|language=en}}
</div>

::本维基支持中文<code>zh</code>、英文<code>en</code>和日文<code>ja</code>。

==语义搜索==
Semantic MediaWiki提供了一些方便的查询语言，允许用户查询维基内的数据。<br />
查询语言的语法格式与[[#文本注释|文本注释]]的语法格式类似。<br />
查询语言可以用于[[#特殊页面“问”|特殊页面“问”]]、[[#概念|概念]]和[[#行内查询|行内查询]]。<br />

查询必然会需要额外的服务器资源，管理员可以关闭或限制一些查询功能，以确保站点可以承受这些负载。

;简要介绍

:语义搜索需要确定两件事：
:#需要挑出哪些页面
:#需要显示这些页面的哪些信息

:所有的查询都要说明一些“查询条件”，用来描述要找哪些页面。
:你可以用页面名、页面名字空间、分类，或者用属性值来寻找页面。
:比如下面这个查询条件：
:<pre>[[制作方::上海爱丽丝幻乐团]]</pre>
:查询了所有具有“制作方”属性，且值为“上海爱丽丝幻乐团”的页面。
:如果你前往[[特殊:询问]]页面，将上面的条件输入到左边的“查询”栏中，并按最下方的“搜索结果”按钮，
:SMW就会处理这个查询，并且将符合条件的页面标题显示为一个表格。

:如果结果较多，上方还会出现导航条，可以翻阅全部结果。

:关于'''查询条件'''的写法，详见[[#检索页面|检索页面]]段落。

:其次，是如何显示更多信息。
:上面的例子中，我们查询了所有“制作方”为“上海爱丽丝幻乐团”的作品，也许你会对它们发售的日期感兴趣。
:要显示发售日期，只需将下面这个代码输入右边的“需要显示的附加信息”栏中：
:<pre>?发售日期</pre>
:按下“搜索结果”后，SMW就会显示这些页面的“发售日期”属性值，如果页面有这项属性值的话。
:还可以用更多的输出语句控制这些属性值的显示格式。

:关于用输出语句控制'''要显示的属性'''和'''显示格式'''的方法，详见[[#显示信息|显示信息]]和[[#结果格式|结果格式]]段落。

===检索页面===
{{帮助SMW-翻译提示-小
|原文链接=https://www.semantic-mediawiki.org/wiki/Help:Selecting_pages
}}
SMW[[#语义搜索|语义搜索]]中最重要的就是说明所需寻找页面的语法格式。<br />
查询功能按照给出的分类、属性、或者MW中的名字空间等参数来搜寻维基页面。<br />
下面的段落说明了SMW的查询功能。

;分类和属性值

:在之前[[#语义搜索|语义搜索]]的例子中，我们给出了一个简单的搜寻作品的例子。
:在该例子中，使用了单个搜寻条件<code><nowiki>[[制作方::上海爱丽丝幻乐团]]</nowiki></code>来寻找所需的页面。
:这种标记文本的格式和你在作品页面上给它们赋属性值时是一样的。
:在语义搜索中，使用这种标记文本，SMW就会寻找具有该属性值的页面。
:简单的来说就是这样：
:“给页面属性幅值的语句，和查询具有该属性值的页面的语句是完全一致的。”

:下面说明各种查询条件的含义：
:#<code><nowiki>[[分类:官方作品]]</nowiki></code>会给出该分类下的页面，和该分类下子分类的页面、子分类的子分类的页面等等。
:#<code><nowiki>[[制作方::上海爱丽丝幻乐团]]</nowiki></code>会给出所有“制作方”属性被注释为“上海爱丽丝幻乐团”的页面。
:#<code><nowiki>[[发售价格::1000日元]]</nowiki></code>会给出所有“发售价格”属性为“1000日元”，或者与“1000日元”等值的页面。

:使用上面的各个条件，可以分别查找符合各个条件的页面。
:下面让我们把这几个条件组合起来：
:<pre>[[分类:官方作品]] [[制作方::上海爱丽丝幻乐团]] [[发售价格::1000日元]]</pre>
:这样就可以查询所有发售价格等值于1000日元，制作方为上海爱丽丝幻乐团的官方作品。
:就是说，如果在查询中给出了多个条件，则查询结果会满足全部条件，即[https://en.wikipedia.org/wiki/Logical_conjunction 逻辑与]。
:顺带一提，允许在各个查询条件之间使用换行，使得查询语句更易读：
:{{pre|<nowiki>
[[分类:官方作品]]
[[制作方::上海爱丽丝幻乐团]]
[[发售价格::1000日元]]
</nowiki>}}
:注意这里的所有查询条件必须被显式满足。也就是说，如果一个页面没有填写“发售价格”，那么它就不会被搜索出来。
:在解析属性时，SMW会忽略前缀或后缀空格，所以<code><nowiki>[[发售价格::1000日元]]</nowiki></code>与<code><nowiki>[[发售价格::   1000日元   ]]</nowiki></code>效果是一样的。
:有些类型会有更多的特点，比如[[类型:数字]]会忽略1,000中间的,分割符，而比如[[类型:页面]]会进行重定向页面的一些处理。
:如果有些查询条件比较常用，你也可以参见[[#概念|概念]]段落制造一个临时的类似“分类”的页面集合。

;排序
:对于[[#ask|ask]]一节的例子，我们可以添加多关键字排序条件：
<pre>
{{#ask:
[[分类:同人专辑]]
[[发售展会名称::Comic Market 91]] 
|?会场售价 = 会场售价
|?专辑类型 = 专辑类型
|limit = 10
|mainlabel = 专辑页面
|sort = 会场售价，专辑类型
|order=asc，desc
}}
</pre>
:详细内容请参见[[#排序|排序]]一节。

;限制与注意点
:无法在子查询中使用刚刚查询得到的属性。不过可以使用[[#行内语义模板|语义模板]]来实现将查询到的信息作为另一个查询的条件这个功能。
:无法查询属性是否缺失、也无法查询不在某个分类中的全部页面。
:比如说，灵梦与魔理沙有<code><nowiki>[[新作登场::True]]</nowiki></code>，而玄爷与冈崎梦美没有填写这个属性。这时你要查找“非新作角色”时，搜索<pre><nowiki>{{#ask:[[分类:官方角色]][[新作登场::False]]}}</nowiki></pre>的时候就什么也搜不到。搜索<pre><nowiki>{{#ask:[[分类:!新作角色]]}}</nowiki></pre>搜索的则是位于“！新作角色”分类下的页面。
:对于没有填写某个属性的情况，可以通过创建一个模板，内容为<pre><nowiki>{{#set: |新作角色 (all)={{#ifeq: {{#show: {{PAGENAME}} |新作角色 }} |true |true |false }}}}</nowiki></pre>的方法，然后查询属性时查询<pre><nowiki>{{#ask:[[分类:官方角色]][[新作登场(all)::False]]}}</nowiki></pre>即可。
:这种情况下，请记得模板页面同样有缓存，不会在编辑页面后立刻被更改。
====比较器注意事项====

===显示信息===
===结果格式===
===行内查询===
====查询子对象====
====对查询行为的查询====

===概念===
===推理===

==语义模板==
===信息框格式语义模板===
===行内语义模板===
===语义模板应用规则===

==浏览界面==
===特殊页面“问”===
===特殊页面“浏览”===



[[分类:扩展帮助文档]]