X-Git-Url: http://git.tremily.us/?a=blobdiff_plain;f=doc%2Fblog.mdwn;h=c4a379fdbaf0d29d9de0cd0d4e3abfa86df3d96c;hb=41fe5053e99221b403a8c003403c5d6143bd1a7c;hp=6e697d7e2d952b1ad8d1a5cd79711ef857f1caa8;hpb=c5c1519d97d18a6e630ee7afb647632109a4853b;p=ikiwiki.git diff --git a/doc/blog.mdwn b/doc/blog.mdwn index 6e697d7e2..c4a379fdb 100644 --- a/doc/blog.mdwn +++ b/doc/blog.mdwn @@ -1,42 +1,4 @@ -[[if test="enabled(inline)" - then="This wiki has the inline plugin **enabled**." - else="This wiki has the inline plugin **disabled**."]] +Ikiwiki allows turning any page into a weblog, by using the +[[ikiwiki/directive/inline]] [[ikiwiki/directive]]. For example: -[[if test="enabled(inline)" - then="You can" - else="If this wiki had the inline plugin enabled, you could"]] -turn any page on this wiki into a weblog by using the `inline` -[[PreProcessorDirective]]. 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"]]