English
资源说明：Clean and minimalist DokuWiki template, suitable for blogging with the BlogTNG plugin.
I. About
"mnml-blog" is a clean and minimalist template for DokuWiki. It is designed
to use DokuWiki as blogging software. The name means "minimalist blog", and
it was created for the personal weblog [1] of Andreas Haerter [2].
Website:
Maintainer: ARSAVA page where all posting shall appear. Then look
where the option "mnmlblog_newpostform_location" (-> "Use following wiki
page for the '' form") points to (default is
":wiki:create_new_blogpost") and create a wiki page there
(the "New Post" link at the bottom right of the footer is using this link).
See the BlogTNG plugin page [2] or my tutorial [4] for details.
Update:
See the mnml-blog template website for instructions [5].
[1]
[2]
[3]
[4]
[5]
III. Customizing the template
In order to make updates of your installed "mnml-blog" template easy, follow
these hints for customizing the template:
- Place your files in "mnml-blog/user"
The place to store *all* user-defined, custom stuff is the
"mnml-blog/user" directory because your files will not be touched or
overwritten on template updates! So you normally can copy all new files
into "mnml-blog/" to update the template without loosing your changes.
Note: There are example files helping you modifying the template.
The are delivered with the ".dist" extensions. Just remove the
".dist" extension to use them.
- Own logo
If you want to replace the default logo showed in the upper left, simply
create a "logo.[png|gif|jpg]" in "mnml-blog/user". The template recognizes
the file automatically and will use it instead of the default text.
Note: Do not forget to empty your browser's cache if you cannot see any
effect.
- Own favicon
If you want to replace the default favicon, simply create a "favicon.ico"
in "mnml-blog/user". The template recognizes the file automatically and
will use it instead of the default one. Do not forget to empty your
browser's cache afterwards. By the way: you might find the online
FavIcon Generator [1] useful.
Note: "favicon.png" is also possible but not recommended (because it is
not supported by older MSIE versions).
- Own CSS
To apply additional CSS rules, create a
- "mnml-blog/user/screen.css" file to influence the normal layout. You
can rename the "screen.css.dist" to "screen.css" as starting point.
- "mnml-blog/user/print.css" file to influence the print layout. You
can rename the "print.css.dist" to "print.css" as starting point.
- "mnml-blog/user/rtl.css" file to influences "right-to-left" languages
like Hebrew. You can rename the "rtl.css.dist" to "rtl.css" as
starting point.
The file(s) will be included automatically (as the last ones for the
relevant media, therefore you are able to overrule existing styles).
Note: Do not forget to empty your browser's cache if you cannot see any
effect.
- Own JavaScript
To load additional JavaScript, create a "mnml-blog/user/user.js" file. You
can rename the "user.js.dist" to "user.js" as starting point (it contains
some examples and useful comments how to define your own JavaScript).
ATTENTION: You have to activate the template option "mnml-blog_loaduserjs"
(->"Load 'mnml-blog/user/user.js'?") in the DokuWiki Config
Manager!
- Own boxes
To apply own boxes in the right column, have a look at
"mnml-blog/user/boxes.php". Don't worry: you will find some examples how
to define the boxes. If you still have questions after playing with the
examples, see "IV. Support" on how to get help.
If "mnml-blog/user/boxes.php" does not exist, simply copy it out of the
current installation archive.
- Web analytics software (Piwik, Google Analytics etc.)
Tools like Piwik and Google Analytics normally provide a small code
snippet ("tag") which you have to include at your website to make
everything work. If you want to use such software with this template,
create a "mnml-blog/user/tracker.php.dist". You don't have to deliberate
where you have to copy and paste the code, simply do it there. You can
rename the "tracker.php.dist" to "tracker.php" as a good starting point
(it contains some examples and useful comments how to define your own
boxes).
- Own Apple Touch Icon
If you want to replace the default Apple Touch Icon, simply create a
"apple-touch-icon.png" in "mnml-blog/user". The template recognizes the
file automatically and will use it instead of the default one. Have a look
at Apple's developer database (cf. "Configuring Web Applications" [2]) if
you need more information.
[1]
IV. Support
If you need help, check the FAQ [1] and try to find useful information by
using the DokuWiki Search page [2]. If you found nothing helpful, ask your
question at the DokuWiki forum [3] (preferred) or IRC channel [4].
[1]
[2]
V. Contact
If you think you have found a bug or have a useful idea (a.k.a. "feature
request"), create an issue [1] on GitHub (preferred), or contact us by
mail [2].
Feel free to submit patches as GitHub pull requests (preferred) or by mail
as well. However, please try to respect the DokuWiki coding style [3] as
this template follows its rules.
[1]
[2] ARSAVA
[3]
VI. Other notes
If you like this free project, you might buy us a coffee [1], or get some
cool QR Code merchandise [2]. Thank you! :-)
Do not hesitate to contact ARSAVA [3] if you need professional DokuWiki
support, training or if you think we are the ones to get your project done.
[1]
[2]
[3]
VIII. Creation transcript
Some developers may find this interesting. Additionally, I am very oblivious
:-P.
In principle, I followed my own tutorial [1]. There was just no "starter"
template [2] when "mnml-blog" was created. Therefore, after ~1 year, I
switched the CSS base from DokuWiki's default template to the starter
template, but the markup of "main.php" is still based on the default
template's "main.php".
[1]
[2]
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
