Difference between revisions of "Wikispooks:Semantic Templates"
(New Footer section) |
(expand) |
||
| Line 1: | Line 1: | ||
| − | {{ | + | {{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 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]]s - The first object defined on Wikispooks, with a [[Template:DocProv|functional Template]] and [[Form:Document|form]] | |
| − | + | # [[Template:Websites]]s - Fairly simple, but fully functional template, no form as yet | |
| − | + | # [[Template:Properties]]s - See [[WikiSpooks:Properties]] for the full set, a short and sweet template, currently no form | |
| − | + | # [[Template:Event]]s - Less functional, less consistent, no form | |
| − | }} | + | # [[Template:Person]]s - Even less functional, even less consistent, no form |
| − | + | # [[Template:Groups]]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). The previous approach to this was to have a set of numbered parameters, e.g {{t|Author}}, {{t|Author2}}, {{t|Author3}} etc. This is cumbersome and was implemented in a hurry. A better approach is under development which inputs the data as separate items in a list, either comma-separated or slash(/)-separated. Some templates list both possibilities. ''If you are inputting data and have a choice, avoid the older, numbered parameters, using the list parameters instead. If you are coding, check out 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 and code accordingly. | ||
| + | |||
| + | ===Dates=== | ||
| + | ''Dates should be input as a single field'', although some legacy code has separate fields for years, months & days. There are issues regarding data input and missing data items, but SMW is pretty good with date processing and a single field is the preferred option. | ||
| + | |||
| + | ==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]] | ||
Revision as of 18:54, 4 January 2014
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 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:Documents - The first object defined on Wikispooks, with a functional Template and form
- Template:Websitess - Fairly simple, but fully functional template, no form as yet
- Template:Propertiess - See WikiSpooks:Properties for the full set, a short and sweet template, currently no form
- Template:Events - Less functional, less consistent, no form
- Template:Persons - Even less functional, even less consistent, no form
- Template:Groupss - 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:
- #ask: and #show: For querying properties
- #set: For setting properties
- #arraymap:' and '#arraymaptemplate:
A helpful summary of syntax is the quick reference guide, available here.
Multiple Values for Fields
Some parameters can take multiple values (e.g. an article can have more than one author). The previous approach to this was to have a set of numbered parameters, e.g Author, Author2, Author3 etc. This is cumbersome and was implemented in a hurry. A better approach is under development which inputs the data as separate items in a list, either comma-separated or slash(/)-separated. Some templates list both possibilities. If you are inputting data and have a choice, avoid the older, numbered parameters, using the list parameters instead. If you are coding, check out the '#arraymap:' and '#arraymaptemplate:' parser instructions and code accordingly.
Dates
Dates should be input as a single field, although some legacy code has separate fields for years, months & days. There are issues regarding data input and missing data items, but SMW is pretty good with date processing and a single field is the preferred option.
See Also
- http://semantic-mediawiki.org/wiki/Help:Semantic_templates - The SMW official (and good) documentation on semantic templates
| ||||||
|
