PSML

A complete reference of PageSeeder's markup language PSML

<xref-fragment>

Summary

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">)

Attributes

This element includes the following attributes

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

@id

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

@type

The type of fragment

Examples

Schema

XML Schema

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

Relax Schema

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

Compatibility

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