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. ''
'''Type''': Policy


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


'''Source File''': http://www.portlandonline.com/shared/cfm/image.cfm?id=40414


= Forward =
'''Executive Summary''':


Practice site: '''{{PSITE|Practice}}'''
'''BICYCLE MASTER PLAN'''<br>
Non-Binding City Policy<br>
'''Introduction'''
Portland is considered one of the country's most bicycle-friendly cities. In October 1995, it was selected by Bicycling Magazine as the most bicycle friendly city in the United States. How did we get there?
Portland's first Bicycle Plan was developed in 1973 by a residents' task force. This effort led to the creation of the Portland Office of Transportation's Bicycle Program--one of the country's oldest--and the Bicycle Advisory Committee, a group of residents appointed by City Council to advise on all matters related to bicycling.
The bicycle is a key means of transportation for thousands of Portland residents and a desired means of transportation for many thousands more. Over half of Portland residents own a bicycle and ride at least occasionally. Bicycle use is rising rapidly. The bicycle share of trips is about two percent in Portland, 3.3 percent in the inner, more dense areas of town. While only 200 cyclists per day were recorded on the Hawthorne Bridge in 1975, by 1995 this number had climbed to nearly 2,000.
Many aspects of Portland encourage bicycle use. Portland's current bikeway network consists of over 150 miles of bicycle lanes, bicycle boulevards, and off-street paths. Tri-Met's entire bus fleet is equipped with bicycle racks. From July 1994 to July 1995, close to 80,000 bicycles were taken on MAX or bus and over 6,300 permits sold. Cyclists can park at over 1,400 publicly-installed bicycle racks or rent longer-term space at one of 190 bicycle lockers. Bicycle commuters can take advantage of one of the new "Bike Central" stations (providing showers, changing facilities, and long-term bicycle storage), while new cyclists will soon be able to enjoy escorted commute rides.
The energy and commitment of many organizations and businesses improve the bicycling environment. Portland's Parks Bureau and Metro's Greenspaces Program are installing dozens of miles of off-street paths, such as the Springwater corridor and Eastside Esplanade. More than a dozen bicycle shops provide crucial services to Portland Cyclists. there is an impressive array of advocacy, education, and riding groups, including the bicycle Transportation Alliance, Community Cycling Center, Critical Mass, Kaiser Permanente's Injury Prevention Program, Portland United Mountain Pedalers, Portland Wheelmen Touring Club, and Yellow Bike Program. The Portland Police Bureau and the Office of Transportation's Parking Patrol use bicycles, as do some of Portland General Electric's meter readers.
Finally, a diverse coalition of educators, administrators, bicycle advocates, and government agencies are working to make bicycling a more viable and safe option for children. These efforts include the Office of Transportation's Kids on the Move curriculum, Traffic Calming Program (installing speed bumps and signal beacons around schools), Community Traffic Safety Program (For Kids' Sake Slow Down campaign, and bicycle safety workshops), and Bicycle Program (installing bicycle racks at, and bikeways to, schools). Others involved include Portland Public Schools, parents, educators, the Community Cycling Center (teaching children bicycle safety, repair, and riding skills), and numerous groups working to increase helmet use.
With this kind of momentum, increasing bicycle use should be a snap. However, despite all these efforts, Portland still has a long way to go to be truly bicycle-friendly. Our bikeway network is discontinuous and incomplete; only five percent of arterial streets have bicycle lanes. Bicycle parking is found at only two percent of commercial businesses outside the central city. Very few children bicycle to school even if they live less than a mile away. People from all ages, parts of the city, and walks of life have requested improvements to the bicycling environment. Numerous local surveys, focus groups, and other comment opportunities consistently demonstrate the public's interest in and commitment to bicycling as a means of transportation.
'''Background'''
The Bicycle Master Plan was created over a two and a half year period with input from over 2,000 residents, including neighborhood activists, business people, parents, educators, regular cyclists, and individuals wishing to bicycle--both for the first time and more frequently. Additional input came from staff of the Portland Office of Transportation, Tri-Met, the Port of Portland, Multnomah County, Washington County, Clackamas County, Metro, the Oregon Department of Transportation, and the Portland bureaus of Planning and Parks.
The Plan provides guidance over a 20-year period for improvements that will encourage more people to ride more frequently for daily needs. The mission of the Master Plan is to make bicycling an integral part of daily life in Portland.
'''Key Elements'''
The Bicycle Master Plan addresses five key elements:
1) policies and objectives that form part of Portland's Comprehensive Plan Transportation Element;
2) developing a recommended bikeway network;
3) providing end-of-trip facilities;
4) improving the bicycle-transit link; and
5) promoting bicycling through education and encouragement.
Associated with each of these elements are objectives, action items, and five-, 10-, and 20-year benchmarks to measure progress. where appropriate, the costs of achieving these benchmarks are included. these benchmarks and costs are found at the end of this Executive Summary.
In addition, the Plan provides bikeway design and engineering guidelines and a summary of laws relating to bicycle use.
'''Bicycle Transportation Policy and Objectives'''
Policy 6.12 of the Transportation Element of the City's Comprehensive Plan is the following statement:
Make the bicycle an integral part of daily life in Portland, particularly for trips of less than five miles, by implementing a bikeway network, providing end-of-trip facilities, improving bicycle/transit integration, encouraging bicycle use, and making bicycling safer.
The following objectives accompany this policy statement.
'''Objectives:'''
A. Complete a network of bikeway that serves bicyclists' needs, especially for travel to employment centers, commercial districts, transit stations, institutions, and recreational destinations.
B. Provide bikeway facilities that are appropriate to the street classifications, traffic volumes, and speed on all rights-of-way.
C. Maintain and improve the quality, operation and integrity of bikeway network facilities.
D. Provide short- and long-term bicycle parking in commercial districts, along Main Streets, in employment centers and multifamily developments, at schools and colleges, industrial developments, special events, recreational areas, and transit facilities such as light rail stations and park-and-ride lots.
E. Provide showers and changing facilities for commuting cyclists. Support development of such facilities in commercial buildings and at "Bike Central" locations.
F. Increase the number of bicycle-transit trips. Support Tri-Met's "Bikes on Transit" Program.
G. Develop and implement education and encouragement plans aimed at youth, adult cyclists, and motorists. Increase public awareness of the benefits of bicycling and of available resources and facilities.
H. Promote bicycling as transportation to and from school.
'''Recommended Bikeway Network'''


