Specifying the Number of Hierarchical Levels
When issuing the Generate command with the command line option -m, you indicate the number of hierarchical levels to create from the source document.
Specifying the number of levels helps to prevent a large and unnecessary granular level of mapping rules from being generated.
If -m is not used, the default is to map every element in the document to a Contenta object. This is a very inefficient mapping approach and is detrimental to performance and possibly to the reuse of document components.
Example:
Your document contains the following structure:
<Manual>
<Chapter>
<Section>
<Sub-Section>
<para>
<list>
<table>
If you specify -m 4, Generate creates a map file with four hierarchical levels—a mapping rule is created for Manual, Chapter, Section, and Sub-Section, but not for para, list, or table.