= Metadata =

The metadata abstraction is used in MoinLight to control the conversion of
wiki content from its [[Input|input]] form to its eventual [[Output|output]]
form.

The settings or properties retained by the conversion metadata are described
below.

<<TableOfContents(2)>>

== attachments ==

 Default:: `attachments`

The name used for attachment directories.

== document_index ==

 Default:: (none)

The filename to be incorporated into page links so that such links reference a
particular file instead of the page directory containing the file. This is
useful when generating HTML content to be browsed as local files.

== index_name ==

 Default:: `index.html`

The filename to be used for HTML documents providing page content in a
directory [[#output_context|output context]]. This will inherit any specified
setting for the [[#document_index|document index]].

== input_context ==

 Default:: `standalone`
 Alternatives:: `directory`, `moindirectory`

The form of the [[Input|input]] to be processed.

== input_encoding ==

 Default:: `utf-8`

The character encoding used in the input documents.

== input_filename ==

 Default:: (none)

The location of the input document or directory of documents.

== input_format ==

 Default:: `moin`

The default format of input documents.

== input_separator ==

 Default:: (none)

The separator used to structure hierarchical pagenames.

== interwiki ==

 Default:: (none)

A mapping of identifiers to URLs, used to generate interwiki links.

== link_format ==

 Default:: (depends on the [[#output_format|output format]])

The format of encoded links in converted documents. Typically, this will
conform to the general output format of the documents.

== output_context ==

 Default:: `standalone`
 Alternative:: `directory`

The form of the [[Output|output]] to be processed.

== output_encoding ==

 Default:: `utf-8`

The character encoding used in the output documents.

== output_format ==

 Default:: `moin`

The default format of output documents.

== output_filename ==

 Default:: (none)

The location of the output document or directory of documents.

== root_pagename ==

 Default:: `FrontPage`

The pagename of the root document in a collection of documents.

== theme_name ==

 Default:: (none)
 Alternatives:: (see below)

Required for applying themes to output. The names combine a theme name with an
output format. For example:

|| '''Alternative''' || '''Theme''' || '''Format''' ||
|| `default.html`    || `default`   || `html`       ||
|| `mercurial.html`  || `mercurial` || `html`       ||

== variables ==

 Default:: (none)

A mapping of names to values, used to generate variable substitutions.
