.dist
extensionClean and minimalist template, suitable for blogging with the BlogTNG plugin
Compatible with DokuWiki
Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus
“mnml-blog” is a clean and minimalist template for DokuWiki. It is designed to use DokuWiki with the BlogTNG plugin as blogging software. The name means “minimalist blog”, and it was created for Andreas Haerter's personal weblog.
If you like the template, you might want to donate a few bucks, or get some cool QR Code merchandise. It is a lot of work. Thank you!
Version | 2014-02-09 |
---|---|
Download | 2014-02-09_mnml-blog.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. You may find the text “How to create an easily maintainable DokuWiki template” useful, too.
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.
This template is designed for the usage with the BlogTNG plugin only (it may work for other purposes, but I do not test or support anything else)! You may find “How to create a DokuWiki based blog (BlogTNG plugin)” useful to get everything started. |
---|
'<blog newform>
' form”) points to (default is :wiki:create_new_blogpost
) and create a wiki <blog newform>
page there (the “New Post” link at the bottom right of the footer is using this link). See BlogTNG for details.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.
What to do to update your installed mnml-blog template?
/lib/tpl/mnml-blog
./lib/tpl/mnml-blog
. This works without problems when you follow the rules described in the 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.1)#removed in 2011-11-30 /css/_mediamanager.css /css/basic.css /css/content.css /css/design.css /css/includes.css /css/structure.css
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_sidebar”) and its content will be shown instead of the message. All of these placeholders are configurable. Have a look at the DokuWiki admin section:
If you need an example for a header or sidebar navigation, try the following as content for the page configured at “If yes, use following wiki page as header|sidebar navigation” (respectively :wiki:navigation_header
and :wiki:navigation_sidebar
by default):
* [[:start|Home]] * [[:contact|Contact]]
As mentioned above, just edit the page like every other wiki page to change the navigation. A simple list is enough, the template provides some CSS magic to create a navigation out of it.
Simply have a look at /lib/tpl/mnml-blog/VERSION
. This is a textfile containing the version you are using (e.g. 2011-05-08
).
See customizing.
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:
/mnml-blog/user/logo.[png|gif|jpg]
. The template recognizes the file automatically and will use it instead of the default logo.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 |
---|---|---|---|
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 Dutch and Korean language files; Update support and contact information. |
2013-02-20 | Release 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-12-09 | Release 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-11-30 | Release 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 | Release 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 | Release Update | rc2011-05-08 “Rincewind RC2”, 2010-11-07 “Anteater” | Cross browser compatibility fixes. |
2011-05-08 | Release | rc2011-04-22 “Rincewind RC1”, 2010-11-07 “Anteater” | Initial release. |
For a complete change log, see the commits on Github.
Feel free to add yours here:
No longer working:
.dist
extension