View source for Wikispooks:Semantic Templates

{{HelpSection|image=SMW.png}}
Although semantic properties can be added inline in text, this is cumbersome and unsystematic so should be used only for testing purposes. All the {{SMW}} data on Wikispooks pages is input through [[WikiSpooks:templates]].

==Object Orientation==
The templates are structured around a set of objects. Each object its own set of semantic properties and accompanying template to mark process them. Some are displayed to the user, some are not. As of January 2014, the objects as currently defined, in order of completion are:
# [[Template:Document|Document]]s - The first object defined on Wikispooks, with a [[Template:DocProv|functional Template]] and [[Form:Document|form]]
# [[Template:Website|Website]]s - Fairly simple, but fully functional template, no form as yet
# [[Template:Property|Properties]] - See [[:Category:Properties]] for the full set, a short and sweet template, currently no form
# [[Template:Event|Event]]s - Less functional, less consistent, no form
# [[Template:Person|Person]]s - Even less functional, even less consistent, no form 
# [[Template:Group|Group]]s - Template currently just in planning, no form

==Syntax==
A 'semantic template' is just a template which uses semantic mediawiki, whether for reading or writing properties. The basic parser directives you'll need are: 
* [http://semantic-mediawiki.org/index.php/Help:Inline_queries#Parser_function_.23ask #ask:] and [http://semantic-mediawiki.org/index.php/Help:Inline_queries#Parser_function_.23show #show]: For querying properties
* #set: For setting properties
* [http://www.mediawiki.org/wiki/Extension:Semantic_Forms/Semantic_Forms_and_templates#arraymap #arraymap:]' and '[http://www.mediawiki.org/wiki/Extension:Semantic_Forms/Semantic_Forms_and_templates#arraymaptemplate #arraymaptemplate:] 
A helpful summary of syntax is the quick reference guide, available [http://postable.net/smwqr/smw-quick-reference.pdf here].

===Multiple Values for Fields===
Some parameters can take multiple values (e.g. an article can have more than one author) and at least 3 approaches to this are tried and tested. Which method(s) would work best for Wikispooks is an open question.

====Numbered Fields====
The first approach used on Wikispooks was to have a set of numbered parameters, e.g {{t|Author}}, {{t|Author2}}, {{t|Author3}} etc. This is straightforward but does not make full use of the facilities provided by SMW software and does makes for long, ugly templates. Some templates and forms still use this method.

====Lists====
The current preferred approach stores the data as separate items in a comma-separated list. ''This means that ',' should not be used in page titles''. These lists are easily processed with the '[http://www.mediawiki.org/wiki/Extension:Semantic_Forms/Semantic_Forms_and_templates#arraymap #arraymap:]' and '[http://www.mediawiki.org/wiki/Extension:Semantic_Forms/Semantic_Forms_and_templates#arraymaptemplate #arraymaptemplate:]' parser instructions.

Note that the processing of two properties ([[Property:Has keyProperties|Has keyProperties]] and [[Property:Has keyPropertyHeaders|Has keyPropertyHeaders]]) is too complex to be done with either #arraymap: or #arraymaptemplate: (since it is not done independently) so #titleparts: is needed instead, which requires use of slash(/)-separated lists.

====Multiple Templates====
Another approach is the use of multiple templates. This is not used on WikiSpooks, but may be seen in action at [http://discoursedb.org/w/index.php?title=Form:Author DiscourseDB], a site run by Yaron Koren, the key developer of {{SMW}}. This appears better supported as regards input (try adding multiple Wikipedia items on the DiscourseDB site, for example) but could lead to quite messy page source if applied to the large objects already developed at Wikispooks.

==See Also==
* http://semantic-mediawiki.org/wiki/Help:Semantic_templates - The SMW official (and good) documentation on semantic templates
{{WikiSpooks Footer/Semantic Mediawiki}}
[[Category:Semantic Mediawiki]]