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

From TDWG Terms Wiki
Jump to: navigation, search
m (fix autocomplete)
m (#forminput try option: no autofocus)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
[[File:Logo Semantic Web.svg|104px|thumbnail|right|Logo Semantic Web]]
 
'''Guidelines on how to create a new term'''
 
'''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: '''<nowiki>[[Property::page-you-link-to]]</nowiki>'''. ''Attributes'' are created simply by providing a value instead of the Page, eg: '''<nowiki>[[Property::value]]</nowiki>'''.
+
Using the Semantic Wiki each entity is described by its own Wiki Page. Properties and attributes for the entity are 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 colons inside the wiki-link syntax, eg: '''<nowiki>[[Property::page-you-link-to]]</nowiki>'''. ''Attributes'' are created simply by providing a value instead of the Page, eg: '''<nowiki>[[Property::value]]</nowiki>'''.
  
http://upload.wikimedia.org/wikipedia/commons/a/ad/Logo_Semantic_Web.png
+
==  A term is a member of a vocabulary ==
  
== Terms are member of a vocabulary ==
+
New terms should be created as part of one of the vocabularies (of terms). Each vocabulary of terms should 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.
 
+
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.
+
  
 
== Add a new term/concept automatically ==
 
== Add a new term/concept automatically ==
  
 
Use the following form:
 
Use the following form:
{{#forminput:form=Concept|button text=Create or edit a concept|autocomplete on category=Concept}}
+
{{#forminput:form=Concept|button text=Create or edit a concept|autocomplete on category=Concept|no autofocus}}
  
 
== Steps to add a new term manually ==
 
== Steps to add a new term manually ==
  
* The first step is to add a link to a page for the new term to the respective vocabulary page.
+
# The first step is to add a link to a page for the intended new term.
* Then you follow the new link to create a page for your new term. This page will provide the description of the term.
+
# 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.
+
# 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: <nowiki>[[Property::annotation to page or value]]</nowiki>.
+
# The semantic markup is provided by the following syntax:
  Eg. <nowiki>[[skos:definition::This is a definition for a term]]</nowiki>
+
<pre style="margin-left:1.5em;">
  Eg. <nowiki>[[rdfs:isDefinedBy::http://rs.gbif.org/terms/1.0/]]</nowiki>
+
In general: [[Property::annotation to page or value]]
* We have imported some of the most common vocabularies used for annotation of terms such as RDF, RDFS, SKOS, Dublin Core, VANN, etc.
+
Eg. [[skos:definition::This is a definition for a term]]
* 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.
+
Eg. [[rdfs:isDefinedBy::http://rs.gbif.org/terms/1.0/]]
* Terms are assigned to a vocabulary of terms using the <nowiki>[[Category:<vocabulary-prefix>]]</nowiki> syntax.
+
</pre>
 +
 
 +
We have already imported some of the most common vocabularies used for annotation of terms such as RDF, [[RDF Schema|RDFS]], [[Simple Knowledge Organization System|SKOS]], [[Dublin Core]], [[Vocabulary for annotating vocabulary descriptions|VANN]], etc.
 +
 
 +
If you want to use other properties for annotation, you simply start using the new property—however the exported RDF for your new term will not be correctly represented before the property is imported to this wiki. We recommend that you make contact with one of the Wiki Administrators to import new properties and use forms to set/edit properties.
 +
 
 +
Terms are assigned to a vocabulary of terms using the <nowiki>[[Category:<vocabulary-title>]]</nowiki> syntax.
 +
 
 +
== See also==
 +
* [[Help:Import vocabulary]]
 +
 
 
[[Category: Help]]
 
[[Category: Help]]

Latest revision as of 11:22, 21 January 2020

Logo Semantic Web

Guidelines on how to create a new term

Using the Semantic Wiki each entity is described by its own Wiki Page. Properties and attributes for the entity are 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 colons 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]].

A term is a member of a vocabulary

New terms should be created as part of one of the vocabularies (of terms). Each vocabulary of terms should 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.

Add a new term/concept automatically

Use the following form:

 


Steps to add a new term manually

  1. The first step is to add a link to a page for the intended new term.
  2. Then you follow the new link to create a page for your new term. This page will provide the description of the term.
  3. 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.
  4. The semantic markup is provided by the following syntax:
In general: [[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 already 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 the exported RDF for your new term will not be correctly represented before the property is imported to this wiki. We recommend that you make contact with one of the Wiki Administrators to import new properties and use forms to set/edit properties.

Terms are assigned to a vocabulary of terms using the [[Category:<vocabulary-title>]] syntax.

See also