Create a “Chapter” page layout using the steps given under “Create a new page layout” procedure.
- RoboHelp User Guide
- Introduction
- Projects
- Collaborate with authors
- PDF Layout
- Editing and formatting
- Format your content
- Create and manage cross-references
- Create and manage links
- Single-source with snippets
- Work with images and multimedia
- Create and use variables for easy updates
- Work with Variable Sets
- Use Find and Replace
- Auto save your content
- Side-by-side editing in Split View
- Use the Spell Check feature
- Create and Edit Bookmarks
- Insert and update fields
- Switch between multiple views
- Autonumbering in CSS
- Import and linking
- TOCs, indexes, glossaries, and citations
- Conditional content
- Microcontent
- Review and Collaboration
- Translation
- Generating output
- Publish output
- Publish to a RoboHelp Server
- Publish to an FTP server, a Secure FTP server, or a File System
- Publish to SharePoint Online
- Publish to Zendesk Help Center
- Publish to Salesforce Knowledge Base
- Publish to ServiceNow Knowledge Base
- Publish to Zoho Knowledge Base
- Publish to Adobe Experience Manager
- Publish to Atlassian Confluence Knowledge Base
- Publish to a RoboHelp Server
- Appendix
Design a page layout
When creating a PDF document, you would have different sections for presenting different types of information. For example, a PDF document would start from a front or cover page, which would have your company’s logo, book title, or version information. Then there would be chapters, appendices, or glossary pages. Each section in a PDF document looks different and that is achieved by creating and customizing the page layout.
When you design your page layout, you can define the various elements that make up a page. For example, you can define the page size, margins, header and footer, orientation, and other page specifications on a page. The PDF Publishing feature allows you to design your page as per the Page Media standards. Most of the settings that are covered under the Paged Media standards can be easily customized using the PDF Publishing feature’s user interface. For some other advanced-level formatting, you can use the Source view to write your own CSS code.
Once you have designed the page layouts, you need to associate these layouts with their respective sections in the PDF Page Layout settings.
See the Create and customize page layouts section for details on how to create and open a page layout for customization.
Types of page layouts
A PDF document typically contains the following sections:
- Cover page
- Table of contents
- Lift of figures
- Lift of tables
- Chapter or topic pages
- Glossary
- Index
- Back page
These sections would need a corresponding page layout to present the information in a specific format. In addition, you can also have a blank page that is used as a filler to start a new chapter from an odd or even page. In that case, you can either use the default page layout or create a page layout for a blank page.
The Page Layouts settings under the Template>Settings section allow you to define which page layout is to be used for different sections of your PDF. Each page layout can further have different first, right, or left page variants.
Create the first, right, or left page layout variants
Different page layouts in your PDF template can be further customized by having different first, right, or left page layout variants. You can design these pages differently using the page layout designer.
Consider the following points when creating the page layouts:
- If you want to use a single page layout for all pages within a chapter, then you would create only a single chapter page layout without any variant.
- If you want to have a different look and feel for the first page for chapters in your book, then you need to create a First page layout variant for your chapters.
- If you want to have a different look and feel for every left and right side page of your book, then you need to create the Left and Right side variants for your chapter page layout.
- If you want your chapters to start from an odd or even page, then can choose to create a page layout for the blank page. This page layout is used to fill the gap between two chapters to ensure the chapter starts from the desired odd or even page.
The following example will walk you through the process of creating variants of a page layout:
-
A blank Chapter page layout is created and added under the Page Layouts.
By default, when you create a page layout, it is also opened up for editing. The following screenshot displays a blank (default) page layout:
The header, footer, and content area in a template is created by default. You can easily customize these areas using the page properties, content properties, and various tools (like inserting images, fields, and more) given in the user interface.
-
Mouse hover over the Chapter layout, and click Options to display the context menu.
-
Click or mouse hover over Add Layout Variant and choose the desired page layout (First, Left, or Right) that you want to create.
The selected page layout is created using a copy of the base Chapter layout. This means that if you have made any changes in the default Chapter page layout, the same changes are replicated in the variant page layout at the time of page layout creation.
Work with the Page Properties of a page layout
While designing a page layout, having control over various page properties is essential. The PDF Publishing feature encapsulates all major page properties under the Page Properties panel. The Page Properties panel provides access to various properties under the following sections:
- Page Size : Specify the page size you want to use for the page layout. The Page Size dropdown list allows you to choose from over 15 page sizes. You can also create a page layout using a custom page size, see Set the page size for more details.
- Orientation : Specify the page orientation to use for the page layout. You can choose from Portrait or Landscape page orientations. Note that you can choose to have different orientations applied to different page variants in a page layout. For example, if your content contains a wide table or a large image, then you can create a landscape page layout and apply that layout to the wider table or image.
- View Rotation : Specify the side or direction in which the original top side is represented after rotation. You can choose from Clockwise 90, Anticlockwise 90, or Anticlockwise 180 degrees. This is very useful in a situation wherein you want to use a combination of Portrait and Landscape layouts in your output. For example, you can use portrait as the generic page layout, and you can set a landscape page layout for rendering wide tables. In that situation, you can set to display the table content in Clockwise 90 degrees. That way the page will be oriented in landscape and the content will be rotated 90 degrees to maintain continuity in view. We will see how this is achieved as an example later in this section.
- Page Numbering Restart from : Specify the page number from where the numbering for this page layout will start. For example, you can set the page number to restart for every chapter. In that case, you need to set the Restart Numbering from property to 1 on the First page layout variant of the chapter page layout.
Apply to the first occurence only: If selected, this option enables you to reset the page number specifically for only the first occurence of any Page Layout, with the following pages being numbered automatically thereafter. For example, if you set the Page Numbering Restart from to 2 and select the option Apply to the first occurence only, then only the first page of the first chapter will begin from page number 2. Subsequent pages will then continue numbering automatically after 2.
- Layout : Specify page margins along with padding for top, bottom, left, and right sides. The following illustration explains how margins, padding, and borders are rendered around the content. Note that the margin at the top and bottom of a page contain the header and footer.
- Background : Include an image or a color as the background of your page layout. For an image, you can specify the height and width of the image along with repetition and position properties.
- Footnote : Specify the properties to display footnotes in your output. You can choose to specify the margins and padding properties along with a border style.
Set the page size
The very first thing that you need to define in a page layout is the page size. In the Page Properties, there are over 15-page sizes that you can choose for a page layout. You can also create a custom page size by performing the following steps:
-
Open the required page layout for editing.
-
In the right panel, click Page Properties.
-
- In the Page Size drop-down list, select Custom.
- The Page Width and Page Height fields are displayed.
-
- Enter the desired page dimensions in the Page Width and Page Height fields.
Use page orientation and view rotation
Let’s look at an example wherein a combination of portrait and landscape page orientation and view rotation properties are used. In this example, we will create a PDF with default portrait orientation, but a table will be rendered in landscape orientation with content in Clockwise 90 degree view. The final output will look something similar to:
In the above output, the Contact List information is presented in landscape mode with content also rotated in 90 degrees. The remaining content is displayed in the normal portrait mode.
To achieve this kind of output, we need to perform the following main tasks:
-
Create a page layout with Landscape orientation.
-
Change the View Rotation property to render content in 90°.
-
Create a custom style to use the new page layout.
-
Add the style in the outputclass definition of the table that we want to render in the landscape page layout.
Perform the following steps to achieve the above tasks:
-
Create a page layout with Landscape orientation.
Create a “Landscape” page layout using the steps given under “Create a new page layout” procedure.
In the right panel, click Page Properties.
Change the Orientation to Landscape.
-
Change the View Rotation property to render content in 90° clockwise direction.
Select Clockwise 90° from the View Rotation dropdown list.
Click Save All to save the updated page layout properties.
-
Create a custom style to use the new page layout.
Expand the left sidebar and double-click on the template in which you want to create the style.
Expand the Stylesheets section.
Hover over the Layout stylesheet, and click the (Options icon) … and choose Edit.
The Layout stylesheet is opened for editing.
Right click on Other Styles and choose New Style.
In the Add Style popup, enter landscape-style in the classname.
Select Done.
Double-click on the .landscape-style style to open it for editing.
Expand the Pagination property.
Enter Landscape in the Page Layout property.
Select Save All.
-
Add the style in the class definition of the table that we want to render in the landscape page layout.
In a topic editor, open the file where you want to apply the new page layout.
Find the <table> element, which is to be rendered in Landscape mode.
In the breadcrumb, click on the table element to select the table.
In the right panel, click and open the Content Properties panel.
Add a class property with landscape-style as property value.
-
Select Save All.
-
Generate the PDF output.
Add a background image
Based on your requirements, you might want to add a background image that appears on every first page of a Chapter (PDF) output. The Background properties under the Page Properties allow you to easily add a background image. You can choose to replicate this image across a page, and position the image anywhere in the top, bottom, or center area of the page.
For example, to insert a background image in the center part of your content area, then perform the following steps:
-
Open the required page layout for editing.
-
Click anywhere in the content area.
-
In the right panel, click Page Properties.
-
Click the browse button in the Image Path location field.
-
Browse to and select the image you want to use as the background image.
-
Change the image size by adjusting the height and width properties.
-
Set the other properties to adjust the way you want the background image to appear.
Background Repeat : Specify whether you want the background to repeat or not.
Background Position : Specify a position for the background image on your page.
Work with page header and footer
When you include information in a header or footer in a page layout that information is repeated on all pages using that page layout. Typically, the header area is used for chapter or topic title and the footer area is used for showing page numbers.
When you create a new page layout the header and footer area is created by default. You can do many customizations in the header and footer area of a page layout. For example, you can insert an image (like a logo), variables (containing dynamic information), or static content.
Change the header and footer margins and lines
By default, the header and footer margins are set to 1 inch. You can change this default value by changing the Margin setting in the Page Properties panel. Perform the following steps to change the header and footer size:
-
Open the required page layout for editing.
-
In the right panel, click Page Properties.
-
Expand the Layout section.
-
Click the lock icon next to the Margin property.
-
To change the header size, enter the desired value in the Top margin field.
-
To change the footer size, enter the desired value in the Bottom margin field.
Remove the header and footer
The header and footer overlay in the top and bottom margins. Technically, this means that if you want to have a header and footer in your page layout, you must reserve the required space in the top and bottom margins.
If you do not want a page layout to have a header and footer, then there are two ways to achieve this:
- If you want to retain the top and bottom margins, leave the header and footer area blank.
- If you do not want to retain the top and bottom margins (like designing the front and back cover of a magazine), then you can remove the margins by setting the top and bottom margin properties to 0. This leaves no space for the header and footer.
Add an image or a logo in the header
Based on your requirements, you might want to add an image that appears in the header area (or any other part) of the page layout. There are two ways in which you can add an image in your page layout:
- Use an image from the template Resources.
- Use the <Add Image> tool in the page layout editor.
To insert an image like your company’s logo in the header area, perform the following steps:
-
Open the required page layout for editing.
-
Select the Edit Header icon to bring your cursor in the header area.
-
To add an image, choose anyone of the following methods:
Click the Inert Image icon in the toolbar; in the Select Path pop-up, browse to the image location and click Select to insert it in the header area.
Drag and drop an image from the Resources folder into the header area.
Once an image is inserted, you can modify its attributes to give it the look and feel that you want. The easiest way of changing the way an image or any other element on your page layout looks, use the Content Properties panel.
Add fields and metadata
Fields are very useful when you want to insert a piece of information that is pre-defined. For example, you can include a Chapter Title field in your chapter’s header area that is replaced with the actual chapter’s title when published.
There are the following categories for fields that you can insert in your page layout:
- Date
- Time
- Topic Title
- Project Title
- Page Number
- Total Page
- Chapter Title
- Chapter Number
- Metadata
Each of these field categories contain different variations in which the field information can be inserted. For example, a Date field can have different variations such as YYYY-MM-DD, MM/DD/YY, MM/DD/YYYY and so on. Similarly, Page Number can have variations in the form of roman, decimal, or even locale-specific formats such as Arabic, Devanagari, Hebrew, and more.
In addition to the predefined fields, you can also add metadata information as variables or fields in your page layout. This metadata is stored in your source TOC content, and it can be easily inserted in your page layout.
In the following example, we will insert a page number and a chapter title in the footer area of a page layout.
-
Open the required page layout for editing.
-
Select the Edit Footer icon to bring your cursor in the footer area or click inside the footer area.
-
Insert a paragraph element by clicking the Insert HTML Elements icon, and selecting Paragraph from the list of elements.
-
Select the Insert Fields icon.
-
Select the Page Number category from the Field list, the default(1) page number format from the Format list, and select Insert.
-
Enter a blank space after the page number field and click the Insert Fields icon.
-
Select the Chapter Title category from the Field list, the Chapter Title format from the Format list, and click Insert.
The Chapter Title field, which is populated with the chapter’s title at the time of publishing, is inserted in the footer area. At this time, the page number and chapter title fields are separated by a space.
-
To right-align the Chapter Title, perform the following steps:
Click on the Field element on the breadcrumb to select the Chapter Title field.
In the right panel, click the Content Properties icon.
Expand the Layout properties section, and set the Float property value to right.
The Chapter Title field is aligned towards the right side of the page footer.
Work with content area
The content area is the largest area in terms of content space. The content area is populated with your topic’s content. In some special cases, you can add boilerplate content in the content area. This content is published at the specified location in your page layout. For example, the heading in your table of contents, glossary, and index can be added as boilerplate content, which is published “as is” in the final output. Another example is the chapter TOC, which is typically added on the first page of every chapter.
One of the most commonly used customizations in the content area is the multi-column layout. With the powerful page layout designer, you can customize specific pages to render in multiple columns, while keeping the content in other pages in a single column.
In the following sections, we will cover various scenarios to customize the content area.
Add a chapter TOC
A chapter table of contents serves as a quick reference for the readers to know what is in the chapter. Typically, a chapter TOC is added at the very beginning of a chapter. So, if you want to use a chapter TOC, then you can add it in the content area of the main chapter page layout or the first page layout variant of a chapter.
In the following example, we will insert a chapter TOC in the first page layout of a chapter:
-
Open the required page layout for editing.
-
Place the cursor in the content area of the page layout.
-
Select the Chapter TOC icon.
-
Open the Content Properties panel to customize the TOC heading levels.
The look and feel of the default TOC can be customized using the stylesheets. The style starting with chaptoc-level-# (like chaptoc-level-1, chaptoc-level-2, and so on) are used to customize the styles for the chapter TOC.
Work with multi-column page layout
Multi-column page layouts are very common in publishing magazines or indexes in a book. The PDF Publishing feature allows you to easily split your document into multiple columns. Using different page layouts, you can choose to keep only a specific section divided into multiple columns while keeping the other sections in a single column (or normal) layout.
To create a page layout with multiple columns, perform the following steps:
-
Open the required page layout for editing.
-
As the multi-column layout is applied on the content, excluding the header and footer area, you need to select the content element in the breadcrumb.
Once you select the content breadcrumb, the Content Properties panel will show the properties for Columns.
-
Use the multiple column properties to customize the multi-column page layout:
Column Count: Specify the number of columns to divide the page. Use the up and down arrow icons or enter a number to set the number of columns.
Column Width: Specify the width of a column in a multi-column layout. By default, the size is set in pixels (px), you can also specify it in pt, rem, em, %, or in units.
Column Gap : Specify the space between individual columns.
Column Span : If you want any element on your page layout to span across columns, then you need to use this property. This is achieved by modifying the style of the desired element using the Stylesheets.
In your page layout, if you want a certain text to appear on the first page of all chapter page layouts, then you can add it to the First page variant of the Chapter page layout.
As shown in the following example, the Span Column property for the heading text is set to all. This ensures that even though the document is multi-column, the heading spans across columns.
Column Fill : Specify how content fills columns. By default, it is set to Balance which fills each column with equal amount of content.
Column Rule : If you want to have a line in between columns, then use this property to define the line or ruling styles. Specify the values for ruling Style, Color, and Width to add a line in between columns.
Work with Content Properties panel
The Content Properties panel lets you easily update the look and feel of the elements on your page layout. The properties under the Content Properties panel are divided into the following sections:
- Font : Contains text-related properties. You can set Font Family, Weight, Size, Text Decoration (as underline, overline, line-through), Text Style (as Bold, Italics, and more), Text Alignment (as left, right, center, or justified), handle White Spaces (as predefine format, no-wrap, break-space, and more), Line Height, Letter Spacing, and Text Indent.
- Border : Contains properties to add and format a border to an element in your page layout. You can set Border Side (as all, top, bottom, right, or left), Border Style (as Solid, Dashed, Dotted lines, or more), Border Color, Width, and Radius for having a curved border. In the following example, a curved border has been added in the header area of the page.
- Layout : Contains properties to configure the layout of an element in your page layout. You can set Height, Width, Margins and Padding (for top, bottom, left, or right), Horizontal or Vertical alignment, Float (as Left, Right, or none), Clear (as left, right, both, or none), element’s Position (as absolute, fixed, relative, or more), Display (as block, content, fix or more), Z Index, Transparency, Transform (by rotating or scaling), and Transform Origin (by X and Y-offset).
- Background : Contains properties to include a background image or color shade. You can set the Image Size (by setting Height or Width), Background Repeat (as repeat, no-repeat, round, or more), and Background Position (as left top, right center, center bottom, or more).
- Columns : Contains properties to configure multi-column properties for the page or any specific element, such as Chapter TOC.