PDF Layout Studio

3.1.1. Page dimensions

This menu contains settings that apply to all pages of a document.

The default measurement unit is “millimeters”.

There are two other units of measure to choose from for some parameters:

Header and footer

Use these settings to adjust the row height with the full page preview.

Make the initial header and footer setup with the menu Header and footer.

3.1.2. Structure element titles

The settings made in the Default menu affect all structural elements present in the document.

The menu of each element allows you to set specific values for some styles while preserving the default values for others.

By setting the particular values, the arrow to the right of each parameter becomes active.

Click the arrow to return to the default.

The Hyphenate feature allows you to hyphenate a particularly long word at the end of a title line.

3.1.3. Section titles

This menu is dedicated to setting the titles of 6 section levels.

The Hyphenate feature allows you to hyphenate a particularly long word at the end of a title line.

3.1.4. Text body

This menu is dedicated to setting the text of the document excluding the titles.

The Show links reference feature allows you to display the url address of a link embedded in the text via Links & References → Links → External Link.

3.1.5. Table of contents

This menu is dedicated to setting the table of contents:

Click on next to the item for which you want to display the table of contents preview.

Click on next to the items you want to enable/disable the table of contents for in your publication.

The “Maximum Level” parameter defines the granularity of the table of contents.

The “Section Levels” setting defines the granularity of the table of contents specific to document sections.

	The result of this setting is visible directly in the publication.

Use the Choose structure elements menu (to the right of the preview area) to hide elements that are missing from the structure of your document in the preview.

The Entry Style menu allows you to format each type of element defined for the table of contents.

3.1.6. Header and footer

This menu is dedicated to the configuration of headers and footers for all the pages of the document, including the title page.

Editing modes

There are three editing modes:

This tab allows you to preview headers and footers along with the page content.

Composition of header and footer

Setting up the header and footer areas includes:

The composition of the header or footer is done by dragging and dropping a widget into the desired area on the green background that appears when the widget hovers over the top edge of the area:

A zone can host several widgets.

Editing a widget placed in the area follows the procedure described in Widgets.

3.1.6.1. Widgets

The settings panel contains widgets that can be used in the header and/or the footer.

Editing each widget can be done directly on the settings panel. In this case, the widget can be reused as a template with predefined formatting. This type of editing is recommended for Text and Image widgets where the content can be modified for each reuse.

The standard widgets that bear the name of the elements of the XML document (Title, Date, Author, etc.), are reserved for these elements only. The custom Xpath widget allows you to retrieve other elements from the XML document to link them to the style sheet.

The configuration of the personalized Xpath widget follows the procedure described in Custom Xpath Widget Setup.

1. Click on to the right of the widget name.

   A window opens with the settings.

2. Click on one of the colored parts of the margins and borders diagram to display its characteristics:

   

   The result of the setting is displayed in the preview area at the bottom of the window.

Custom Xpath Widget Setup

The custom Xpath widget allows you to retrieve elements from the XML document that are not available in the standard widgets.

Custom Xpath widget is used in headers and footers and cover pages.

XPath is a language for identifying the elements of an XML structure. The configuration of the widget consists in composing an access path for the element of the XML document. This path is made up of nodes (elements, attributes, processing instructions, etc.) linked together by path expressions.

Figure 2. Example of the path

	The use of path expression types is described in Table 1, “Most Common Path Expressions”.

The Information block contains information that is not published by default. The custom XPath widget allows them to be published.

Elements that can be retrieved from the style sheet via xpath, must also be placed in the Information block of the XML document:

Figure 3. Example of the Information block and its contents

Procedure 26. To compose the xpath:

1. In the Information block, select the desired element.

2. In the Context, locate the name of this element.

   Figure 4. Example of an element name in Context

   
   
   

   	These names are part of the naming convention according to the DocBook standard and are displayed in the tooltip when hovering over each element.

3. In the studio, drag the widget into the preview area. Click on to the right of the widget name.

4. In the XPath field of the studio, place the nodes represented by the names of the elements. Precede each name with d: and separate with /. Since the elements are placed in the Information block, the path will start with d:info/.

   	For xpath elements in the header or footer, the path must start with /*/. This allows the style sheet to retrieve the element for all sequences of pages generated by the structural elements (chapters, sections, preface, etc.) present in the document. Figure 5. Example of location path in header or footer

	The value-of or apply-templates feature.  When publishing, some items may be published in red: . This is because the stylesheet cannot find a model associated with this element. In this case, selecting value-of extracts the text content of the element.

Setting the xpath to select particular elements of the same type

It is possible to retrieve several elements of the same type (several images, several tables, etc.) in the style sheet via xpath.

Here is the example of the image recovery procedure.

1. Place all the necessary images in the Information block > Cover.

2. Give each image a different value in the role attribute by selecting the imageobject element.

   Figure 6. role attribute for imageobject

   
   
   

3. Compose the xpath for each image as follows in the example: d:info//d:imageobject[@role='image_produit'].

Table 1. Most Common Path Expressions

Syntax	Use	Example
d:	indicates that the element belongs to the DocBook namespace.	d:info/d:date
/	used to select children of an element. It indicates that we want to select an element that is directly under the parent element.	d:info/d:date For the example given, the date element is a child of the info element.
//	used to search items in depth.	d:info//d:date For the given example, we will search for all the date elements that are in the info block regardless of their parents.
*	selects all items.	d:info/d:legalnotice/d:*
[]	used to filter selected items based on their attributes or values. Or to represent an index in a list.	d:info/d:legalnotice[2] For the given example, the xpath selects the second legalnotice element, child of the info element.
@	selects attributes.	d:info/d:date[@role='anniversaire'] For the given example, we select the imageobject elements that have the role attribute with the value “anniversary”.

3.3.1. Lists and procedure steps

These menus are used to manage the configuration of lists and procedure steps up to four levels.

Bulleted lists

The Symbol drop-down menu offers a choice of predefined bullets, no bullet, or a custom bullet.

To integrate a custom bullet:

3.3.2. Tables

This menu is used to configure:

3.3.3. Admonitions

This menu allows you to customize the admonitions icons.

The default icon preview depends on the content in your workspace that matches those items.

For spaces that contain the standard style sheet, the default preview is as follows:

For spaces that contain the custom stylesheet for admonitions, etc., the preview will show the custom icons.

It is possible to modify the icons:

To modify a created style sheet, click on its label in the list of style sheets. It opens in the studio for editing.