View source for Help:Type URL/zh-hans

{{Type/zh-hans
 |datatype name=URL
 |description=Holds URIs, URNs and URLs
 |component=Semantic MediaWiki
 |minimum version=1.0
 |type id=_uri
}}
'''URL''' is a built-in [[datatype]] of [[Semantic MediaWiki]] that is used for the most common kinds of URLs, URNs, and URIs. It accepts almost any string and interprets it as a URL. The URL appears as a link in text and the [[Help:Factbox|Factbox]].

Technically speaking, e-mail addresses and even telephone numbers are also kinds of URLs. There are special datatypes for these kind of data values that should be used in such cases: {{DataType|Email}} and {{DataType|Telephone number}}.

{{DataType|Annotation URI|start}} is a specialized variant of this datatype.

{{Release|3.0.0}} introduced {{Config|$smwgURITypeSchemeList}} setting the list of permissive permissive [[wikipedia:en:Uniform_Resource_Identifier#Generic_syntax|URI schemes]] for data values to allow for better validation.

== 选择Text还是URL ==
[[MediaWiki]] will generally display a property of {{DataType|Text}} that starts with ''<nowiki>http://</nowiki>'' or ''<nowiki>https://</nowiki>'' as a hyperlink. However, strings do not check the validity of the input as a URL, and URLs have different meaning in [[Help:RDF export|RDF export]], so it is generally recommended to use Type:URL if applicable.

The URL type denotes that it is a reference to something else. The ontology language [https://www.w3.org/TR/owl2-primer/ OWL DL] that we use as an export format uses many URIs for identifying its language constructs. But it is not desirable to make new statements about those language constructs. For example, you clearly do not want to declare ''owl:sameAs'', the property that specifies that two individuals refer to the same concept, as the ''capital of Germany''! For this reason, the datatype Type:URL disallows certain URIs that already have a predefined meaning that cannot be used without changing the output format of the whole wiki. The corresponding URI ranges are specified by the MediaWiki system message [[MediaWiki:smw_uri_blacklist]] which can be extended by wiki-administrators. URIs from those ranges will be rejected by the wiki, but this will not have any effect on normal usage where URIs typically just point to some web-resource, such as an HTML or image document.

== 在值内搜索 ==
Since {{Release|1.8.0}} the first 40 characters (if more than 72 characters were stored as property value) or all 72 characters (if a maximum of 72 characters were stored as property value) are searchable as explained on the help page about [[Help:Selecting_pages#Like, not like|selecting pages]].[[CiteRef::mail:user:smw:tp5020618p5020801]] Searching within property values was not possible in earlier versions of Semantic MediaWiki (≤ 1.7.1).

With {{Release|2.5.0}} a [[Help:Full-text search|full-text search feature]][[CiteRef::gh:smw:1481]] was introduced which allows to search with in more than just the maximum of 72 characters as described before.

{{Release|3.0.0|start}} again introduced {{Config|$smwgFieldTypeFeatures}} with it's option <code>SMW_FIELDT_CHAR_LONG</code>[[CiteRef::gh:smw:2536]] making it possible to extend the searchable length as described here to 300 characters[[CiteRef::so:3489041]] without relying on the [[Help:Full-text search|full-text search feature]].

== 显示结果 ==
There is one output format <code>NOWIKI</code> available which is specific to this datatype. It escapes the URL and displays it as a plain string. This is useful if you e.g. want to generate links containing text on the page with the query result. See the help page on [[Help:Displaying information#URL|displaying information]] for further information on this.

== 示例 ==
{{API example}}

== 另见 ==
* {{Config|$smwgURITypeSchemeList}}帮助页面
* {{Config|$smwgFieldTypeFeatures}}帮助页面

<div style="display: none">
{{DEFAULTSORTKEY:URL}}
{{doc.info
 |master page=Help:Type URL
 |status=effective
 |progress=100
 |priority=2
 |minversion=3.0.0
}}
</div>