DokuWiki

It's better when it's simple

User Tools

Site Tools


template:mnml-blog

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
template:mnml-blog [2013-02-20 12:59] – Move GitHub downloads (they are deprecated, see https://github.com/blog/1302-goodbye-uploads) Andreastemplate:mnml-blog [2023-10-31 00:30] (current) Klap-in
Line 1: Line 1:
 ====== mnml-blog Template ====== ====== mnml-blog Template ======
- 
- 
  
 ---- template ---- ---- template ----
-Author_mail   dokuwiki@dev.syn-systems.com SYN Systems +description   : Clean and minimalist template, suitable for blogging with the BlogTNG plugin 
-Description:    Clean and minimalist template, suitable for blogging with the BlogTNG plugin +author        ARSAVA 
-LastUpdate_dt 2011-12-09 +email         : dokuwiki@dev.arsava.com 
-Compatible    2010-11-07 "Anteater"2011-05-25 "Rincewind"2012-01-25 "Angua+lastupdate    : 2014-02-09 
-Template_tags:  minimalistminimalblogcleanBlogTNGbloggingweblog +compatible    : Anteater, Rincewind, Angua, Adora BelleWeatherwaxBinkyPonder StibbonsHrunDetritus 
-Screenshot_img: http://img27.imageshack.us/img27/794/dokuwikitemplatemnmlblo.png+depends       :  
 +conflicts     :  
 +similar       :  
 +screenshot_img: http://img27.imageshack.us/img27/794/dokuwikitemplatemnmlblo.png 
 +tags          : minimal, blog, clean
  
-downloadurl:    http://andreas-haerter.com/downloads/dokuwiki-template-mnml-blog/latest +downloadurl   https://andreashaerter.com/downloads/dokuwiki-template-mnml-blog/latest 
-bugtracker    https://github.com/syn-systems/dokuwiki-template-mnml-blog/issues +bugtracker    https://github.com/arsava/dokuwiki-template-mnml-blog/issues 
-sourcerepo    https://github.com/syn-systems/dokuwiki-template-mnml-blog/ +sourcerepo    https://github.com/arsava/dokuwiki-template-mnml-blog/ 
-donationurl:    http://syn-systems.com/donate/dokuwiki-template-mnml-blog/ +donationurl   : http://donate.andreas-haerter.com/dokuwiki-template-mnml-blog/ 
-----+---- 
  
-^ :!: DokuWiki 2012-09-10 "Adora Belle" RC1 introduced [[:changes#release_candidate_1_-_2012-09-10_adora_belle|markup changes]] (especially regarding the Table of Contents). Many template (including this one) have to be changed before you can use them with DokuWiki 2012-09-10. I am working on an update, please wait until it is released before upgrading your DokuWiki. :!: ^ 
 ===== About ===== ===== About =====
  
 "mnml-blog" is a clean and minimalist template for DokuWiki. It is designed to use DokuWiki with the [[plugin:blogtng|BlogTNG plugin]] as blogging software. The name means "minimalist blog", and it was created for [[http://blog.andreas-haerter.com/|Andreas Haerter's personal weblog]]. "mnml-blog" is a clean and minimalist template for DokuWiki. It is designed to use DokuWiki with the [[plugin:blogtng|BlogTNG plugin]] as blogging software. The name means "minimalist blog", and it was created for [[http://blog.andreas-haerter.com/|Andreas Haerter's personal weblog]].
  
-  * Maintainer: [[http://syn-systems.com/|SYN Systems]].+  * Maintainer: [[https://dev.arsava.com/|ARSAVA]] ([[https://andreashaerter.com/|Andreas Haerter]])
   * Contact: See "[[.:mnml-blog#support|Support]]" and "[[.:mnml-blog#contact|Contact]]".   * Contact: See "[[.:mnml-blog#support|Support]]" and "[[.:mnml-blog#contact|Contact]]".
  
 +===== Download =====
 +
 +:!: If you like the template, you might want to [[http://donate.andreas-haerter.com/dokuwiki-template-mnml-blog/|donate]] a few bucks, or get some cool [[http://goqr.me/|QR Code]] merchandise. It is a lot of work. Thank you! :-)
  
-===== Download ======+^ Version   | ''2014-02-09''                                                                                           | 
 +Download  | [[https://andreashaerter.com/downloads/dokuwiki-template-mnml-blog/latest|2014-02-09_mnml-blog.tar.gz]]  |
  
-:!: If you like the templateyou might want to [[http://syn-systems.com/donate/dokuwiki-template-mnml-blog/|donate]] a few bucksor get some cool [[http://goqr.me/|QR Code]] merchandiseIt is a lot of workThank you! :-)+  * **Note for existing users**Since ''2014-02-09''there is no separate update ''.tar.gz'' anymoreThe current archive is used for both install and update now. Instead of providing a separate update archive without the ''/user'' sub-directoryall example files in ''/user'' are delivered with the ''.dist'' extensions now to make sure your files won't get overwrittenThis should be easier an more DokuWiki-like than the previous approach.
  
-=== Latest release ===+=== Important release notes for 2014-02-09 ===
  
-^ Version          | ''2011-12-09''                                                                                          | +  * :!: Fixed a major bug, the configuration option were un-savable on DokuWiki 2013-12-08 "Binky" 
-^ Download         | [[http://andreas-haerter.com/downloads/dokuwiki-template-mnml-blog/latest|2011-12-09_mnml-blog.tar.gz]] |+  * Full support for DokuWiki 2013-12-08 "Binky". 
 +  * There is no separate update archive anymore.
  
-=== Latest update ===+=== Important release notes for 2013-11-17 ===
  
-^ From             | Any [[template:mnml-blog#how_can_i_check_which_version_is_currently_installed|version]]                               | +  * Full support for DokuWiki rc2013-10-28 "Binky".
-^ To               | ''2011-12-09''                                                                                                        | +
-^ Download         | [[http://andreas-haerter.com/downloads/dokuwiki-template-mnml-blog/latest-update|2011-12-09_mnml-blog-update.tar.gz]] |+
  
 === Repository (for developers) === === Repository (for developers) ===
  
-The source code of this template is available as [[https://github.com/syn-systems/dokuwiki-template-mnml-blog/tree/master|Git repository]]. You may find the text "[[http://blog.andreas-haerter.com/2011/03/16/how-to-create-a-maintainable-dokuwiki-template|How to create an easily maintainable DokuWiki template]]" useful, too.+The source code of this template is available as [[https://github.com/arsava/dokuwiki-template-mnml-blog/tree/master|Git repository]]. You may find the text "[[http://blog.andreas-haerter.com/2011/03/16/how-to-create-a-maintainable-dokuwiki-template|How to create an easily maintainable DokuWiki template]]" useful, too.
  
 === Verify download (for geeks) === === Verify download (for geeks) ===
  
-See ''[[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/CHECKSUMS.asc|CHECKSUMS.asc]]'' for MD5, SHA-1 and SHA-256 checksums. The file is signed with the GnuPG/PGP key (''[[http://andreas-haerter.com/contact/gpg-public-key|0x423B2839]]''). You can use ''<nowiki>gpg --verify ./CHECKSUMS.asc</nowiki>'' to check/validate it.+See ''[[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/CHECKSUMS.asc|CHECKSUMS.asc]]'' for MD5, SHA-1 and SHA-256 checksums. The file is signed with the GnuPG/PGP key (''[[https://andreashaerter.com/contact/gpg-public-key|0x423B2839]]''). You can use ''<nowiki>gpg --verify ./CHECKSUMS.asc</nowiki>'' to check/validate it.
  
- +===== Installation =====
-===== Installation ======+
  
 ^ This template is designed for the usage with the [[plugin:blogtng|BlogTNG plugin]] //only// (it may work for other purposes, but I do not test or support anything else)! You may find "[[http://blog.andreas-haerter.com/2011/05/15/how-to-create-a-dokuwiki-blog-blogtng-plugin|How to create a DokuWiki based blog (BlogTNG plugin)]]" useful to get everything started. ^ ^ This template is designed for the usage with the [[plugin:blogtng|BlogTNG plugin]] //only// (it may work for other purposes, but I do not test or support anything else)! You may find "[[http://blog.andreas-haerter.com/2011/05/15/how-to-create-a-dokuwiki-blog-blogtng-plugin|How to create a DokuWiki based blog (BlogTNG plugin)]]" useful to get everything started. ^
- 
  
   - Refer to [[:template]] on how to do the basic install and use templates in DokuWiki. For updating, see [[.:mnml-blog#update|below]].   - Refer to [[:template]] on how to do the basic install and use templates in DokuWiki. For updating, see [[.:mnml-blog#update|below]].
Line 60: Line 62:
   - Look where the option "mnmlblog_newpostform_location" (-> "Use following wiki page for the '''<nowiki><blog newform></nowiki>''' form") points to (default is '':wiki:create_new_blogpost'') and create a wiki ''<nowiki><blog newform></nowiki>'' page there (the "New Post" link at the bottom right of the footer is using this link). See [[plugin:blogtng|BlogTNG]] for details.   - Look where the option "mnmlblog_newpostform_location" (-> "Use following wiki page for the '''<nowiki><blog newform></nowiki>''' form") points to (default is '':wiki:create_new_blogpost'') and create a wiki ''<nowiki><blog newform></nowiki>'' page there (the "New Post" link at the bottom right of the footer is using this link). See [[plugin:blogtng|BlogTNG]] for details.
   - Create a header or sidebar navigation. Have a look at "[[.:mnml-blog#what_are_these_please_fill_or_disable_this_placeholder_pagename_everywhere|What are these "Please fill or disable this placeholder ([pagename])" everywhere?]]" to get help.   - Create a header or sidebar navigation. Have a look at "[[.:mnml-blog#what_are_these_please_fill_or_disable_this_placeholder_pagename_everywhere|What are these "Please fill or disable this placeholder ([pagename])" everywhere?]]" to get help.
- 
  
 ===== Support ===== ===== Support =====
Line 66: Line 67:
 If you need help: If you need help:
   * Check the [[.:mnml-blog#faq|FAQ]].   * Check the [[.:mnml-blog#faq|FAQ]].
-  * Check the [[https://github.com/syn-systems/dokuwiki-template-mnml-blog#readme|README]].+  * Check the [[https://github.com/arsava/dokuwiki-template-mnml-blog#readme|README]].
   * Use [[http://search.dokuwiki.org]] to find useful information.   * Use [[http://search.dokuwiki.org]] to find useful information.
  
 If you found nothing helpful, ask your question at the [[http://forum.dokuwiki.org/|DokuWiki forum]] (preferred) or [[:irc|IRC channel]]. If you found nothing helpful, ask your question at the [[http://forum.dokuwiki.org/|DokuWiki forum]] (preferred) or [[:irc|IRC channel]].
- 
  
 ===== Contact ===== ===== Contact =====
  
-If you think you have found a bug or have a useful idea (a.k.a. "feature request"), [[https://github.com/syn-systems/dokuwiki-template-mnml-blog/issues|create an issue]] on GitHub (preferred), or contact us by [[dokuwiki@dev.syn-systems.com|mail]].+If you think you have found a bug or have a useful idea (a.k.a. "feature request"), [[https://github.com/arsava/dokuwiki-template-mnml-blog/issues|create an issue]] on GitHub (preferred), or contact us by [[dokuwiki@dev.arsava.com|mail]].
  
 Feel free to submit patches as GitHub pull requests (preferred) or by mail as well. However, please try to respect the [[:devel:coding_style|DokuWiki coding style]] as this template follows its rules. Feel free to submit patches as GitHub pull requests (preferred) or by mail as well. However, please try to respect the [[:devel:coding_style|DokuWiki coding style]] as this template follows its rules.
  
- +===== Update =====
-===== Update ======+
  
 What to do to update your installed mnml-blog template? What to do to update your installed mnml-blog template?
   - First of all: Backup your data, especially ''/lib/tpl/mnml-blog''.   - First of all: Backup your data, especially ''/lib/tpl/mnml-blog''.
-  - Don't be scared. It is no rocket science.+  - Don't be scared. It is not rocket science.
   - Download the current //update// [[.:mnml-blog#download|from above]].   - Download the current //update// [[.:mnml-blog#download|from above]].
-  - Uncompress it and copy it over your current ''/lib/tpl/mnml-blog''. This works without problems when you followed the rules described in the [[https://github.com/syn-systems/dokuwiki-template-mnml-blog#readme|README]] (=> the place for *all* user-defined, custom stuff is ''/lib/tpl/mnml-blog/user''!) cause previously existing files in this directory are simply not included in the update archive (and therefore it can't overwrite anything of your stuff).+  - Simply uncompress and copy it over your current ''/lib/tpl/mnml-blog''. This works without problems when you follow the rules described in the [[https://github.com/arsava/dokuwiki-template-mnml-blog#readme|README]] (=> the place for *all* user-defined, custom stuff is ''/lib/tpl/mnml-blog/user''!) because previously existing files in ''/lib/tpl/monobook/mnml-blog'' will not be touched or overwritten.((except the example files with the ''.dist'' extension))
   - The files in "lib/tpl/mnml-blog/blogtng-tpl" are a BlogTNG data template (see [[plugin:blogtng#templates|BlogTNG templates]] for details).\\ :!: **Please copy these files after a mnml-blog update into all used BlogTNG data template dirs below "lib/plugins/blogtng/tpl".**\\ Hint: By default, there is only "lib/plugins/blogtng/tpl/default". You may overwrite the existing files in there (:!: but remember: you have to do this again on every BlogTNG-Update then!).   - The files in "lib/tpl/mnml-blog/blogtng-tpl" are a BlogTNG data template (see [[plugin:blogtng#templates|BlogTNG templates]] for details).\\ :!: **Please copy these files after a mnml-blog update into all used BlogTNG data template dirs below "lib/plugins/blogtng/tpl".**\\ Hint: By default, there is only "lib/plugins/blogtng/tpl/default". You may overwrite the existing files in there (:!: but remember: you have to do this again on every BlogTNG-Update then!).
   - 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:\\ <code>   - 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:\\ <code>
Line 96: Line 95:
 /css/structure.css /css/structure.css
 </code> </code>
- 
  
 ===== FAQ ===== ===== FAQ =====
Line 141: Line 139:
   * I can't test //every// browser (version) out there. Therefore it does not mean the template does not work if your browser is not listed above. Just try it out if you want to be sure.   * I can't test //every// browser (version) out there. Therefore it does not mean the template does not work if your browser is not listed above. Just try it out if you want to be sure.
  
 +===== Customizing =====
  
- +Have a look at the [[https://github.com/arsava/dokuwiki-template-mnml-blog#readme|README]]. Everything regarding
-===== Customizing ====== +
- +
-Have a look at the [[https://github.com/syn-systems/dokuwiki-template-mnml-blog#readme|README]]. Everything regarding+
   * own logo   * own logo
   * own favicon   * own favicon
Line 156: Line 152:
   * :!: The place for **all** user-defined, custom stuff is "mnml-blog/user". Reason: this folder will not be touched on updates.   * :!: The place for **all** user-defined, custom stuff is "mnml-blog/user". Reason: this folder will not be touched on updates.
   * :!: If you want to replace the default text logo showed in the upper left, simply create a ''/mnml-blog/user/logo.[png|gif|jpg]''. The template recognizes the file automatically and will use it instead of the default logo.   * :!: If you want to replace the default text logo showed in the upper left, simply create a ''/mnml-blog/user/logo.[png|gif|jpg]''. The template recognizes the file automatically and will use it instead of the default logo.
- 
  
  
Line 163: Line 158:
 Older releases are no longer recommended for usage and are listed for reference only. Older releases are no longer recommended for usage and are listed for reference only.
  
-^  mnml-blog version  ^  Download                                                                                                                                                                                                                            ^  Designed for and tested on DokuWiki                                            ^ Comment +^  mnml-blog version  ^  Download                                                                                                                                                                                                                          ^  Designed for and tested on DokuWiki                                            ^ Comment  ^ 
-|  ''2011-12-09''     | [[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-12-09_mnml-blog.tar.gz|Release]]\\ [[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-12-09_mnml-blog-update.tar.gz|Update]]  |  rc2011-11-10 "Angua RC1",\\ 2011-05-25a "Rincewind"                            | Small improvements, better clearing of blog posting contents (don't forget to update all used BlogTNG data template dirs below ''lib/plugins/blogtng/tpl''). | +|  ''2014-02-09''     | [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2014-02-09_mnml-blog.tar.gz|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. | 
-|  ''2011-11-30''     | [[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-11-30_mnml-blog.tar.gz|Release]]\\ [[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-11-30_mnml-blog-update.tar.gz|Update]]  |  rc2011-11-10 "Angua RC1",\\ 2011-05-25a "Rincewind"                            | :!: Full support for DokuWiki's new Media Manager; Apple Touch Icon support (see README for details); added Russian and Spanish language. | +|  ''2013-11-17''     | [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2013-11-17_mnml-blog.tar.gz|Release]]\\ [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2013-11-17_mnml-blog-update.tar.gz|Update]]  |  rc2013-10-28 "Binky",\\ 2012-10-13 "Adora Belle"                               | Full support for DokuWiki rc2013-10-28 "Binky"; Add Dutch and Korean language files; Update support and contact information. | 
-|  ''2011-05-15''     | [[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-15_mnml-blog.tar.gz|Release]]\\ [[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-15_mnml-blog-update.tar.gz|Update]]  |  rc2011-05-08 "Rincewind RC2",\\ 2010-11-07 "Anteater"                          | Fixed blogtng template error "template file comment for template main does not exist!"+|  ''2013-02-20''     | [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2013-02-20_mnml-blog.tar.gz|Release]]\\ [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2013-02-20_mnml-blog-update.tar.gz|Update]]  |  2012-10-13 "Adora Belle",\\ 2012-01-25b "Angua"                                | Full support for DokuWiki 2012-10-13 "Adora Belle"; :!: New option: ''mnmlblog_qrcodebox'' (controls if a box with a QR Code of current wiki page URL will be shown in the sidebar); added Czech language. | 
-|  ''2011-05-10''     | [[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-10_mnml-blog.tar.gz|Release]]\\ [[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-10_mnml-blog-update.tar.gz|Update]]  |  rc2011-05-08 "Rincewind RC2",\\ 2010-11-07 "Anteater"                          | Cross browser compatibility fixes. | +|  ''2011-12-09''     | [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-12-09_mnml-blog.tar.gz|Release]]\\ [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-12-09_mnml-blog-update.tar.gz|Update]]  |  rc2011-11-10 "Angua RC1",\\ 2011-05-25a "Rincewind"                            | Small improvements, better clearing of blog posting contents (don't forget to update all used BlogTNG data template dirs below ''lib/plugins/blogtng/tpl''). | 
-|  ''2011-05-08''     | [[http://andreas-haerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-08_mnml-blog.tar.gz|Release]]                                                                                                                        |  rc2011-04-22 "Rincewind RC1",\\ 2010-11-07 "Anteater"                          | Initial release. | +|  ''2011-11-30''     | [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-11-30_mnml-blog.tar.gz|Release]]\\ [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-11-30_mnml-blog-update.tar.gz|Update]]  |  rc2011-11-10 "Angua RC1",\\ 2011-05-25a "Rincewind"                            | :!: Full support for DokuWiki's new Media Manager; Apple Touch Icon support (see README for details); added Russian and Spanish language. | 
 +|  ''2011-05-15''     | [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-15_mnml-blog.tar.gz|Release]]\\ [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-15_mnml-blog-update.tar.gz|Update]]  |  rc2011-05-08 "Rincewind RC2",\\ 2010-11-07 "Anteater"                          | Fixed blogtng template error "template file comment for template main does not exist!"
 +|  ''2011-05-10''     | [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-10_mnml-blog.tar.gz|Release]]\\ [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-10_mnml-blog-update.tar.gz|Update]]  |  rc2011-05-08 "Rincewind RC2",\\ 2010-11-07 "Anteater"                          | Cross browser compatibility fixes. | 
 +|  ''2011-05-08''     | [[https://andreashaerter.com/tmp/downloads/dokuwiki-template-mnml-blog/2011-05-08_mnml-blog.tar.gz|Release]]                                                                                                                       |  rc2011-04-22 "Rincewind RC1",\\ 2010-11-07 "Anteater"                          | Initial release. |
  
 ==== Latest changes ==== ==== Latest changes ====
  
-For a complete change log, see the [[https://github.com/syn-systems/dokuwiki-template-mnml-blog/commits|commits on Github]].+For a complete change log, see the [[https://github.com/arsava/dokuwiki-template-mnml-blog/commits|commits on Github]].
  
-{{rss>https://github.com/syn-systems/dokuwiki-template-mnml-blog/commits/master.atom date}}+{{rss>https://github.com/arsava/dokuwiki-template-mnml-blog/commits/master.atom date}}
  
  
Line 181: Line 178:
  
 Feel free to add yours here: Feel free to add yours here:
-  * [[http://blog.andreas-haerter.com]] 
   * [[http://www.rocking-minds.org]]   * [[http://www.rocking-minds.org]]
-  * [[http://linuxisit.com]] 
-  * [[http://chrisge.org]] 
   * [[http://blog.slucas.fr]]   * [[http://blog.slucas.fr]]
   * [[http://www.heiko-barth.de/blog/]]   * [[http://www.heiko-barth.de/blog/]]
 +  * [[http://www.alpinequest.net]]
 +  * [[http://ptruchon.pagekite.me]]
 +
 +No longer working:
 +  * [[http://blog.andreas-haerter.com]]
   * [[http://notepad.pavlatka.cz]]   * [[http://notepad.pavlatka.cz]]
 +  * [[http://linuxisit.com]]
  
template/mnml-blog.1361361559.txt.gz · Last modified: 2013-02-20 12:59 by Andreas

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki