Back to Search Back to Search Results

One-Page Map Display

The built-in portal themes exercise the ability to display all of the topics in a DITA map or assembly as a single HTML page. The handling of this functionality is slightly different between maps and assemblies.

The td.content portal theme tag carries the expandReferences attribute, which can be used when referencing DITA maps to insert an XML document containing all of the topics in the publication, instead of the flattened DITA map markup. The XML structure for this document is similar to, but not quite the same as, the structure used by the DITA Open Toolkit when rendering PDF output. See the td.content documentation for details.

For DITA maps, the mapViewer.ftl template includes a link to the custom page custom/expandedMap.ftl, which renders the map with the expandReferences flag set.

For Assemblies, the assemblyViewer.ftl tag includes a similar link. However, instead of going to a custom page, it reuses the assemblyViewer.ftl page with a special parameter controlling whether or not to expand references.

In both cases, the monolithic renderings use the /xsl/map/monolith.xsl transformation, which reuses /xsl/topic/topic.xsl, overriding certain things like related-link handling.