DragonFly BSD

inline

The inline directive is supplied by the inline plugin.

This is a directive that allows including one wiki page inside another. The most common use of inlining is generating blogs and RSS or Atom feeds.

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 simple podcasting; for fuller-featured podcast feeds, enclose media files in blog posts using meta.

The optional rootpage parameter 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:

[[!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)"]]

usage

There are many parameters you can use with the inline directive. These are the commonly used ones:

Here are some less often needed parameters: