Description

The Blog Plugin makes blogs in your wiki easily possible. The blog component shows the latest entries (pages) from a namespace in reverse chronological order. In this new version, the creation date is the sort key – no longer the date of the last non-minor modification as in previous versions. The archive component lists all entries that were written (created) in the given month.

Installation

Configure your own DokuWiki blogsuite install package, consisting of all mandatory plugins plus any optional features you want to include: BlogSuite BundleHub The Bundle Hub is currently out of date and not updated any more, please install the plugins individually Site seems to be down for sime time, here is the archived version if you want to see possible optional plugins & features.

This includes a specified number of most recent blog entries from the given namespace into the current page. Below the entries a link to the page (permalink), the author, the creation date and the number of comments are shown. Link, author, date and comments info can be hidden. At the end of the blog a link to older entries lets you navigate in the history of the blog. At the very end, if you have enough rights to create new pages, a form for new blog entries is displayed.

Note that when the page with the blog syntax is in the specified namespace, content my be shown twice. At some point, the loop will be detected and stopped. You should therefore make sure that either the page with the listing is in a different namespace or use the excluded_pages-option to explicitly exclude the blog page from the blog listing.

Archive

{{archive>[namespace]?[month]&[flags]&author=[username]}}

[namespace]

the namespace for which you want an archive list; * is the whole wiki, . is the same namespace as the page lies in

Changes

the syntax that lists everything till now correctly updates the cache now whenever a page is changed or a comment or linkback is added.

the cache is not used anymore when it contains an archive listing with a page that the current user can't access. The excluded pages won't be included again automatically unless the cache expires for other reasons, the ~~NOCACHE~~ macro can be used if this is needed.

My dates are shown wrong. What can I do?

Is it possible to change the way the date is displayed?

How can I alter the date of a blog post?

You can use the meta plugin to manually set the creation date (and modification date) in the page source, then select the modification date in the blog plugins order setting. An alternative solution would be to alter the timestamps of the created files.

Is it possible to show table of contents?

The table of contents is shown automatically (depending on the settings in DokuWiki itself) from version 2013-02-07 on.

The header is always a link to the page even though it's disabled in the include plugin settings

The blog plugin assumes that in the context of a blog the header should be a link. However from version 2013-02-26 on it is possible to disable this behavior by using the nolink-flag, the blog plugin now only sets a default without overriding the nolink flag.

Is it possible to show just the first lines of each post with a 'Read more' link to view the full post?

I think I solved myself.
In the blog mark, use the following flags

{{blog>?5&firstseconly&readmore}}

This will work if you add an H2 header (in the full post) where you want to make appear the 'Read more' link.
If you don't need or want an H2 header in your post, you can add a empty H2 header, just as a delimiter for the text you want to show in the Blog's headlines

the excluded_pages does not work

In the blog mark ,use the following flags

{{blog>*?5&!(^|:)index$!}}
or
{{blog>*?5&excluded_pages=!(^|:)index$!}}

all above flags does not work, the index pages in sub namespace is still included .