Over view of new features for every version

Version 5.1

Below are some new features in PageSeeder Version 5.1. For full details of the new features and changes see Release notes.


Transclusions are XRefs (cross-references) where the linked content appears as if it is part of the source document. In other words the XRef link is replaced by the linked content on the document view page.

This can be useful in the following situations:

  • if the same content appears multiple times in different places
  • if an image has a low resolution and a high resolution version they can be stored in a separate file called an "image shell" but appear as if they are actually in the documents that use them

A transclusion can be created by setting the Link Type for the XRef to Transclude.


The transclusion will then appear as an XRef link in the editor.


In  the document view the transcluded content will appear inside a box. Clicking on the bottom of the box will direct to the document that contains the content.


To create an XML document outside PageSeeder which includes a transclusion, a  <blockXref> element with the @type="Transclude" attribute needs to be used, for example:

<blockXref title="Low-res" frag="1.1251"
  display="document+manual" type="Transclude"
  href="system_overview.xml">System Overview: Low-res</blockXref>

Hierarchical XRefs

Hierarchical XRefs (cross-references) allow creation of content documents that all start with heading1, but assemble those documents in a hierarchy using one or more masters documents. When the documents are published, the headings will be adjusted to the correct level for the hierarchy.

This can be useful for:

  • Easily re-arranging the content hierarchy without having to change the individual heading levels
  • Being able to easily see the hierarchy in a single master document
  • Have the same content appear at different levels in different hierarchies with the correct heading levels

A hierarchical XRef is created by adding a @level="x" attribute on <xref> or <blockXref> elements, where x is a number from 1 to 5. This level can be modified using the XRef List editor on Master documents using the left and right arrow buttons.


When publishing using generate-concatenated-xml the @level attribute will automatically change heading and para levels on the target content relative to the source document. For example if master (M) has an XRef to master (N) with level 2, and master (N) has an XRef to document (A) with level=3 (M -2-> N -3-> A). Then when (M) is published, a heading1 in document (A) will become a heading6 (2 + 3 + 1).


Created on , last edited on