View source for Help:Ask syntax/Annotation query marker

{{ask.syntax
 |syntax=@annotation
 |description=Marks an inline query as part of an annotation
 |display title=<code>#ask:</code> syntax – "annotation" query marker
 |introduced with=3.0.0
 |component=query marker
 |keyword=self-reference;post process;annotation
}}

The '''<code>@annotation</code>''' query marker marks an inline query as part of an annotation. It was introduced in {{Release|3.0.0}}[[CiteRef::gh:smw:2572]].

== Rationale ==

It is possible to use [[Help:Inline queries|inline queries]] (<code>#ask</code> or <code>#show</code>) to create semantic annotations. In other words, you can set the value of a semantic property to the result of an inline query. Since caching is used, the property value will not be automatically updated when the query result changes.

You can now let Semantic MediaWiki know that the inline query is used inside of a semantic annotation via the annotation query marker. This then allows Semantic MediaWiki to update the property value when the query result changes.

== Example ==
The output of a query used to provide the data value of an annotation:

; Syntax
<pre>
[[SomeProperty::{{#show: {{FULLPAGENAME}} |?AnotherProperty |link=none |@annotation }}]]
</pre>

; Link
[https://sandbox.semantic-mediawiki.org/wiki/Issue/2572 <sandbox.semantic-mediawiki.org>: More examples for this query marker]

{{Callout
 |Only add this query marker once to a page if you need this feature for more than one annotation. All of them will make use of the marker.
 |error
}}

== Note ==
Post-processing of jobs created by this query marker is done by {{Api|smwtask}}.[[CiteRef::gh:smw:3318]] See also {{Config|$smwgPostEditUpdate}}.

== See also ==
* Help page on [[Help:Self-reference queries|self-reference inline queries]]
* https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/src/PostProcHandler.php

<div style="display: none">
{{#scite:gh:smw:2572
 |type=pullrequest
 |url=https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2572
}}
{{doc.info
 |master page=Help:Ask_syntax/Annotation_query_marker
 |status=effective
 |progress=100
 |priority=1
 |minversion=3.0.0
}}
</div>