format

The format directive is supplied by the format plugin.

The directive allows formatting a chunk of text using any available page format. It takes two parameters. First is the type of format to use, ie the extension that would be used for a standalone file of this type. Second is the text to format.

For example, this will embed an otl outline inside a page using mdwn or some other format:

[[!format  otl """
foo
    1
    2
bar
    3
    4
"""]]

Note that if the highlight plugin is enabled, this directive can also be used to display syntax highlighted code. Many languages and formats are supported. For example:

[[!format  perl """
print "hello, world\n";
"""]]

format can also be used to format entire source files and display them on a page. Simply put an inline directive with the raw attribute set inside a format. This can be useful if you want to both serve the file raw, as well as show it syntax highlighted on a page. An example:

[[!format  python """
[[!inline pages="program.py" raw="yes"]]
"""]]

[[View raw file|program.py]]