README.md
1# Page Templater - Embed your page
2
3
4This is a [DokuWiki](http://www.dokuwiki.org) plugin. The News Page of [i-net software](https://www.inetsoftware.de/support/news) uses the blog plugin. The blog entries always have a plain look - unless you define some style for them, e.g. using boxes. Using Page Templater you can define templates for the blog namespaces. In our case, we have added a template for news entries which includes the archive.
5You can also use the META plugin and define a template for only one page:
6
7```
8~~META:
9templater page=:my:template-page
10~~
11```
12
13## Template Prequisites
14
15
16The template page has to have the word ``@@CONTENT@@`` in the content. This is the placeholder where the content of your original page will be located.
17
18## Some more Template Functionality
19
20You can define more placeholders on your own. Simply use the word ``@@YOURPLACEHOLDER@@`` in the template page (where ``YOURPLACEHOLDER`` is actually your word to be replaced).
21
22Template Page Example:
23
24```
25====== This my page with a Placeholder ======
26
27**@@YOURPLACEHOLDER@@**
28```
29
30You can now define the following in your page:
31
32```
33~~META:
34templater page = :my:template
35&templater yourplaceholder = This is an important text
36&templater !yourimageholder = {{:this:can:be:an:image.jpg|}}
37~~
38```
39
40**Note:** The page above defines a templater property using an exclamation mark (!) - this property will be fed into the DokuWiki XHTML renderer and produce rendered output.
41