Creating a section

Background

Starting point

The procedure in this topic assumes Skribenta is installed and configured for normal operation, and:

You have logged into Skribenta.
You are assigned to one of the following user roles: content provider, technical writer or administrator.
You have selected the workspace you want to work in.
A content file or a configuration file is created in the workspace.
You have browsed to and opened the file in the Workspace view or the Publications view.

Your need

You need to organize your file content in a way that increases the readability. Sections with titles can give your content a logical flow.

The possibility

It is possible to build sections to organize and structure the included information into hierarchies. Sections are possible to nest within sections, to build a content structure. Within a section, it is possible to insert elements such as paragraphs, tables, lists etc.

The element section is used to create a chapter structure. A section can be placed on different levels, which means that a section can correspond to a part in a book, a chapter, a subchapter, a section, a subsection or an appendix.

A section can be moved up and down in the file hierarchy without needing to change the element type to conform to the hierarchical level (compared to the heading elements h1, h2, h3 and so forth in HTML, which in contrast have pre-defined hierarchical meanings).

A section normally has a title i.e., a title element as the first child. A section title is displayed in many places, for example in the Table of Contents, in the Bookmark part of the PDF reader, in the References ("see Chapter..."), and in the page header.

A published title can consist of three parts: a prefix, a number and the title text. Example: "Chapter 4 Functions". The parts that are printed in the publication are controlled by the style sheet. Only the name of the section needs to be added as the title (in the example 'Functions').

About this task

What you will learn

This instruction tells you how to create a section.

The result

This is the content before creating a section:

This is the content after creating a section:

In the shown images, the XML tags are visible. To show XML tags, see Turning XML element tags on or off.

Overall steps

Open the file, then create a section in the file.

Time

1 minute

Procedure

In the shown images, the XML tags are visible. To show XML tags, see Turning XML element tags on or off.

1. Make sure that the step(s) in section "Starting point" (see section "Background" above) are performed.

2. In your file content, put the caret where you want to create a section.

3. On the top toolbar, click Block > Section (or press Ctrl+Enter).

A section element is created.

4. Type your section title text.

5. Click the section element arrow, or double-click the title element, or press Ctrl+Down Arrow, to expand the section element.

6. Put the caret in the element expansion and type your section content text.

Alternative procedure: Create a section title from a paragraph

In the shown images, the XML tags are visible. To show XML tags, see Turning XML element tags on or off.

1. Make sure that the step(s) in section "Starting point" (see section "Background" above) are performed.

2. In your file content, put the caret where you want to create a section.

3. Type some text that will be your section title.

4. Press Ctrl+Enter.

The text is placed in a title element in a section element.

5. Type your section content text.

Alternative procedure: Create a section from selected content

In the shown images, the XML tags are visible. To show XML tags, see Turning XML element tags on or off.

1. Make sure that the step(s) in section "Starting point" (see section "Background" above) are performed.

2. In your file content, put the caret where you want to create a section.

3. Create some content you want to wrap in a section.

4. Select all the content.

5. On the top toolbar, click Block > Section or press Ctrl+Enter.

The content is wrapped in a section element with an empty title.

6. Type your section title text.