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.