Special page "Ask"
Template:Interlanguagelink: en The semantic search page, which can be found at special page "Ask"Provides an interface that assists users with creating and executing semantic queries is a special page providing an interface that assists users with creating and executing semantic queries.
Query construction
On the top of the page there are two text area fields. The first one, titled 'Query', is meant for the portion of the query for selecting pages. The second one, titled 'Additional data to display', is meant to hold the set of properties that are displayed for each queried page - see the help page on displaying information. Each property should be prepended with a question mark, just as is done in regular #ask queries.
As of Semantic MediaWiki 1.5.2Released on an unknown date unknown versions of MediaWiki this field has autocompletion on property names, meaning that you can start typing the beginning of a property name, and a set of completions will show up. You can also just type a question mark, and you will see the list of all properties defined on the wiki at once.
Semantic MediaWiki 3.0.0Released on an unknown date unknown versions of MediaWiki introduced an input assistance in the query conditions field, meaning that you can prompt for suggestions.1 Depending on the suggestion prefix chosen you can trigger suggestions for:
- prefix
p:
for properties - prefix
c:
for categories, and - prefix
con:
for concepts.
Query parameters
As of Semantic MediaWiki 1.5.0Released on an unknown date unknown versions of MediaWiki, additional controls are shown under the text fields, which allow the user to pass parameters to the query that give extra control over how the data is displayed. The controls shown change according to the result format selected, as different formats support different parameters.
Running the query
You can run the query by hitting the 'find results' button in the lower left corner of the page, after which the results will be shown.
Downloading the results
Semantic MediaWiki 2.4.0Released on an unknown date unknown versions of MediaWiki introduced quick download links shown above the queried results to the right allowing to download them immediately in JSON, CSV, RSS and RDF.2 See the screenshot on this page.
Customizing
Starting with Semantic MediaWiki 1.8.0Released on an unknown date unknown versions of MediaWiki and Semantic MediaWiki 1.9.1Released on an unknown date unknown versions of MediaWiki respectively 3 options for further customization were introduced:
- CSS classes
.smw-ask-parameter-description
can be used to change the parameter text display behaviour, e.g. font-size etc. (since Semantic MediaWiki 1.8.0Released on an unknown date unknown versions of MediaWiki).smw-ask-query
can be used to change the query interface containing the following "sub-classes": (since Semantic MediaWiki 1.9.1Released on an unknown date unknown versions of MediaWiki).smw-ask-query-condition
can be used to change the input field "Query" for entering query conditions (since Semantic MediaWiki 1.9.1Released on an unknown date unknown versions of MediaWiki).smw-ask-query-printout
can be used to change the input field "Additional data to display" for entering the query printouts (since Semantic MediaWiki 1.9.1Released on an unknown date unknown versions of MediaWiki).smw-ask-query-format
can be used to change the query interface containing the following "sub-class": (since Semantic MediaWiki 1.9.1Released on an unknown date unknown versions of MediaWiki).smw-ask-query-format-selector
can be used to change the appearance of the drop-down menue used for selecting the result format (since Semantic MediaWiki 1.9.1Released on an unknown date unknown versions of MediaWiki)
- A setting to allow toggling between the standard parameter text or a compact info tooltip based display (since Semantic MediaWiki 1.8.0Released on an unknown date unknown versions of MediaWiki)
- A setting to enable the option box to be collapsed by default (since Semantic MediaWiki 1.8.0Released on an unknown date unknown versions of MediaWiki)
Notes
- Configuration parameter
$smwgLinksInValues
No description was provided. set to "true
" (SMW < 2.5) or "SMW_LINV_PCRE
" (SMW ≥ 2.5)
Results of a query displayed on this special page are not parsed further. This means that results for properties of datatype "Text"Holds text of arbitrary length containing links will be displayed as-is, i.e. links like SMW Project within the data value will be displayed as [[Help:SMW Project|SMW Project]]
even if this configuration parameter is enabled.
- Semantic MediaWiki 2.5.0Released on an unknown date unknown versions of MediaWiki and later offers the "
SMW_LINV_OBFU
" option (recommended setting) for best experience with links in values.
- Property lookup cache
Since Semantic MediaWiki 1.9.0Released on an unknown date unknown versions of MediaWiki the search form with autocompletion for the printout statements, i.e. the field labeled "Additional data to be displayed" is using the lookup cache for properties due to performance considerations. This is governed by the configuration parameter $smwgCacheUsage
Sets how the caching behaviour or special pages related to Semantic MediaWiki is controlled.
See also
- Help page on browsing interfaces - introduces all simple browsing interfaces of Semantic MediaWiki, including the factbox
- Help page on semantic search - covers advanced semantic queries, as are also used for inline queries
- Help page on input assistance