Practical Semantic Mediawiki: Difference between revisions

From zooid Wiki
Jump to navigation Jump to search
Line 14: Line 14:
* Require created accounts to edit (closed editing)
* Require created accounts to edit (closed editing)
* Require created accounts to access (fully private)
* Require created accounts to access (fully private)
** Encryption to avoid snooping


Access models can be changed over time.
Access models can be changed over time; avoid starting a wiki with jargon or unsympathetic content.


== Site users ==
== Site users ==

Revision as of 15:34, 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, 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 better on more devices, more straightforward navigation)
  • Mediawiki is accessible, SMW has issues (forms)
  • Value content over appearance
  • Good tags for images
Copyright continuum, from traditional copyright to public domain

Terms of use

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


Using Mediawiki

MediaWiki logo without tagline.png

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.

  • [[Mypage]] — A wiki link
    • [[File:Mypicture.png]] — Media (inline or link)
  • [http://theirsite.com] — A non-wiki link. Use a space after the link to use your own link text. Their site.
  • {{My Template}} — A template (reusable content, function or variable) — Don't Repeat Yourself
  • {{{}}} — SMW variable
  • ''Italic'', '''Bold'''
  • * List heading level one — use # for numbered list
    • ** List level two — ## for numbered list
      • ...
  • =Heading one=
    • ==Heading two==
      • ...
  • 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.

Placeography | Biofuel Visions

  • Re-using 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 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.

[[Date::Jan 1, 2011]]

Classes

  • Creating a class (template, properties, forms)
    • One topic per page
    • Formlink {{#formlink:Comment|comment||Comment[Topic]={{PAGENAME}}}}</formlink>

Views

Basic inference

Future directions


Mediawiki Widgets

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
    • Embed widget on pages

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