hold onto your hats, full-fledged blogging has arrived in ikiwiki!

6 files changed, 59 insertions, 39 deletions

diff --git a/doc/blog.mdwn b/doc/blog.mdwn
new file mode 100644
index 000000000..d300736a8
--- /dev/null
+++ b/doc/blog.mdwn
@@ -0,0 +1,8 @@
+You can turn any page on this wiki into a weblog by inserting a
+[[PostProcessorDirective]]. Like this:
+
+\\[[inline pages="blog/*" show="10"]]
+
+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.
diff --git a/doc/features.mdwn b/doc/features.mdwn
index 4699f3096..4a83604ad 100644
--- a/doc/features.mdwn
+++ b/doc/features.mdwn
@@ -27,13 +27,6 @@ Currently implemented:
   and is quite smart about converting it to html. The only additional markup
   provided by ikiwiki aside from regular markdown is the [[WikiLink]].
 
-* [[RSS]]
-
-  ikiwiki supports generating RSS (2.0) feed for individual pages. These
-  feeds can be subscribed to, to get an update when a page is changed.
-
-  (Support for proper blogs is also planned.)
-
 * support for other file types
 
   ikiwiki also supports files of any other type, including raw html, text,
@@ -45,9 +38,21 @@ Currently implemented:
 
   Arbitrarily deep hierarchies of pages with fairly simple and useful [[SubPage/LinkingRUles]]
 
+* [[blog]]s
+
+  You can turn any page in the wiki into a [[blog]]. Pages with names 
+  matching a specified [[GlobList]] will be displayed as a weblog within
+  the blog page. And an RSS feed can be generated to follow the blog.
+
+  ikiwiki also supports generating RSS feed for individual pages that
+  do not contain a [[blog]]. These feeds can be used to be sent a new
+  version of a page when it is changed.
+
 * Fast compiler
 
-  ikiwiki is fast and smart about updating a wiki, it only builds pages that have changed (and tracks things like creation of new pages and links that can indirectly cause a page to need a rebuild)
+  ikiwiki is fast and smart about updating a wiki, it only builds pages
+  that have changed (and tracks things like creation of new pages and links
+  that can indirectly cause a page to need a rebuild)
 
 * [[Templates]]
 
diff --git a/doc/helponformatting.mdwn b/doc/helponformatting.mdwn
index 545148e86..4ef41d16f 100644
--- a/doc/helponformatting.mdwn
+++ b/doc/helponformatting.mdwn
@@ -51,4 +51,9 @@ To link to any other web page, or to an email address, you can just put the url
 
 ----
 
+Advanced users can use [[PostProcessorDirective]]s to do additional cool
+stuff.
+
+----
+
 This style of text formatting is called [[MarkDown]].
diff --git a/doc/postprocessordirective.mdwn b/doc/postprocessordirective.mdwn
new file mode 100644
index 000000000..fa8432e3f
--- /dev/null
+++ b/doc/postprocessordirective.mdwn
@@ -0,0 +1,11 @@
+Postprocessor directives are similar to a [[WikiLink]] in form, except they
+contain spaces and parameters. The general form is:
+
+\\[[directive param="value" param="value"]]
+
+This gets expanded after the rest of the page is processed, and can be used
+to transform the page in various ways.
+
+Currently, these postprocessor directives are available:
+
+* "inline" to make a [[blog]]
diff --git a/doc/sandbox.mdwn b/doc/sandbox.mdwn
index d39f76032..37bb6bd89 100644
--- a/doc/sandbox.mdwn
+++ b/doc/sandbox.mdwn
@@ -36,3 +36,12 @@ Bulleted list
 [[WikiLink]]
 
 [[SandBox/SubPage]] -- a page under this one.
+
+----
+
+This sandbox is also a [[blog]]! Any subpage of this page is automatically
+added to the blog below.
+
+----
+
+[[inline pages="sandbox/*" show="5"]]
diff --git a/doc/todo.mdwn b/doc/todo.mdwn
index 4ae62867e..f918bf156 100644
--- a/doc/todo.mdwn
+++ b/doc/todo.mdwn
@@ -61,38 +61,15 @@ that linked back to it could be added to the page. However, doing linkbacks
 also needs to tie into the main logic, to determine what pages need to be
 renered, so maybe that won't be a plugin.
 
-## blogging and rss
+## blogging
 
-The wiki should emit rss feeds for pages. The simple case is a regular
-page (done). The complex case is a blog composed of multiple pages.
-
-### multi-page blog
-
-This also takes care of the feature of wanting to make a wiki page
-comprised of several sub-pages that can be independantly edited. Add a
-token that can be embedded into a page and that specifies a [[GlobList]] of
-pages. Now when any page matching the globs changes, this page must be
-updated too. 
-
-For the html rendering, just embed the most recently created N pages in the
-[[GlobList]], with the title of each being a link to the individual page,
-plus a link to an additional page that lists all the titles of every
-matching page in creation order (archives). Plus at the bottom a small web
-form that prompts for a title and allows creating a new page for a new blog
-post.
-
-For the rss rendering, generate a proper weblog of the same pages.
-Of course for permalinks use the links to the subpages.
-
-Note that this allows for weblogs with different sections, etc.
-
-Requirements:
-
-* Need to keep track of the globlists in the index file.
-* Need to pick a good token and note that the token will need to be passed
-  multiple parameters. Possibly something like this:
-
-  	[[inline pages="myblog/*" show="30"]]
+- 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.
+- Add a link to the end of a blog to go to the archives; this would
+  probably best be another cgi script, to avoid needing to generate big
+  static pages for little used archives.
+- Should probably add params to control various rss fields like the blog
+  title, its author email, its copyright info, etc. 
 
 ## revisit case
 
@@ -161,6 +138,11 @@ exposing ones from the underlaydir. Will need to make sure that the mtime
 for the source file is zeroed when the page is removed, and that it then
 finds the underlay file and treats it as newer.
 
+## wikilinks features
+
+- \[[John|Fred]] is a Wikipedia method for linking to the one page
+  while displaying it as the other, Kyle would like this.
+
 ## Logo
 
 ikiwiki needs a logo. I'm thinking something simple like the word "ikiwiki"