Difference between revisions of "Tips for editors"

From AIRWiki
Jump to: navigation, search
(Wiki pages dedicated to the management of the semantic tools)
Line 17: Line 17:
 
== 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
 
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>{{</nowiki>Project
+
<nowiki>{{</nowiki>Project
| [...]
+
| [...]
| restopic=SomeTopic
+
| restopic=SomeTopic
| [...]
+
| [...]
<nowiki>}}</nowiki>
+
<nowiki>}}</nowiki>
 
But if you are writing a query to select the projects with topic SomeTopic you should NOT use
 
But if you are writing a query to select the projects with topic SomeTopic you should NOT use
<nowiki>[[</nowiki>restopic::SomeTopic<nowiki>]]</nowiki>
+
<nowiki>[[</nowiki>restopic::SomeTopic<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>[[</nowiki>prjResTopic::SomeTopic<nowiki>]]</nowiki>
+
<nowiki>[[</nowiki>prjResTopic::SomeTopic<nowiki>]]</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 ]
 
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 ]
  

Revision as of 11:38, 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.