Difference between revisions of "Help:How to create a new term"

Revision as of 16:45, 15 February 2012

Guidelines on how to create a new term

Using the Semantic Wiki each entity is described by it's own Wiki Page. Properties and attributes for the entity is added as annotations to this page. Each vocabulary (of terms) and each individual term will thus be described by separate Wiki Pages. Relations between entities are created as a Typed Link. Attributes are similar to Typed Links and used to annotate the entity/Wiki Page with a value. Types Links are created by adding a (semantic) Property separated by two colon inside the wiki-link syntax, eg: [[Property::page-you-link-to]]. Attributes are created simply by providing a value instead of the Page, eg: [[Property::value]].

http://upload.wikimedia.org/wikipedia/commons/a/ad/Logo_Semantic_Web.png

Terms are member of a vocabulary

New terms should be created as part of one of the vocabulary (of terms). Each vocabulary of terms would be managed by an expert group (often a TDWG task group). Permissions to add new terms can be restricted to members of the expert group. If no suitable existing vocabulary of terms is available, then a new vocabulary can be proposed and created. Remember that new vocabularies should be managed by an expert group, so the first step could be to mobilize members for such a task group.

Steps to add a new term

• The first step is to add a link to a page for the new term to the respective vocabulary page.
• Then you follow the new link to create a page for your new term. This page will provide the description of the term.
• If you are not sure how to add the semantic markup, then just try to describe the term, including what label to use and a definition to use. Someone can assist you to make the semantic markup later.
• The semantic markup is provided by the following syntax: [[Property::annotation to page or value]].

 Eg. [[skos:definition::This is a definition for a term]]
 Eg. [[rdfs:isDefinedBy:=http://rs.gbif.org/terms/1.0/]]

• We have imported some of the most common vocabularies used for annotation of terms such as RDF, RDFS, SKOS, Dublin Core, VANN, etc.
• If you want to use other properties for annotation, you simply start using the new property - however for the exported RDF on your new term will not be correctly represented before the property is imported to this wiki. We recommend to make contact with one of the Wiki Administrators to import new properties.
• Terms are assigned to a vocabulary of terms using the [[Category:<vocabulary-prefix>]] syntax.