Skip to main content

 PSML

A complete reference of PageSeeder's markup language PSML

<para>

Summary

The <para> element represents a paragraph.

Paragraphs can be numbered automatically using the @numbered attribute or manually using the @prefix attribute.

Usage context

Element categoryblock
PSML levelportable
Permitted contentcharacter-style elements, text and images
Permitted parent<fragment> <item> <block> <cell>
HTML equivalent<p> 
OpenXML equivalent<w:p>

Attributes

This element includes the following attributes:

NameTypeRequiredDescription
indentindentnoNumber of levels to indent (1 to 6)
numberedbooleannoIf this paragraph is numbered
prefixxs:stringnoPrefix for paragraph (used for numbered paragraphs)

@indent

The number of levels to indent the paragraph. The indent applies to the whole paragraph but not to subsequent paragraphs.

In the portable PSML level, the indent must not exceed 6, however, in processed PSML, it is possible that the computed paragraph indent exceeds 6.

@numbered

A boolean flag to indicate whether the attributes are numbered automatically.

In the user interface, if the auto-number can not be calculated it appears as a series of ‘y.’ which signals that the publication configuration might need to be modified.

@prefix

A manual prefix for the paragraph.

A manual prefix is an alternative to the auto-numbered prefix and overrides the auto-number.

Although there is no limit on the size of a prefix, be aware that it might not be practical to display long prefixes.

Examples

Paragraph 

A paragraph.

<para>A simple paragraph.</para>

The previous PSML is converted to HTML as:

<p>A simple paragraph.</p>

 Auto-numbered paragraph

An indented auto-numbered paragraph.

<para numbered="true" indent="2">This paragraph is indented.</para>

By default numbered paragraphs are indented.

Prefixed paragraph

An indented paragraph using the manual prefix “2(b)”

<para indent="2" prefix="2(b)">Another paragraph</para>

Schema

XML Schema

<xs:element name="para">
  <xs:complexType mixed="true">
    <xs:choice minOccurs="0" maxOccurs="unbounded">
      <xs:group ref="character-style-group" />
      <xs:element ref="image" />
    </xs:choice>
    <xs:attribute name="indent">
      <xs:simpleType>
        <xs:restriction base="xs:integer">
          <xs:pattern value="[1-6]"/>
        </xs:restriction>
      </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="prefix" type="xs:string" />
    <xs:attribute name="numbered"
                  type="xs:boolean"
                  use="optional"
                  default="false" />
  </xs:complexType>
</xs:element>

Relax Schema

element para {
  attribute indent { xs:integer }?,
  attribute prefix { xs:string }?,
  attribute numbered { xs: boolean }?,
  (character-style-group | image)+
}

Compatibility

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

See also

Created on , last edited on