Skip to main content

 Element reference

PSML elements from <author> to <xref>



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 kinds of fragment elements are the following:

Usage context

Element categorystructure
PSML levelportable
Permitted content<blockxref>
Permitted parent<section>
HTML equivalentno direct equivalent but akin to <nav>
OpenXML equivalent


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


Following is an example that can be uploaded. Once uploaded, PageSeeder adds 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"
    <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.

Created on , last edited on