Practical Semantic Mediawiki: Difference between revisions

From zooid Wiki
Jump to navigation Jump to search
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>
{{SH_Triple|Sook Yin Lee|Rdf:type|Vancouver}}
 
{{SH_Add|3707|20100622033521|User:Rparungao}}{{SH_Obsolete|0}}
= Acronyms =
 
* SMW = Semantic Mediawiki
* MW = Mediawiki
* CC = Creative Commons
 
= Web publishing =
 
== Access models ==
* Fully open, no login required
* Require login for editing
* Require created accounts to edit (closed editing)
* Require created accounts to access (fully private)
** Encryption to avoid snooping
 
Access models can be changed over time; avoid starting a wiki with jargon or unsympathetic content.
 
== Site users ==
 
* Levels
** De-emphasize control, make it as flat as possible
** Bureaucrats still exist
* OpenID signin
 
== Accessibility ==
 
''Here, accessibility refers to supporting people with vision, keyboard control or cognitive difficulties.''
 
* Making sites accessible generally increases usability
** Works on more devices from text browser to handheld
** Typically more straightforward navigation
** Accessible hot keys can be used by any expert user
** [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, image maps
 
[[File:Copright continuum.jpg|right|500px|Copyright continuum, from traditional copyright to public domain]]
 
== Terms of use ==
 
* Creative Commons - share with options for attribution, non-commercial, changes
** [http://creativecommons.org/choose/?jurisdiction=ca Choose your license]
* Traditional copyright - by permission only
 
* Re-using content
** [http://search.creativecommons.org/ Find CC media]
 
<br class="cleared" />
 
= Using Mediawiki =
 
[[File:MediaWiki_logo_without_tagline.png|right]]
 
''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 ===
 
''Rather than using a rich text editor, Mediawiki uses a progressively learned set of markup, that's designed to be human-readable, consistent and enforces meaning over appearance.''
 
* <nowiki>[[Mypage]]</nowiki> — A wiki link
** <nowiki>[[File:Mypicture.png]]</nowiki> — Media (inline or link)
** <nowiki>[[Mypage|This is my page]]</nowiki> Alternate link text (using pipe symbol)
* <nowiki>[http://theirsite.com]</nowiki> — A non-wiki link. Use a space after the link to use your own link text. <nowiki>[http://theirsite.com Their site]</nowiki>.
* <nowiki>{{My Template}}</nowiki> — A template (reusable content, function or variable) — Don't Repeat Yourself
** Pipe symbol is used to pass parameters — <nowiki>{{Show Something|Something}}</nowiki>
* <nowiki>{{{}}}</nowiki> — SMW variable
* <nowiki>''Italic'', '''Bold'''</nowiki>
* <nowiki>* List heading level one</nowiki> — use # for numbered list
** <nowiki>** List level two</nowiki> — ## for numbered list
*** ...
* <nowiki>=Heading one=</nowiki>
** <nowiki>==Heading two==</nowiki>
*** ...
 
* Proactive linking
** Brainstorm using links
* Categories
** Subcategories
* Uploading images and files
* 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.''
 
[http://www.placeography.org/index.php/Main_Page Placeography] | [http://genozymes-ge3ls.ca/wiki/Bioenergy Biofuel Visions]
 
* Re-using 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
* Re-using styles [[MediaWiki:Common.css]]
* Hiding MW's menus and changing the 'skin'
 
= Semantic Mediawiki =
 
[[File:SMW_logo_180px.png|right]]
 
''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 annotations and relationships
** Triples
* What properties does your content need to be useful?
 
== Inline property annotation ==
 
''Single instances of data can be marked-up using annotations.''
 
<nowiki>[[Date::Jan 1, 2011]]</nowiki>
 
* [http://semantic-mediawiki.org/wiki/Help:Properties_and_types#List_of_data_types Built-in types]
* Geographic coordinate
* [[Special:Properties|Viewing all properties]]
* Subtypes
* [[Special:Ask|Queries]]
 
== Classes ==
 
* [[Special:CreateClass|Creating a class]] (template, properties, forms)
** One topic per page
** Formlink <nowiki>{{#formlink:Comment|comment||Comment[Topic]={{PAGENAME}}}}</formlink></nowiki>
 
== Views ==
 
== Basic inference==
 
== Future directions==
 
<br class="cleared" />
 
= Mediawiki Widgets=
 
''[http://www.mediawikiwidgets.org/Main_Page Mediawiki Widgets] allow embedding third-party site content for rich media (Youtube, photo sites, etc) and interactive discussions (DISQUS, Twitter, etc) without needing to set it up or host it on your site''.
 
* DISQUS discussion
** Register with DISQUS
** Get key
** Create [[Widget:DISQUS|widget]]
** Embed widget on pages
 
= Converting content or sites =
 
* [http://johnmacfarlane.net/pandoc/ Pandoc]
* Convertors for [http://wiki.services.openoffice.org/wiki/Convert2MediaWiki Open Office], [http://wikieducator.org/Microsoft_Launches_Open_Source_Filter_for_Mediawiki Microsoft Word]
 
= 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 =
 
[[Category:SemWeb]]

Revision as of 15:46, 25 November 2010