The <linkline-properties/> command

This command assigns the link line formatting preferences applied when processing a full looseleaf partition.

Where allowed

Within the $document mapping.

Range of effect

The entire document.

Attributes

position

Specifies where link lines are positioned within a page.

If fixed, link lines are positioned within a linkline fixed block defined in each page type of your layout. The fixed block link line style is applied from the linkline header/footer mapping

If data, link lines are positioned within a data block declared in the page layout data area and styled using a link line custom marker mapping.

The default link line position is fixed.

name

If the link line position is data, specifies the name of a custom marker block mapping invoked each time a data block link line is processed.

This attribute is ignored if the link line position is fixed.

min-threshold

If the link line position is data, specifies the minimum amount of free space that must exist before a link line can be rendered on a page. At run time, the threshold is defined as the maximum of the specified value and the depth of the rendered link line content.

Data block link lines can appear on the front page or back page of a leaf. If the amount of free space on the front page of a leaf is less than the specified threshold the link line will be rendered on the back of the leaf. If the amount of free space on the back page of a leaf is less that the specified threshold then the link line will not appear.

This attribute is ignored if the link line position is fixed.

side

If the link line position is data, specifies the side of a leaf on which TopLeaf can render a link line. Permitted values are:

  • any — a link line may appear on either the front page or back page of a leaf. This is the default.

  • front — a link line may only appear on the front page of a leaf

  • back — a link line may only appear on the back page of a leaf

This attribute is ignored if the link line position is fixed.

valign

If the link line position is data, specifies the vertical alignment applied when rendering a link line. Permitted values are top, middle, or bottom.The default vertical alignment is top.

The following diagram illustrates how the vertical alignment is applied when rendering a data block link line (shown in red) :

This attribute is ignored if the link line position is fixed.

Link line style and content

A link line can reference the folio of the front page of the following leaf by including the <link-folio/> directive within the link line custom content.

For data block link lines, any spacing between the content at the end of a leaf and the link line is controlled entirely by the above spacing generated by the link line mapping.

Example

The following command specifies that link lines are to be positioned within a data block declared in the page layout data area and styled using the %LinkLine custom marker mapping. A link line will only appear at the end of a leaf on a page that contains at least two centimetres of free space:

<linkline-properties 
	type=”data” 
	name=”LinkLine”
	min-threshold=”2cm”
 />

Restrictions

  • The content of any link line is implicitly bound. A link line can not span or emit, either directly or indirectly, a leaf break, page break, or column break.

  • A link line mapping can not declare, either directly or indirectly, a note, float, or running header.

  • The maximum depth of a data link line is constrained by the depth of the page data block.