5.2. Sub-Tags

Aus Hugo Doku

The sub-tags of .filter files are instructions, manipulating DOM. All sub-tags on the same level build a process chain, where each chain element has a DOM as input and a DOM as output. While running the process chain the DOM is always hold in memory. Thus you do not see the intermediate result, except you use <dump> (see Section 5.2.1).

5.2.1. <dump>

Description:

The sub-tag <dump> writes the input DOM to disk and forwards it to its output. This is helpful to see the intermediate result of the process chain, built by all sub-tags on the same level of original input file.

Attributes:

Name	Description	Required	Default Value
name	The name of the XML file, which results of the DOM and is written to disk (target dump file).	yes
encoding	The encoding within the <?xml ?> instruction of the target dump file	no	"utf-8"
doc-type	The doc-type definition of the <!DOCTYPE > specification of the target dump file (see important note below!)	no	""
public-id	The public-id definition of the <!DOCTYPE > specification of the target dump file (see important note below!)	no	""
system-id	The system-id definition of the <!DOCTYPE > specification of the target dump file (see important note below!)	no	""

Important

A <!DOCTYPE> has the following structure:

<!DOCTYPE doc-type PUBLIC "public-id" "system-id">

If one of the <!DOCTYPE > attributes (e.g. the public-id) is set, all other <!DOCTYPE > attributes are required as well. If you do not set any data, there is no <!DOCTYPE > in the target dump file.