2,153
edits
Practical Semantic Mediawiki: Difference between revisions
Practical Semantic Mediawiki (view source)
Revision as of 15:49, 25 November 2010
, 25 November 2010→Basic markup
| 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> | |||
{{ | |||
= 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 === | |||
<div style="background-image: url(http://www.soil-net.com/album/Water/Atmosphere/slides/Sky_Clouds_13.jpg)"> | |||
''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. It's not dependant on special programs, and could be carved into a park bench and retain its meaning.'' | |||
* <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> | |||
*** ... | |||
</div> | |||
* 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]] | |||