MediaWiki/Wikipedia look and feel for DokuWiki (traditional)
Compatible with DokuWiki
Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Hrun
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
“monobook” brings you the traditional1) MediaWiki/Wikipedia look and feel for DokuWiki.
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:
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!
Version | 2014-02-09 |
---|---|
Download | 2014-02-09_monobook.tar.gz |
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.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.
If you need help:
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.
January 2010: This template is a complete rewrite of the no longer supported monobook by Terence J. Grant and will be maintained by Andreas Haerter from ARSAVA in the future. That is why you will find two different update descriptions below. Have a look at “How can I check which version is currently installed?” if you don't know which version you are currently using. |
---|
/lib/tpl/monobook
. But don't be scared. It is not rocket science./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)#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
…you're lucky. An update should be done within minutes:
/lib/tpl/monobook
. But don't be scared. It is no rocket science./lib/tpl/monobook
/lib/tpl/monobook_old
/lib/tpl/monobook
(the new monobook by Andreas Haerter)/lib/tpl/monobook_old
(the old monobook by Terence J. Grant)/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./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./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…).
…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 anymore5).
Otherwise look at the README after downloading the template. There is described where to put own CSS6). 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
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:
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
):
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:
Please note:
Have a look at the README. Everything regarding
apple-touch-icon.png
)is described there.
For the ones who are never reading READMEs:
/monobook/user/logo.[png|gif|jpg]
. The template recognizes the file automatically and will use it instead of the default logo./monobook/user/tabs.php
(NOT /monobook/conf/tabs.php
)./monobook/user/buttons.php
(NOT /monobook/conf/buttons.php
)./monobook/user/boxes.php
(NOT /monobook/conf/boxes.php
).
If one of the files within /monobook/user/
does not exist7), just take the missing files from the newest installation archive and copy them into /monobook/user/
.
…to insert into /monobook/user/tabs.php
(NOT /monobook/conf/tabs.php
).8)
//Recent Changes (thanks to Stefan Riemer for this) //To get some space between this and the other tabs, you may add the following //additional CSS to /monobook/user/screen.css: // li#tab-recent { // margin-left: 1.6em; // } if (!empty($conf["recent_days"])){ $_monobook_tabs["tab-recent"]["text"] = $lang["btn_recent"]; //language comes from DokuWiki core $_monobook_tabs["tab-recent"]["href"] = wl("", array("do" => "recent"), false, "&"); $_monobook_tabs["tab-recent"]["nofollow"] = true; }
…to insert into /monobook/user/boxes.php
(NOT /monobook/conf/boxes.php
).9)
To support BookCreator plugin, use this code:
//To add support for bookcreator plugin $_monobook_boxes["bookcreator"]["headline"] = "Create book"; $_monobook_boxes["bookcreator"]["xhtml"] = " <ul>\n" ." <li id=\"tb-bookcreator\"><a href=\"".wl(cleanID(getID()), array("do" => "addtobook"))."\" rel=\"nofollow\">".hsc('Add/Remove page')."</a></li>\n" ." <li id=\"tb-bookcreator\"><a href=\"".wl('wiki:ebook')."\" rel=\"nofollow\">".hsc('Show selection')."</a></li>\n" ." </ul>";
— mluigi 2010/04/01 17:12
To add “recent changes” and the plugin "listeabo": added in lang.php
english:
$lang['monobook_changes'] = "Recent changes"; $lang['monobook_listeabo'] = "List with subscribtions";
dutch:
$lang['monobook_changes'] = "Recent gewijzigd"; $lang['monobook_listeabo'] = "Lijst met inschrijvingen";
And the following in user/boxes.php
$_monobook_boxes["Addition"]["headline"] = "TITLE"; $_monobook_boxes["Addition"]["xhtml"] = "<ul>\n" // added recent changes ." <li><a href=\"".DOKU_BASE."doku.php?do=recent"."\" rel=\"nofollow\">".hsc($lang["monobook_changes"])."</a></li>\n" // added listabo ." <li><a href=\"".DOKU_BASE."doku.php?do=listeabo"."\" rel=\"nofollow\">".hsc($lang["monobook_listeabo"])."</a></li>\n" ."</ul>";
Theo Klein 2010/02/18 11:09
…to insert into /monobook/user/screen.css
(NOT /monobook/static/css/screen.css
).10)
Open /user/screen.css
and insert:
div.dokuwiki a.wikilink1:link{ color: #006600 !important; } div.dokuwiki a.wikilink1:visited { color: #009933 !important; } div.dokuwiki a.wikilink1:hover { color: #006600 !important; }
Simply replace the colors with a value you like (thanks to Theo for this).
Open /user/screen.css
and insert:
/* Give sidebar more space. Default widths: - 12.2em as left spacer for the content area. This example is using 14.2em instead. - 11.6em as sidebar width. This example is using 13.6em instead. - 10.9em as width for the search input field. This example is using 12.9em instead. - 150px as left spacer for the Ajax searchbox. This example is using 180px. */ /* move content container more to the right */ #content { margin: 2.8em 0 0 14.2em; } #column-content { margin: 0 0 .6em -14.2em; } #column-content #content { margin-left: 14.2em !important; /* adjustment for IE (7) */ } /* redefine sidebar width + tab bar position */ .portlet { width: 13.6em; } #p-cactions { left: 13.6em; /* tab bar */ } /* search input field */ #qsearch__in { width: 12.9em; } /* ajax "matching pagename" searchbox */ #qsearch__out { left: 180px }
Thanks to SteRe for this.
Store your background image as /user/background.jpg
, open /user/screen.css
and insert:
html { background-color: #f9f9f9; } body { background: #f9f9f9 url(user/background.jpg) 0 0 no-repeat; }
If needed, replace the color #f9f9f9
with a value fitting your needs.
ATTENTION: This hack needs monobook version 2010-05-29
or newer! Older ones do not work!
Little intro: before I began using the monobook template I used dokubrick, this had a different quicksearch, integrating it into the right side menu. In monobook I didn't like the quicksearch, that little screen floating over the text… So I made an alteration, integrating it into the left side of monobook. To do this you need open /user/screen.css
and insert:
#qsearch__out { position: static !important; font-size: 85% !important; background: __background__ !important; margin-top: 0 !important; margin-bottom: 0.5em; width: 12.2em; display: none; border: 1px solid #aaa; padding: 0 .8em .3em .5em; }
— Theo
Open /user/screen.css
and insert:
div#content .dokuwiki code { white-space: pre; }
Open /user/screen.css
and insert:
/* background color of normal wiki pages */ .ns-0 #content, .ns-0 #p-cactions li, .ns-0 #p-cactions li a, .ns-0 #p-cactions .selected, .ns-0 #p-cactions .selected a, .ns-0 #p-cactions .selected span { background: #F8FCFF; } /* background color of "special" wiki pages (e.g. edit, discussion, cite...) */ .ns-1 #content, .ns-1 #p-cactions li, .ns-1 #p-cactions li a, .ns-2 #content, .ns-2 #p-cactions li, .ns-2 #p-cactions li a { background: #F8FCFF; } /* background color of Tabs while hover */ .ns-0 #p-cactions li a:hover, .ns-0 #p-cactions .selected a:hover, .ns-1 #p-cactions li a:hover, .ns-2 #p-cactions li a:hover { background: #C5E6FF; } /* background color of Sitebar Boxes */ .pBody { background-color: #FFEDDF; } /* background color of Sitebar Searbox */ #p-search .pBody { background-color: #FFDFE1; }
If needed, replace the colors #F8FCFF
, #C5E6FF
, #FFEDDF
and/or #FFDFE1
with values fitting your needs. Thanks to marsmond for idea and initial work.
Open /user/screen.css
and insert:
/* TOC and TOC header background */ div.dokuwiki div.tocheader, div.dokuwiki span.toc_open, div.dokuwiki span.toc_close, div.dokuwiki #toc__inside { background-color: #FF0000; } div.dokuwiki span.toc_open, div.dokuwiki span.toc_close { border-color: #FF0000 !important; } /* TOC header: css arrow */ div.dokuwiki span.toc_open { border-top-color: #AA00FF !important; } div.dokuwiki span.toc_close { border-bottom-color: #AA00FF !important; }
Replace the colors #FF0000
and/or #AA00FF
with values fitting your needs for the table of contents (TOC). You can strip the “TOC header: css arrow” if you won't change the arrow color.
Open /user/screen.css
and insert:
/* <code> and <file> blocks */ div#content .dokuwiki pre.code, div#content .dokuwiki pre.file { background-color: #AA00FF; } /* tab of <file> block */ div#content .dokuwiki dl.file dt, div#content .dokuwiki dl.code dt { background-color: #AA00FF; border-color: #AA00FF; }
Replace the color #AA00FF
with a values fitting your needs.
I had a problem where after making some adjustments the Wiki basically was not viewable via mobile. I found an easy fix for this by adjusting one number in the template.
Using FTP find echo “<meta name=\”viewport\“ content=\”width=device-width,initial-scale=1\“ />”; and change the scale to .25. This fixed the problem with me and now the site looks somewhat normal via mobile.
You, sir, win the internets for the mobile browsing fix.
Older releases are no longer recommended for usage and are listed for reference only.
monobook version | Download | Designed for and tested on DokuWiki | Release notes and comments |
---|---|---|---|
2014-02-09 | Release No update archive anymore, the new tar.gz is used for both install and update. | 2013-12-08 “Binky”, 2012-10-13 “Adora Belle” | Fixed bug, un-savable configuration on 2013-12-08 “Binky”; Full support for DokuWiki 2013-12-08 “Binky”; Update support and contact information. |
2013-11-17 | Release Update | rc2013-10-28 “Binky”, 2012-10-13 “Adora Belle” | Full support for DokuWiki rc2013-10-28 “Binky”; Add Korean and Chinese (simplified) language files; Update support and contact information. |
2013-02-20 | Release Update | 2012-10-13 “Adora Belle”, 2012-01-25b “Angua” | Added Chinese (as used in Taiwan) language. |
2012-10-17 | Release Update | 2012-10-13 “Adora Belle”, 2012-01-25b “Angua” | Small improvements: better SSL/HTTPS handling for the QR Code feature; fixed XHTML error (id-conflict). |
2012-10-14 | Release Update | 2012-10-13 “Adora Belle”, 2012-01-25b “Angua” | Full support for DokuWiki 2012-10-13 “Adora Belle”; New option: monobook_qrcodebox (controls if a box with a QR Code of current wiki page URL will be shown in the sidebar); Multilingual side-wide and copyright notices for Translation plugin users (cf. commit message). |
2011-12-10 | Release Update | rc2011-11-10 “Angua RC1”, 2011-05-25a “Rincewind” | Added fix for wrong horizontal rule clearing (---- / <hr> -Tag) |
2011-11-29 | Release Update | rc2011-11-10 “Angua RC1”, 2011-05-25a “Rincewind” | Full support for DokuWiki's new Media Manager; Multilingual navigation for Translation plugin users; Apple Touch Icon support (see README for details). |
2011-05-10 | Release Update | rc2011-05-08 “Rincewind RC2”, 2010-11-07 “Anteater”, 2009-12-25 “Lemming” | Cross browser compatibility fixes. |
2011-05-04 | Release Update | rc2011-04-22 “Rincewind RC1”, 2010-11-07 “Anteater”, 2009-12-25 “Lemming” | Improved media manager, added Russian and Esperanto language, hide breadcrumbs in mediamanager. |
2011-03-17 | Release Update | 2010-11-07 “Anteater”, 2009-12-25 “Lemming” | Added Polish language, plugin compatibility improvements (CSS): bureaucracy and some others. |
2011-03-16 | Release Update | 2010-11-07 “Anteater”, 2009-12-25 “Lemming” | Improved Anteater compatibility; Switched css base from 'default' template to 'starter' template (→ reason). |
2010-08-17 | Release Update | 2009-12-25 “Lemming” | Added /user/tracker.php to make web analytics software integration easier; CSS fixes for lists and TOC; some minor bugfixes. |
2010-06-29 | Release Update | 2009-12-25 “Lemming” | New config options (user pages optional, closed wiki - most tabs/boxes will be hidden until user is logged in if active). Template respects $conf['disableactions'] . Improved translation plugin integration (now placed at sidebar). Language names are taken from title attribute (→ introduced in newer plugin versions), so you may have to update the plugin for best optical results. Support for PNG favicon. Many many improvements. |
2010-06-02 | Release Update | 2009-12-25 “Lemming” | Added Spanish language, fixed Italian language (settings), added workaround for “jumping textarea” in MSIE8. |
2010-05-29 | Release Update | 2009-12-25 “Lemming” | Added Dutch language, added Brazilian Portuguese language, TOC position now configurable, removed “access denied” messages for included pages, some bugfixes. |
2010-01-20 | Release Update | 2009-12-25 “Lemming” | Added Norwegian language, updated Japanese and French language, added workaround for PHP Bug #49692. |
2010-01-19 | Release Update | 2009-12-25 “Lemming” | Configurable boxes (left column), optional “full screen” media manager (see config), Japanese language, some bugfixes. |
2010-01-13 | Release Update | 2009-12-25 “Lemming” | Configurable footer buttons, Italian language, some bugfixes. |
2010-01-12 | Release | 2009-12-25 “Lemming” | First version released by new maintainer (Andreas Haerter), rewrite of the no longer maintained monobook by Terence J. Grant. |
Pre 2010-01-12 | — | ≤ 2009-02-14 | All older versions were maintained and developed by Terence J. Grant. There will be no more support for them, please follow the update instructions to get a supported version. If you have to run a DokuWiki version older than 2009-12-25 “Lemming” (for whatever reason) and therefore still have to use an outdated monobook version, the archived legacy monobook content may be interesting. |
For a complete change log, see the commits on Github.
monobook/conf/default.php
. I consider this a severe privacy issue. — kp 2015-07-24 23:32All versions >=2010-01-12 are heavily inspired and partially based on the great work done by Terence J. Grant. He developed the template from 2006 until the end of 2009 but did not have enough time to maintain it any longer. Thank you for your work and your ideas!
For a complete listing, see the enclosed CREDITS file.
Feel free to add yours here:
.dist
extension/lib/tpl/monobook/user/screen.css
influences normal layout; /lib/tpl/monobook/user/print.css
influences print layout, /lib/tpl/monobook/user/rtl.css
influences “right-to-left” languages like Hebrew/monobook/user/