Wikimedia blog

News from the Wikimedia Foundation and about the Wikimedia movement

Posts Tagged ‘book’

New book dives into the architecture of MediaWiki, git, puppet and other open-source applications

The cover of the book, based on the photo of a building from a low-angle shot

The Architecture of Open-Source Applications is a collection of technical essays detailing the architecture of twenty-four major open-source applications.

The second volume of the Architecture of Open-Source Applications book, which includes a chapter on MediaWiki, is now available online and on lulu.com.

The Architecture of Open-Source Applications is a collection of technical essays detailing the architecture of twenty-four major open-source applications. This is the second volume of a series that aims to help developers understand how great and large programs are constructed, and the decisions (or accidents) that led to the way they now work. The series draws inspiration from books used by architects that feature case studies of the great buildings of history.

This volume contains a chapter detailing the inner workings of MediaWiki, the wiki software that powers all Wikimedia sites, including Wikipedia.

The writing of the chapter was coordinated by myself and Sumana Harihareswara. While I put together the majority of the content, it wouldn’t have been possible without the initial knowledge-sharing effort made by many Wikimedia engineers and volunteer MediaWiki developers, who also reviewed and improved the several revisions the text underwent.

The chapter on MediaWiki is available on the book’s website, along with the other chapters from both volumes. Its content was integrated into the documentation on mediawiki.org (at MediaWiki history and Manual:MediaWiki architecture) when it was completed in November 2011.

Greg Wilson and Amy Brown, the book’s editors, contacted the Wikimedia Foundation in August 2011 to offer to feature MediaWiki in the second volume. We chose a very collaborative approach to writing the chapter to ensure that the content was accurate and thorough, and also to split the workload among subject matter experts.

This volume dives into the inner workings of other tools familiar to the Wikimedia community, like Git, GNU Mailman, nginx and Puppet.

All of the book’s content is released under the Creative Commons Attribution license, similar to the license used on Wikimedia sites. It is freely available for reading online at http://www.aosabook.org, and you can also order a print from lulu.com. E-book and PDF versions will be available for purchase shortly. All royalties from purchases are donated to Amnesty International.

This is the second book published this year that contains a chapter written by Wikimedia staff, after the publication of Open Advice, a collection of essays, stories and lessons learned by members of the Free Software community.

I hope the chapter on MediaWiki, and also the rest of the book, will prove useful and interesting to the Wikimedia community and other developers. If you enjoyed it, learned from it, or would like to see more publications of this type, let us know!

Guillaume Paumier
Technical communications manager

Free software community shares lessons learned in “Open Advice” book

Open Advice book cover

The "Open Advice" book is available for free download, or purchase as print from lulu.com.

The Open Advice book, a collection of essays, stories and lessons learned by members of the Free Software community, is out!

The book was just announced at FOSDEM, the Free and Open Source Software Developers’ European Meeting, in Brussels over the week-end.

About 50 authors from many different projects of the free software community were brought together by Lydia Pintscher, the book’s editor, who started the project in early 2011.

A year and 380 pages later, the book is now available, and tries to provide an answer to the question: What’s the key thing you would have liked to know when you started contributing?

Authors answer that question for many topics, ranging from “Writing patches” to “Documentation for Novices”, to business models, conferences, translation, design, and more.

I contributed “Learn from your users”, a chapter on user experience and usability testing. You’ll also recognize other names from the Wikimedia community, like Evan Prodromou, Markus Krötzsch and Felipe Ortega.

You can learn more about the book and the authors on the book’s website.

All the content of the book is released under the same license as Wikipedia, the Creative Commons Attribution Share-Alike license.

Check it out! You can download the book for free as a PDF file, order a print from lulu.com if you prefer paper books, or fork the text on GitHub.

I hope you’ll like the book, and it’ll prove useful, whether you’re new to the world of software, or you’re a seasoned contributor already.

Guillaume Paumier
Technical Communications Manager

Wiki-to-print feature now available in the German Wikipedia

A printed book ordered through PediaPress.com

A printed book ordered through PediaPress.com

