Changes

Cue mediawiki MediaWiki slideshow 5 minutes prior to presentationThere is video, but so far I haven't been able to slice it and keep the audio track intact.-->These screenshots of [[:Category:MediaWiki Sites|sites running MediaWiki]] illustrate the breadth of usage in the software world, and also some compelling theming examples. Audio of my presentation is at http://www.archive.org/details/collaboration.at.wiki.speed-audio-part1 <!-- and locally at http://freephile.com/mediawiki-greg.mp3 (45 minutes long) --> == What's a Wiki? ==Wiki is the Hawaiian word for quick, and Ward Cunningham - the inventor of the wiki - named his project after the wiki wiki shuttle. A backcronym that is probably equally apropos is WIKI stands for "What I Know Is..." MediaWiki is the free software (GPL) that runs Wikipedia under the auspices of the [http://www.wikimedia.org/ Wikimedia Foundation]. == Meet the speaker ==[[Image:Thomas Jefferson rev.jpg|thumb|right|He who receives an idea from me, receives instruction himself without lessening mine; as he who lights his taper at mine, receives light without darkening me.]] 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.

<!--What do I'm Greg Rundlett [http://iicknow about wikis in production? Well, back in 1999 when I was a web developer at RagingBull, we used a wiki system as a content creation and management backend to our website front-end.harvard Starting in 2005, I used MediaWiki as the platform to organize operations, development and technology services at OASIS.edu/people] [http://freephile.com] [http://rundlett.com] Most recently, a free software advocate who lives I've been deploying MediaWiki in Newburyport, MA with my wife and two sonsnew role at the IIC at Harvard. I'm here to show you a lot share some of things about the wiki system called MediaWiki and hope that experience with 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 ... [http://en.wikiquote.org/wiki/Thomas_Jefferson quoting Thomas Jefferson] ''He who receives an even greater knowledge than I started with just idea from our sharingme, receives instruction himself without lessening mine; as he who lights his taper at mine, receives light without darkening me.''<ref>[http://press-pubs.uchicago.edu/founders/documents/a1_8_8s12. Nobody has lesshtml Thomas Jefferson to Isaac McPherson], everybody has more13 Aug. 1813.ME 13:333</ref>

== 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. It's the most popular wiki software in the world; both in terms of hosting the largest single wiki Wikipedia [http://en.wikipedia.org/wiki/Main_Page WikiPedia] as well as deployments by all sort of individuals, groups and corporations. In practical terms that means people you hire will know mediawikiMediaWiki.

[[Image:Logo Wikimania Buenos Aires.jpg|thumb|300px|WikiMania]]

=== Syntax ===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.

=== Editor Options ===; WYSIWYG editor :Wysiwyg Weird Yucky Stupid Interface Wrecks Sucky Interference With Your Goodness

# <ol><li> [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 MediaWiki installation. {{Messagebox ||type=normal|text=wikEd is enabled sitewide on this wiki. Turn it on in your [[Special:Preferences|Preferences]] settings}}# <li> FCK Editor is a full wysiwyg editor that includes page link searching as you type# <li> 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# <li> Kaltura does a collaborative video editing solution http://corp.kaltura.com/wiki/index.php/MediaWiki_Extension</ol>

==== WikEd ====

* Runs automatically on every MediaWiki installation when installed as a local [https://addons.mozilla.org/en-US/firefox/addon/748 Greasemonkey ] user script

==== FCK Editor ====* http://www.mediawikiMediaWiki.org/wiki/Extension:FCKeditor_(by_FCKeditor_and_Wikia)note In 2007 it was announced that a WYSIWYG editor would be built for MediaWiki. Wikia (Jimmy Wales' for-profit venture) started work on it. It still isn't ready for prime time. 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.

==== OpenOffice ====OpenOffice (since v. 2.3) has had a built-in "Export to MediaWiki" menu option. So, you can write an article in OpenOffice Writer (or StarOffice Writer) and export the file to wiki markup. This could be useful particularly if you want to convert large collections of Word documents. One drawback to "export" is that you would still have to copy and paste that output into the wiki. http://extensions.services.openoffice.org/project/wikipublisher is the extra hook that allows you to save your page in the wiki(essentially registering your user data in the instance of OpenOffice

* Use this http://userscripts.org/scripts/show/6372 greasemonkey Greasemonkey script to show any mediawiki MediaWiki page as a presentation

# Import/Export (TODO talk about exporting to text)

##<pre>[[Special:ListGroupRights]]</pre> # Image searchingGalleries like [[Special:NewImages]]# SVG support# Protection(lock a page) Not to be confused with 'versions' that helps with things like versioned documentation for software products.

# [[Namespaces ]] or go directly to [[Special:PrefixIndex]]<dl>

## <dt> Help <dd> What it sounds like, this namespace isunfortunately empty with a new installation. See [[MediaWiki/Help]]

# [[Templates ]] "[[transclusion]]"## <pre><noinclude> </noinclude> <includeonly></includeonly></pre> show [[Template:Messagebox]] example.

## copying from mediawiki MediaWiki [[Special:ExpandTemplates]]

One good practice is to have some sort of text version or other backup of your wiki in case the machine, webserver, or database that the system depends on is down. As an administrator, you can use the dumpBackup.php script found in the <code>maintenance</code> directory of you MediaWiki installation. Something like the following in a system [[cron]] would be good:<source lang="bash">/usr/bin/php /var/www/phase3/maintenance/dumpBackup.php --current --output= Administering it file:/var/backups/example.com/`date +%F`-wiki.text.export.txt</source> As a user, one tool that can come in handy is [[Special:Wiki2XML]] <ref>http://tools.wikimedia.de/~magnus/wiki2xml/README, see also [[Format_conversion]]</ref> Another useful tool to the Administrator is the bulk image importer. To import all the screenshots that I used at the start of this presentation, I did the following:<source lang="bash">php importImages.php --user=Freephile --comment='Set of screenshots of sites using MediaWiki ' ~/Desktop/mediawiki/snaps/</source>* Custom menuNote how using a Category tag in the comment will automatically place the images in the Category specified.

# [http://www.mediawikiMediaWiki.org/wiki/Manual:Extensions The Manual]# [http://www.mediawikiMediaWiki.org/wiki/Extension_Matrix An incomplete list of extensions]

See more at [[MediaWiki/Extensions]]

# http://www.mediawikiMediaWiki.org/wiki/Extension:EasyTimeline

MediaWiki is developed using a Continuous Integration approach meaning that their trunk is tested and running in production http://www.mediawikiMediaWiki.org/wiki/Version_lifecycle

[http://www.mediawikiMediaWiki.org/wiki/Download_from_SVN use svn] to get it, and that way updating your installation is as simple as <code>svn up</code>

<pre><slide>flowerpixel</slide></pre> will create a nice slideshow<slide>pixel</slide>

# CodeReview http://www.mediawikiMediaWiki.org/wiki/Extension:CodeReview e.g. http://www.mediawikiMediaWiki.org/wiki/Special:Code/MediaWiki/44245#c829# [http://www.mediawikiMediaWiki.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

* http://www.mediawikiMediaWiki.org/wiki/User:Pfctdayelise/Manual:Uselang_hack

* Daniel J. Barrett wrote the [http://oreilly.com/catalog/9780596519797/toc.html MediaWiki Book] published by O'Reilly ISBN 978-0596519797(no need for any special markup, ISBN numbers are automatically recognized by the parser. You can also visit [[Special:BookSources]])

* Documentation (remember [[mw:Help:Contents|user at Help:Contents]] and [[mw:Manual:Contents|admin at Manual:Contents]])