Wiki book: Difference between revisions
m (using an external editor) |
m (using an external editor) |
||
Line 1: | Line 1: | ||
{{ | {{Incomplete}} | ||
<pageby nominor="false" comments="false"/> | <pageby nominor="false" comments="false"/> | ||
Line 9: | Line 8: | ||
* A print book authored on the wiki and then post-processed for typesetting and minor adjustments. A typical example are the [http://meta.wikimedia.org/wiki/WikiReader WikiReader]s, collections of articles from Wikimedia Foundation projects on a certain topic, in the form of PDFs published for download and intended to be printed, and also to be sold in printed form. | * A print book authored on the wiki and then post-processed for typesetting and minor adjustments. A typical example are the [http://meta.wikimedia.org/wiki/WikiReader WikiReader]s, collections of articles from Wikimedia Foundation projects on a certain topic, in the form of PDFs published for download and intended to be printed, and also to be sold in printed form. | ||
* A real print book prepared on the wiki, but | * A real print book prepared on the wiki, but heavily edited once imported to a word processor. | ||
* A collection of wiki articles assembled on the fly by a user into a PDF document. | * A collection of wiki articles assembled on the fly by a user into a PDF document. | ||
Line 22: | Line 21: | ||
# '''Books as "after thought"'''. Some people create wiki pages about isolated subjects and that could grow into a collection of related subjects. Making a "book" out of these should be as easy as possible. | # '''Books as "after thought"'''. Some people create wiki pages about isolated subjects and that could grow into a collection of related subjects. Making a "book" out of these should be as easy as possible. | ||
# '''Evolving tutorials'''. With a wiki one can test (and change in real time) tutorials. These could then be assembled into a printable textbook. E.g. with (lots) of extra work I could do this for my [[Flash tutorials]]. Already now we generate PDFs for handouts. In addition, one get get occasional help from users to fix small mistakes and broken links. | # '''Evolving tutorials'''. With a wiki one can test (and change in real time) tutorials. These could then be assembled into a printable textbook. E.g. with (lots) of extra work I could do this for my [[Flash tutorials]]. Already now we generate PDFs for handouts. In addition, one get get occasional help from users to fix small mistakes and broken links. | ||
# Cross-references and references to external sources are easy to create and to manage in a wiki. In some word processors this is troublesome, e.g. Word (all versions) is a total disaster with respect to | # Cross-references and references to external sources are easy to create and to manage in a wiki. In some word processors this is troublesome, e.g. Word (all versions) is a total disaster with respect to cross-referencing and other tagging. | ||
== Mediawiki technology == | == Mediawiki technology == | ||
Mediawikis (like this one) or the | Mediawikis (like this one) or the Wikipedias rely on an infrastructure that is badly suited for producing books in any form. Firstly the wiki syntax fairly complicated to parse. Worse, most Mediawikis include at least some (or hundreds) of so-called templates, e.g. <nowiki>{{incomplete}}</nowiki> will insert a banner on top of a page in this wiki. Still worse, there exist extensions (e.g. to define diagrams with a code) that rely on complex external markup languages. | ||
Until recently, we couldn't find any easy strategy to produce high-quality PDF or insure perfect export/import to text processing software. This may have changed with the recent [http://www.mediawiki.org/wiki/Extension:Collection Collection] extension contributed by [http://pediapress.com/ http://pediapress]. Information on various Wikipedia servers is still fairly chaotic and many pages are not really updated. See for example the discussion about [http://meta.wikimedia.org/wiki/Paper_Wikipedia Paper Wikipedia], but that may change sometimes in the near future - [[User:Daniel K. Schneider|Daniel K. Schneider]] 17:52, 23 March 2009 (UTC) | |||
=== Strategies for creating PDF from Mediawiki === | |||
=== Strategies for creating PDF from | |||
; Tools | ; Tools | ||
Line 38: | Line 35: | ||
* [http://www.plog4u.org/index.php/Using_Eclipse_Wikipedia_Editor The Eclipse Wikipedia Editor with PDF Exporter] | * [http://www.plog4u.org/index.php/Using_Eclipse_Wikipedia_Editor The Eclipse Wikipedia Editor with PDF Exporter] | ||
* [http://www.mediawiki.org/wiki/Extension:Collection Collection] is an extension that you can | * [http://www.mediawiki.org/wiki/Extension:Collection Collection] is an extension that you can install in your own wiki. It will allow a user to organize personal selections of pages in a collection. Collections then can be structured with chapters, exported in ODF, [[DocBook]] or PDF using other extensions or ordered as print book through [http://pediapress.com/ http://pediapress]. | ||
** [http://www.mediawiki.org/wiki/Extension:PDF_Writer Extension:PDF_Writer | ** [http://www.mediawiki.org/wiki/Extension:PDF_Writer Extension:PDF_Writer aka mwlib.rl] is a python library for writing PDF documents from Mediawiki articles which were parsed by the [http://groups.google.com/group/mwlib mwlib library] (used together with collection). | ||
* [http://www.mediawiki.org/wiki/Extension:Pdf_Book Extension:PdfBook] is an extension that can generate PDF from a page with a list of links, e.g. a category page. All pages found in the link will be assembled into a single HTML page and then processed with the [http://www.htmldoc.org/ Htmldoc] server script. | * [http://www.mediawiki.org/wiki/Extension:Pdf_Book Extension:PdfBook] is an extension that can generate PDF from a page with a list of links, e.g. a category page. All pages found in the link will be assembled into a single HTML page and then processed with the [http://www.htmldoc.org/ Htmldoc] server script. | ||
* [http://www.mediawiki.org/wiki/Alternative_parsers Alternative parsers] ( | * [http://www.mediawiki.org/wiki/Alternative_parsers Alternative parsers] (Mediawiki). A list of links, descriptions, and status reports of the various alternative Mediawiki parsers—that is, programs and projects, other than Mediawiki itself, which are able or intended to translate Mediawikis text markup syntax into something else. | ||
=== Strategies for creating real print books === | === Strategies for creating real print books === | ||
Line 57: | Line 54: | ||
* Copy paste page contents into a word processor. | * Copy paste page contents into a word processor. | ||
* A variant is to generate a big | * A variant is to generate a big HTML from several articles, e.g. with the [http://www.mediawiki.org/wiki/Extension:Pdf_Book Extension:PdfBook] extension. Then, open this HTML in your word processor. Figures (including dynamically generated ones) should be imported that way. | ||
== Links to wikibooks and | == Links to wikibooks and organizations that publish them == | ||
=== Wikipedia books === | === Wikipedia books === |
Revision as of 18:52, 23 March 2009
<pageby nominor="false" comments="false"/>
The term wiki book is ambiguous and means several things:
- A collection of wiki pages about a topic. The best example are the Wikibooks from Wikipedia. Sometimes PDF versions are made available too.
- A print book authored on the wiki and then post-processed for typesetting and minor adjustments. A typical example are the WikiReaders, collections of articles from Wikimedia Foundation projects on a certain topic, in the form of PDFs published for download and intended to be printed, and also to be sold in printed form.
- A real print book prepared on the wiki, but heavily edited once imported to a word processor.
- A collection of wiki articles assembled on the fly by a user into a PDF document.
See also open content and open educational resources (OER). Wiki books are a favorite tool for open content authors.
Why wiki books
There are several arguments:
- Wikis are good tools for mass collaboration (social computing) as well as for fairly large groups work. This idea seems to work in some Wikibooks projects.
- Books as "after thought". Some people create wiki pages about isolated subjects and that could grow into a collection of related subjects. Making a "book" out of these should be as easy as possible.
- Evolving tutorials. With a wiki one can test (and change in real time) tutorials. These could then be assembled into a printable textbook. E.g. with (lots) of extra work I could do this for my Flash tutorials. Already now we generate PDFs for handouts. In addition, one get get occasional help from users to fix small mistakes and broken links.
- Cross-references and references to external sources are easy to create and to manage in a wiki. In some word processors this is troublesome, e.g. Word (all versions) is a total disaster with respect to cross-referencing and other tagging.
Mediawiki technology
Mediawikis (like this one) or the Wikipedias rely on an infrastructure that is badly suited for producing books in any form. Firstly the wiki syntax fairly complicated to parse. Worse, most Mediawikis include at least some (or hundreds) of so-called templates, e.g. {{incomplete}} will insert a banner on top of a page in this wiki. Still worse, there exist extensions (e.g. to define diagrams with a code) that rely on complex external markup languages.
Until recently, we couldn't find any easy strategy to produce high-quality PDF or insure perfect export/import to text processing software. This may have changed with the recent Collection extension contributed by http://pediapress. Information on various Wikipedia servers is still fairly chaotic and many pages are not really updated. See for example the discussion about Paper Wikipedia, but that may change sometimes in the near future - Daniel K. Schneider 17:52, 23 March 2009 (UTC)
Strategies for creating PDF from Mediawiki
- Tools
- Collection is an extension that you can install in your own wiki. It will allow a user to organize personal selections of pages in a collection. Collections then can be structured with chapters, exported in ODF, DocBook or PDF using other extensions or ordered as print book through http://pediapress.
- Extension:PDF_Writer aka mwlib.rl is a python library for writing PDF documents from Mediawiki articles which were parsed by the mwlib library (used together with collection).
- Extension:PdfBook is an extension that can generate PDF from a page with a list of links, e.g. a category page. All pages found in the link will be assembled into a single HTML page and then processed with the Htmldoc server script.
- Alternative parsers (Mediawiki). A list of links, descriptions, and status reports of the various alternative Mediawiki parsers—that is, programs and projects, other than Mediawiki itself, which are able or intended to translate Mediawikis text markup syntax into something else.
Strategies for creating real print books
- Using the collection extension
- Help:Books (en.wikipedia). This page shows you how to create a book from Wikipedia articles in three steps. Books can be created in PDF form or ordered for printing on the PediaPress website.
- This procedure is based on the Collection extension (see above).
- FAQ
- Help:Books/for experts
- Copy and paste
- Copy paste page contents into a word processor.
- A variant is to generate a big HTML from several articles, e.g. with the Extension:PdfBook extension. Then, open this HTML in your word processor. Figures (including dynamically generated ones) should be imported that way.
Links to wikibooks and organizations that publish them
Wikipedia books
- Help:Books (en.wikipedia). This page shows you how to create a book from Wikipedia articles in three steps. Books can be created in PDF form or ordered for printing on the PediaPress website.
- Wikibooks “Wikibooks is a Wikimedia community for creating a free library of educational textbooks that anyone can edit. Wikibooks began on July 10, 2003; since then Wikibooks has grown to include over 35,021 pages in a multitude of textbooks created by volunteers like you!”, retrieved 18:18, 20 March 2009 (UTC).
- Wikibooks.org (List of international Wikibook wikis).
- Wikipedia:WikiReader (This page is currently inactive and is retained for historical reference...)
- WikiReader (Wikimedia meta-wiki).
Other organizations
There are lots of educational organizations that use wikis or similar CMS technology, e.g.
- WikiEducator. Some of its contents can be considered virtual books, but you'll have to dig a bit - Daniel K. Schneider 18:18, 20 March 2009 (UTC)
- Connexions
- Scholarpedia (not a collection of books actually, but it does include "encyclopedias about subjects")
See also open contents and open educational resources
Publishing companies
- WikiReader. Published some print books in German made from Wikipedia articles.
- weBook, online writing and reading in several areas. Read also Wiki book publisher for collaborative writing.
- Random House will publish a synthesis of the 50'000 most popular german wiki articles.
- PediaPress has an interesting model. You select the content from your favorite wiki and PediaPress takes care of typesetting, printing and shipping. See also Help:Books.
Wikibooks in educational technology
Orey, M.(Ed.). (2001). Emerging perspectives on learning, teaching, and technology. Retrieved <insert date>, from http://projects.coe.uga.edu/epltt/
Various links
- Wikinomics has some propaganda for the "collective intelligence" argument.
- Rick Sapir explains with Writing a Book, the Wiki Way why (and a bit how) he wrote TikiWiki for Smarties, an online document.
Bibliography
- Barton, Matthew D. et al (n.d.), Rhetoric and Composition, Wikibook, http://en.wikibooks.org/wiki/Rhetoric_and_Composition. (Good example of a wikibook, but also includes good information on composition and collaborative writing).
- Mason, Bruce and Sue Thomas (2008). A Million Penguins Research Report, Institute for Creative Technologies, De Montfort University. PDF. Good reading about why a million penguins can't write a very good novel. This paper includes also further links to related blogs.