== Acronyms ==
Objectives A, B, and C, listed above, pertain to the development of the bikeway Network.
There are about 185 miles of existing and planned bicycle lanes, bicycle boulevards, and off-street paths in Portland. The bikeway network calls for the addition of approximately 445 miles to this system to create a 630 mile network of preferred and appropriate convenient and attractive bikeways throughout Portland. When complete, this network should enable cyclists to find a bikeway within approximately one-quarter to one-half mile from every location in Portland.
'''Provide End-of-Trip Facilities'''


* MW: Mediawiki
Objectives D and E pertain to providing end-of-trip facilities.
* SMW: Semantic Mediawiki
A survey undertaken for the Master Plan found sub-standard bicycle parking in the majority of Portland's commercial areas. Many public facilities, including schools and parks, were likewise deficient in adequate bicycle parking.
To address this problem, the master Plan calls for a public-private partnership to install higher levels of bicycle parking; provide for long-term bicycle parking to serve commuters, students, and others needing longer-term bicycle storage; and provide other end-of-trip services like showers, changing rooms, and clothing storage.
An estimated 1,900 short-term and 145 long-term bicycle parking spaces exist in Portland. The Plan calls for the development of an additional 8,600 short-term and 23,000 long-term spaces in 20 years.
'''Improving the Bicycle-Transit Link'''


= Web publishing =
Objective F pertains to improving the bicycle-transit link.
Two types of bicycle-transit trips are possible in Portland. Riders can take their bicycles aboard buses and light-rail through the bicycles-on-Tri-Met program, for which over 6,300 permits have been sold. From July, 1994 to June, 1995 almost 80,000 bicycles-on-transit trips were made. Bicyclists can also "bike-and-ride," making use of long-term bicycle parking at transit centers and light-rail stations. As of February, 1996 there were 56 bicycle lockers spaces at transit centers and MAX stations.
The City will continue to support and promote the Bicycles on Tri-Met program, and assist Tri-Met in providing and promoting long-term bicycle parking at the transit system to encourage bicycle use.
Promoting Bicycling Through Education and Encouragement
Objectives G and H pertain to promoting bicycling through education and encouragement.
Bicycle education is concerned with developing safe cycling skills in children, teaching adult cyclists their rights and responsibilities, and teaching motorists how to more effectively share the road with cyclists.
Encouragement includes providing a bikeway network, end-of-trip facilities, and bicycle-transit services, holding encouragement events, providing incentives, and providing information and/or maps with recommended cycling routes.
Many organizations throughout Portland provide bicycling education and encouragement. The City will continue to support these organizations as able, with the goal of having three to five annual bicycling promotion events. Additional long-term goals are to have 10 percent of children bicycling to school and 100 percent of children receiving bicycle safety education.
'''Providing Bikeway Design and Engineering Guidelines'''


== Difference between Semantic Mediawiki and static web sites, CMS, Mediawiki ==
The Master Plan offers detailed design and engineering guidelines for different types of bicycle facilities. Included are intersection designs, signing and marking, maintenance considerations, and bicycle parking code requirements. This information, and the text of state laws and local ordinances pertaining to bicycling, are found in the Master Plan's appendices.
'''Conclusion'''
Bicycling produces no air or noise pollution, decreases traffic congestion, reduces taxpayer burden, helps alleviate parking demand, saves energy, uses land and road space efficiently, provides mobility, saves individuals money, improves health and fitness, and is fast and fun! The success of the bicycle Master Plan will only be assured by the continued support of Portland's cycling community and other residents recognizing the benefits bicycling brings to all residents.


* 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.
[[Category:Portland]]
* 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
* 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'''
 
 
* Designing information well makes it easier to find, consistent and re-usable.
 
== 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 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
 
== 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