Default editor – Paragraphs, headings, and other blocks

Key point: Editing paragraphs, headings, pre-formatted content and block labels.

Block-level content formats includes paragraphs, headings, pre-formatted content and block labels.

Options to quickly format blocks of text are available on left of the editing toolbar.

Editing toolbar – blocks

Formatting drop-down

You can also list and switch between block-level formats by using the formatting drop-down.

editing_format_dropdown_block_v59901.png

Paragraphs

When you type a block of text into a fragment, the default representation is “Paragraph”.

In the following images, you see the para icon button is selected, and to the right in the toolbar, in the formatting drop-down, you see “Paragraph”.

Editing toolbar – blocks

Editing toolbar – formatting style

lightbulb icon

When editing a table cell or a list item, you can also use the para icon button to toggle the paragraph on and off, as paragraphs are often unnecessary inside these.

Headings

To represent a paragraph as a “Heading”, click one of the buttons H1-H4 – the button then shows as selected. In the formatting drop-down, you see the format you have chosen, for example, Heading 1, Heading 2.  Although PageSeeder supports heading levels 5 and 6, they aren’t directly available on the toolbar buttons. You can either use one of the keyboard shortcuts or click the angle-down icon icon on the right of the formatting drop-down and select Blocks, then the Heading 5 or Heading 6, or any of the other available block format options.

Alternatively, you can use one of the block patterns to apply a heading format without having to use the editing toolbar, editing context menu, or formatting drop-down.

Once you have applied a heading format, you can toggle between that format and the paragraph format by pressing Control+H. You can increase the heading level by pressing Shift+Tab or decrease it by pressing Tab.

lightbulb icon

Headings are not allowed in table cells.

Applying/removing auto-numbering

To manually apply an auto-number to a paragraph or heading, click the autonumber icon icon in the editing toolbar or the editing context menu.

You can toggle auto-numbering – press Control+J

You can also use the block patterns for numbered headings.

info-circle icon

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

Setting a manual prefix

To apply a manual prefix to a paragraph or heading, click the prefix icon icon in the editing toolbar or the editing context menu to open the Set paragraph/heading prefix dialog. Type your prefix and click Save. To remove a prefix, click the prefix icon icon and then click Remove.

Set heading/paragraph dialog

Preformat

The preformat icon icon can be used for formatting, for example, for plain text to preserve whitespace, or for blocks of computer source code typically with a monospaced font.

It is good practice to use the role to specify the language of code samples.

lightbulb icon

PageSeeder can recognise a number of programming languages and automatically applies syntax highlighting when a valid lang-* role is used.

  • You can use the text pattern ```  to apply preformat.
  • Press Shift+Enter to exit the preformat and place cursor in the next paragraph.
  • To remove a preformat, click the para icon icon.

Block labels

Block labels have a name and can wrap blocks of content such as paragraphs or lists.

info-circle icon

Project managers configure labels at the project level – for more information, see configuration.

Block labels can be nested if the content is already inside a block label, but it can make editing difficult. 

Add a block label

  • In the editing toolbar, click the angle-down icon icon to the right of the label icon icon to reveal a drop-down list of available block label names – click a label to apply.
  • In the editing context menu, hold the cursor over the label icon Block labels option to reveal a drop-down list of available block labels – click a label to apply.
  • At the start of an empty line, start typing the text pattern //label_name:. Press Enter when your label displays or when you have clicked your label if more than one option is auto-suggested. An empty block displays, ready for you to type your content.
  • Press Control+Shift+L, the keyboard shortcut to apply the most recently used block label.

Remove a block label

  • In the editing toolbar, click the label icon icon once.
  • In the editing context menu, click the label-slash icon Remove block option.
  • In the editing context menu, click the Clear formatting option.
  • Press Control+Shift+L, the keyboard shortcut to remove the most recently used block label.

Delete an empty block label

  • Press Delete.

Exit a block label

  • When at the end of the last paragraph, press Enter twice.
  • When at the end of the last item in a list, press Enter three times.

Change a block label

  • First remove the unwanted label, then add the new label.