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.

Formatting drop-down

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

Paragraphs

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

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

When editing a table cell or a list item, you can also use the 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 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.

Headings are not allowed in table cells.

Applying/removing auto-numbering

To manually apply an auto-number to a paragraph or heading, click the 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.

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 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 icon and then click Remove.

Preformat

The 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.

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 icon.

Block labels

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

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 icon to the right of the 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 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 icon once.
  • In the editing context menu, click the 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.