Difference between revisions of "MediaWiki/Presentation"
Jump to navigation
Jump to search
(revert edits to fix search where character encoding was a problem) |
|||
| (27 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{Draft}} | |
== Preface == | == Preface == | ||
| Line 5: | Line 5: | ||
| + | <!-- | ||
internal notes | internal notes | ||
| Line 13: | Line 14: | ||
# DONE Contact Andy Oram about getting a copy of the O'Reilly MediaWiki book; invite | # DONE Contact Andy Oram about getting a copy of the O'Reilly MediaWiki book; invite | ||
# 85% Write outline, get more detail out at BostonPHP website | # 85% Write outline, get more detail out at BostonPHP website | ||
| − | # | + | # 50% Publicize // sent notice to local groups, O'Reilly etc. |
# 50% Complete presentation | # 50% Complete presentation | ||
## 10% Images | ## 10% Images | ||
| Line 22: | Line 23: | ||
== Intro == | == Intro == | ||
| − | + | MediaWiki is the free software (GPL) that runs Wikipedia under the auspices of the Wikimedia Foundation. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | I'm Greg Rundlett [http://iic.harvard.edu/people] [http://freephile.com] [http://rundlett.com], a free software advocate who lives in Newburyport, MA with my wife and two sons. I'm here to show you a lot of things about the wiki system called MediaWiki and hope that you'll take away a lot from this presentation. The great thing about sharing knowledge; like sharing free software; is that you can take away as much as you possibly can and I may take away an even greater knowledge than I started with just from our sharing. Nobody has less, everybody has more. | |
| − | + | Oh, and I do have some tangible free and cool stuff too. Freebies (books, commons) | |
| − | |||
| − | == | + | == Using it == |
| − | + | I'm not going into a detailed comparison of various wikis, trying to argue which is best. But I'll point out a few reasons why you should care about MediaWiki in case you don't know. | |
| − | |||
| − | I'm | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | It's the most popular wiki | + | It's the most popular wiki in the world. In practical terms that means people you hire will know mediawiki. |
| − | The growth | + | The growth is exponential. The quality is excellent. |
Does your wiki have [http://wikimania2006.wikimedia.org/wiki/Main_Page conferences]? | Does your wiki have [http://wikimania2006.wikimedia.org/wiki/Main_Page conferences]? | ||
| − | [[Image:Logo | + | [[Image:Logo Buenos Aires.jpg|thumb|300px|WikiMania]] |
| − | |||
| − | |||
| − | Does your wiki have | + | Does your wiki have a foundation to keep it going? |
| − | + | I do want to point out that MediaWiki does not use <ref>CamelCase</ref> words in order to make a link. This means a lot to all the Irish people of the world, and also the marketers who seem pretty convinced of the coolness of McWords like ThinkPad, etc. | |
| − | |||
| − | |||
| − | I do want to point out that MediaWiki does not use CamelCase words in order to make a link. This means a lot to all the Irish people of the world, and also the marketers who seem pretty convinced of the coolness of McWords like ThinkPad, etc. | ||
MediaWiki syntax is easy to learn, and easy to use. In fact, you might already be using it without even knowing it. | MediaWiki syntax is easy to learn, and easy to use. In fact, you might already be using it without even knowing it. | ||
| Line 79: | Line 57: | ||
[http://www.vimeo.com/2142196 See the kids in their Halloween costumes] | [http://www.vimeo.com/2142196 See the kids in their Halloween costumes] | ||
| − | + | == Editor Options == | |
| − | ; WYSIWYG editor : | + | ; WYSIWYG editor :Wysiwyg Yucky Stupid Interface Wrecks Your Goodness |
| − | + | # [http://en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd WikEd] is a full wysiwyg editor with special features for MediaWiki. You can install it for yourself in a single browser as a user script http://userscripts.org/scripts/show/12529 or you can install it into your mediawiki installation. | |
| − | + | # FCK Editor is a full wysiwyg editor that includes page link searching as you type | |
| − | + | # Java project called Textile-J is now an Eclipse plugin called the "Mylyn WikiText component" that does wiki markup http://www.eclipseplugincentral.com/Web_Links-index-req-viewlink-cid-1098.html | |
| − | + | # Kaltura does a collaborative video editing solution http://corp.kaltura.com/wiki/index.php/MediaWiki_Extension | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | === WikEd === | |
* Wikicode syntax highlighting | * Wikicode syntax highlighting | ||
* Pasting, import, and conversion of formatted text, e.g. from Microsoft-Word and web pages | * Pasting, import, and conversion of formatted text, e.g. from Microsoft-Word and web pages | ||
| Line 105: | Line 78: | ||
* Improved diff display | * Improved diff display | ||
* Follow links and wiki-links (ctrl-click) | * Follow links and wiki-links (ctrl-click) | ||
| − | * Runs automatically on every MediaWiki installation when installed as a local | + | * Runs automatically on every MediaWiki installation when installed as a local Greasemonkey user script |
For more details, see the [http://en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd WikEd] homepage | For more details, see the [http://en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd WikEd] homepage | ||
| − | + | === FCK Editor === | |
| − | * http://www. | + | * http://www.mediawiki.org/wiki/Extension:FCKeditor_(by_FCKeditor_and_Wikia) |
| − | + | note that I had to patch a minor bug to get it to work and even then, it did funny things with my article (wanted to collapse a line-break between template tag and next line resulting in a space being inserted prior to the next line, resulting in preformatted text rendering for that line. | |
| − | |||
| − | |||
| − | |||
Other points about using MediaWiki | Other points about using MediaWiki | ||
* Style sheets and | * Style sheets and | ||
| − | * Use this http://userscripts.org/scripts/show/6372 | + | * Use this http://userscripts.org/scripts/show/6372 greasemonkey script to show any mediawiki page as a presentation |
| Line 132: | Line 102: | ||
# Search - OpenSearch | # Search - OpenSearch | ||
# Interwiki links | # Interwiki links | ||
| − | # Import/Export | + | # Import/Export |
# Special pages | # Special pages | ||
| − | ##<pre>[[Special:ListGroupRights]]</pre> | + | ##<pre>[[Special:ListGroupRights]]</pre> Image searching |
| − | + | # Protection | |
| − | |||
| − | # Protection | ||
# Microformats Wikipedia implements microformats easily because through the power of templates, an author can fill out a template and not even know that he is using microformats in the final product. Firefox, through the tails extension, can [http://vimeo.com/192962/ export microformats via bluetooth], so that an employee directory on your intranet can talk to your mobile phone. @TODO: write up a contact template, a contact page and test the export | # Microformats Wikipedia implements microformats easily because through the power of templates, an author can fill out a template and not even know that he is using microformats in the final product. Firefox, through the tails extension, can [http://vimeo.com/192962/ export microformats via bluetooth], so that an employee directory on your intranet can talk to your mobile phone. @TODO: write up a contact template, a contact page and test the export | ||
== Creating Structure == | == Creating Structure == | ||
# Wikifarm | # Wikifarm | ||
| − | # | + | # Namespaces <dl> |
## <dt> Main <dd> What is sounds like, there is no need to specify this namespace when making links | ## <dt> Main <dd> What is sounds like, there is no need to specify this namespace when making links | ||
## <dt> Image <dd> Used for all file uploads, whether image, video, sound, doc or whatever. Each upload creates it's own article within this namespace | ## <dt> Image <dd> Used for all file uploads, whether image, video, sound, doc or whatever. Each upload creates it's own article within this namespace | ||
## <dt> Project <dd> Used as a "About Us" namespace -- not used for the main content of your wiki, but normally reserved for pages about the project which created the wiki. If you need to do a substantial edit to a template and want to try it out, one method of doing that would be to copy the article into the project namespace, use the new template, and your article wouldn't be normally included in search results. | ## <dt> Project <dd> Used as a "About Us" namespace -- not used for the main content of your wiki, but normally reserved for pages about the project which created the wiki. If you need to do a substantial edit to a template and want to try it out, one method of doing that would be to copy the article into the project namespace, use the new template, and your article wouldn't be normally included in search results. | ||
| − | ## <dt> Help <dd> What it sounds like, this namespace is | + | ## <dt> Help <dd> What it sounds like, this namespace is |
## <dt> Template <dd> | ## <dt> Template <dd> | ||
## <dt> Category <dd> | ## <dt> Category <dd> | ||
| Line 153: | Line 121: | ||
</dl> | </dl> | ||
# Subpages | # Subpages | ||
| − | # | + | # Templates "transclusion" |
| − | ## <pre><noinclude> </noinclude> <includeonly></includeonly></pre> | + | ## <pre><noinclude> </noinclude> <includeonly></includeonly></pre> show example. |
## arguments | ## arguments | ||
## Templates used on this page | ## Templates used on this page | ||
| − | ## copying from | + | ## copying from mediawiki [[Special:ExpandTemplates]] |
# Categories | # Categories | ||
# Navigation (talk about in Administration) | # Navigation (talk about in Administration) | ||
| + | |||
== Administering it == | == Administering it == | ||
| − | + | * Custom menu | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Developing it == | == Developing it == | ||
| Line 189: | Line 137: | ||
# Extensions | # Extensions | ||
# Conversion of existing wikis and documents [[Format conversion]] | # Conversion of existing wikis and documents [[Format conversion]] | ||
| − | |||
| − | |||
=== Theming === | === Theming === | ||
The quickest thing you do is change the menu and the logo | The quickest thing you do is change the menu and the logo | ||
| − | |||
=== Extensions === | === Extensions === | ||
| − | # [http://www. | + | # [http://www.mediawiki.org/wiki/Manual:Extensions The Manual] |
| − | # [http://www. | + | # [http://www.mediawiki.org/wiki/Extension_Matrix An incomplete list of extensions] |
So many examples, which ones to highlight? | So many examples, which ones to highlight? | ||
| Line 207: | Line 152: | ||
* http://help.wikia.com/wiki/Special:Version | * http://help.wikia.com/wiki/Special:Version | ||
* http://wiki.eclipse.org/index.php/Special:Version | * http://wiki.eclipse.org/index.php/Special:Version | ||
| − | |||
| − | |||
==== Timelines ==== | ==== Timelines ==== | ||
| − | # http://www. | + | # http://www.mediawiki.org/wiki/Extension:EasyTimeline |
# http://www.ehartwell.com/InfoDabble/MediaWiki_extension:_Timeline | # http://www.ehartwell.com/InfoDabble/MediaWiki_extension:_Timeline | ||
MIT's SIMILE project Timeline is integrated into Semantic MediaWiki | MIT's SIMILE project Timeline is integrated into Semantic MediaWiki | ||
* e.g. http://semanticweb.org/wiki/Events | * e.g. http://semanticweb.org/wiki/Events | ||
| − | |||
| − | |||
| − | |||
== Getting it, Installing it == | == Getting it, Installing it == | ||
| − | MediaWiki is developed using a Continuous Integration approach meaning that their trunk is tested and running in production http://www. | + | MediaWiki is developed using a Continuous Integration approach meaning that their trunk is tested and running in production http://www.mediawiki.org/wiki/Version_lifecycle |
{| class="datatable" | {| class="datatable" | ||
| Line 241: | Line 181: | ||
| bgcolor="#FF1000" | September 2008 | | bgcolor="#FF1000" | September 2008 | ||
|} | |} | ||
| − | [http://www. | + | [http://www.mediawiki.org/wiki/Download_from_SVN use svn] to get it, and that way updating your installation is as simple as <code>svn up</code> |
| Line 247: | Line 187: | ||
=== Creating Slideshows === | === Creating Slideshows === | ||
[[MediaWiki/Slideshow]] | [[MediaWiki/Slideshow]] | ||
| − | <pre><slide> | + | <pre><slide>flower</slide></pre> will create a nice slideshow |
| − | |||
from http://meta.wikimedia.org/wiki/User:BR/S5_slide_for_mediawiki_documentation/en | from http://meta.wikimedia.org/wiki/User:BR/S5_slide_for_mediawiki_documentation/en | ||
=== Integration with Software Development === | === Integration with Software Development === | ||
| − | # CodeReview http://www. | + | # CodeReview http://www.mediawiki.org/wiki/Extension:CodeReview e.g. http://www.mediawiki.org/wiki/Special:Code/MediaWiki/44245#c829 |
| − | # [http://www. | + | # [http://www.mediawiki.org/wiki/Extension:ExtensionDistributor ExtensionDistributor] ([https://wikitech.leuksman.com/view/ExtensionDistributor info]) is a tool that automatically packages code from subversion and sends the user a tarball. There is a lot of interesting information at wikitech that describes how the WikiMedia Foundation is operated technically |
=== Setup for an intranet and/or KB === | === Setup for an intranet and/or KB === | ||
| Line 263: | Line 202: | ||
Feed recent changes into publishing system that moves those out into front-end -- even static. In this sense, you can have editors feeding content into your website. We did this at Raging Bull - a company that I worked at back in 1999 (already several years after [http://en.wikipedia.org/wiki/Ward_Cunningham Ward Cunningham] first developed the wiki concept). | Feed recent changes into publishing system that moves those out into front-end -- even static. In this sense, you can have editors feeding content into your website. We did this at Raging Bull - a company that I worked at back in 1999 (already several years after [http://en.wikipedia.org/wiki/Ward_Cunningham Ward Cunningham] first developed the wiki concept). | ||
| − | Another example that is clearly "publishing"-centric is the way that wikis are used to put books online: | + | Another example that is clearly "publishing"-centric is the way that wikis are used to put books online: |
| − | * http://cyber.law.harvard.edu/wealth_of_networks/Main_Page (@TODO add thumbnails) | + | * http://cyber.law.harvard.edu/wealth_of_networks/Main_Page (@TODO add thumbnails) |
* http://en.wikibooks.org/wiki/Main_Page | * http://en.wikibooks.org/wiki/Main_Page | ||
| − | + | [[Category:book references]] | |
== One Hack == | == One Hack == | ||
| Line 273: | Line 212: | ||
* http://commons.wikimedia.org/wiki/MediaWiki:UploadForm.js/Documentation | * http://commons.wikimedia.org/wiki/MediaWiki:UploadForm.js/Documentation | ||
* http://commons.wikimedia.org/wiki/Commons:Redesigning_the_upload_form | * http://commons.wikimedia.org/wiki/Commons:Redesigning_the_upload_form | ||
| − | * http://www. | + | * http://www.mediawiki.org/wiki/User:Pfctdayelise/Manual:Uselang_hack |
== Resources == | == Resources == | ||
| − | * Daniel J. Barrett wrote the [http://oreilly.com/catalog/9780596519797/toc.html MediaWiki Book] published by O'Reilly ISBN 978-0596519797 | + | * Daniel J. Barrett wrote the [http://oreilly.com/catalog/9780596519797/toc.html MediaWiki Book] published by O'Reilly ISBN 978-0596519797 |
* IRC | * IRC | ||
| − | * | + | * Manual |
* Source | * Source | ||
* [http://userscripts.org/tags/wikipedia More user scripts] | * [http://userscripts.org/tags/wikipedia More user scripts] | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
[[Category:Wiki]] | [[Category:Wiki]] | ||
[[Category:Presentations]] | [[Category:Presentations]] | ||
[[Category:Howto]] | [[Category:Howto]] | ||
Revision as of 00:12, 17 December 2008
- ↑ CamelCase
