Improve handling of page breaks (#916)

* Remove page break from title and always allow for partition and chapter
* Move strip of format string into the Tokenizer class
* Fix page breaks in HTML for skip and sep
* Update documentation
* Update tests
* Allow page breaks before scene and section headers
* Never hide the scene header and instead default to skip line

docs/source/project_structure.rst

@@ -30,13 +30,13 @@ title. See also the :ref:`a_fmt` section for more details about the markdown syn
 The syntax for the four basic header types, and the two special header types, is listed in section
 :ref:`a_fmt_head`. The meaning of the four levels for the structure of your novel is as follows:
 
-**Header Level 1**
+**Header Level 1: Partition**
    This header level signifies that the text refers to a top level partition. This is useful when
    you want to split the manuscript up into books, parts, or acts. These headings are not required.
    The novel title itself should use the special header level one code explained in
    :ref:`a_fmt_head`.
 
-**Header Level 2**
+**Header Level 2: Chapter**
    This header level signifies a chapter level partition. Each time you want to start a new
    chapter, you must add such a heading. If you choose to split your manuscript up into one
    document per scene, you need a single chapter document with just the heading. You can of course
@@ -44,17 +44,21 @@ The syntax for the four basic header types, and the two special header types, is
    chapter with a quote or other introductory text that isn't part of a scene, this is also where
    you'd put that text.
 
-**Header Level 3**
+**Header Level 3: Scene**
    This header level signifies a scene level partition. You must provide a title text, but the
    title text can be replaced with a scene separator or just skipped entirely when you export your
    manuscript.
 
-**Header Level 4**
+**Header Level 4: Section**
    This header level signifies a sub-scene level partition, usually called a "section" in the
    documentation and the user interface. These can be useful if you want to change tag references
    mid-scene, like if you change the point-of-view character. You are free to use sections as you
    wish, and can filter them out of the final manuscript just like with scene titles.
 
+Page breaks are automatically added before level 1 and 2 headers when you export your project to a
+format that supports page breaks, or when you print the document directly from the build tool. If
+you want page breaks in other places, you have to specify them manually. See :ref:`a_fmt_break`.
+
 .. tip::
    There are multiple options of how to process novel titles when exporting the manuscript. For
    instance, chapter numbers can be applied automatically, and so can scene numbers if you want
@@ -76,7 +80,7 @@ document, like so:
 The title is by default centred on the page when exported. You can add more text to the page as you
 wish, like for instance the author's name and details.
 
-If you want an additional page inserted after the title page, starting on a fresh page, you can add
+If you want an additional page of text after the title page, starting on a fresh page, you can add
 ``[NEW PAGE]`` on a line by itself, and continue the text after it. This will insert a page break
 when the project is exported.
 
@@ -93,7 +97,9 @@ build tool to skip these chapters.
 ``##! Unnumbered Chapter Title``
 
 There is a separate formatting feature for such chapters in the :guilabel:`Build Novel Project`
-tool as well. See the :ref:`a_export` page for more details.
+tool as well. See the :ref:`a_export` page for more details. When exporting to a format that
+supports page breaks, also unnumbered chapters will have a page break added just like for normal
+chapters.
 
 .. Note::
    Previously, you could also disable the automatic numbering of a chapter by adding an ``*`` as

docs/source/usage_format.rst

@@ -218,3 +218,11 @@ headers of level two for novel documents, i.e. chapters, but not for project not
 
 If you need to add a page break somewhere else, put the text ``[NEW PAGE]`` on a line by itself
 before the text you wish to start on a new page.
+
+Page breaks are automatically added to partition, chapter and unnumbered chapter headers of novel
+documents. If you want such breaks for scenes and sections, you must add them manually.
+
+.. note::
+   The page break code is applied to the text that follows. It adds a "page break before" mark to
+   the text when exporting to HTML or Open Document. This means that a ``[NEW PAGE]`` which has no
+   text following it will not result in a page break.

docs/source/usage_interface.rst

@@ -34,10 +34,7 @@ the project. It has four columns:
 
 **Column 4**
    The fourth column shows the user-defined status or importance labels you've assigned to each
-   project item. See :ref:`a_ui_tree_status` for more details. By default, both the icon and the
-   label text is shown, but you can turn off the text label from :guilabel:`Preferences`. If the
-   text label is off, the text will instead appear in a tooltip when you hover your mouse over the
-   icon.
+   project item. See :ref:`a_ui_tree_status` for more details.
 
 Right-clicking an item in the project tree will open a context menu under the cursor, displaying
 a selection of actions that can be performed on the selected item.