A document-tag, or a tag, is a document-specific key-text pair, where the text can be queried and modified by its key. In contrast to variables, tags do not have a scope, and they persist for the whole execution of Remark. This allows to embed meta-data into documents, which can then be used by the macros.
A document-tag can be set by the set_tag
command, and retrieved by
the tag
command.
[[set_tag author]]:
John Doe
Jane Doe
[[tag author]]
John Doe Jane Doe
Remark predefines the following tags for each document. They can be freely changed. However, they are provided useful initial values by the tag parsers before starting the conversion. The predefined tags are:
* Description: [[tag description]]
* Link-description: [[tag link_description]]
* Detail: [[tag detail]]
* Author: [[tag author]]
* Filename: [[tag file_name]]
* Relative name: [[tag relative_name]]
* Relative directory: [[tag relative_directory]]
* File extension: [[tag extension]]
* Html-head: [[tag html_head]]