<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 category | block |
|---|---|
| PSML level | portable |
| Permitted content | character-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:
| Name | Type | Required | Description |
|---|---|---|---|
| indent | indent | no | Number of levels to indent (1 to 6) |
| numbered | boolean | no | If this paragraph is numbered |
| prefix | xs:string | no | Prefix 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.