From ZooidWiki

This free hands-on workshop for non technical users emphasizes the "need to know" aspects of Web publishing, wikis, information design and Semantic Mediawiki for flexible, structured, practical re-usable content that fits into the Web of Data. It is not expected participants will become experts in all these topics, but will be able to create a site, and have an overview of what can be done as a basis of progressive learning. The workshop comes with unlimited free support for any open cause (as practical).

I will be guiding this workshop November 26, 2010 at ecto coop in Montreal from 10AM till 1PM.

Contents 1 Forward 1.1 Acronyms 2 Web publishing 2.1 Difference between Semantic Mediawiki and static web sites, CMS, Mediawiki 2.2 Access models 2.3 Site users 2.4 Accessibility 2.5 Terms of use 3 Using Mediawiki 3.1 Progressive uses 3.2 Creating pages 3.2.1 Basic markup 3.2.2 Categories 3.2.3 Images and files 3.2.4 Page maintenance 3.2.5 Templates 3.2.6 Making pages look good 4 Semantic Mediawiki 4.1 Inline property annotation 4.2 Queries 4.3 Classes 4.4 Examples 4.4.1 Use cases of Semantic Mediawiki's classes 4.4.1.1 Discourse DB 4.4.1.2 Placeography 4.4.1.3 Asian Canadian Wiki 4.5 Views 4.6 Basic inference 4.7 Future directions 5 Mediawiki Widgets 6 Converting content or sites 7 Hosting 8 Getting help 9 Reusing this workshop

[edit] Forward

Practice site: http://practice.zooid.org/wiki/Practice

[edit] Acronyms

• MW: Mediawiki
• SMW: Semantic Mediawiki

[edit] Web publishing

[edit] Difference between Semantic Mediawiki and static web sites, CMS, Mediawiki

• Designing information well makes it easier to find, consistent and re-usable.

• Static web sites can be more difficult to manage active content, it's harder to re-use content. They can require more technical knowledge to edit consistently.
• Content management systems use forms to guide content editing, but they tend to require low level changes (database, programming), and most users have constrained access to the site
• Mediawiki is designed to organize large sets of pages, potentially with many involved people, with potentially less constrained access
• It is the same software the world-changing Wikipedia uses
• Semantic Mediawiki adds structured information and views (Wikipedia considers their approach)
  • We are going to learn markup encoding in order to have more control over content and appearance

[edit] 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.

[edit] Site users

• Levels
  • De-emphasize control, make it as flat as possible
  • Bureaucrats still exist - edit site-wide content and styles, block pages and users
• OpenID signin allows people to use account information from other OpenID sites

Practice: Create an account and sign in

[edit] Accessibility

Here, accessibility refers to supporting people with vision, keyboard control or cognitive impediments.

• 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
  • The curb cuts principle
• Mediawiki is accessible, SMW has issues (forms)
• Value content over appearance
• Use good captions for images ([[File:Orange.png|A square of the colour orange]]) , image maps

[edit] Terms of use

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

• Re-using content
  • Find CC media

[edit] Using Mediawiki

Mediawiki is the underlying software of Wikipedia. It is robust, relatively easy to host (and there are lots of easy to use free and low cost hosting sites), and supported by a large community and supports hundreds of useful extensions.

[edit] Progressive uses

• Basic site with pages and categories
  • You just need to know a few things for your wiki to be as useful as most Web sites
• Add widgets for more interactivity
• Wiki gardening to reorganize content
• Add semantic classes for reusable data

• Typical users of a site
  • Viewer
  • Casual editor
  • Advanced editor (defines new templates, categories)
  • Gardener (organizes site content)
  • Helper (helps others)
  • Semantic coder
• Third party sites
  • Media
  • Page links
  • Semantic content

• Ideally online people will get to know each other through user pages (example)

[edit] Creating pages

• How to name pages
  • One topic per page
• Short, avoid special symbols, use sentence type capitalization, avoid Title Case unless appropriate

[edit] 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. It's not dependant on special programs, and could be carved into a park bench and retain its meaning.

