{"id":28567072,"url":"https://github.com/foundata/dokuwiki-template-monobook","last_synced_at":"2025-10-12T19:13:39.644Z","repository":{"id":45474572,"uuid":"832375","full_name":"foundata/dokuwiki-template-monobook","owner":"foundata","description":"\"monobook\" brings you the traditional MediaWiki/Wikipedia look and feel for DokuWiki.","archived":false,"fork":false,"pushed_at":"2022-09-13T10:03:09.000Z","size":676,"stargazers_count":18,"open_issues_count":18,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-06T11:48:33.522Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.dokuwiki.org/template:monobook","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/foundata.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-08-11T23:46:51.000Z","updated_at":"2025-06-04T16:49:27.000Z","dependencies_parsed_at":"2023-01-18T06:00:59.584Z","dependency_job_id":null,"html_url":"https://github.com/foundata/dokuwiki-template-monobook","commit_stats":null,"previous_names":["foundata/dokuwiki-template-monobook"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foundata%2Fdokuwiki-template-monobook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foundata%2Fdokuwiki-template-monobook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foundata%2Fdokuwiki-template-monobook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foundata%2Fdokuwiki-template-monobook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/foundata","download_url":"https://codeload.github.com/foundata/dokuwiki-template-monobook/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foundata%2Fdokuwiki-template-monobook/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259104360,"owners_count":22805862,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-10T15:40:33.568Z","updated_at":"2025-10-12T19:13:34.603Z","avatar_url":"https://github.com/foundata.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n  I. About\n\n    \"monobook\" brings you the traditional MediaWiki/Wikipedia look and feel for\n    DokuWiki.\n\n    Website:     \u003chttps://www.dokuwiki.org/template:monobook\u003e\n    Maintainer:  ARSAVA \u003chttps://dev.arsava.com/\u003e\n    Contact:     See \"IV. Support\" and \"V. Contact\".\n\n    It is heavily inspired and partially based on the great \"Monobook for\n    DokuWiki\" template, originally maintained by Terence J. Grant [1] from 2006\n    until the end of 2009.\n\n    [1] \u003chttp://tjgrant.com/\u003e\n\n\n\n  II. Installation and update\n\n    The installation works as described [1] on DokuWiki.org. Extract the\n    downloaded archive into your DokuWiki's \"lib/tpl/\" folder. Then select the\n    template in the Config Manager by adjusting the template option.\n\n    See the monobook template website for update instructions [2].\n\n    [1] \u003chttps://www.dokuwiki.org/template\u003e\n    [2] \u003chttps://www.dokuwiki.org/template:monobook#update\u003e\n\n\n\n  III. Customizing the template\n\n    In order to make updates of your installed \"monobook\" template easy, follow\n    these hints for customizing the template:\n\n    - Place your files in \"monobook/user\"\n      The place to store *all* user-defined, custom stuff is the \"monobook/user\"\n      directory because your files will not be touched or overwritten on\n      template updates! So you normally can copy all new files into \"monobook/\"\n      to update the template without loosing your changes.\n      Note: There are example files helping you modifying the template.\n            The are delivered with the \".dist\" extensions. Just remove the\n            \".dist\" extension to use them.\n\n    - Own logo\n      If you want to replace the default logo showed in the upper left, simply\n      create a \"logo.[png|gif|jpg]\" in \"monobook/user\". The template recognizes\n      the file automatically and will use it instead of the default logo.\n      Note: Do not forget to empty your browser's cache if you cannot see any\n            effect.\n\n    - Own favicon\n      If you want to replace the default favicon, simply create a \"favicon.ico\"\n      in \"monobook/user\". The template recognizes the file automatically and\n      will use it instead of the default one. You might find the online FavIcon\n      Generator [1] useful.\n      Note: \"favicon.png\" is also possible but not recommended (because it is\n            not supported by older MSIE versions).\n\n    - Own CSS\n      To apply additional CSS rules, create a\n        - \"monobook/user/screen.css\" file to influence the normal layout. You\n          can rename the \"screen.css.dist\" to \"screen.css\" as starting point.\n        - \"monobook/user/print.css\" file to influence the print layout. You\n          can rename the \"print.css.dist\" to \"print.css\" as starting point.\n        - \"monobook/user/rtl.css\" file to influences \"right-to-left\" languages\n          like Hebrew. You can rename the \"rtl.css.dist\" to \"rtl.css\" as\n          starting point.\n      The file(s) will be included automatically (as the last ones for the\n      relevant media, therefore you are able to overrule existing styles).\n      Note: Do not forget to empty your browser's cache if you cannot see any\n            effect.\n\n    - Own JavaScript\n      To load additional JavaScript, create a \"monobook/user/user.js\" file. You\n      can rename the \"user.js.dist\" to \"user.js\" as starting point (it contains\n      some examples and useful comments how to define your own JavaScript).\n      ATTENTION: You have to activate the template option \"monobook_loaduserjs\"\n                 (-\u003e\"Load 'monobook/user/user.js'?\") in the DokuWiki Config\n                 Manager!\n\n    - Own CSS, language specific\n      To apply additional CSS rules only for a specific language, edit/create\n      \"monobook/lang/\u003cyour-language\u003e/style.css\". This file will be included\n      automatically if DokuWiki runs/shows a page in the language of choice (as\n      the last one, therefore you are able to overrule existing styles).\n      Note: Do not forget to empty your browser's cache if you cannot see any\n            effect.\n\n    - Own tabs\n      To apply own tabs, create a \"monobook/user/tabs.php\" file. You can rename\n      the \"tabs.php.dist\" to \"tabs.php\" as a good starting point (it contains\n      some examples and useful comments how to define your own tabs). If you\n      still have questions after playing with the examples, see \"IV. Support\"\n      on how to get help.\n\n    - Own footer buttons\n      To apply own buttons/graphics in the footer (-\u003e these small 80x15 pics),\n      create a \"monobook/user/buttons.php\" file. You can rename the\n      \"buttons.php.dist\" to \"buttons.php\" as a good starting point (it contains\n      some examples and useful comments how to define your own buttons). If you\n      still have questions after playing with the examples, see \"IV. Support\"\n      on how to get help.\n\n    - Own boxes\n      To apply own boxes in the left column/sidebar, create a\n      \"monobook/user/boxes.php\" file. You can rename the \"boxes.php.dist\" to\n      \"boxes.php\" as a good starting point (it contains some examples and useful\n      comments how to define your own boxes). If you still have questions after\n      playing with the examples, see \"IV. Support\" on how to get help.\n\n    - Web analytics software (Piwik, Google Analytics etc.)\n      Tools like Piwik and Google Analytics normally provide a small code\n      snippet (\"tag\") which you have to include at your website to make\n      everything work. If you want to use such software with this template,\n      create a \"monobook/user/tracker.php.dist\". You don't have to deliberate\n      where you have to copy and  paste the code, simply do it there. You can\n      rename the \"tracker.php.dist\" to \"tracker.php\" as a good starting point\n      (it contains some examples and useful comments how to define your own\n      boxes).\n\n    - Own Apple Touch Icon\n      If you want to replace the default Apple Touch Icon, simply create a\n      \"apple-touch-icon.png\" in \"monobook/user\". The template recognizes the\n      file automatically and will use it instead of the default one. Have a look\n      at Apple's developer database (cf. \"Configuring Web Applications\" [2]) if\n      you need more information.\n\n    [1] \u003chttp://tools.dynamicdrive.com/favicon/\u003e\n    [2] \u003chttp://j.mp/sx3NMT\u003e\n\n\n\n  IV. Support\n\n    If you need help, check the FAQ [1] and try to find useful information by\n    using the DokuWiki Search page [2]. If you found nothing helpful, ask your\n    question at the DokuWiki forum [3] (preferred) or IRC channel [4].\n\n    [1] \u003chttps://www.dokuwiki.org/template:monobook#faq\u003e\n    [2] \u003chttp://search.dokuwiki.org/\u003e\n    [3] \u003chttps://forum.dokuwiki.org/\u003e\n    [4] \u003chttps://www.dokuwiki.org/irc\u003e\n\n\n\n  V. Contact\n\n    If you think you have found a bug or have a useful idea (a.k.a. \"feature\n    request\"), create an issue [1] on GitHub (preferred), or contact us by\n    mail [2].\n\n    Feel free to submit patches as GitHub pull requests (preferred) or by mail\n    as well. However, please try to respect the DokuWiki coding style [3] as\n    this template follows its rules.\n\n    [1] \u003chttps://github.com/arsava/dokuwiki-template-monobook/issues\u003e\n    [2] ARSAVA \u003cdokuwiki@dev.arsava.com\u003e\n    [3] \u003chttps://www.dokuwiki.org/devel:coding_style\u003e\n\n\n\n  VI. Other notes\n\n    If you like this free project, you might buy us a coffee [1], or get some\n    cool QR Code merchandise [2]. Thank you! :-)\n\n    Do not hesitate to contact ARSAVA [3] if you need professional DokuWiki\n    support, training or if you think we are the ones to get your project done.\n\n    [1] \u003chttps://donate.arsava.com/dokuwiki-template-monobook/\u003e\n    [2] \u003chttp://goqr.me/\u003e\n    [3] \u003chttps://dev.arsava.com/\u003e\n\n\n\n  VII. Explanatory notes about the dirs of this template\n\n    - \"monobook/conf\"\n      Contains some configuration files (do NOT edit them!), especially\n        - default.php: default settings [1]\n        - metadata.php: configuration metadata [2]\n\n    - \"monobook/lang\"\n      Language files (subdir names = language code). You may copy the English\n      language files and translate them if your language is missing. Simply send\n      us the translated files (cf. \"V. Contact\") and I will include them in the\n      next release :-D.\n\n    - \"monobook/static\"\n      Static files (images, CSS, JavaScript). The interesting stuff is located\n      in subdirs (as described below).\n      - \"3rd\"\n        Static files originally taken from a third party like MediaWiki or\n        DokuWiki. The subdir \"dokuwiki\" contains files originally taken from the\n        DokuWiki \"default\" or \"starter\" template. The subdir \"monobook\" contains\n        files taken from the MediaWiki \"monobook\" skin.\n      - \"css\"\n        All non-3rd-party Cascading Style Sheets (CSS). See my tutorial [3] for\n        more information about how the CSS is handled.\n      - \"img\"\n        All non-3rd-party images files.\n      - \"js\"\n        All non-3rd-party JavaScript files.\n\n    - \"monobook/user\"\n      Place for userdefined stuff. E.g. if you want use an own logo, simply copy\n      a logo.[png|gif|jpg] in here. See \"III. Customizing the template\" for\n      details.\n\n    [1] \u003chttps://www.dokuwiki.org/devel:configuration#default_settings\u003e\n    [2] \u003chttps://www.dokuwiki.org/devel:configuration#configuration_metadata\u003e\n    [3] \u003chttp://j.mp/eq8zSo\u003e\n\n\n\n  VIII. Creation transcript\n\n    Some developers may find this interesting. Additionally, I am very oblivious\n    :-P.\n\n    After some discussion and a quick release as \"monodoku\", this template was\n    renamed to \"monobook\" to replace the existing \"Monobook for DokuWiki\" by\n    Terence J. Grant because Terence got no more time for maintenance (BTW:\n    Terence, thank you for your work and your great(!) ideas I got from your\n    \"Monobook for DokuWiki\"). To cut a long story short: you may call this\n    template a rewrite/successor of Terence J. Grant's \"Monobook for DokuWiki\".\n\n    There are some reasons for a complete rewrite (instead of improving/patching\n    Terence J. Grant's one), let me explain the initial situation:\n    - \"monobook\" is a wide-spread skin for the MediaWiki-Software. It is also\n      used by Wikipedia right now (Jan 2010).\n    - Terence J. Grant created \"monobook for DokuWiki\". He emulated some missing\n      MediaWiki features within the DokuWiki environment with his template\n      (e.g.: discussion pages) - he did a great job! The styles themselves are a\n      relatively hard copy of the original \"monobook\" css- and js-files from\n      MediaWiki's \"monobook\" and the Wikipedia website. IMHO Terence had quick\n      updates in mind when doing this (means: when Wikipedia is updating its\n      styles, he might just want to copy the static stuff, comment out some\n      lines and the \"porting\" would be done). You will find some information\n      about his actions in the README of the replaced \"monobook for DokuWiki\"\n      by Terence J. Grant.\n    - Terence J. Grant does not have enough time for maintenance (as he said on\n      his website at the end of 2009). Additionally, the roughly wrapped\n      Wikipedia/monobook-styles and the structure were makinging some trouble:\n      - The styles were bloated (-\u003e they are not designed for DokuWiki, most\n        styles are simply not used plus they are specialized for Wikipedia's\n        websites, not even MediaWiki in special).\n      - Hardcoded URLs within some css-files were resulting in problems in SSL\n        environments (-\u003e loading unencrypted content from\n        http://upload.wikimedia.org... additionally, calling third party hosts\n        is bad behaviour + LAN-only environments simply will not get needed\n        files).\n      - The styles.ini was not used, leading to *much* bigger stylesheets and\n        much more HTTP requests because some nice DokuWiki features were not\n        used and/or \"Monobook for DokuWiki\" was not compatible to (-\u003e \"Compact\n        CSS and javascript output\").\n     - Terence J. Grant's template needed the \"Display Wiki Page\"-plugin (which\n       is/was developed by him, too). Right now, this is simply not needed\n       anymore: DokuWiki got a core function named \"tpl_include_page()\" to do\n       this.\n    That is why I decided to take the great ideas plus some lines of code of\n    Terence J. Grant's \"monobook for DokuWiki\" to rewrite it, following the\n    official DokuWiki template structure guidelines.\n    The downside of this desicion is, that if Wikipedia updates its styles,\n    reverse engineering instead of simple file copying is needed if the new\n    rules should be applied. But I think this is not really dramatic because\n    not every pinch of change should be ported (and if Wikipedia would get a\n    completely new layout, a new DokuWiki template should be created instead\n    of forcing people to decide: a) not using updates or b) using a style the\n    might not like). I want an optical, not a technical clone.\n\n    - Installed DokuWiki (Release \"2009-12-25\", \"Lemming\") + Terence J. Grant's\n      \"monobook\" template for testing purpose.\n\n    - Copied the default template from DokuWiki (Release \"2009-12-25\") as\n      mentioned at \u003chttps://www.dokuwiki.org/devel:templates\u003e and renamed the\n      copy to \"monobook\". Afterwards, the following files/dirs where deleted:\n      - monobook/images\n      - monobook/_admin.css\n      - monobook/design.css\n      - monobook/footer.html\n      - monobook/layout.css\n      - monobook/_linkwiz.css\n      - monobook/media.css\n      - monobook/print.css\n      - monobook/rtl.css\n\n    - Created the dirs mentioned in \"II. Some notes about the dirs of this\n      template\".\n\n    - Created \"index.html\" files in all subdirs of the template to prevent\n      directory browsing. Plus \"deny from all\" .htaccess files in all relevant\n      template subdirs containing PHP (this is simply some ADDITIONAL security\n      precaution - everything should also be save without these files. But\n      better safe than sorry).\n\n    - Configured DokuWiki to use Terence J. Grant's \"monobook\" template to\n      determine which styles/files copied from the MediaWiki monobook and/or\n      Wikipedia are really in use (after looking and understanding the template\n      itself, for sure).\n      The interesting folders (as mentioned in the README by Terence J. Grant):\n      - common is from mediawiki\n      - monobook is from mediawiki\n      - wikipedia is from wikipedia\n      After this, I looked at \"monobook/lang/*\" and \"monobook/conf*\" (from\n      Terence J. Grant's \"monobook\") to take some ideas.\n\n    - After investigation, some files were copied into the provided places\n      within \"/monobook/static/3rd\":\n\n      - The following 3rd-party styles and files were used/are needed for\n        further development and therefore were copied from Terence J. Grant's\n        \"monobook\" template:\n        - /monobook/monobook/buttonshadow.png\n        - /monobook/monobook/bullet.gif\n        - /monobook/monobook/discussionitem_icon.gif\n        - /monobook/monobook/external.png\n        - /monobook/monobook/file_icon.gif\n        - /monobook/monobook/headbg.jpg\n        - /monobook/monobook/IE50Fixes.css\n        - /monobook/monobook/IE55Fixes.css\n        - /monobook/monobook/IE60Fixes.css\n        - /monobook/monobook/IE70Fixes.css\n        - /monobook/monobook/IEMacFixes.css\n        - /monobook/monobook/lock_icon.gif\n        - /monobook/monobook/main.css\n        - /monobook/monobook/news_icon.gif\n        - /monobook/monobook/rtl.css\n        - /monobook/monobook/user.gif\n      - The following files were copied from Andreas Gohr's \"default\" template:\n        - /default/*.css (see \u003chttp://j.mp/eq8zSo\u003e why I did that)\n        - /default/images/closed.gif\n        - /default/images/favicon.ico\n        - /default/images/open.gif\n        - /default/images/tocdot2.gif\n      - The following files were copied from Anika Henke's's \"starter\" template:\n        - /starter/images/external-link.png\n        - /starter/images/unc.png\n        - /starter/images/email.png\n      - The following files were downloaded from Wikipedia\n        - http://de.wikipedia.org/skins-1.5/common/IEFixes.js\n        - http://de.wikipedia.org/skins-1.5/common/commonPrint.css\n\n    - Edited \"monobook/static/3rd/monobook/main.css\"\n      - All url() rules were edited (-\u003e \"static/3rd/...\").\n      - \"#catlinks\" was replaced with \".catlinks\" because the styles are needed\n        for more than one element.\n      To make this clear, a comment was added at the top of the files.\n\n    - Edited \"monobook/static/3rd/dokuwiki/design.css\"\n      All url() rules were edited (-\u003e replaced \"url(images/\" through\n      \"url(static/3rd/dokuwiki/\").\n      To make this clear, a comment was added at the top of the files.\n\n    - Edited \"monobook/static/3rd/monobook/IE60Fixes.css\"\n      - \"#catlinks\" was replaced with \".catlinks\" because the styles are needed\n        for  more than one element. To make this clear, a comment was added at\n        the top of the files.\n\n    - Created\n      - \"monobook/static/css/print.css\"\n      - \"monobook/static/css/rtl.css\"\n      - \"monobook/static/css/screen.css\"\n      All relevant information should be found within the inline comments.\n\n    - Created the \"main.php\" for \"monobook\". Used the main.php of the \"default\"\n      template as base (as mentioned on the DokuWiki template developer sites),\n      and doing some cherry picking on the Terence J. Grant's \"monobook\"\n      main.php. After few hours and some coffees later, work was done.\n\n    - Placed the obligatory 80x15 buttons in \"/static/img\". I copied them\n      from the \"default\" DokuWiki template (exept \"button-monobook.png\", for\n      sure). Added the needed markup in the \"main.php\".\n\n    - Took Andreas Gohr's original \"mediamanager.php\" and \"detail.php\" out of\n      the \"default\" template. After working a little bit, I found a way to\n      prevent additional work and/or redundant code to realize the output of\n      these files. Everything is described through the PHP comments in the\n      files... look at them if needed. I mainly choose the same way like\n      Terence J. Grant.\n\n    - Copied the \"do_cite.php\" from Terence J. Grant's \"monobook\", renamed it to\n      \"inc_cite.php\", and edited everything until it was useful for my template.\n\n    - Worked worked worked.... and done! :-P\n\n    - After ~1 year, I switched the CSS base from DokuWiki's default template\n      to \u003chttps://www.dokuwiki.org/template:starter\u003e. See \u003chttp://j.mp/f7V4ES\u003e\n      for more information about this. I edited some files, see\n      \"monobook/static/3rd/dokuwiki/00_starter-tmpl-notes.txt\" for details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoundata%2Fdokuwiki-template-monobook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoundata%2Fdokuwiki-template-monobook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoundata%2Fdokuwiki-template-monobook/lists"}