2,153
edits
Practical Semantic Mediawiki: Difference between revisions
no edit summary
(→Views) |
No edit summary |
||
| (43 intermediate revisions by 2 users not shown) | |||
| Line 23: | Line 23: | ||
* 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 | * 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 | * Mediawiki is designed to organize large sets of pages, potentially with many involved people, with potentially less constrained access | ||
* Semantic Mediawiki adds structured information and views | * 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''' | ** '''We are going to learn markup encoding in order to have more control over content and appearance''' | ||
=== To add === | |||
* culture, content, technology | |||
* distributing content | |||
== The wiki model == | |||
pages, links, categories | |||
== Access models == | == Access models == | ||
| Line 46: | Line 55: | ||
== Accessibility == | == Accessibility == | ||
''Here, accessibility refers to supporting people with vision, keyboard control or cognitive | ''Here, accessibility refers to supporting people with vision, keyboard control or cognitive impediments.'' | ||
* Making sites accessible generally increases usability | * Making sites accessible generally increases usability | ||
| Line 128: | Line 137: | ||
** Use <nowiki>[]</nowiki> brackets and space after the link to use your own link text. <nowiki>[http://theirsite.com Their site]</nowiki>. | ** 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) | * <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 | ** 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 | ** 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 | ||
| Line 140: | Line 149: | ||
** Brainstorm using links | ** Brainstorm using links | ||
{{Practice|Create a new page that's a unique generally recognized | {{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}} | {{Practice|Put your page in a category, put that category in a sub-category}} | ||
===Images and files === | |||
* Uploading images and files | * Uploading images and files | ||
=== Page maintenance=== | |||
* Moving pages | * Moving pages | ||
| Line 157: | Line 174: | ||
* Deleting pages | * Deleting pages | ||
* Templates - used for consistently reused content | === 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 === | === Making pages look good === | ||
| Line 170: | Line 195: | ||
* Possible to hide MW's menus and change the 'skin' | * Possible to hide MW's menus and change the 'skin' | ||
{{Practice|Add <nowiki><div class="noticebox">...</div></nowiki> | {{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}} | {{Bonus practice|Move your div to a reusable template}} | ||
| Line 194: | Line 219: | ||
* What properties does your content need to be useful? | * What properties does your content need to be useful? | ||
== Inline property annotation == | == Inline property annotation == | ||
| Line 217: | Line 236: | ||
</div> | </div> | ||
{{Practice|Add a population annotation to your place.}} | {{Practice|Add a population annotation to your [[:Category:Place|place]].}} | ||
* [http://semantic-mediawiki.org/wiki/Help:Properties_and_types#List_of_data_types Built-in types] | * [http://semantic-mediawiki.org/wiki/Help:Properties_and_types#List_of_data_types Built-in types] | ||
| Line 223: | Line 242: | ||
* [[Special:Properties|Viewing all properties]] | * [[Special:Properties|Viewing all properties]] | ||
* Subtypes | * 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 == | == Queries == | ||
| Line 236: | Line 258: | ||
''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).'' | ''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.}} | {{Practice|Change your page so it's a an Entity.}} | ||
| Line 248: | Line 269: | ||
</div> | </div> | ||
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 | |||
* {{PSITE|Special:CreateClass}} (template, properties, forms) | * {{PSITE|Special:CreateClass}} (template, properties, forms) | ||
** One topic per page | ** 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] | ** 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 | * Class templates will often contain queries that show linked classes | ||
=== Use cases of Semantic Mediawiki | === Use cases of Semantic Mediawiki's classes=== | ||
==== Discourse DB ==== | ==== Discourse DB ==== | ||
''http://www.discoursedb.org ([http://discoursedb.org/wiki/TSA_airport_screening_procedures_controversy example]) stores | ''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> | <pre> | ||
| Line 292: | Line 325: | ||
==== Placeography ==== | ==== 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'''. | ''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> | <pre> | ||
| Line 335: | Line 368: | ||
The template includes queries for Events for the current page. | The template includes queries for Events for the current page. | ||
{{Practice|Create your own semantic class with template, properties, form. Add pages to it {{ | Forms and templates can support multiple properties per field. | ||
{{Practice|Create your own semantic class using {{PSITE|Special:CreateClass}} with template, properties, form. Add pages to it Include a Place field that has a type of Page }} | |||
{{See|[http://www.mediawiki.org/wiki/Extension:Semantic_Forms Semantic Forms documentation].}} | |||
== Views == | == Views == | ||
| Line 364: | Line 400: | ||
''If the page's population is greater than 50000, then put it in the category of 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. | 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== | == Future directions== | ||
| Line 392: | Line 435: | ||
* [http://johnmacfarlane.net/pandoc/ Pandoc] | * [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] | * 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 = | = Hosting = | ||
* Export a site, modularize by category | * [[Special:Export]] a site, modularize by category | ||
** Complete site export | ** Complete site export | ||
* [[Special:Version]] | * [[Special:Version]] | ||
| Line 408: | Line 452: | ||
* Mediawiki help sites and community | * Mediawiki help sites and community | ||
* Semantic mediawiki help sites and community | * Semantic mediawiki help sites and community | ||
* If it's for an open cause, ask me | * If it's for an open cause, ask me or other [semantic] wikiers | ||
** User group | ** User group | ||
| Line 416: | Line 460: | ||
[[Category:SemWeb]] | [[Category:SemWeb]] | ||
[[Category:Practical Semantic Mediawiki]] | |||
{{Blikied|Nov 25, 2010}} | {{Blikied|Nov 25, 2010}} | ||