• ''Italic'', '''Bold'''
• * List heading level one — use # for numbered list
  • ** List level two — ## for numbered list
    • ...
• =Heading one=
  • ==Heading two==
    • ...

• [[Mypage]] — A wiki link
  • "Red links" are links to pages that don't exist
  • [[File:Mypicture.png]] — Media (inline or link)
    • A shortcut to creating images is to create the File: link first, then follow the red link to the upload form
  • [[Mypage|This is my page]] Alternate link text (using pipe symbol)
• http://theirsite.com — A non-wiki link
  • Use [] brackets and space after the link to use your own link text. [http://theirsite.com Their site].

• {{My Template}} — A template of page-included content (reusable content, function or site value).. templates are included from the inside out — {{second{{first}} }}
  • Don't Repeat Yourself
  • Pipe symbol is used to pass parameters — {{Highlight|Anything}} can be used to consistently apply an appearance to anything passed as a parameter
• {{ #geocode: Montréal, Quebec}} — Template function, in this case geocode turns a place name into geographic coordinates
• {{{1}}} — SMW variable, in this case the first value passed to a template

The most important rule is make sure your brackets match.

• Finding or starting pages using go/search
• Proactive linking
  • Brainstorm using links

Practice: Create a new page that's a unique generally recognized world city, include a link to another wiki page and another site.

[edit] Categories

• Categories [[Category:Places with rivers]]
  • Subcategories [[Category:Places with immediate access to water]]

It's a good practice to put every page in at least one category.

Practice: Put your page in a category, put that category in a sub-category

[edit] Images and files

• Uploading images and files

[edit] Page maintenance

• Moving pages
  • Moving preserves the original link, can be useful for "also known as"

Practice: Move your page to a more specific location (Placename, Region), observe Special:RecentChanges


Bonus practice: Add an image, place it on the right and include a caption.

• Deleting pages

[edit] Templates

• Templates - used for consistently reused content or formatting

• Like a page link, for the first instance just enter a template placeholder, using two curly brackets instead of square. {{My template}}
• Then follow the red link to fill in the template, and use it on other pages.
• Templates can accept parameters, separated by the pipe symbol. {{{Template|Parameter1|Parameter2|...}} Parameters are available in the template as {{{1}}}, {{{2}}}, etc.

• Template example

[edit] 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
• Possible to hide MW's menus and change the 'skin'

Practice: Add <div class="noticebox" style="float: right">...</div> around some page content, add <br class="cleared" /> after

Bonus practice: Move your div to a reusable template

[edit] Semantic Mediawiki

SMW is an extension ecology of MW that allows marking up content for re-use, and creating easier to use forms and views.

• Meaning through annotations and relationships
  • You define the relationships for your application
  • Triples — subject, predicate, object
    • Subject — what we're talking about
    • Predicate — the relationship type
    • Object - what the subject is being related to
  • Combine them and you can flexibly describe anything

• • Montréal is a place
  • Montréal has population 1,906,811
  • Montréal has geographic coordinates 45.5088889, -73.5541667 (latitude and longitude)

• What properties does your content need to be useful?

[edit] Inline property annotation

Single instances of data can be marked-up using annotations. Annotations look like categories, but they use a double colon. The first part is the relationship type, the second either a value or object page.

• [[Date::Jan 1, 2011]] — A date value that adds a date to the page it's on.
• [[asserted by::David Mason]] — A page link that asserts the page it's on

Practice: Add a population annotation to your place.

• Built-in types
• Geographic coordinate
• Viewing all properties
• Subtypes
  • A city is a place

• With inline properties, you can annotate any page in a freeform way, and query those annotations on other pages, using views like maps and timelines, simple lists for todo items, sums for numbers, etc

[edit] Queries

"Ask" queries can be added to any page to add links or values from other pages according to parameters, for example, by category, pages that have particular values, etc.

• • {{ #ask: [[A::Place]] }}
  • {{ #ask: [[Category:City]] }}

• Interactive queries

[edit] Classes

Instead of using inline property assignments, semantic classes use templates with value assignments. This allows display formatting and further, consistent semantic interaction according to the template name (which is usually the category).

Practice: Change your page so it's a an Entity.

Classes are composed of:

• A template, which both assigns properties and displays them. You can change it to have all the pages look the same.
• Properties, which is the collection of distinct data about that class
• A form, which makes it easier to enter new page in that class

• http://practice.zooid.org/wiki/Special:CreateClass (template, properties, forms)
  • One topic per page
  • Formlink snippet to add to a page, for a form named Comment: {{#formlink:Comment|Add a comment}} Example

[edit] Examples

• Form: Asian Canadian Wiki
• Form: Biofuels vision
• Databases: Genozymes environmental databases

• Class templates will often contain queries that show linked classes

[edit] Use cases of Semantic Mediawiki's classes

[edit] Discourse DB

http://www.discoursedb.org (example) stores discourse relationships (position) for articles on current topics in a structured system.

{{Item
|author=The author or authors of the item; if there is more than one, separate their names with comas
|source=The publication in which it was printed/posted
|date=The date of publication
|url=A URL at which it can be found, if one exists
|quote=A one-to-four-sentence quote from the item, that captures the spirit of the opinion it holds
}}

The template includes a query for positions on this Item.

{{#ask:[[Category:Positions]][[Addresses topic::{{PAGENAME}}]]|format=topiclayout}}, which uses the isfor, isagainst, and ismixed properties.

{{#ask: [[is for::{{PAGENAME}}]]
  |format=template
  |template=ItemQuery
  |sort=Was published on
  |order=descending
  |link=subject
  |? Was written by
  |? Was published by
  |? Was published on
  |? Has URL
  |? Has quote
}}

[edit] Placeography

http://www.placeography.org (example) documents information about places. Its properties show some of the ambiguities when trying to describe things.

{{Infobox Building
|Building name
|Image
|Address
|Neighbourhood
|City-locality
|State-province
|County
|Country
|Year built
|Year razed
|Primary style
|Secondary style
|Additions
|Major Alterations
|Moved from Location
|Historic Function
|Current Function
|Architect or source of design
|Builder
|...
}}

[edit] Asian Canadian Wiki

http://www.asiancanadianwiki.org (example) AAType is used for artists and organizations.

{{AAType
|Image=uploaded picture
|Home page=URL
|Arts=acting, dance, ...
|Type=Person or Group
|Aspects=Developer, Moderator, Prominent
}}

The template includes queries for Events for the current page.

Forms and templates can support multiple properties per field.

Practice: Create your own semantic class using http://practice.zooid.org/wiki/Special:CreateClass with template, properties, form. Add pages to it Include a Place field that has a type of Page

[edit] Views

• Format= parameter to queries
  • {{ #ask: [[Geographic coordinate::+]]|format=map}}

• Timeline, Calendar, Map, Facet browser

Practice: Create a facet view for entered places

[edit] Basic inference

Inference is used to derive information from basic details.

{{#ifexpr: {{{Population|}}} > 50000 | [[Category:City]] }}

If the page's population is greater than 50000, then put it in the category of city.

• If it's within 500m of a place...
• If it has been visited in the last 4 months
• If it has a picture...
• If it has more than one relation...

This is a simple form of artificial intelligence, that can be very useful for large sets of pages for arbitrary classifications.

[edit] Future directions

• Relating ontologies (categories and properties) between sites
• Reusing content
  • Open data — information from government and other sources is becoming available
• Easier to use interfaces
  • But it always helps to have an understanding of the details
• Creating a big picture across the web where anyone can ask questions and add their data

[edit] 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

[edit] Converting content or sites

• Pandoc
• Convertors for Open Office, Microsoft Word
• Convert from spreadsheet, other databases, etc.

[edit] Hosting

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

[edit] Getting help

• View source of pages
• Mediawiki help sites and community
• Semantic mediawiki help sites and community
• If it's for an open cause, ask me or other [semantic] wikiers
  • User group

[edit] Reusing this workshop

Material on this page is free to re-use under a Creative Commons by-sa license, please attribute wiki.zooid.org.