summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/blog.mdwn6
-rw-r--r--doc/sandbox.mdwn4
-rw-r--r--doc/todo/blogging.mdwn4
-rw-r--r--doc/todo/upgradehooks.mdwn6
4 files changed, 13 insertions, 7 deletions
diff --git a/doc/blog.mdwn b/doc/blog.mdwn
index 598ad98d5..0d67619da 100644
--- a/doc/blog.mdwn
+++ b/doc/blog.mdwn
@@ -1,12 +1,16 @@
You can turn any page on this wiki into a weblog by inserting a
[[PostProcessorDirective]]. Like this:
-\\[[inline pages="blog/* !*/Discussion" show="10"]]
+\\[[inline pages="blog/* !*/Discussion" show="10" rootpage="blog"]]
Any pages that match the specified [[GlobList]] (in the exaple, any
[[SubPages]] of "blog") will be part of the blog, and the newest 10
of them will appear in the page.
+The optional `rootpage` setting tells the wiki that new posts to this blog
+should default to being [[SubPages]] of "blog", and enables a form at the
+top of the blog that can be used to add new items.
+
If you want your blog to have an archive page listing every post ever made
to it, you can accomplish that like this:
diff --git a/doc/sandbox.mdwn b/doc/sandbox.mdwn
index 69876d26d..a4e01b7c2 100644
--- a/doc/sandbox.mdwn
+++ b/doc/sandbox.mdwn
@@ -40,6 +40,4 @@ Bulleted list
This sandbox is also a [[blog]]! Any [[SubPage]] of this page is automatically
added to the blog below.
-----
-
-[[inline pages="sandbox/*" show="5"]]
+[[inline pages="sandbox/*" rootpage="sandbox" show="5"]]
diff --git a/doc/todo/blogging.mdwn b/doc/todo/blogging.mdwn
index 9ae6cf4a6..55bb24689 100644
--- a/doc/todo/blogging.mdwn
+++ b/doc/todo/blogging.mdwn
@@ -1,6 +1,4 @@
-- Add a small form at top and bottom of a blog to allow entering
- a title for a new item, that goes to a template to create the new page.
- Should probably add params to control various rss fields like the blog
title, its author email, its copyright info, etc.
- The [[TODO]] page would work better if the first N were shown in full,
- and then all open items were shown in summary. Maybe add this mode. \ No newline at end of file
+ and then all open items were shown in summary. Maybe add this mode.
diff --git a/doc/todo/upgradehooks.mdwn b/doc/todo/upgradehooks.mdwn
new file mode 100644
index 000000000..90ef725ae
--- /dev/null
+++ b/doc/todo/upgradehooks.mdwn
@@ -0,0 +1,6 @@
+It's annoying to have to manually run --setup, especially for multiple
+blogs, on upgrade. Is the deb is used, there could be a postinst hook to do
+this.
+
+Let there be an /etc/ikiwiki/wikis, which just lists setup files and the
+user who owns them. postinst loops through, su's, and runs --setup. Voila!