A few weeks ago, we rolled out a feature to allow users to generate PDF files, OpenDocument word processor files, and on-demand printed books in one of our smaller sister projects, Wikibooks. This same technology has now also been experimentally enabled on the German Wikipedia (thanks to Frank Schulenburg for creating a beautiful help page). Essentially, you can compile a wiki-book from any number of Wikipedia articles, download a PDF or OpenDocument version, or order a printed version from our technology partner, PediaPress. And if you like your book remixes, you can save them for others to use and share.

If you want to take your favorite Wikipedia articles with you on the go, or if you want to have a nicely formatted PDF version, or you want to edit them further in a word processor, this technology is for you. The reason this is being tested on the German Wikipedia, in case you were wondering, is that PediaPress is a German company, and they will be able to respond quickly to feedback directly from the German Wikipedia community. With more than 1.4 billion pageviews a month, the German Wikipedia is also the second most viewed language edition, right after English with 5.2 billion pageviews. We’ve dedicated some hardware to this feature, and testing it on the German Wikipedia will give us a good idea how it behaves under high traffic characteristics.

It should go without saying that all the code developed through this partnership is open source. In other words, if you want to set up your own wiki with PDF support, OpenDocument support, or connectivity to the PediaPress on-demand printing service, you can install the Collection Extension and enable it on your wiki. When we say free, we mean it.

If all goes well, this feature will become available in all Wikimedia projects where it makes sense. This technology has been developed with the generous support of the Commonwealth of Learning and the Open Society Institute.

Erik Moeller, Deputy Director Wikimedia Foundation

PS: In unrelated tech news, our CTO Brion Vibber has blogged about the AbuseFilter extension, an important tool whose development we’re supporting, which will help Wikipedians to deal more effectively with spam, vandalism, and other destructive user behavior. And if you haven’t seen it, also note his recent post about the Drafts feature that’s being tested, and which should help against accidental loss of edits.

Two new wiki books!

How Wikipedia Works

MediaWiki

Not one, but two new books to add to your library this month.  Earlier in September we were pleased to see How Wikipedia Works (published by No Starch Press), authored by prominent Wikipedians Phoebe Ayers, Charles Matthews, and Ben Yates.

Today another title has hit shelves, with significant contributions from our own CTO (and MediaWiki wunderkind) Brion Vibber, O’Reilly’s MediaWiki, authored by Daniel J. Barrett.

Congratulations to all the authors!

Jay Walsh, Head of Communications

Wikipedia in (German) Book Form

Original author: AJ Ashton (on OpenClipArt). Code fixed by verdy_p for XML conformance, and MediaWiki compatibility, using a stricter subset of SVG without the extensions of SVG editors, also cleaned up many unnecessary CSS attributes, or factorized them for faster performance and smaller size. All the variants linked below are based on this image.Wikipedia in a book? That’s right! I know it may not be the first thing that comes to mind when one thinks of Wikipedia but our mission at the Wikimedia Foundation is make all human knowledge accessible to everyone, and that includes bringing that knowledge to the offline world.

Wikimedia Germany (the German Wikimedia chapter) spent a lot of time and energy pulling this project together and was able to get the weight of publishing powerhouse Bertelsmann behind the project. Furthermore, they helped Bertelsmann to understand and support our mission because the GFDL would require Bertelsmann to contribute the changes back to Wikipedia. This makes this a unique endeavor in the publishing world and could be considered a success just for getting this off the ground.

Here is a quick summary and the main stats of the book project:

Title: The Wikipedia Encyclopaedia in one volume (“Das Wikipedia
Lexikon in einem Band”)
Size: 993 pages
Illustrations: approx. 1,000
Keywords and definitions: approx. 50,000
Index: WIKIPEDIA’s most frequently accessed keywords
Content: Abstracts/first paragraph of the online-edition; countries
given with basic key facts
Format: 17 x 24 cm
Get-up: Hardcover, four-colour
Target retail price (VAT included): EUR 19.95
Publication date: Autumn 2008

The book is only in German for the German market but we will be watching this innovative project closely because…who knows? You can’t change the world unless you push the limits and try to break existing paradigms. Much of the credit for this arrangement belongs to Mathias, Arne and everyone involved with the German chapter – they did all the hard work. Danke!

Time to celebrate with some schnitzel and a large Dunkel (or an Apelsaft, if you prefer)!

Kul Wadhwa, Head of Business Development