PSML

A complete reference of PageSeeder's markup language PSML

<para>

Summary

The <para> element represents a simple 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>
PSStandard equivalent<para>

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 no 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 should be numbered automatically.

In the user interface, the auto-number will appear as a series of 'y.' as the numbering is only computed when the document is published or processed.

@prefix

A manual prefix for the paragraph.

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

Note

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

Examples

 

A simple paragraph.

<para>A simple paragraph.</para>

The PSML above will be converted to HTML as:

<p>A simple paragraph.</p>

 

An indented auto-numbered paragraph.

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

Note

It is often necessary to indent numbered paragraphs.

 

A prefixed paragraph.

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

Note

It is often necessary to indent prefixed paragraphs.

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

Elements: 

Created on , last edited on