Paragraph
Key point: A running block of text that can have indentation and numbering.

A paragraph is the default container for a running block of text in PageSeeder.

See paragraphs in PSML for more detailed explanations on the usage of paragraphs in relation to other text containers such as block labels, tables and lists.

Numbering and indentation

By default, paragraphs have no numbering or indentation.

You can add numbering to a paragraph so that it can be preceded by a numbering prefix and considered for the document hierarchy. By default, only headings are included in a TOC, but it can be configured to include auto-numbered or prefixed paragraphs.

When you insert a paragraph after a numbered paragraph, it is automatically numbered by PageSeeder. You can easily remove the numbering from the new paragraph if you want.

Auto-numbering

Project managers configure auto-numbering at the project level – for more information, see publication type.

PageSeeder defaults to auto-numbering. The auto-numbering automatically numbers paragraphs based on their position in the numbering hierarchy and scheme. This means that the numbering changes automatically when the numbering of the preceding heading or paragraph changes or when the document’s position changes in a publication.

During editing, PageSeeder waits until you save your document to recompute the numbering. PageSeeder automatically recomputes the numbering even when documents are inserted, moved or removed from the publication.  

Manual numbering

If you prefer controlling the numbering manually, or the prefix doesn’t match your numbering scheme, you can manually specify the prefix for the paragraph.

Indentation

When you number paragraphs, PageSeeder automatically indents the paragraph. Paragraph indentation reflects the level of the paragraph in the numbering hierarchy.

If a paragraph is numbered but not indented, its numbering prefix appears in the gutter of the document. Although it is possible, it isn’t recommended.

For developers

In PSML, paragraphs are represented using the <para> element.

For more information, see the para element in the PSML reference on the PageSeeder developer’s website.