Components of a PDF template components-pdf-template

Start any new chapter from: Allows you to define how each chapter is published in the final PDF. You can choose from a New Page, Odd Page, Even Page, or Current Page   options. If you choose to start a new chapter from an odd page, then a blank page is inserted after a chapter that ends on an odd page. For example, if your chapter ends on page number 15, then the publishing process will insert a blank 16^th page so that the new chapter can start from the 17^th page. If you choose the Current Page option, then all chapters are published in continuation without any page breaks. For example, if a chapter ends in the middle of page 15, then the next chapter is also started from the 15th page itself.

Start each topic from a new page: If you want each topic within your chapter to start from a new page, then select Start each topic from a new page option. If you want to keep your topics in continuation without any page gaps, then deselect this option.

TOC Structure: Allows you to customize the hierarchy of the Table of Contents. It uses the following additional settings:

• Use Headings up to Level: It allows you to adjust the number of heading levels to be displayed in the TOC structure of your PDF.
• Do not show page number for the first level in TOC: Select this option to hide the corresponding page numbers for all chapters that contain nested or child topics. Consider the following example wherein an output is created without selecting this option.

{width="250"}

In the above example, Advanced PDF Settings, Appendix, and Legal are the first level topic headings or chapter titles. A page number is assigned to all of these headings.

Now, if you select this option and generate the output, then you will get the following TOC:

{width="250"}

Here you can notice that the first chapter Advanced PDF settings is not given any page number, as it has nested or child topics. Whereas a page number if assigned to Appendix and Legal because they are standalone topics without any child topic.

Do not show chapter number in the TOC : Select this option to display the chapter names without the chapter numbers in the TOC. By default, the chapter numbers are displayed in the TOC of your PDF output.

Leader format: Use the drop-down to select Dotted, Solid, or Space leader lines to connect heading levels to its corresponding page numbers.
For applying TOC structure and styling heading levels, see Add a chapter TOC.

Use table continuation marker: Select this option to define markers for long tables that spread across multiple pages.
You can define the text to appear before and after the break. For example, a table breaks on page 5, and you define <Continued on page %page-num%> for Text Before Break. The text displays “Continued on page 6” at the bottom of page 5.

Use language variables to define the continuation marker text before and after the break. Depending on your chosen language, the localized value is automatically picked in the PDF output. For example, you can publish Continued on page %page-num% as a text in English and Fortsetzung auf Seite %page-num% in German.

Hover over {width="25"} near the option to view more details about it.

Link glossary terms to the glossary page: Select this option to show the glossary terms as hyperlinks in the content and link them to the terms on the glossary page. This helps the readers to quickly view the definition of a term defined in the glossary.

To convert the glossary terms to hyperlinks, you need to:

• Enable Glossary in the Page Layout Order tab for a DITA map.
• Add the Glossary in the Back Matter Pages for a Book map.

If you don’t enable the Glossary page, the Glossary terms in the content are not converted to hyperlinks in the PDF output.

Chapters & Topics: You can specify the page layout for the for the Chapter & Topics. The selected layout will be applied to all the Chapters and Topics.

TOC: If you have designed the TOC page layout, select TOC in the drop-down list, and all TOC pages in your document will have the TOC page layout.

List of Figures and List of Tables: You can also specify the page layout for figures and tables. The selected layout will be applied to all the Figures and Tables.

Index: If you have designed an Index page layout, map it to the Index option. Using the stylesheets, you can style different index elements in the PDF output. Use the index styles .idx-header, .idx-footer, .idx-body, .idx-title, .idx-keyword-group, .idx-unit, .idx-keyword, .idx-name, .idx-link and .idx-child to customize the styles for the elements of the index.

Glossary: If you have a Glossary page layout, then map it to the Glossary option.

The terms in the glossary of your PDF output are always sorted in alphabetical order.

You can also add the tag sort-as to define a sort key for the glossary terms. Experience Manager Guides then uses the sort key to sort the glossary terms in place of the glossary terms. If you haven’t defined the sort key, it uses the glossary terms for sorting. For example, you can add the tag sort-as to the glossterm and set its value to A for the term “USB” (For example, <glossterm>USB<sort-as>A</sort-as></glossterm>). Similarly, you can add sort-as tag and set its value to B for the term “Pen Drive”. When you sort these glossary terms, the sort key A for the glossary term “USB” appears before the sort key B for the glossary term “Pen Drive”. So, in the PDF output, “USB” comes before “Pen Drive” on the glossary page.

Using the stylesheets, you can style different glossary elements in the PDF output. Use the glossary styles .glo-header, .glo-footer, .glo-body, .glo-title, .glo-unit, .glo-link, and .glo-term to customize the styles for the elements of the glossary.

Learn more about using the style editor to work with the common content styles.

