A complete reference of PageSeeder's markup language PSML



The <xref-fragment> element is a specialized fragment which only contains block-level cross-references.

It is used to create a collection or hierarchy of documents.

Other kind of fragment elements:

Usage context

Element categorystructure
PSML levelportable
Permitted content<blockxref>
Permitted parent<section>
HTML equivalentno direct equivalent but akin to <nav>
OpenXML equivalent
PSStandard equivalent<body>
(when <section format="psxreflist">)


This element includes the following attributes

idfragment-idyesThe fragment ID.
typefragment-typenoThe template type.
labelslabel-listnoA list of fragment labels


A identifier for this fragment that is unique within the document.


The type of fragment


Below is a simple example that can be uploaded. Once uploaded PageSeeder will add all the generated attributes and content.

<xref-fragment id="5">
  <blockxref href="chapter1.psml" frag="default">
     Chapter 1: Down the Rabbit-Hole
  <blockxref href="chapter2.psml" frag="default">
     Chapter 2: The Pool of Tears


XML Schema

<xs:element name="xref-fragment">
         <xs:element ref="blockxref" minOccurs="0" maxOccurs="unbounded"/>
      <xs:attribute name="id" type="fragment-id" use="required"/>
      <xs:attribute name="type" type="fragment-type"/>
      <xs:attribute name="labels" type="label-list"/>

Relax Schema

element xref-fragment {
   attribute id { fragment-id },
   attribute type { fragment-type }?,
   attribute labels { label-list }?, 
   element blockxref*


This element was introduced in the first draft of PSML and is well supported from PageSeeder 5.1.

PS Standard XML

In the Standard Format, fragments are expressed using the <body> element and a different algorithm is used to compute their Fragment identifier. Support for the @pagebreak attribute has been dropped.

Section formats have been deprecated and new specialized fragments have been created. The PSML <xref-fragment> element corresponds to a Standard Format <body> element when the parent section has format "psxreflist".

While the Standard format contained a list of XRefs wrapped in paragraphs. The PSML <xref-fragment> only accepts a sequence of <blockxref> elements.

See also

Created on , last edited on