Practical Semantic Mediawiki: Difference between revisions

no edit summary
No edit summary
No edit summary
Line 1: Line 1:
<blockquote>This hands-on session for non technical users emphasizes the "need to know" aspects of Web publishing, wikis, information design and Semantic Mediawiki.</blockquote>
<blockquote>This hands-on session for non technical users emphasizes the "need to know" aspects of Web publishing, wikis, information design and Semantic Mediawiki.</blockquote>


== Acronyms ==
= Acronyms =


* SMW = Semantic Mediawiki
* SMW = Semantic Mediawiki
* MW = Mediawiki
* CC = Creative Commons
* CC = Creative Commons


== Web publishing ==
= Web publishing =


=== Access models ===
== Access models ==
* Fully open
* Fully open
* Require login
* Require login
Line 15: Line 16:


Access models can be changed over time.
Access models can be changed over time.
== Accessibility ==
* Making sites accessible generally increases usability
** [http://asyourworldchanges.wordpress.com/2008/10/06/using-the-curb-cuts-principle-to-reboot-computing/ The curb cuts principle]
* Mediawiki is accessible, SMW has issues (forms)
* Value content over appearance
* Good tags for images


[[File:Copright continuum.jpg|right|500px]]
[[File:Copright continuum.jpg|right|500px]]
Line 28: Line 37:


<br class="cleared" />
<br class="cleared" />
= Using Mediawiki =
''Mediawiki is the underlying software of Wikipedia. It is robust, supported by a large community and supports hundreds of useful extensions.''
== Creating pages ==
== Creating pages ==


* How to name pages
* How to name pages
** Keep one topic per page
** One topic per page
* Short, avoid special symbols, sentence form
* Short, avoid special symbols, sentence form
* Code and matching brackets
* Code and matching brackets
* Basic markup — <nowiki>[[]] , [], |, [[File]] headings, bold, bullet points</nowiki>
* Basic markup — <nowiki>[[]] , [], |, {{}}, {{{}}}, [[File]] headings, bold, bullet points</nowiki>
* Linking
* Linking
** Brainstorm using links
** Brainstorm using links
Line 43: Line 57:
* Moving pages
* Moving pages
* Deleting pages
* Deleting pages
 
* Templates - used for consistently reused content
=== Accessibility ===
 
* Mediawiki is accessible, SMW has issues (forms)
* Making sites accessible generally increases usability
* Value content over appearance
* Good tags for images


=== Making pages look good ===
=== Making pages look good ===
Line 57: Line 65:
* CSS styling <nowiki><div style="background: orange">Hello world</div></nowiki>
* CSS styling <nowiki><div style="background: orange">Hello world</div></nowiki>
** Avoid losing meaning (don't use <nowiki><big></nowiki> for headers), keep it simple
** Avoid losing meaning (don't use <nowiki><big></nowiki> for headers), keep it simple
* Re-using styles [[MediaWiki:Common.css]]  
* Re-using styles [[MediaWiki:Common.css]]
* Hiding MW's menus and changing the 'skin'


== Semantic Mediawiki ==
= Semantic Mediawiki =


[[File:SMW_logo_180px.png|right]]
[[File:SMW_logo_180px.png|right]]


''Used to create re-usable data, create easier to use forms.''
''SMW is an extension ecology of MW that allows marking up content for re-use and create easier to use forms and views.''


* Meaning through relationships
* What properties does your content need to be useful?
** Triples
* Inline annotations
* Inline annotations
* [[Special:Ask|Queries]]
* [[Special:Ask|Queries]]
* [[Special:CreateClass|Creating a class]] (template, properties, forms)
* [[Special:CreateClass|Creating a class]] (template, properties, forms)
** One topic per page
** Formlink <nowiki>{{#formlink:Comment|comment||Comment[Topic]={{PAGENAME}}}}</formlink></nowiki>
** Formlink <nowiki>{{#formlink:Comment|comment||Comment[Topic]={{PAGENAME}}}}</formlink></nowiki>
* Subtypes
* Basic inference


<br class="cleared" />
<br class="cleared" />


== Converting content or sites ==
= Converting content or sites =


* [http://johnmacfarlane.net/pandoc/ Pandoc]
* [http://johnmacfarlane.net/pandoc/ Pandoc]


== Hosting ==
= Hosting =


* Export a site, modularize by category
* Export a site, modularize by category
Line 85: Line 100:
* Wikia
* Wikia
* Self-hosting
* Self-hosting
= Getting help =


[[Category:SemWeb]]
[[Category:SemWeb]]