Add Enterprise Branding to the First Page of a DITA PDF

This article will cover:

Achieving Enterprise branding by seamlessly merging the FrontCover page with the chapter page, ensuring the enterprise’s identity is prominently displayed at the top of the content.

Before:

After:

Set up your Content

To publish content in PDF format, you must create a Ditamap or Bookmap.

Sample Bookmap structure :

<bookmap>
  <title>My Bookmap Title </title>
  <frontmatter>
    <booklists>
      <toc/>
      <figurelist/>
      <tablelist/>
    </booklists>
  </frontmatter>

  <chapter href="chapter1.ditamap">
  <chapter href="chapter2.ditamap">
  </chapter>

  <backmatter>
    <booklists>
      <indexlist/>
    </booklists>
  </backmatter>
</bookmap>

Sample Ditamap structure:

<map title="My map Title">

  <topicref href="topic1.dita" >
  </topicref>
  <topicref href="topic2.dita">
  </topicref>

</map>

The FrontCover of PDF is automatically generated if Bookmap contains <frontmatter>.

Make the Necessary Changes in the PDF Template

In this section, we will set up our template. (You can use or duplicate the Hi-tech template to get started.)

Set up your Template :

If you are using Ditamap for PDF generation :

When publishing a DITAMAP, Native PDF provides the functionality to automatically generate a FrontCover page. The option to enable or disable FrontCover Page generation can be configured in the Native PDF template.

To merge:

If you are using Bookmap for PDF generation

In the case of a Bookmap, the sequence of Page Layout Order is controlled by the Bookmap’s structure rather than the template’s order.

To achieve this for Bookmap , We will utilize NativePDF’s JavaScript feature.

window.addEventListener('DOMContentLoaded', function () {
    window.pdfLayout.onAfterPagination(function () {
        var frontMatterWrappers = document.querySelectorAll('.rh-front-matter-wrapper');

        frontMatterWrappers.forEach(function(wrapper) {
            var contentDiv = wrapper.querySelector('div[data-region="content"]');
            var chapterBody = document.querySelector('.chapter-body');

            if (contentDiv && chapterBody) {
                chapterBody.insertBefore(contentDiv, chapterBody.firstChild);
            }

            wrapper.remove();
        });
    });
});

Attachments :

Other Resources: