Table of Contents

“monobook” brings you the traditional¹⁾ MediaWiki/Wikipedia look and feel for DokuWiki.

• Maintainer: ARSAVA (Andreas Haerter)
• Contact: See “Support” and “Contact”.

There are some things you'll find in this template that you won't find in most other templates, and are inspired by Wikipedia and MediaWiki. Some features:

• Discussions
  Configurable discussion pages without requiring an additional plugin.
• User pages
  Users can have their own home page on your wiki.
• Cite this Article
  Allows students, journalists, researchers, and the like to easily reference articles on your site.
• Permanent Link
  Guarantees that articles you link to are the same as you saw them that second you link them.
• Automatic plugin integration
  monobook automatically detects and uses some popular, optionally installed plugins. Therefore you don't have to insert any code snippets or stuff when using: Translation, Open Office Export²⁾, html2pdf³⁾
• All non-page portions (e.g. navigation) of the template can be edited just as if they were pages. How cool is that?

If you like the template, you might want to donate a few bucks, or get some cool QR Code generator merchandise. It is a lot of work. Thank you!

• Note for existing users: Since 2014-02-09, there is no separate update .tar.gz anymore. The current archive is used for both install and update now. Instead of providing a separate update archive without the /user sub-directory, all example files in /user are delivered with the .dist extensions now to make sure your files won't get overwritten. This should be easier an more DokuWiki-like than the previous approach.

• Fixed a major bug, the configuration option were un-savable on DokuWiki 2013-12-08 “Binky” (cf. Issue 5).
• Full support for DokuWiki 2013-12-08 “Binky”.
• There is no separate update archive anymore.

• Full support for DokuWiki rc2013-10-28 “Binky”.

The source code of this template is available as Git repository.

See CHECKSUMS.asc for MD5, SHA-1 and SHA-256 checksums. The file is signed with the GnuPG/PGP key (0x423B2839). You can use gpg --verify ./CHECKSUMS.asc to check/validate it.

1. Refer to template on how to install and use templates in DokuWiki. For updating, see below.
2. Configure the place-holders. Have a look at “What are these "Please fill or disable this placeholder ([pagename])" everywhere?” to get help.

If you need help:

• Check the FAQ.
• Check the README.
• Use search.dokuwiki.org to find useful information.

If you found nothing helpful, ask your question at the DokuWiki forum (preferred) or IRC channel.

If you think you have found a bug or have a useful idea (a.k.a. “feature request”), create an issue on GitHub (preferred), or contact us by mail.

Feel free to submit patches as GitHub pull requests (preferred) or by mail as well. However, please try to respect the DokuWiki coding style as this template follows its rules.

1. Backup your data, especially /lib/tpl/monobook. But don't be scared. It is not rocket science.
2. Download the current version from above.
3. Simply uncompress and copy it over your current /lib/tpl/monobook. This works without problems when you follow the rules described in the README (⇒ the place for *all* user-defined, custom stuff is /lib/tpl/monobook/user!) because previously existing files in /lib/tpl/monobook/user will not be touched or overwritten.⁴⁾
4. Recommended: Also update the plugins Translation, Open Office Export, dw2pdf and html2pdf if you are using one ore more of them. This is especially important regarding Translation (some older versions may cause problems and/or results are looking badly).
5. Have fun and think about a small donation .
6. Here is a list of files that were removed in recent releases. They do no harm, but you should delete them to keep your installation clean and tidy:
   

   #removed in 2014-02-09
   /static/img/button-qrcode.png
   /user/button-css.png
   /user/button-xhtml.png
   /bug49642.php
   /README-de
   
   #removed in 2011-11-29
   /static/3rd/dokuwiki/_mediamanager.css
   /static/3rd/dokuwiki/basic.css
   /static/3rd/dokuwiki/content.css
   /static/3rd/dokuwiki/design.css
   /static/3rd/dokuwiki/includes.css
   /static/3rd/dokuwiki/structure.css
   /inc_mediamanager.php
   
   #removed in 2011-03-16
   /static/3rd/dokuwiki/_linkwiz.css
   /static/3rd/dokuwiki/layout.css
   /static/3rd/dokuwiki/media.css

• There will be no more updates for versions by Terence J. Grant.
• No additional plugins needed, also Display Wiki Page is not required anymore.
• Mediamanager, Link wizard and other new features are working.
• No problems regarding SSL/TLS/HTTPS loading unencrypted content, nothing comes from upload.wikimedia.org.
• Usage of DokuWiki's style.ini leading to much smaller style sheets and less HTTP requests.
• Bugfixes and support for the newest DokuWiki syntax. Compare the rendered :wiki:syntax page (before/after).

…you're lucky. An update should be done within minutes:

