Difference between revisions of "Tips for editors"

From AIRWiki
Jump to: navigation, search
Line 16: Line 16:
  
 
== Wiki pages dedicated to the management of the semantic tools ==
 
== Wiki pages dedicated to the management of the semantic tools ==
* When writing queries, beware! The name of a property can be DIFFERENT from the name used in the semantic part of the wiki pages describing the objects of your query. For instance, any project page includes something like <nowiki>
+
* When writing queries, beware! The name of a property can be DIFFERENT from the name used in the semantic part of the wiki pages describing the objects of your query. For instance, any project page includes something like
{{Project
+
<nowiki>{{</nowiki>Project
 
| [...]
 
| [...]
 
| restopic=SomeTopic
 
| restopic=SomeTopic
 
| [...]
 
| [...]
}}
+
<nowiki>}}</nowiki>
</nowiki>But if you are writing a query to select the projects with topic SomeTopic you should NOT use <nowiki>
+
But if you are writing a query to select the projects with topic SomeTopic you should NOT use
[[restopic::Robot development]]
+
<nowiki>[[</nowiki>restopic::SomeTopic<nowiki>]]</nowiki>
</nowiki> Instead, you have to use the name of the property corresponding to the "restopic" field in the project page. This name is "prjResTopic", therefore the correct query will use
+
Instead, you have to use the name of the property corresponding to the "restopic" field in the project page. This name is "prjResTopic", therefore the correct query will use
</nowiki>But if you are writing a query to select the projects with topic SomeTopic you should NOT use <nowiki>
+
<nowiki>[[</nowiki>prjResTopic::SomeTopic<nowiki>]]</nowiki>
[[prjResTopic::Robot development]]
+
How can you find out the right name for the properties associated to (the content of) a page? When a page includes semantic information, [...to be continued! Work is ongoing. GF ]
</nowiki>. How can you find out the right name for the properties associated to (the content of) a page? When a page includes semantic information, [...to be continued! Work is ongoing. GF ]
+
  
 
== basic principles of AIRWiki ==
 
== basic principles of AIRWiki ==

Revision as of 12:37, 8 February 2010

This page is a repository of suggestions, tips and tricks for editors (i.e., all users!) of AIRWiki.

Resources

These resources can be handy when you are trying to figure out how to do something:

  • MediaWiki help: general help for users of wikis.
  • SMW help: help on the semantic tools provided by the Semantic MediaWiki (SMW) extension used by AIRWiki.
  • SMW_Project_Workflow: description of the complete lifecycle of a project in AIRWiki, from proposal to closure. Useful if you are setting up or coordinating a project.
  • Dynamic Page Generation: guidelines for the creation of semantic queries within AIRWiki. A collection of useful examples.
  • AIRWiki_Ontology: this is the structure of the ontology behind the semantic elements of AIRWiki. Useful to keep in mind when writing queries.
  • SMW extension: official page of the SMW extension for MediaWiki. It provides a list of the features of SMW.
  • Semantic Forms extension for SMW: official page of the extension providing SMW with semantic forms functionality, listing its features.

Tips for inexperienced Semantic MediaWiki users

  • New to SMW? This introduction is the right place to understand what it is and why it is useful.

Wiki pages dedicated to the management of the semantic tools

  • When writing queries, beware! The name of a property can be DIFFERENT from the name used in the semantic part of the wiki pages describing the objects of your query. For instance, any project page includes something like

{{Project | [...] | restopic=SomeTopic | [...] }} But if you are writing a query to select the projects with topic SomeTopic you should NOT use [[restopic::SomeTopic]] Instead, you have to use the name of the property corresponding to the "restopic" field in the project page. This name is "prjResTopic", therefore the correct query will use [[prjResTopic::SomeTopic]] How can you find out the right name for the properties associated to (the content of) a page? When a page includes semantic information, [...to be continued! Work is ongoing. GF ]

basic principles of AIRWiki

The following guidelines represent decisions about the structure of AIRWiki that have been taken. You should always comply with them when editing the AIRWiki.

  • All reasonably static information about the AIRLab should be published in the AIRLab website. All information which need to be modified more frequently (say: at least twice a year) should instead be put into the AIRWiki. The AIRWiki also offers the possibility of building pages which are automatically updated.
  • The AIRLab website should mention all the research areas active in AIRLab; but some of these could be absent from the AIRWiki.
  • AIRWiki DOES NOT include a "Projects" page (where the projects of AIRLab are listed). Projects are listed in the pages of the relevant research area.