Practical Semantic Mediawiki: Difference between revisions

From zooid Wiki
Jump to navigation Jump to search
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]]

Revision as of 15:00, 25 November 2010

This hands-on session for non technical users emphasizes the "need to know" aspects of Web publishing, wikis, information design and Semantic Mediawiki.

Acronyms

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

Web publishing

Access models

  • Fully open
  • Require login
  • Require created accounts to edit (closed editing)
  • Require created accounts to access (fully private)

Access models can be changed over time.

Accessibility

  • Making sites accessible generally increases usability
  • Mediawiki is accessible, SMW has issues (forms)
  • Value content over appearance
  • Good tags for images
Copright continuum.jpg

Terms of use

  • Creative Commons - share with options for attribution, non-commercial, changes
  • Traditional copyright - by permission only


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

  • How to name pages
    • One topic per page
  • Short, avoid special symbols, sentence form
  • Code and matching brackets
  • Basic markup — [[]] , [], |, {{}}, {{{}}}, [[File]] headings, bold, bullet points
  • Linking
    • Brainstorm using links
  • Categories
  • Uploading images and files
    • What not to upload
    • Subcategories
  • Moving pages
  • Deleting pages
  • Templates - used for consistently reused content

Making pages look good

CSS is the style system of Web pages and can also be used in Mediawiki. Like wiki markup, learning can be progressive.

  • CSS styling <div style="background: orange">Hello world</div>
    • Avoid losing meaning (don't use <big> for headers), keep it simple
  • Re-using styles MediaWiki:Common.css
  • Hiding MW's menus and changing the 'skin'

Semantic Mediawiki

SMW logo 180px.png

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
  • Queries
  • Creating a class (template, properties, forms)
    • One topic per page
    • Formlink {{#formlink:Comment|comment||Comment[Topic]={{PAGENAME}}}}</formlink>
  • Subtypes
  • Basic inference


Converting content or sites

Hosting

  • Export a site, modularize by category
    • Complete site export
  • Special:Version
  • Free light/startup hosting
  • Inexpensive Mediawiki with SMW option
  • Wikia
  • Self-hosting

Getting help