Practical Semantic Mediawiki: Difference between revisions

Jump to navigation Jump to search
No edit summary
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. ''
== Duluth, Minn Bans Mercury Fever Thermometers ==


I will be guiding this workshop November 26, 2010 at [http://www.ecto.coop/ ecto coop] in Montreal from 10AM till 1PM.
'''Type:''' Ordinance


= Forward =
'''Status:''' Adopted


Practice site: '''{{PSITE|Practice}}'''
'''Date:''' March 6, 2000


== Acronyms ==
'''Summary:'''


* MW: Mediawiki
On March 6, 2000, the city of Duluth adopted the nation's first-ever ban on the sale of mercury fever and basal (used by women) thermometers. The purpose of this ordinance is to help eliminate mercury from the waste stream.
* SMW: Semantic Mediawiki


= Web publishing =
An earlier Minnesota law (M.S. Section 116.92, subd. 7) prohibits medical facilities from routinely distributing mercury thermometers. Another state law (M.S. Section 115A.932) prohibits depositing them in solid waste.


== Difference between Semantic Mediawiki and static web sites, CMS, Mediawiki ==
'''Full Text:'''


* Static web sites can be more difficult to manage, it's harder to re-use content.
Sec. 28-61. Sale and purchase of various mercury containing devices prohibited.
* Content management systems use forms to guide content editing, but they tend to require low level changes (database, programming), and end users have constrained access to the site
Unless otherwise provided by state or federal law:
* Mediawiki is designed to organize large sets of pages, potentially with many involved people
* Semantic Mediawiki adds structured information and views
** '''We are going to learn markup encoding in order to have more control over content and appearance'''


(a) No person shall sell at retail or offer for sale at retail within the city any fever thermometer or basal thermometer containing mercury;


* Designing information well makes it easier to find, consistent and re-usable.
(b) No public or private school in Duluth offering kindergarten, elementary, junior high school or high school classes shall purchase bulk elemental mercury or mercury compounds for use in classrooms;


== Access models ==
(c) For purposes of this paragraph, the words “mercury sphygmomanometer” means a mercury containing device used to measure blood pressure. No person shall sell, purchase, install or reinstall a mercury sphygmomanometer within the city;
* 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.
(d) For the purposes of this paragraph the words “gastrointestinal devices” means a mercury containing device passed into the gastrointestinal tract commonly referred to as a Miller Abbott tube, cantor tube or bougie or as feeding tubes. Gastrointestinal devices may not be sold or purchased within the city;


== Site users ==
(e) For the purposes of this paragraph, the word “thermostat” means a device commonly used to sense and, through electrical communication with heating, cooling or ventilation equipment, control room temperature. No person shall sell or install in a commercial or residential building in the city any thermostat that contains mercury;


* Levels
(f) For the purposes of this paragraph, the word “barometer” means a device used to measure atmospheric pressure. No person shall sell or purchase a barometer which contains mercury within the city unless such sale or purchase is required by federal regulations;
** 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}}
(g) For the purposes of this paragraph, the word “psychrometer” means a device used to measure relative humidity. No person shall sell or purchase a psychrometer which contains mercury within the city unless such sale or purchase is required by federal regulations.


== Accessibility ==
(Ord. No. 9441, 3-6-2000, §1; Ord. No. 9561, 9-23-2002, §1.)


''Here, accessibility refers to supporting people with vision, keyboard control or cognitive difficulties.''
[[Category:Toxics and Pollution]]
 
[[Category:City Governments]]
* Making sites accessible generally increases usability
[[Category:Minnesota]]
** 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
 
== 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 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
* Guide users of the site
** Viewer
** Casual editor
** Advanced editor, gardener
** Semantic coder
 
== Creating pages ==
 
* How to name pages
** One topic per page
* Short, avoid special symbols, use sentence type capitalization, avoid Title Case unless appropriate
* Code and matching brackets
 
=== 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 (reusable content, function or site value)
** 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
 
* Finding pages
* Starting new pages
* Proactive linking
** Brainstorm using links
 
{{Practice|Create a new page that's a unique generally recognized placename, include a link to another page and another site.}}
 
* Categories
** Subcategories
 
{{Practice|Put your page in a category, put that category in a sub-category}}
 
* Uploading images and files
 
* 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 - 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]]
* Possible to hide MW's menus and change the 'skin'
 
{{Practice|Add <nowiki><div class="noticebox">...</div></nowiki> to some page content}}
 
{{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
 
* What properties does your content need to be useful?
 
== 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]
 
== 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
 
== 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]
 
* Class templates will often contain queries that show linked classes
 
{{Practice|Create your own semantic class with template, properties, form. Add pages to it {{PSITE|Special:Forms}} }}
 
== 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]
 
<br class="cleared" />
 
== Basic inference==
 
''Inference is used to derive information from basic information.''
 
<nowiki>{{#ifexpr: {{{Population|}}} > 50000
 
| [[Category:City]] }}
</nowiki>
 
''If the page's population is greater than 50000, then put it in the category of city.''
 
This is a simple form of artificial intelligence, that be very useful for large sets of pages for arbitrary classifications.
 
== Future directions==
 
* Relating ontologies (categories and properties) between sites
* Reusing content
* 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]
 
= 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 =
 
* View source of pages
* Mediawiki help sites and community
* Semantic mediawiki help sites and community
* If it's for an open cause, ask me
** Let's form a 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].
 
[[Category:SemWeb]]
 
 
{{Blikied|Nov 25, 2010}}

Navigation menu