Basic concepts
The Book hierarchy
Parts
A novel is expected to be divided into chapters and sections. Parts are optional; technically they are first level chapters. However, in the novelibre project tree they are on the same level as the chapters, but they produce a heading one level above. Thus, parts are mainly for inserting first level headings between the chapters, if needed.
Hint
You can convert chapters into parts and vice versa by simply changing the level.
Note
A predecessor of novelibre was novelyst. There, the parts were on a higher hierarchy level in the project tree than the chapters, as it corresponds to logical perception. It was therefore possible to move parts together with their subordinate chapters, or to mark entire parts as “Unused”. In practice, however, this proved to be cumbersome. I find it easier to move only the part boundaries and leave the chapter order unchanged when defining parts.
Chapters
A novelibre project must at least have one chapter. In the exported documents, regular chapters have a second level heading.
For novelibre, the chapters only serve as containers for sections to which the actual dramaturgical function is assigned. This is why there are only a few chapter properties to be set.
Sections
All body text of a novel in novelibre belongs to sections. Sections can be scenes, pieces of exposition, descriptions, narrative summaries—it is entirely up to you how you divide your text into sections. There is a variety of metadata for sections for your free use.
In the text body of the exported documents, sections are separated by section dividers by default, like so:
* * *
However, if you need more fragmented sections when plotting and organizing than the reader should see later, you can also append sections to each other as new paragraphs with no section divider inbetween.
Part/chapter/section types
Each part, chapter, and section is of a type that can be changed via context menu or Part/Chapter/Section menu. The type can be Normal or Unused.
- Normal
“Normal” type parts, chapters, and sections are counted. The totals are displayed in the status bar.
“Normal” type sections are exported to the manuscript and included in the word count.
“Normal” type parts and chapters can have subelements of each type.
“Normal” type tree elements are color coded according to the coloring mode settings.
- Unused
You can mark parts, chapters, and sections as unused to exclude them from word count totals and export.
The subelements of unused parts and chapters are unused as well.
If you mark a section “Unused”, its properties are preserved.
Unused tree elements are displayed in gray.
Section completion status
You can assign a status to each “Normal” type section via context menu or Section menu. You can choose between Outline*, Draft, 1st Edit, 2nd Edit, and Done.
You can choose a coloring mode to display sections in different colors depending on their completion status.
Optionally, you can declare one of the status to be the current work phase, and choose a coloring mode that highlights sections that are behind schedule.
Newly created sections are set to “Outline” by default.
Word counts by status appear in the Book properties.
Characters and story world
You can define characters, locations, and items, and you can relate them to sections to keep track of their place in the story. There is also some metadata stored with novelibre, mainly as a quick reference that might come in handy when writing or editing.
Note
novelibre is not meant as a tool for extensive world building. For this, there is a plethora of dedicated applications, online and offline wikis, and notetaking software. However, novelibre offers the option of linking images and files with the characters, locations, and items to facilitate access if your external application allows this.
Important
If you want to assign viewpoint characters to your sections, you first have to create the characters that come into question.
Formatting text
It is assumed that very few types of text markup are needed for a novel text. When importing from ODT, novelibre supports the following formats:
Emphasized style or italics.
Strongly emphasized style or bold.
Quotations (paragraph visually distinguished from body text).
Unordered list item (indented paragraph with a bullet).
About document language handling
ODF documents are generally assigned a language that determines spell checking and country-specific character substitutions. In addition, Office Writer lets you assign text passages to languages other than the document language to mark foreign language usage or to suspend spell checking.
- Document overall
The project language (Language code acc. to ISO 639-1 and country code acc. to ISO 3166-2) can be set in the Book settings (right pane) under Document language.
- Text passages in sections
Paragraph-wise or inline text markup for other languages is supported by novelibre.
Project lock
When exporting a document that can be edited outsides novelibre, the project can be automatically locked in order to prevent confusion. This behavior depends on the Export settings.
Important
The project can only be locked if all changes are saved.
In locked state, the project cannot be modified via the user interface. The footer bar is then displayed in reversed colors, the menu entries for changing data or exporting other documents are greyed out, and the widgets in the Properties view are disabled.
The project lock state is persistent. This is achieved by automatically
creating a lock file named .LOCK.<project name>.novx#. If you delete
this file while novelibre is not running, the project will be unlocked
upon next start.
Usually, the project is automatically unlocked after re-importing the externally edited document.
Hint
The project lock is nothing more than a strong reminder. You can
unlock the project at any time at your
own risk. You also can manually lock the project,
if necessary. The 
toolbar button toggles the locking state.
Comments, footnotes, endnotes
ODT comments, footnotes, and endnotes are supported by novelibre.
Tip
novelibre has no support for images in the text body. You can instead use comments as placeholders. Replace them with your images (or any other special formatting beyond the capabilities of novelibre) at the end, when you prepare your finished novel for publishing.