Difference between revisions of "SMW Project Workflow"

From AIRWiki
Jump to: navigation, search
m (All master thesis proposals in a research area)
Line 128: Line 128:
 
This can be done by editing the page source or using the form: [[Form:Project]] (changing the value of the property [[Property:prjStatus|Status]]).
 
This can be done by editing the page source or using the form: [[Form:Project]] (changing the value of the property [[Property:prjStatus|Status]]).
  
= Dynamic Page Generation =
 
 
Semantic queries can be used to automatically generate lists of pages satisfying some requirements.
 
[http://semantic-mediawiki.org/wiki/Help:Inline_queries Here] you can find the complete documentation for inline queries.
 
 
In this section you can find some examples of ad hoc queries that may be useful in this wiki.
 
 
== All the Projects suggested by a given Tutor ==
 
 
<nowiki>{{#ask: [[Category:Project]][[prjTutor::User:{{PAGENAME}}]]|?prjTitle = |format=ul}}</nowiki>
 
 
You can see the result [[User:RiccardoTasso#Tutored_projects|here]]
 
 
Note: <nowiki>{{PAGENAME}}</nowiki> is a variable which identifies the title of the current page.
 
Putting this query inside a user's page, all projects tutored by that user will be shown as results.
 
 
== All master thesis proposals in a research area ==
 
 
To generate the results in a list, showing the research topic of each proposal:
 
 
<nowiki>{{#ask: [[Category:ProjectProposal]]
 
[[PrjLevel::Bs]]
 
[[PrjType::Thesis]]
 
[[PrjResArea::Social Software and Semantic Web]] |
 
?PrjResTopic |
 
format=list
 
}}</nowiki>
 
 
 
To show the results in the template [[Template:ProjectProposalViz|ProjectProposalViz]]:
 
 
<nowiki>{{#ask: [[Category:ProjectProposal]]
 
[[PrjLevel::Bs]]
 
[[PrjType::Thesis]]
 
[[PrjResArea::Social Software and Semantic Web]] |
 
?PrjTitle |
 
?PrjImage |
 
?PrjDescription |
 
?PrjTutor |
 
?PrjStarts |
 
?PrjStudMin |
 
?PrjStudMax |
 
?PrjCFUMin |
 
?PrjCFUMax |
 
?PrjResArea |
 
?PrjResTopic |
 
format = template |
 
template = Template:ProjectProposalViz
 
}}</nowiki>
 
 
You can see the result of this query [[Master_Level_Theses#Social_Software_and_Semantic_Web|here]].
 
 
== All finished projects in a research topic, ordered by end date ==
 
 
<nowiki>{{#ask: [[Category:Project]][[prjResTopic::Folksonomies]][[prjStatus::Closed]]|?prjTitle = |sort=prjEnd|order=desc|format=ul}}</nowiki>
 
 
See the result [[Finished_Projects#Semantic_Tagging|here]].
 
  
 
= Useful Documentation =
 
= Useful Documentation =
  
 
[http://www.mediawiki.org/wiki/Extension:Semantic_Forms|Official Documentation for Semantic Forms]
 
[http://www.mediawiki.org/wiki/Extension:Semantic_Forms|Official Documentation for Semantic Forms]

Revision as of 18:58, 9 October 2009

This page explains how to use the AIR wiki to benefit from its semantic capabilities following a typical Project Lifecycle (from its proposal to its end).

Project Proposal

When a Tutor (Professor, PhD Student or Researcher) has a Proposal of course or thesis projects for students, she can submit it to the wiki.

Form

To easily insert a Project Proposal in the AIRWiki go to this special page: Form:ProjectProposal. To get more in depth with details look at the following sections.

Template Documentation

  • title:
  • image:
  • description:
  • tutor(s):
  • cfumin:
  • cfumax:
  • studmin:
  • studmax:
  • resarea:
  • restopic:
  • level:
  • type:
  • status:

Example

This should be the source a typical Project Proposal page.

{{ProjectProposal
|title=Extending a search engine with semantic information
|image=velociraptor.png
|description=We are used to keyword-based search engines, where only documents matching the exact words in the query are retrieved...
|tutor=DavidLaniado;MarcoColombetti
|cfumin=5
|cfumax=20
|studmin=1
|studmax=2
|resarea=Social Software and Semantic Web
|restopic=Semantic Search
|level=Bs;Ms
|type=Course;Thesis
|status=Proposal
}}

Student Registration

When a Student requests to join a Project, she has to be registered to the wiki from the page: Log in / Create Account. Each user should be registered with the notation NameSurname (e. g. AlanTuring). A page for the user is automatically created, and it should be filled in with her data.

Attention: each user page is by default accessible only to registered users. If you want your page to be visible to unregistered users, you have to explicitly ask for it to Riccardo Tasso, Davide Eynard or David Laniado.

Form

A user's page can be edited with a semantic form, by clicking on the tab "edit with form".

To get more in depth with details look at the following sections.

Template Documentation

The following fields have to be filled in:

  • category:
  • firstname:
  • lastname:
  • email:
  • advisor:
  • projectpage:
  • photo:

Example

{{SMWUser
|category=Student
|firstname=Alan
|lastname=Turing
|email=alan@cl.cam.ac.uk
|advisor=LudwigWittgenstein;AlonzoChurch
|projectpage=On Computable Numbers
|photo=turing.png
}}

Project Instantiation

When a Student and a Tutor have defined a concrete Project (maybe starting from a Project Proposal) they should create a page for it to present their work. Remember that the Project name has to be different from the Project Proposal name; in case you want to keep the same name, a possible convention is to use non capital letters for Project Proposal page names, and capital letters for Project page names. The discussion page, available for each Project page and accessible only to registered users, can be used for coordination tasks between Students and Tutors.

Form

To easily insert a Project in the AIRWiki go to this special page: Form:Project. To get more in depth with details look at the following sections.

Template Documentation

  • title:
  • short_descr:
  • tutor:
  • students:
  • resarea:
  • restopic:
  • start:
  • end:
  • level:
  • type:
  • status:
  • image:

Example

{{Project
| title=Wikipedia Category Map
| short_descr= Tool for managing categories and pages in Wikipedia.
| tutor=DavidLaniado;RiccardoTasso
| students=CarloBandera
| resarea=Social Software and Semantic Web
| restopic=Semantic Tagging
| start=2009/07/14
| end=2009/09/17 
| level=Ms
| type=Course
| status=Closed
| image=
}}


Project End

When the Project ends it should be declared as closed. This can be done by editing the page source or using the form: Form:Project (changing the value of the property Status).


Useful Documentation

Documentation for Semantic Forms