Practical Semantic Mediawiki: Difference between revisions

From zooid Wiki
Jump to navigation Jump to search
Line 1: Line 1:
''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).''
{{SH_Rev|3889|20100623013423|User:Rparungao|Sook Yin Lee}}
 
I will be guiding this workshop November 26, 2010 at [http://www.ecto.coop/ ecto coop] in Montreal from 10AM till 1PM.
 
 
= Forward =
 
Practice site: '''{{PSITE|Practice}}'''
 
== Acronyms ==
 
* MW: Mediawiki
* SMW: Semantic Mediawiki
 
= Web publishing =
 
== 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 [http://www.gossamer-threads.com/lists/wiki/foundation/216574#216574 considers their approach])
** '''We are going to learn markup encoding in order to have more control over content and appearance'''
 
== 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 - 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}}
 
== 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
** [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
* Use good captions for images (<nowiki>[[File:Orange.png|A square of the colour orange]]</nowiki>) , image maps
 
== Terms of use ==
[[File:Copright continuum.jpg|right|500px|Copyright continuum, from traditional copyright to public domain]]
 
* 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, 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.''
 
<br class="cleared" />
 
== 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 ([http://en.wikipedia.org/wiki/User:Bkwillwm example])
 
== Creating pages ==
 
* How to name pages
** One topic per page
* Short, avoid special symbols, use sentence type capitalization, avoid Title Case unless appropriate
 
=== Basic markup ===
 
[[File:Sky_Clouds_13.jpg|right|400px|A picture of clouds with the sun poking through in case people start to panic]]
 
''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>''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>
*** ...
 
* <nowiki>[[Mypage]]</nowiki> — A wiki link
** "Red links" are links to pages that don't exist
** <nowiki>[[File:Mypicture.png]]</nowiki> — 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
** <nowiki>[[Mypage|This is my page]]</nowiki> Alternate link text (using pipe symbol)
* <nowiki>http://theirsite.com</nowiki> — A non-wiki link
** Use <nowiki>[]</nowiki> brackets and space after the link to use your own link text. <nowiki>[http://theirsite.com Their site]</nowiki>.
 
* <nowiki>{{My Template}}</nowiki> — A template of page-included content (reusable content, function or site value).. templates are included from the inside out — <nowiki>{{second{{first}} }}</nowiki>
** Don't Repeat Yourself
** Pipe symbol is used to pass parameters — <nowiki>{{Highlight|Anything}}</nowiki> can be used to consistently apply an appearance to anything passed as a parameter
* <nowiki>{{ #geocode: Montréal, Quebec}}</nowiki> — Template function, in this case geocode turns a place name into geographic coordinates
* <nowiki>{{{1}}}</nowiki> — 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 [[:Category:Place|city]], include a link to another wiki page and another site.}}
 
===Categories===
 
* Categories <nowiki>[[Category:Places with rivers]]</nowiki>
** Subcategories <nowiki>[[Category:Places with immediate access to water]]</nowiki>
 
''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}}
 
===Images and files ===
 
* Uploading images and files
 
=== 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
 
=== 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. <nowiki>{{My template}}</nowiki>
* 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. <nowiki>{{{Template|Parameter1|Parameter2|...}}</nowiki> Parameters are available in the template as <nowiki>{{{1}}}, {{{2}}}</nowiki>, etc.
 
* [[Template example]]
 
=== 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]]
* Possible to hide MW's menus and change the 'skin'
 
{{Practice|Add <nowiki><div class="noticebox" style="float: right">...</div></nowiki> around some page content, add <nowiki><br class="cleared" /></nowiki> after}}
 
{{Bonus practice|Move your div to a reusable template}}
 
= Semantic Mediawiki =
 
[[File:SMW_logo_180px.png|right]]
 
''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?
 
== 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.''
 
* <nowiki>[[Date::Jan 1, 2011]]</nowiki> — A date value that adds a date to the page it's on.
* <nowiki>[[asserted by::David Mason]]</nowiki> — A page link that asserts the page it's on
 
 
<div class="noticebox" style="background: #FFB04C">
'''Page: Montreal'''
 
* <nowiki>[[A::Place]]</nowiki>
* <nowiki>[[Population::1906811]]</nowiki>
* <nowiki>[[Geographic coordinates::45.5088889, -73.5541667]]</nowiki>
</div>
 
{{Practice|Add a population annotation to your place.}}
 
* [http://semantic-mediawiki.org/wiki/Help:Properties_and_types#List_of_data_types Built-in types]
* Geographic coordinate
* [[Special:Properties|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'''
 
== 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.''
 
** <nowiki>{{ #ask: [[A::Place]] }}</nowiki>
** <nowiki>{{ #ask: [[Category:City]] }}</nowiki>
 
* [[Special:Ask|Interactive queries]]
 
== 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.}}
 
<div class="noticebox" style="background: #FFB04C">
'''Page: [[Montréal]]'''
 
<nowiki>{{Entity</nowiki><br />
<nowiki>|A=Place</nowiki><br />
<nowiki>|Population=10000</nowiki><br />
<nowiki>}}</nowiki>
</div>
 
* {{PSITE|Special:CreateClass}} (template, properties, forms)
** One topic per page
** Formlink snippet to add to a page, for a form named Comment: <nowiki>{{#formlink:Comment|Add a comment}}</nowiki> [http://genozymes-ge3ls.ca/wiki/Bioenergy Example]
 
== Examples ==
 
* Form: [http://www.asiancanadianwiki.org/wiki/Amrita_Choudhury Asian Canadian Wiki]
* Form: [http://genozymes-ge3ls.ca/wiki/Special:FormEdit/Topic Biofuels vision]
* Databases: [http://genozymes-ge3ls.ca/wiki/Environmental_database Genozymes environmental databases]
 
* Class templates will often contain queries that show linked classes
 
=== Use cases of Semantic Mediawiki's classes===
 
==== Discourse DB ====
 
''http://www.discoursedb.org ([http://discoursedb.org/wiki/TSA_airport_screening_procedures_controversy example]) stores discourse relationships (position) for '''articles''' on current topics in a structured system.''
 
<pre>
{{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
}}
</pre>
 
''The template includes a query for positions on this Item.''
 
<nowiki>{{#ask:[[Category:Positions]][[Addresses topic::{{PAGENAME}}]]|format=topiclayout}}</nowiki>, which uses the isfor, isagainst, and ismixed properties.
 
<pre>
{{#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
}}
</pre>
 
==== Placeography ====
 
''http://www.placeography.org ([http://www.placeography.org/index.php/Pillsbury_A_Mill%2C_301_Main_Street_South_East%2C_Minneapolis%2C_Minnesota example]) documents information about '''places'''. Its properties show some of the ambiguities when trying to describe things.''
 
<pre>
{{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
|...
}}
</pre>
 
==== Asian Canadian Wiki ====
 
''http://www.asiancanadianwiki.org  ([http://www.asiancanadianwiki.org/wiki/Ni_Komang_Swijani example]) AAType is used for '''artists''' and '''organizations'''.''
 
<pre>
{{AAType
|Image=uploaded picture
|Home page=URL
|Arts=acting, dance, ...
|Type=Person or Group
|Aspects=Developer, Moderator, Prominent
}}
</pre>
 
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 with template, properties, form. Add pages to it {{PSITE|Special:CreateClass}} }}
{{Bonus practice|Add a map to the template if the page has a location that can be geocoded}}
 
{{See|[http://www.mediawiki.org/wiki/Extension:Semantic_Forms Semantic Forms documentation].}}
 
== Views ==
 
<div style="float: right">
{{ #ask: [[Geographic coordinate::+]]|format=map}}
</div>
 
* Format= parameter to queries
** <nowiki>{{ #ask: [[Geographic coordinate::+]]|format=map}}</nowiki>
 
* [http://innovationcell.com/wiki/Impact Timeline], Calendar, Map, [http://www.asiancanadianwiki.org/wiki/Facet_browse_with_map Facet browser]
 
{{Practice|Create a facet view for entered places}}
 
<br class="cleared" />
 
== Basic inference==
 
''Inference is used to derive information from basic details.''
 
<nowiki>{{#ifexpr: {{{Population|}}} > 50000
 
| [[Category:City]] }}
</nowiki>
 
''If the page's population is greater than 50000, then put it in the category of city.''
 
* ''If it's within 500m of water...''
* ''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.
 
{{See|[http://www.mediawiki.org/wiki/Extension:Parser_function_extensions parser functions documentation].}}
 
== 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
 
<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]
* Convert from spreadsheet, other databases, etc.
 
= 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
 
= 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
** User group
 
= Reusing this workshop =
 
Material on this page is free to re-use under a [http://creativecommons.org/licenses/by-sa/2.0/ Creative Commons by-sa license], please attribute wiki.zooid.org.
 
[[Category:SemWeb]]
[[Category:Practical Semantic Mediawiki]]
 
{{Blikied|Nov 25, 2010}}

Revision as of 14:05, 26 November 2010

Template:SH Rev

Retrieved from "https://wiki.zooid.org/index.php?title=Practical_Semantic_Mediawiki&oldid=3914"