X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/88e8f08c8ffe61fbb3aa8d0fbf78a86c30c65543..ae1857b43cf55a393a507b8434f172cbdb29d5b0:/doc/blog.mdwn diff --git a/doc/blog.mdwn b/doc/blog.mdwn index 859fa6aaa..c4a379fdb 100644 --- a/doc/blog.mdwn +++ b/doc/blog.mdwn @@ -1,35 +1,4 @@ -You can turn any page on this wiki into a weblog by inserting a -[[PreProcessorDirective]]. Like this: +Ikiwiki allows turning any page into a weblog, by using the +[[ikiwiki/directive/inline]] [[ikiwiki/directive]]. For example: - \[[inline pages="blog/* and !*/Discussion" show="10" rootpage="blog"]] - -Any pages that match the specified [[PageSpec]] (in the example, any -[[SubPage]] of "blog") will be part of the blog, and the newest 10 -of them will appear in the page. Note that if files that are not pages -match the [[PageSpec]], they will be included in the feed using RSS -enclosures, which is useful for podcasting. - -The optional `rootpage` parameter tells the wiki that new posts to this blog -should default to being [[SubPage]]s 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: - - \[[inline pages="blog/* and !*/Discussion" archive="yes"]] - -You can even create an automatically generated list of all the pages on the -wiki, with the most recently added at the top, like this: - - \[[inline pages="* and !*/Discussion" archive="yes"]] - -If you want to be able to add pages to a given blog feed by tagging them, -you can do that too. To tag a page, just make it link to a page or pages -that represent its tags. Then use the special link() [[PageSpec]] to match -all pages that have a given tag: - - \[[inline pages="link(life)"]] - -Or include some tags and exclude others: - - \[[inline pages="link(debian) and !link(social)"]] + \[[!inline pages="blog/* and !*/Discussion" show="10" rootpage="blog"]]