Front Matter Pages and Back Matter Pages: These page layouts define the styling for front or back matter pages in your book. If you’ve designed the front matter layout, map it to the Front Matter Pages option. When you select the front matter layout from the dropdown, the front matter layout is applied to all topics present in the front matter.

If you’ve designed the back matter layout, map it to the Back Matter Pages option. When you select the back matter layout from the dropdown, the back matter layout is applied to all topics present in the back matter.

Front Matter Pages is also used as a fallback layout for the TOC, List of Figures, and List of Tables. Similarly, Back Matter Pages is also used as a fallback layout for the Index and Glossary layouts. If you have not selected the layout for these, the selected Front or Back Matter Pages layout is applied. If you have not selected the Front or Back Matter Pages layout, the default page layout is applied to them.

Page Layout for Empty Pages: You can also specify the page layout for the empty pages. The selected layout will be applied to all empty pages. For example, if you have designed a Blank page layout for all empty pages, then select Blank in the drop-down list, and all empty pages in your document will have the Blank page layout.

Cover Page and Back Page: If you have designed a cover page layout, then map it to the Cover Page option. Similarly, if you have a back page layout, then map it to the Back Page option. If no cover or back page layouts have been created, then the default page layout is applied.

TOC

Chapters & Topics

List of Figures

List of Tables

Index

Glossary

Citation

{width="550"}

If you do not want to show a particular section in your PDF output, you can hide that by turning the toggle switch off.

You can also define the order in which these different sections are generated in your PDF. To change the default order of these sections, select the dotted bars to drag and drop the sections at the desired location.

Select the dotted bars to drag and drop the page layout at the desired location.

Select Remove Layout to remove a layout.

You can also merge a static page with the previous page or the next page.

You can also add a custom layout multiple times and order them. This helps you publish the static content accordingly.

For example, you can use a custom layout to publish a static warning multiple times within the PDF output.

Default: The default order of the pages as per the source file.

Odd pages first: All odd pages are moved before all even pages.

Even pages first: All even pages are moved before all odd pages.

Reverse: The page order is reversed.

Booklet: All pages are ordered as in a booklet.

Right to Left Booklet: All pages are in right-to-left booklet order.

Custom: Define a custom order of pages instead of a predefined order.

• “a…b” — All consecutive pages from a to b.
• “a,b,c” — New page order a, b, c.
• “a*b” — The page a is repeated b times.
• “-a” — Negative page numbers count backward beginning from the last page and can be combined with other custom orders.
• “X” — All pages of the document. Same result as “1…-1”.

Printer Marks: When you prepare a document for print production, printer marks are added to the page boundaries to assist in proper alignment, trimming, and color selection during printing. By selecting a printer mark, the page boundary is extended to accommodate the mark, which are trimmed during print. You can choose to display the following printer marks in your PDF output:

• Trim Marks: Select the option to place a mark at each corner of the trim area to indicate where the paper needs to be trimmed after printing.
• Bleed Marks: Select to place a mark at each corner of the bleed box to indicate the trim area for the extended image.
• Registration Marks: Select to place a mark outside the crop area for aligning the different separations in a color document.
• Color Bars: Select to add a strip of colors outside the trim area to maintain color consistency and adjust ink density when printing.

Set dimensions for the selected printer marks using the Line Width, Line Color, and Bleed Box Width options.

Media Box size: This is the overall page size including the extended area occupied by printer marks. Use the drop-down option to select the page size for your PDF output or create your own custom size.

Color Space: You are given an option to choose from RGB or CMYK color spaces to print your PDF document. Choose RGB to display the generated PDF digitally and CMYK for physical printing. Colors defined in the document are converted to the chosen color space.

{title}: Creates a cross-reference to the title of the topic. For example, See Useful Links on page 2.

{page} Adds a cross-reference to the page numbers. For example, See on page 1.

{description}: Adds a cross-reference to the text of the description. For example, See the details of AEM Guides.

{chapter}: Adds a cross-reference to the chapter numbers. For example, See on Chapter 1.

{bookmarkText}: Creates a cross-reference to the bookmarked text. For example, See stop_words on page 5.

{captionText}: Creates a cross-reference to caption of the figure or table in your topic. For example, See Airflow on Page 2.

{figure}: Adds a cross-reference to the figure number. Picks the figure number from the auto number styles that you’ve defined for figcaption. For example, you can use “See {figure} on page {page}”. The cross-reference in the output contains the auto-generated figure number and its page number, “See Figure 1 on page 5”.

{table}: Adds a cross-reference to the table number. Picks the table number from the auto number styles you’ve defined for caption. For example, you can use “See {table} on page {page}”. The cross-reference in the output contains the auto-generated table number and its page number, “See Table 1 on page 5”.