1. Backup your data, especially /lib/tpl/monobook. But don't be scared. It is no rocket science.
2. Check if you run DokuWiki ver. 2009-12-25 “Lemming” or newer (older ones do NOT work). If not, update DokuWiki first.
3. Take your time to read all listed instructions here. If there is something you don't understand, ask before updating.
4. Go to the DokuWiki Config Manager and set the template option to “default” or another installed template.
   Don't worry if “monobook” was/is the only available template: you can update without problems, but your Wiki can't work normally until the update is finished.
5. Rename
   /lib/tpl/monobook
   into
   /lib/tpl/monobook_old
   This directory will be deleted later, we do this for easier data migration.
   Your DokuWiki will be unreachable after renaming if you did not configure DokuWiki to use another template as mentioned above… don't panic, everything should work when the update is finished!
6. Download the newest release of monobook for DokuWiki and install as described. After this, the following directories should exist:
   • /lib/tpl/monobook (the new monobook by Andreas Haerter)
   • /lib/tpl/monobook_old (the old monobook by Terence J. Grant)
7. Go to the DokuWiki Config Manager, set the template option to “monobook” and reconfigure the monobook template options as appreciated. Please note that compress (“Compact CSS and JavaScript output”… don't confuse with the compression option) is now compatible with monobook and should be enabled for better performance and less traffic.
8. If you used an own logo (normally /lib/tpl/monobook_old/user/logo.[png|gif|jpg]) copy it as logo.[png|gif|jpg] into /lib/tpl/monobook/user/. The template recognizes the file automatically and will use it instead of the default logo.
9. If you used an own favicon (normally /lib/tpl/monobook_old/user/favicon.ico) copy it to /lib/tpl/monobook/user/favicon.ico. The template recognizes the file automatically and will use it instead of the default favicon.
10. Empty your browser's cache and call your DokuWiki with your browser. If everything looks fine, delete /lib/tpl/monobook_old/ (but make sure you really backed up the date before upgrading, maybe you done some modification you can't remember now but in a few days…).
11. You may uninstall the Display Wiki Page plugin if not needed by another plugin or template. “monobook” does not need this anymore.
12. Have fun and think about a small donation .

…there may be some more work to do. Basically it should work as described above, but you may have to figure out which of your own styles located in /lib/tpl/monobook_old/Common.css and/or /lib/tpl/monobook_old/Monobook.css are still needed. If the styles were just bugfixes (e.g. making Linkwizard/Icons work), you should not need them anymore⁵⁾.

Otherwise look at the README after downloading the template. There is described where to put own CSS⁶⁾. In most cases, your CSS should work when copied into the user-CSS-files – if not, check if some XHTML-element-IDs may changed and edit. If you need help editing your CSS, ask the forums…

The template optionally imports normal wiki pages and shows their content as

• navigation
• toolbox
• global, sidewide notice
• copyright note (off by default, default is the common copyright note by DokuWiki)

This means you can create the page mentioned in the “Please fill or disable this placeholder” message (e.g. “:wiki:navigation”) and its content will be shown instead of the message. All of these placeholders are configurable. Have a look at the DokuWiki admin section:

• Show site wide notice?
• If yes, use following wiki page for the site wide notice:
  […]
• Show navigation?
• If yes, use following wiki page as navigation:
  […]
• Show copyright notice?
• If yes, use default copyright notice?
• If not default, use following wiki page as copyright notice:
  […]
• Show toolbox?
• If yes, use default toolbox?
• If not default, use following wiki page as toolbox location:

Simply have a look at lib/tpl/monobook/VERSION. This is a textfile containing the version you are using (e.g. 2010-06-02). If there is no VERSION file, you are running the no longer supported monobook by Terence J. Grant. Have a look at the update notes to get a maintained version.

See customizing.

Go to the DokuWiki admin section and have a look at the following option (introduced in monobook version 2010-06-29):

• Closed wiki (most links/tabs/boxes are hidden until user is logged in)?

Short answer: yes. The template brings support for basic discussion pages without the need to install any additional plugin. However, if you are interested to use the Discussion plugin (which allows threaded replies, avatars, captcha and other controls at the bottom of the wikipage instead of a separated basic discussionpage), simply install it and deactivate the template option “Use discussion tabs/sites?” at the DokuWiki admin section.

Even if the footnotes may work as expected in some other templates, the wrong insitu footnote popup position is not a template but a DokuWiki 2010-11-07 “Anteater” issue (see Bug 2114). All templates with relative positioning are affected. This bug is fixed since DokuWiki 2011-04-22 “Rincewind RC1”. If you update your DokuWiki installation, the problem should be gone.

The template should be compatible with all modern browsers:

• Firefox ≥ 3
• Opera ≥ 10
• Safari ≥ 4, Chrome ≥ 1 and other newer Webkit based browsers.
• MS Internet Explorer ≥ 7

Please note:

• MS Internet Explorer 6 is