Blog
Blog turns ordinary wiki pages into blog posts. A post is not a special kind of page but a page carrying a metadata block; listings, feeds, comments, tags and scheduling all follow from it.
Get started
Common tasks
| What you want | For whom | Where it is |
|---|---|---|
| How do I write my first post? | Authors | Quick start |
| How do I list posts on a page? | Authors | Reference: listings |
| How do I change how a listing looks? | Authors | Reference: template sets |
| How do I schedule a post for later? | Authors | Reference: scheduling |
| How do I allow or review comments? | Operators | Reference: comments |
| How do I set up a second blog? | Operators | Reference: several blogs |
| How do I reach posts from a program? | Developers | Reference: interface |
How it fits together
Wiki page ──carries──▶ <wk:blog> block
│ │
│ └──projected──▶ Index (SQLite) ──feeds──▶ Listing, feed, workbench
│ ▲
├──who, when──▶ Page history │
│ │
└──who may see──▶ Access control │
│
Comments, subscriptions ──database only─────────────┘
Everything to the left of the projection can be rebuilt from the pages. Comments and subscriptions have no counterpart on a page — they survive a reindex, but they do not travel with a copied page.
What the package does
- Posts are ordinary wiki pages — versioned, searchable, copyable.
- Several separate blogs in one wiki, told apart by the blog name alone.
- Listings with paging, tag cloud, tag search and related posts.
- The states draft, pending review, scheduled and published.
- Comments with review before release, subscriptions and a confirmation step.
- RSS feeds and a preview for sharing on social networks.
- Two text formats: DokuWiki markup and Markdown.
Core concepts
The page is the truth. The <wk:blog> block on the page carries everything that makes it a post, and travels with it when the page is copied into another wiki. The database is an index derived from that block for fast listings; it can be rebuilt from the pages at any time. Visibility is governed by the wiki access control, and who changed what and when is answered by the page history. In full: Reference: data storage.
Administration
The administration screen lives at ?do=admin&page=wkblog. It holds the overview with the editorial counts, the post list, comment review, the “SEO & Social” surface and the maintenance routines. See Reference: administration screen.
When something does not work
This package has no diagnostic pages of its own yet. The known special cases are described in Reference: behaviour in special cases.