diff --git a/docs/source/images/fig_build_settings_headings.png b/docs/source/images/fig_build_settings_headings.png
index a7262725..bba80c30 100644
Binary files a/docs/source/images/fig_build_settings_headings.png and b/docs/source/images/fig_build_settings_headings.png differ
diff --git a/docs/source/images/fig_editor.png b/docs/source/images/fig_editor.png
index f8aee5bb..b2f772bf 100644
Binary files a/docs/source/images/fig_editor.png and b/docs/source/images/fig_editor.png differ
diff --git a/docs/source/images/fig_manuscript_build.png b/docs/source/images/fig_manuscript_build.png
index 31605cd4..b6a92bfc 100644
Binary files a/docs/source/images/fig_manuscript_build.png and b/docs/source/images/fig_manuscript_build.png differ
diff --git a/docs/source/images/fig_manuscript_build_outline.png b/docs/source/images/fig_manuscript_build_outline.png
new file mode 100644
index 00000000..1ec9ffad
Binary files /dev/null and b/docs/source/images/fig_manuscript_build_outline.png differ
diff --git a/docs/source/images/fig_novel_tree_view.png b/docs/source/images/fig_novel_tree_view.png
index b0f92b8f..41eaf1fa 100644
Binary files a/docs/source/images/fig_novel_tree_view.png and b/docs/source/images/fig_novel_tree_view.png differ
diff --git a/docs/source/images/fig_outline_view.png b/docs/source/images/fig_outline_view.png
index 90b4f3d1..3142af04 100644
Binary files a/docs/source/images/fig_outline_view.png and b/docs/source/images/fig_outline_view.png differ
diff --git a/docs/source/images/fig_project_split_tool.png b/docs/source/images/fig_project_split_tool.png
index a7809f82..cb3c498c 100644
Binary files a/docs/source/images/fig_project_split_tool.png and b/docs/source/images/fig_project_split_tool.png differ
diff --git a/docs/source/images/fig_project_tree_view.png b/docs/source/images/fig_project_tree_view.png
index f5058038..b891d3f1 100644
Binary files a/docs/source/images/fig_project_tree_view.png and b/docs/source/images/fig_project_tree_view.png differ
diff --git a/docs/source/images/fig_viewer.png b/docs/source/images/fig_viewer.png
index 7fbdc71d..d53beee1 100644
Binary files a/docs/source/images/fig_viewer.png and b/docs/source/images/fig_viewer.png differ
diff --git a/docs/source/images/python_powered.png b/docs/source/images/python_powered.png
deleted file mode 100644
index d51df248..00000000
Binary files a/docs/source/images/python_powered.png and /dev/null differ
diff --git a/docs/source/images/screenshot_dark.png b/docs/source/images/screenshot_dark.png
index 7f581b72..03433a38 100644
Binary files a/docs/source/images/screenshot_dark.png and b/docs/source/images/screenshot_dark.png differ
diff --git a/docs/source/images/screenshot_default.png b/docs/source/images/screenshot_default.png
deleted file mode 100644
index 93ba2ac8..00000000
Binary files a/docs/source/images/screenshot_default.png and /dev/null differ
diff --git a/docs/source/images/screenshot_light.png b/docs/source/images/screenshot_light.png
new file mode 100644
index 00000000..bb7e22c7
Binary files /dev/null and b/docs/source/images/screenshot_light.png differ
diff --git a/docs/source/index.rst b/docs/source/index.rst
index b0020fc6..7c8d75c3 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -17,14 +17,12 @@ storage for robustness.
:width: 500
The project storage is suitable for version control software, and also well suited for file
-synchronisation tools. All text is saved as plain text files with a meta data header. The core
-project structure is stored in a single project XML file. Other meta data is saved as JSON files.
-See the :ref:`a_breakdown_storage` section for more details.
+synchronisation tools. All text is saved as plain text files, and your project data as standard
+data formats in XML and JSON. See :ref:`a_storage` for more details.
-Any operating system that can run Python 3 and has the Qt 5 libraries should be able to run
-novelWriter. It runs fine on Linux, Windows and MacOS, and users have tested it on other platforms
-as well. novelWriter can be run directly from the Python source, or installed from packages or with
-pip. See :ref:`a_started` for more details.
+Any operating system that has Python 3 and the Qt 5 libraries should be able to run novelWriter.
+It runs fine on Linux, Windows and MacOS, and users have tested it on other platforms as well.
+See :ref:`a_started` for more details.
**Useful Links**
@@ -53,7 +51,6 @@ pip. See :ref:`a_started` for more details.
int_overview
int_started
int_howto
- int_customise
int_glossary
.. toctree::
@@ -83,6 +80,7 @@ pip. See :ref:`a_started` for more details.
:caption: Additional Details
:hidden:
+ more_customise
more_projectformat
more_counting
diff --git a/docs/source/int_howto.rst b/docs/source/int_howto.rst
index fe5b22fa..bab60b39 100644
--- a/docs/source/int_howto.rst
+++ b/docs/source/int_howto.rst
@@ -19,9 +19,9 @@ Managing the Project
.. dropdown:: Merge Multiple Documents Into One
:animate: fade-in-slide-down
- If you need to merge a set of documents in your project into a single document, you can achieve
- this by first making a new folder for just that purpose, and drag all the files you want merged
- into this folder. Then you can right click the folder, select :guilabel:`Transform` and
+ If you need to merge a selection of documents in your project into a single document, you can
+ achieve this by first making a new folder for just that purpose, and drag all the files you want
+ merged into this folder. Then you can right click the folder, select :guilabel:`Transform` and
:guilabel:`Merge Documents in Folder`.
In the dialog that pops up, the documents will be in the same order as in the folder, but you
@@ -36,7 +36,7 @@ Layout Tricks
The formatting tools available in novelWriter don't allow for complex structures like tables.
However, the editor does render tabs in a similar way that regular word processors do. You can
- set the width of a tab in :guilabel:`Preferences`.
+ set the width of a tab in **Preferences**.
The tab key should have the same distance in the editor as in the viewer, so you can align text
in columns using the tab key, and it should look the same when viewed next to the editor.
@@ -66,18 +66,13 @@ Organising Your Text
Depending on your writing style, you may need to separate between soft and hard scene breaks
within chapters. Like for instance if you switch point-of-view character often.
- In such cases you may want to use a scene heading for hard scene breaks and a section heading
- for soft scene breaks. The :guilabel:`Build Manuscript` tool will let you add separate
- formatting for the two when you generate your manuscript. You can for instance add the common
- "``* * *``" for hard breaks and select to hide section breaks, which will just insert an empty
- paragraph in their place. See :ref:`a_manuscript_settings` for more details.
-
- Keep in mind that this is not what the section heading is intended for, so the app will not
- understand the section heading as a scene, but it will be formatted correctly in the manuscript.
+ In such cases you may want to use different scene headings for hard and soft scene breaks. The
+ **Build Manuscript** tool will let you define a different format for scenes using the ``###``
+ and ``###!`` heading codes when you generate your manuscript. You can for instance add the
+ common "``* * *``" for hard breaks and select to soft scene breaks, which will just insert an
+ empty paragraph in their place. See :ref:`a_manuscript_settings` for more details.
.. versionadded:: 2.4
- You can now distinguish between soft and hard scene breaks with a modified scene header. See
- :ref:`a_manuscript_settings_head_hard` for more details.
Other Tools
diff --git a/docs/source/int_introduction.rst b/docs/source/int_introduction.rst
index a23810bd..c67588e7 100644
--- a/docs/source/int_introduction.rst
+++ b/docs/source/int_introduction.rst
@@ -1,15 +1,21 @@
.. _a_intro:
-************
-Key Features
-************
+********
+Overview
+********
.. _Snowflake: https://www.advancedfictionwriting.com/articles/snowflake-method/
.. _Markdown: https://en.wikipedia.org/wiki/Markdown
-At its core, novelWriter is a multi-document plain text editor. It uses a markup syntax inspired by
-Markdown_ to apply simple formatting to the text. It also allows for some extended formatting codes
-using a shortcode format. See :ref:`a_fmt_shortcodes` for more details.
+At its core, novelWriter is a multi-document plain text editor. The idea is to let you edit your
+text without having to deal with formatting until you generate a draft document or manuscript.
+Instead, you can focus on the writing right from the start.
+
+Of course, you probably need *some* formatting for your text. At the very least you need emphasis.
+Most people are familiar with adding emphasis using underscores and asterisks. This formatting
+standard comes from Markdown_ and is supported by novelWriter. It also uses Markdown formatting for
+defining document headings. If you need more specialised formatting, additional formatting options
+are available using a shortcode format. See :ref:`a_fmt_shortcodes` for more details.
.. admonition:: Limitations
@@ -17,22 +23,28 @@ using a shortcode format. See :ref:`a_fmt_shortcodes` for more details.
those relevant for this purpose. It is **not** suitable for technical writing, and it is **not**
a full-featured Markdown editor.
- It is also not intended as a tool to organise research for writing, and therefore lacks
+ It is also not intended as a tool for organising research for writing, and therefore lacks
formatting features you may need for this purpose. The notes feature in novelWriter is mainly
intended for character profiles and plot outlines.
-Your novel project is organised as a collection of separate plain text documents instead of a
-single, large document. The idea is to make it easier to reorganise your project structure without
-having to cut and paste text between chapters.
+Your novel project in novelWriter is organised as a collection of separate plain text documents
+instead of a single, large document. The idea is to make it easier to reorganise your project
+structure without having to cut and paste text between chapters and scenes.
There are two kinds of documents in your project: :term:`Novel Documents` are documents that are
part of your story. The other kind of documents are :term:`Project Notes`. These are intended for
your notes about your characters, your world building, and so on.
You can at any point split the individual documents by their headings up into multiple documents,
-or merge multiple documents into single documents. This makes it easier to use variations of the
+or merge multiple documents into a single document. This makes it easier to use variations of the
Snowflake_ method for writing. You can start by writing larger structure-focused documents, like
-one per act for instance, and later effortlessly split these up into chapters or scenes.
+for instance one document per act, and later effortlessly split these up into chapters or scenes.
+
+
+.. _a_intro_features:
+
+Key Features
+============
Below are some key features of novelWriter.
@@ -40,12 +52,12 @@ Below are some key features of novelWriter.
The aim of the user interface is to let you focus on writing instead of spending time formatting
text. Formatting is therefore limited to a small set of formatting tags for simple things like
text emphasis and paragraph alignment. When you really want to focus on just writing, you can
- switch the editor into :guilabel:`Focus Mode` where only the text editor panel itself is
- visible, and the project structure view is hidden away.
+ switch the editor into **Focus Mode** where only the text editor panel itself is visible, and
+ the project structure view is hidden away.
**Keep an eye on your notes**
- The main window can optionally show a document viewer to the right of the editor. This view
- panel is intended for displaying another scene document, your character notes, plot notes, or any
+ The main window can optionally show a document viewer to the right of the editor. The viewer
+ is intended for displaying another scene document, your character notes, plot notes, or any
other document you may need to reference while writing. It is not intended as a preview panel
for the document you're editing, but if you wish, you can also use it for this purpose.
@@ -58,32 +70,35 @@ Below are some key features of novelWriter.
later split them into multiple documents based on chapter and scene headings.
**Multi-novel project support**
- You can have multiple Novel type root folders in a project. This allows you to keep a series of
- individual novels with the same characters and world building in the same project, and create
- manuscripts for them individually.
+ The main parts of your project is split up into top level special folders called "Root" folders.
+ Your main story text lives in the "Novel" root folder. You can have multiple such folders in a
+ project. This allows you to keep a series of individual novels with the same characters and
+ world building in the same project, and create manuscripts for them individually.
**Keep track of your story elements**
- All notes in your project can be assigned a :term:`tag` that you can :term:`reference` from any
- other document or note. In fact, you can add a new tag under each heading of a note if you need
- to be able to reference specific sections of it.
+ All notes in your project can be assigned a :term:`tag` that you can then :term:`reference` from
+ any other document or note. In fact, you can add a new tag under each heading of a note if you
+ need to be able to reference specific sections of it.
**Get an overview of your story**
- In the :guilabel:`Outline View` on the main window you can see an outline of all the chapters,
- scenes, and sections of your project. If they have any references in them, these are listed in
- additional columns. You can also add a synopsis to each chapter or scene, which can be listed
- here as well. You have the option to add or remove columns of information from this outline. A
- subset of the outline information is also available in the :guilabel:`Novel View` as an
- alternative view to the project tree.
+ It is not the documents themselves that define the chapters and scenes of your story, but the
+ headings that separate them. In the **Outline View** on the main window you can see an outline
+ of all the chapter and scene headings of your project. If they have any references in them, like
+ which character is in what chapter and scene, these are listed in additional columns.
+
+ You can also add a synopsis to each chapter or scene, which can be listed here as well. You have
+ the option to add or remove columns of information from this outline. A subset of the outline
+ information is also available in the **Novel View** as an alternative view to the project tree.
**Get an overview of your story elements**
- Under the document viewer panel you will find a series of tabs that shows the different story
- elements you have created tags for. The tabs are sorted into Characters, Plots, etc, depending
- on which categories you are using in your story. This panel can be hidden to free up space when
- you don't need it.
+ Under the document viewer panel you will find a series of tabs that show the different story
+ elements you have created tags for. The tabs are sorted into **Characters**, **Plots**, etc,
+ depending on which categories you are using in your story. This panel can be hidden to free up
+ space when you don't need it.
**Assembling your manuscript**
Whether you want to assemble a manuscript, or export all your notes, or generate an outline of
- your chapters and scenes with a synopsis, you can use the :guilabel:`Build Manuscript` tool to
+ your chapters and scenes with a synopsis included, you can use the **Build Manuscript** tool to
do so. The tool lets you select what information you want to include in the generated document,
and how it is formatted. You can send the result to a printer, a PDF, or to an Open Document
file that can be opened by most office type word processors. You can also generate the result
@@ -95,7 +110,7 @@ Below are some key features of novelWriter.
Screenshots
===========
-.. figure:: images/screenshot_default.png
+.. figure:: images/screenshot_light.png
:class: dark-light
novelWriter with light colour theme
diff --git a/docs/source/int_overview.rst b/docs/source/int_overview.rst
index e83dcd58..96c938b7 100644
--- a/docs/source/int_overview.rst
+++ b/docs/source/int_overview.rst
@@ -1,28 +1,22 @@
-.. _a_overview:
+.. _a_reading:
-********
-Overview
-********
+******************
+What to Read First
+******************
-.. only:: html
+The documentation of novelWriter is quite extensive. There are a lot of features to get used to,
+but you don't need all of them to get started.
- .. image:: images/python_powered.png
- :align: right
- :width: 220
+The chapters below labelled "Essential Information" are the ones you need to know to use the
+application correctly. By "correctly", it is meant: in a way so novelWriter understands the basic
+structure of your text. It collects a lot of information from your text and uses it to display the
+structure of it in various ways to help you get an overview of your project.
-novelWriter is built as a cross-platform application using `Python 3 `_ as
-the programming language, and `Qt 5 `_ framework for the user interface.
+The chapters labelled "Recommended Reading" includes additional information on how the different
+parts if the application work and what the features do.
-novelWriter is built for Linux first, so this is where it works best. However, it also runs fine
-on Windows and MacOS due to the cross-platform framework it's built on. The author of the
-application doesn't own a Mac, so on-going Mac support is dependent on user feedback and user
-contributions.
-
-Spell checking in novelWriter is provided by a third party library called
-`Enchant `_. Please see the section on :ref:`a_custom_dict` for
-how to install spell checking languages.
-
-For install instructions for novelWriter, see :ref:`a_started`.
+The "Optional" and "Lookup" chapters contain additional information or lookup tables that are not
+essential for using the application.
Using novelWriter
@@ -82,8 +76,8 @@ meta data for it to extract.
the application interface.
:ref:`a_manuscript` - Recommended Reading
- This chapter explains how the :guilabel:`Manuscript Build` tool works, how you can control the
- way chapter titles are formatted, and how scene and section breaks are handled.
+ This chapter explains how the **Manuscript Build** tool works, how you can control the way
+ chapter titles are formatted, and how scene and section breaks are handled.
Additional Details & Technical Topics
diff --git a/docs/source/int_started.rst b/docs/source/int_started.rst
index d53b68cb..d361de2f 100644
--- a/docs/source/int_started.rst
+++ b/docs/source/int_started.rst
@@ -1,8 +1,8 @@
.. _a_started:
-***************
-Getting Started
-***************
+**********************
+Setup and Installation
+**********************
.. _Enchant: https://abiword.github.io/enchant/
.. _GitHub: https://github.com/vkbo/novelWriter
@@ -15,8 +15,8 @@ Getting Started
.. _AppImage: https://appimage.org/
Ready-made packages and installers for novelWriter are available for all major platforms, including
-Linux, Windows and MacOS, from the `Downloads page`_. See below for install instructions for each
-platform.
+Linux, Windows and MacOS, from the `Downloads page`_. See below for install additional instructions
+for each platform.
You can also install novelWriter from the Python Package Index (PyPi_). See :ref:`a_started_pip`.
Installing from PyPi does not set up icon launchers, so you will either have to do this yourself,
@@ -44,7 +44,7 @@ multiple installations has been known to cause problems.
The novelWriter installer is not signed because Microsoft doesn't currently provide a way for
non-profit open source projects to properly sign their installers. The novelWriter project
doesn't have the funding to pay for commercial software signing certificates. You will therefore
- see an additional warning about this when you download the installer.
+ see an additional warning about this when you download and run the installer.
.. _a_started_linux:
@@ -56,6 +56,7 @@ A Debian package can be downloaded from the `Downloads page`_, or from the Relea
GitHub_. This package should work on both Debian, Ubuntu and Linux Mint, at least.
If you prefer, you can also add the novelWriter repository on Launchpad to your package manager.
+The Launchpad packages `are signed by the author `__.
Ubuntu
diff --git a/docs/source/more_counting.rst b/docs/source/more_counting.rst
index ac408937..7272c9fc 100644
--- a/docs/source/more_counting.rst
+++ b/docs/source/more_counting.rst
@@ -8,8 +8,8 @@ This is an overview of how words and other counts of your text are performed. Th
should be relatively standard, and are compared to Libre Office Writer rules.
The counts provided in the app on the raw text is meant to be approximate. For more accurate
-counts, you need to build your manuscript in the :guilabel:`Manuscript Tool` and check the counts
-on the generated preview.
+counts, you need to build your manuscript in the **Manuscript Tool** and check the counts on the
+generated preview.
Text Word Counts and Stats
@@ -31,11 +31,11 @@ After the above preparation of the text, the following counts are available.
**Character Count**
The character count is the sum of characters per line, including leading and in-text white space
characters, but excluding trailing white space characters. Shortcodes in the text are not
- included, but Markdown codes are. Only headers and text are counted.
+ included, but Markdown codes are. Only headings and text are counted.
**Word Count**
The words count is the sum of blocks of continuous character per line separated by any number of
- white space characters or dashes. Only headers and text are counted.
+ white space characters or dashes. Only headings and text are counted.
**Paragraph Count**
The paragraph count is the number of text blocks separated by one or more empty line. A line
@@ -45,10 +45,10 @@ After the above preparation of the text, the following counts are available.
Manuscript Counts
=================
-These are the rules for the counts available for a manuscript in the :guilabel:`Manuscript Tool`.
-The rules have been tuned to agree with LibreOffice Writer, but will vary slightly depending on the
-content of your text. LibreOffice Writer also counts the text in the page header, which the
-Manuscript Tool does not.
+These are the rules for the counts available for a manuscript in the **Manuscript Tool**. The rules
+have been tuned to agree with LibreOffice Writer, but will vary slightly depending on the content
+of your text. LibreOffice Writer also counts the text in the page header, which the **Manuscript
+Tool** does not.
The content of each line is counted after all formatting has been processed, so the result will be
more accurate than the counts for text documents elsewhere in the app. The following rules apply:
@@ -63,36 +63,36 @@ more accurate than the counts for text documents elsewhere in the app. The follo
The following counts are available:
-**Header Count**
- The number of headers in the manuscript.
+**Headings**
+ The number of headings in the manuscript.
-**Paragraph Count**
+**Paragraphs**
The number of body text paragraphs in the manuscript.
-**Total Word Count**
+**Words**
The number of words in the manuscript, including any comments and meta data text.
-**Text Word Count**
+**Words in Text**
The number of words in body text paragraphs, excluding all other text.
-**Header Word Count**
- The number of words in headers, including inserted formatting like chapter numbers, etc.
+**Words in Headings**
+ The number of words in headings, including inserted formatting like chapter numbers, etc.
-**Total Character Count**
- The number of characters on all lines, including any comments and meta data text. Paragraph
+**Characters**
+ The number of characters in all lines, including any comments and meta data text. Paragraph
breaks are not counted, but in-paragraph hard line breaks are.
-**Text Character Count**
+**Character in Text**
The number of characters in body text paragraphs. Paragraph breaks are not counted, but
in-paragraph hard line breaks are.
-**Header Character Count**
+**Characters in Headings**
The number of characters in headings.
-**Text Words Character Count**
+**Character in Text, No Spaces**
The number of characters in body text paragraphs considered part of a word or punctuation. That
is, white space characters are not counted.
-**Header Words Character Count**
- The number of characters in headers considered part of a word or punctuation. That is, white
+**Character in Headings, No Spaces**
+ The number of characters in headings considered part of a word or punctuation. That is, white
space characters are not counted.
diff --git a/docs/source/int_customise.rst b/docs/source/more_customise.rst
similarity index 90%
rename from docs/source/int_customise.rst
rename to docs/source/more_customise.rst
index f9a3b9fe..6e6c09da 100644
--- a/docs/source/int_customise.rst
+++ b/docs/source/more_customise.rst
@@ -34,10 +34,10 @@ and add dictionaries yourself.
**Install Tool**
-A small tool to assist with this can be found under :guilabel:`Tools > Add Dictionaries`. It will
-import spell checking dictionaries from Free Office or Libre Office extensions. The dictionaries
-are then installed in the install location for the Enchant library and should thus work for any
-application that uses Enchant for spell checking.
+A small tool to assist with this can be found under **Tools > Add Dictionaries**. It will import
+spell checking dictionaries from Free Office or Libre Office extensions. The dictionaries are then
+installed in the install location for the Enchant library and should thus work for any application
+that uses Enchant for spell checking.
**Manual Install**
@@ -81,14 +81,14 @@ modify it as you like.
`novelwriter/assets/icons `_.
Remember to also change the name of your theme by modifying the ``name`` setting at the top of the
-file, otherwise you may not be able to distinguish them in :guilabel:`Preferences`.
+file, otherwise you may not be able to distinguish them in **Preferences**.
For novelWriter to be able to locate the custom theme files, you must copy them to the
:ref:`a_locations_data` location in your home or user area. There should be a folder there named
``syntax`` for syntax themes, just ``themes`` for GUI themes, and ``icons`` for icon themes. These
folders are created the first time you start novelWriter.
-Once the files are copied there, they should show up in :guilabel:`Preferences` with the label you
+Once the files are copied there, they should show up in **Preferences** with the label you
set as ``name`` inside the file.
.. versionadded:: 2.0
@@ -190,10 +190,10 @@ Omitted syntax colours default to black, except ``background`` which defaults to
``texthighlight`` which defaults to white with half transparency.
.. versionadded:: 2.2
- The `shortcode` syntax colour entry was added.
+ The ``shortcode`` syntax colour entry was added.
.. versionadded:: 2.3
- The `optional` syntax colour entry was added.
+ The ``optional`` syntax colour entry was added.
.. versionadded:: 2.4
- The `texthighlight` syntax colour entry was added.
+ The ``texthighlight`` syntax colour entry was added.
diff --git a/docs/source/project_manuscript.rst b/docs/source/project_manuscript.rst
index 9383079d..4f4657bc 100644
--- a/docs/source/project_manuscript.rst
+++ b/docs/source/project_manuscript.rst
@@ -4,9 +4,11 @@
Building the Manuscript
***********************
+.. _Pandoc: https://pandoc.org/
+
You can at any time build a manuscript, an outline of your notes, or any other type of document
-from the text in your project. All of this is handled by the :guilabel:`Manuscript Build` tool.
-You can activate it from the sidebar, the :guilabel:`Tools` menu, or by pressing :kbd:`F5`.
+from the text in your project. All of this is handled by the **Manuscript Build** tool. You can
+activate it from the sidebar, the **Tools** menu, or by pressing :kbd:`F5`.
.. versionadded:: 2.1
This tool is new for version 2.1. A simpler tool was used for earlier versions. The simpler tool
@@ -20,40 +22,60 @@ The Manuscript Build Tool
=========================
.. figure:: images/fig_manuscript_build.png
+ :width: 80%
- The :guilabel:`Manuscript Build` tool main window.
+ The **Manuscript Build** tool main window.
-The main window of the :guilabel:`Manuscript Build` tool contains a list of all the builds you have
+The main window of the **Manuscript Build** tool contains a list of all the builds you have
defined, a selection of settings, and a few buttons to generate preview, open the print dialog, or
run the build to create a manuscript document.
+Outline and Word Counts
+-----------------------
+
+.. figure:: images/fig_manuscript_build_outline.png
+ :width: 80%
+
+ The **Manuscript Build** tool main window with the **Outline** visible.
+
+The **Outline** tab on the left lets you navigate the headings in the preview document. It will
+show up to scene level headings for novel documents, and level 2 headings for notes.
+
+A collapsible panel of word and character counts are also available below the preview document.
+These are calculated from the text you have included in the document, and are more accurate counts
+than what's available in the project tree since they are counted *after formatting*.
+
+For a detailed description on how they are counted, see :ref:`a_counting`.
+
+
.. _a_manuscript_settings:
Build Settings
==============
-Each build definition can be edited by opening it in the :guilabel:`Manuscript Build Settings`
-dialog, either by double-clicking or by selecting it and pressing the edit button in the toolbar.
+Each build definition can be edited by opening it in the **Manuscript Build Settings** dialog,
+either by double-clicking or by selecting it and pressing the edit button in the toolbar.
.. tip::
- You can keep the :guilabel:`Manuscript Build Settings` dialog open while testing the different
- options, and just hit the :guilabel:`Apply` button. You can test the result of your settings
- by pressing the :guilabel:`Preview` button in the main :guilabel:`Manuscript Build` window.
- When you're happy with the result, you can close the settings.
+ You can keep the **Manuscript Build Settings** dialog open while testing the different options,
+ and just hit the :guilabel:`Apply` button. You can test the result of your settings by pressing
+ the :guilabel:`Preview` button in the main **Manuscript Build** window. When you're happy with
+ the result, you can close the settings.
Document Selection
------------------
.. figure:: images/fig_build_settings_selections.png
+ :width: 80%
- The :guilabel:`Selections` page of the :guilabel:`Manuscript Build Settings` dialog.
+ The **Selections** page of the **Manuscript Build Settings** dialog.
-The :guilabel:`Selections` page of the :guilabel:`Manuscript Build Settings` dialog allows you to
-fine tune which documents are included in the build. They are indicated by a green arrow icon in
-the last column. On the right you have some filter options for selecting content of a specific
-type, and a set of switches for which root folders to include.
+The **Selections** page of the **Manuscript Build Settings** dialog allows you to fine tune which
+documents are included in the build. They are indicated by a green arrow icon in the last column.
+On the right you have some filter options for selecting content of a specific type, and a set of
+switches for which root folders to include.
You can override the result of these filters by marking one or more documents and selecting to
explicitly include or exclude them by using the buttons below the tree view. The last button can be
@@ -69,13 +91,14 @@ Formatting Headings
-------------------
.. figure:: images/fig_build_settings_headings.png
+ :width: 80%
- The :guilabel:`Headings` page of the :guilabel:`Manuscript Build Settings` dialog.
+ The **Headings** page of the **Manuscript Build Settings** dialog.
-The :guilabel:`Headings` page of the :guilabel:`Manuscript Build Settings` dialog allows you to set
-how the headings in your :term:`Novel Documents` are formatted. By default, the title is just
-copied as-is, indicated by the ``{Title}`` format. You can change this to for instance add chapter
-numbers and scene numbers, or insert character names, like shown in the figure above.
+The **Headings** page of the **Manuscript Build Settings** dialog allows you to set how the
+headings in your :term:`Novel Documents` are formatted. By default, the title is just copied as-is,
+indicated by the ``{Title}`` format. You can change this to for instance add chapter numbers and
+scene numbers, or insert character names, like shown in the figure above.
Clicking the edit button next to a format will copy the formatting string into the edit box where
it can be modified, and where a syntax highlighter will help indicate which parts are automatically
@@ -86,7 +109,7 @@ Any text you add that isn't highlighted in colours will remain in your formatted
``{Title}`` will always be replaced by the text in the heading from your documents.
You can preview the result of these format strings by clicking :guilabel:`Apply`, and then clicking
-:guilabel:`Preview` in the :guilabel:`Manuscript Build` tool main window.
+:guilabel:`Preview` in the **Manuscript Build** tool main window.
Scene Separators
@@ -107,10 +130,9 @@ be treated as a separator.
Hard and Soft Scenes
^^^^^^^^^^^^^^^^^^^^
-If you wish to distinguish between so-called soft and hard scene breaks, where a hard scene break
-is understood as a scene break that changes point-of-view character, you can use the modified scene
-heading format in your text. You can then give these headings a different formatting in the
-:guilabel:`Headings` settings.
+If you wish to distinguish between so-called soft and hard scene breaks, you can use the
+alternative scene heading format in your text. You can then give these headings a different
+formatting in the **Headings** settings.
See :ref:`a_fmt_head` for more info on how to format headings in your text.
@@ -118,10 +140,9 @@ See :ref:`a_fmt_head` for more info on how to format headings in your text.
Output Settings
---------------
-The :guilabel:`Content`, :guilabel:`Format` and :guilabel:`Output` pages of the
-:guilabel:`Manuscript Build Settings` dialog control a number of other settings for the output.
-Some of these only apply to specific output formats, which is indicated by the section headings on
-the settings pages.
+The **Content**, **Format** and **Output** pages of the **Manuscript Build Settings** dialog
+control a number of other settings for the output. Some of these only apply to specific output
+formats, which is indicated by the section headings on the settings pages.
.. _a_manuscript_build:
@@ -130,12 +151,13 @@ Building Manuscript Documents
=============================
.. figure:: images/fig_build_build.png
+ :width: 80%
- The :guilabel:`Manuscript Build` dialog used for writing the actual manuscript documents.
+ The **Manuscript Build** dialog used for writing the actual manuscript documents.
-When you press the :guilabel:`Build` button on the :guilabel:`Build Manuscript` tool main window, a
-special file dialog opens up. This is where you pick your desired output format and where to write
-the file.
+When you press the :guilabel:`Build` button on the **Build Manuscript** tool main window, a special
+file dialog opens up. This is where you pick your desired output format and where to write the
+file.
On the left side of the dialog is a list of all the available file formats, and on the right, a
list of the documents which are included based on the build definition you selected. You can choose
@@ -157,7 +179,7 @@ Open Document Format
novelWriter HTML
The HTML format writes a single ``.htm`` file with minimal style formatting. The HTML document
- is suitable for further processing by document conversion tools like Pandoc, for importing in
+ is suitable for further processing by document conversion tools like Pandoc_, for importing in
word processors, or for printing from browser.
novelWriter Markup
@@ -198,4 +220,4 @@ on the print dialog.
.. note::
The paper format should in all cases default to whatever your system default is. If you want to
- change it, you have to select it from the :guilabel:`Print Preview` dialog.
+ change it, you have to select it from the **Print Preview** dialog.
diff --git a/docs/source/project_overview.rst b/docs/source/project_overview.rst
index d546992f..9d89759f 100644
--- a/docs/source/project_overview.rst
+++ b/docs/source/project_overview.rst
@@ -4,25 +4,27 @@
Novel Projects
**************
-New projects can be created from the :guilabel:`Project` menu by selecting
-:guilabel:`Create or Open Project`. This will open the :guilabel:`Welcome` dialog, where you can
-select the :guilabel:`New` button that will assist you in creating a new project.
+New projects can be created from the **Project** menu by selecting **Create or Open Project**. This
+will open the **Welcome** dialog, where you can select the :guilabel:`New` button that will assist
+you in creating a new project. This dialog is also displayed when you start novelWriter.
A novelWriter project requires a dedicated folder for storing its files on the local file system.
If you're interested in the details, you can have a look at the chapter :ref:`a_storage`.
-A list of recently opened projects is maintained, and displayed in the :guilabel:`Welcome`
-dialog. A project can be removed from this list by selecting it and pressing the :kbd:`Del` key or
-by right-clicking it and selecting the :guilabel:`Remove Project` option.
+A list of recently opened projects is maintained, and displayed in the **Welcome** dialog. A
+project can be removed from this list by selecting it and pressing the :kbd:`Del` key or by
+right-clicking it and selecting the **Remove Project** option.
.. figure:: images/fig_welcome.jpg
The project list (left) and new project form (right) of the :guilabel:`Welcome` dialog.
-Project-specific settings are available in :guilabel:`Project Settings` in the :guilabel:`Project`
-menu. See further details below in the :ref:`a_proj_settings` section. Details about the project's
-novel text, including word counts, and a table of contents with word and page counts, is available
-through the :guilabel:`Novel Details` dialog.
+Project-specific settings are available in **Project Settings** in the **Project** menu. See
+further details below in the :ref:`a_proj_settings` section.
+
+Details about the project's novel text, including word counts, and a table of contents with word
+and page counts, is available through the **Novel Details** dialog. Statistics about the project
+is also available in the **Manuscript Build** tool.
.. _a_proj_roots:
@@ -33,64 +35,70 @@ Project Roots
Projects are structured into a set of top level folders called "Root Folders". They are visible in
the project tree at the left side of the main window.
-The :term:`novel documents` go into a root folder of type :guilabel:`Novel`. :term:`Project notes`
-go into the other root folders. These other root folder types are intended for your notes on the
-various elements of your story. Using them is of course entirely optional.
+The :term:`novel documents` go into a root folder of type **Novel**. :term:`Project notes` go into
+the other root folders. These other root folder types are intended for your notes on the various
+elements of your story. Using them is of course entirely optional.
A new project may not have all of the root folders present, but you can add the ones you want from
the project tree tool bar.
Each root folder has one or more :term:`reference` :term:`keyword` associated with it that is used
to reference them from other documents and notes. The intended usage of each type of root folder is
-listed below. However, aside from the :guilabel:`Novel` folder, no restrictions are applied by the
+listed below. However, aside from the **Novel** folder, no restrictions are applied by the
application on what you put in them. You can use them however you want.
The root folder system is closely connected to how the Tags and References system works. For more
details, see the :ref:`a_references` chapter.
-:guilabel:`Novel`
+
+Root Folder Types
+-----------------
+
+**Novel**
This is the root folder type for text that goes into the final novel or novels. This class of
documents have other rules and features than the project notes. See :ref:`a_struct` for more
details.
-:guilabel:`Plot`
+**Plot**
This is the root folder type where main plots can be outlined. It is optional, but adding at
- least brief notes can be useful in order to tag plot elements for the :guilabel:`Outline View`.
- Tags in this folder can be references using the ``@plot`` keyword.
+ least brief notes can be useful in order to tag plot elements for the **Outline View**. Tags in
+ this folder can be references using the ``@plot`` keyword.
-:guilabel:`Characters`
+**Characters**
Character notes go in this root folder type. These are especially important if you want to use
- the :guilabel:`Outline View` to see which character appears where, which part of the story is
- told from a specific character's point-of-view, or focusing on a particular character's
- storyline. The character names can also be inserted into for instance chapter titles when you
- create your manuscript. Tags in this type of folder can be referenced using the ``@pov`` keyword
- for point-of-view characters, ``@focus`` for a focus character, or the ``@char`` keyword for any
+ the **Outline View** to see which character appears where, which part of the story is told from
+ a specific character's point-of-view, or focusing on a particular character's storyline.
+
+ The character names can also be inserted into for instance chapter titles when you create your
+ manuscript. Tags in this type of folder can be referenced using the ``@pov`` keyword for
+ point-of-view characters, ``@focus`` for a focus character, or the ``@char`` keyword for any
other character present.
-:guilabel:`Locations`
+**Locations**
The locations folder type is for various scene locations that you want to track. Tags in this
folder can be references using the ``@location`` keyword.
-:guilabel:`Timeline`
+**Timeline**
If the story has multiple plot timelines or jumps in time within the same plot, this folder type
can be used to track this. Tags in this type of folder can be references using the ``@time``
keyword.
-:guilabel:`Objects`
- Important objects in the story, for instance objects that change hands often, can be tracked
- here. Tags in this type of folder can be references using the ``@object`` keyword.
+**Objects**
+ Important objects in the story, for instance physical objects that change hands often, can be
+ tracked here. Tags in this type of folder can be references using the ``@object`` keyword.
-:guilabel:`Entities`
+**Entities**
Does your plot have many powerful organisations or companies? Or other entities that are part of
the plot? They can be organised here. Tags in this type of folder can be references using the
``@entity`` keyword.
-:guilabel:`Custom`
+**Custom**
The custom root folder type can be used for tracking anything else not covered by the above
options. Tags in this folder type can be references using the ``@custom`` keyword.
-The root folders correspond to the categories of tags that can be used to reference them. For more
-information about the tags listed, see :ref:`a_references_references`.
+The root folders are closely tied to the tags and reference system. Each folder type corresponds to
+the categories of tags that can be used to reference them. For more information about the tags
+listed, see :ref:`a_references_references`.
.. note::
You can rename root folders to whatever you want. However, this doesn't change the reference
@@ -105,12 +113,11 @@ information about the tags listed, see :ref:`a_references_references`.
Deleted Documents
-----------------
-Deleted documents will be moved into a special :guilabel:`Trash` root folder. Documents in the
-trash folder can then be deleted permanently, either individually, or by emptying the trash from
-the menu. Documents in the trash folder are removed from the :term:`project index` and cannot be
-referenced.
+Deleted documents are moved into a special **Trash** root folder. Documents in the trash folder can
+then be deleted permanently, either individually, or by emptying the trash from the menu. Documents
+in the trash folder are removed from the :term:`project index` and cannot be referenced.
-A document or a folder can be moved to trash from the :guilabel:`Project` menu, or by pressing
+A document or a folder can be moved to trash from the **Project** menu, or by pressing
:kbd:`Ctrl+Shift+Del`. Root folders can only be removed when they are empty.
@@ -119,13 +126,34 @@ A document or a folder can be moved to trash from the :guilabel:`Project` menu,
Archived Documents
------------------
-If you don't want to delete a document, or put it in the :guilabel:`Trash` folder where it may be
-deleted accidentally, but still want it out of your main project tree, you can create an
-:guilabel:`Archive` root folder and move it there.
+If you don't want to delete a document, or put it in the **Trash** folder where it may be deleted
+accidentally, but still want it out of your main project tree, you can create an **Archive** root
+folder instead and move it there. It has the same effect as moving it to **Trash**, but it is safe
+from deletion.
You can drag any document to this folder and preserve its settings. The document will always be
-excluded from the :guilabel:`Build Manuscript` tool. It is also removed from the
-:term:`project index`, so the tags and references defined in it will not show up anywhere else.
+excluded from the **Build Manuscript** tool. It is also removed from the :term:`project index`, so
+the tags and references defined in it will not show up anywhere else.
+
+
+.. _a_proj_roots_dirs:
+
+Using Folders in the Project Tree
+---------------------------------
+
+Regular folders, those that are not root folders, have no structural significance to the project.
+When novelWriter is processing the documents in a project, like for instance when you create a
+manuscript from it, these folders are ignored. Only the order of the documents themselves matter.
+
+The folders are there purely as a way for you to organise the documents in meaningful sections and
+to be able to collapse and hide them in the project tree when you're not working on those
+documents.
+
+.. versionadded:: 2.0
+ As of version 2.0 it is possible to add child documents to other documents. This is particularly
+ useful when you create chapters and scenes. If you add separate scene documents, you should also
+ add separate chapter documents, even if they only contain a chapter heading. You can then add
+ scene documents as child items to the chapters.
.. _a_proj_roots_orphaned:
@@ -143,8 +171,8 @@ previously have been located in the project. The project loading routine will tr
as close as possible to this location, if it still exists. Generally, it will be appended to the
end of the folder where it previously was located. If that folder doesn't exist, it will try to add
it to the correct root folder type. If it cannot figure out which root folder is correct, the
-document will be added to the :guilabel:`Novel` root folder. Finally, if the :guilabel:`Novel`
-folder is missing, one will be created.
+document will be added to the **Novel** root folder. Finally, if a **Novel** does not exist, one
+will be created.
If the title of the document can be recovered, the word "Recovered:" will be added as a prefix to
indicate that it may need further attention. If the title cannot be determined, the document will
@@ -157,15 +185,16 @@ Project Lockfile
----------------
To prevent lost documents caused by file conflicts when novelWriter projects are synchronised via
-file synchronisation tools, a project lockfile is written to the project storage folder. If you try
-to open a project which has such a file present, you will be presented with a warning, and some
-information about where else novelWriter thinks the project is also open. You will be given the
-option to ignore this warning, and continue opening the project at your own risk.
+file synchronisation tools, a project lockfile is written to the project storage folder when a
+project is open. If you try to open a project which already has such a file present, you will be
+presented with a warning, and some information about where else novelWriter thinks the project is
+also open. You will be given the option to ignore this warning, and continue opening the project at
+your own risk.
.. note::
- If, for some reason, novelWriter crashes, the lock file may remain even if there are no other
- instances keeping the project open. In such a case it is safe to ignore the lock file warning
- when re-opening the project.
+ If, for some reason, novelWriter or your computer crashes, the lock file may remain even if
+ there are no other instances keeping the project open. In such a case it is safe to ignore the
+ lock file warning when re-opening the project.
.. warning::
If you choose to ignore the warning and continue opening the project, and multiple instances of
@@ -175,52 +204,31 @@ option to ignore this warning, and continue opening the project at your own risk
novelWriter will try to resolve project inconsistencies the next time you open the project.
-.. _a_proj_roots_dirs:
-
-Using Folders in the Project Tree
----------------------------------
-
-Folders, aside from root folders, have no structural significance to the project. When novelWriter
-is processing the documents in a project, like for instance when you create a manuscript from it,
-these folders are ignored. Only the order of the documents themselves matter.
-
-The folders are there purely as a way for you to organise the documents in meaningful sections and
-to be able to collapse and hide them in the project tree when you're not working on those
-documents.
-
-.. versionadded:: 2.0
- As of version 2.0 it is possible to add child documents to other documents. This is particularly
- useful when you create chapters and scenes. If you add separate scene documents, you should also
- add separate chapter documents, even if they only contain a chapter heading. You can then add
- scene documents as child items to the chapters.
-
-
.. _a_proj_files:
Project Documents
=================
-New documents can be created from the toolbar in the :guilabel:`Project Tree`, or by pressing
-:kbd:`Ctrl+N`. This will open the create new item menu and let you choose between a number of
-pre-defined documents and folders. You will be prompted for a label for the new item.
+New documents can be created from the toolbar in the project tree, or by pressing :kbd:`Ctrl+N`.
+This will open the create new item menu and let you choose between a number of pre-defined
+documents and folders. You will be prompted for a label for the new item.
-You can always rename an item by selecting :guilabel:`Rename Item` from the :guilabel:`Project`
-menu, or by pressing :kbd:`F2`.
+You can always rename an item by selecting **Rename Item** from the **Project** menu, or by
+pressing :kbd:`F2` when a document or folder is selected.
-Other settings for project items are available from the context menu that you can activate by
-right-clicking on an item in the tree. The :guilabel:`Transform` submenu includes options for
-converting, splitting, or merging items. See :ref:`a_ui_tree_split_merge` for more details on the
-latter two.
+Other settings for project documents and folders are available from the context menu that you can
+activate by right-clicking on an it in the tree. The **Transform** submenu includes options for
+converting, splitting, or merging documents. See :ref:`a_ui_tree_split_merge` for more details on
+the latter two.
Document Templates
------------------
If you wish to create template documents to be used when creating new project documents, like for
-instance a character note template, you can add a :guilabel:`Templates` root folder to your
-project. Any document added to this root folder will show up in the :guilabel:`Add Item` menu in
-the project tree toolbar. When selected, a new document is created with its content copied from the
-chosen template.
+instance a character note template, you can add a **Templates** root folder to your project. Any
+document added to this root folder will show up in the **Add Item** menu in the project tree
+toolbar. When selected, a new document is created with its content copied from the chosen template.
.. versionadded:: 2.3
@@ -233,8 +241,8 @@ Word Counts
A character, word and paragraph count is maintained for each document, as well as for each section
of a document following a :term:`heading`. The word count and change of words in the
current session is displayed in the footer of any document open in the editor, and all stats are
-shown in the details panel below the :guilabel:`Project Tree` for any document selected in the
-project or novel trees.
+shown in the details panel below the project tree for any document selected in the project or novel
+trees.
The word counts are not updated in real time, but run in the background every few seconds for as
long as the document is being actively edited.
@@ -242,7 +250,7 @@ long as the document is being actively edited.
A total project word count is displayed in the status bar. The total count depends on the sum of
the values in the project tree, which again depend on an up to date :term:`project index`. If the
counts seem wrong, a full project word recount can be initiated by rebuilding the project's index.
-Either from the :guilabel:`Tools` menu, or by pressing :kbd:`F9`.
+Either from the **Tools** menu, or by pressing :kbd:`F9`.
The rules for how the counts are made is covered in more detail in :ref:`a_counting`.
@@ -252,33 +260,35 @@ The rules for how the counts are made is covered in more detail in :ref:`a_count
Project Settings
================
-The :guilabel:`Project Settings` can be accessed from the :guilabel:`Project` menu, or by pressing
+The **Project Settings** can be accessed from the **Project** menu, or by pressing
:kbd:`Ctrl+Shift+,`. This will open a dialog box, with a set of tabs.
Settings Tab
------------
-The :guilabel:`Settings` tab holds the project name, title, and author settings.
+The **Settings** tab holds the project name, author, and language settings.
-The :guilabel:`Project Name` can be edited here. It is used for the GUI (main window title) and for
-generating backup files. So keep in mind that if you do change this setting, the backup file names
-will change too.
+The **Project Name** can be edited here. It is used for the main window title and for generating
+backup files. So keep in mind that if you do change this setting, the backup file names will change
+too.
-You can also change the :guilabel:`Authors` and :guilabel:`Project Language` setting. These are
-only used when building the manuscript, for some formats.
+You can also change the **Authors** and **Project Language** setting. These are only used when
+building the manuscript, for some formats. The language setting is also used when inserting text
+into documents in the viewer, like for instance labels for keywords and special comments.
If your project is in a different language than your main spell checking language is set to, you
-can override the default setting here. The project language can also be changed from the
-:guilabel:`Tools` menu. You can also override the automatic backup setting if you wish.
+can override the default setting here. The project language can also be changed from the **Tools**
+menu.
+
+You can also override the automatic backup setting for the project if you wish.
Status and Importance Tabs
--------------------------
-Each document or folder of type :guilabel:`Novel` can be given a "Status" label accompanied by a
-coloured icon, and each document or folder of the remaining types can be given an "Importance"
-label.
+Each document or folder of type **Novel** can be given a "Status" label accompanied by a coloured
+icon, and each document or folder of the remaining types can be given an "Importance" label.
These labels are there purely for your convenience, and you are not required to use them for any
other features to work. No other part of novelWriter accesses this information. The intention is to
@@ -316,22 +326,22 @@ Backup
======
An automatic backup system is built into novelWriter. In order to use it, a backup path to where
-the backup files are to be stored must be provided in :guilabel:`Preferences`.
+the backup files are to be stored must be provided in **Preferences**. The path defaults to a
+folder named "Backups" in your home directory.
Backups can be run automatically when a project is closed, which also implies it is run when the
application itself is closed. Backups are date stamped zip files of the project files in the
project folder (files not strictly a part of the project are ignored). The zip archives are stored
-in a subfolder of the backup path. The subfolder will have the same name as the
-:guilabel:`Project Name` as defined in :ref:`a_proj_settings`.
+in a subfolder of the backup path. The subfolder will have the same name as the **Project Name** as
+defined in :ref:`a_proj_settings`.
-The backup feature, when configured, can also be run manually from the :guilabel:`Tools` menu.
-It is also possible to disable automated backups for a given project in
-:guilabel:`Project Settings`.
+The backup feature, when configured, can also be run manually from the **Tools** menu. It is also
+possible to disable automated backups for a given project in **Project Settings**.
.. note::
- For the backup to be able to run, the :guilabel:`Project Name` must be set in
- :guilabel:`Project Settings`. This value is used to generate the name and path of the backups.
- Without it, the backup will not run at all, but it will produce a warning message.
+ For the backup to be able to run, the **Project Name** must be set in **Project Settings**. This
+ value is used to generate the name and path of the backups. Without it, the backup will not run
+ at all, but it will produce a warning message.
.. _a_proj_stats:
@@ -344,9 +354,8 @@ total word counts of your novel documents and notes at the end of the session, p
session lasted either more than 5 minutes, or that the total word count changed. For more details
about the log file, see :ref:`a_storage`.
-A tool to view the content of the log file is available in the :guilabel:`Tools` menu under
-:guilabel:`Writing Statistics`. You can also launch it by pressing :kbd:`F6`, or find it on the
-sidebar.
+A tool to view the content of the log file is available in the **Tools** menu under **Writing
+Statistics**. You can also launch it by pressing :kbd:`F6`, or find it on the sidebar.
The tool will show a list of all your sessions, and a set of filters to apply to the data. You can
also export the filtered data to a JSON file or to a CSV file that can be opened by a spreadsheet
@@ -356,4 +365,4 @@ application like for instance Libre Office Calc or Excel.
As of version 1.2, the log file also stores how much of the session time was spent idle. The
definition of idle here is that the novelWriter main window loses focus, or the user hasn't made
any changes to the currently open document in five minutes. The number of minutes can be altered
- in :guilabel:`Preferences`.
+ in **Preferences**.
diff --git a/docs/source/project_references.rst b/docs/source/project_references.rst
index cdd29536..7b695801 100644
--- a/docs/source/project_references.rst
+++ b/docs/source/project_references.rst
@@ -16,9 +16,9 @@ this chapter hopes to explain in more detail how to use this tags and references
.. tip::
If you find the Tags and Reference system difficult to follow just from reading this chapter,
- you can create a new project in the :guilabel:`Welcome` dialog's New project form and select
- "Create an example project" from the "Pre-fill project" option. The example project contains
- several examples of tags and references.
+ you can create a new project in the **Welcome** dialog's New project form and select "Create an
+ example project" from the "Pre-fill project" option. The example project contains several
+ examples of tags and references.
.. _a_references_metadata:
@@ -68,7 +68,7 @@ You can only set **one** tag per heading, and the tag has to be unique across **
the project.
After a tag has been defined, it can be referenced in novel documents, or cross-referenced in other
-notes. Tags will also show up in the :guilabel:`Outline View` and in the references panel under the
+notes. Tags will also show up in the **Outline View** and in the references panel under the
document viewer when a document is open in the viewer.
The syntax highlighter will indicate to you that the keyword is correctly used and that the tag is
@@ -79,7 +79,7 @@ that valid tags do.
The tag is the only part of these notes that novelWriter uses. The rest of the document content is
there for you to use in whatever way you wish. Of course, the content of the documents can be added
to the manuscript, or an outline document. If you want to compile a single document of all your
-notes, you can do this from the :guilabel:`Manuscript Build` tool.
+notes, you can do this from the **Manuscript Build** tool.
.. versionadded:: 2.2
Tags are no longer case sensitive. The tags are by default displayed with the capitalisation you
@@ -117,8 +117,8 @@ How to Use References
=====================
Each heading of any level in your project can contain references to tags set in project notes. The
-references are gathered by the indexer and used to generate the :guilabel:`Outline View`, among
-other things.
+references are gathered by the indexer and used to generate the **Outline View**, among other
+things.
References are set as a :term:`keyword` and a list of corresponding tags. The valid keywords are
listed below. The format of a reference line is ``@keyword: value1, [value2] ... [valueN]``. All
@@ -126,70 +126,69 @@ reference keywords allow multiple values.
``@pov``
The point-of-view character for the current section. The target must be a note tag in a
- :guilabel:`Character` type root folder.
+ **Character** type root folder.
``@focus``
The character that has the focus for the current section. This can be used in cases where the
- focus is not a point-of-view character. The target must be a note tag in a :guilabel:`Character`
- type root folder.
+ focus is not a point-of-view character. The target must be a note tag in a **Character** type
+ root folder.
``@char``
- Other characters in the current section. The target must be a note tag in a
- :guilabel:`Character` type root folder. This should not include the point-of-view or focus
- character if those references are used.
+ Other characters in the current section. The target must be a note tag in a **Character** type
+ root folder. This should not include the point-of-view or focus character if those references
+ are used.
``@plot``
- The plot or subplot advanced in the current section. The target must be a note tag in a
- :guilabel:`Plot` type root folder.
+ The plot or subplot advanced in the current section. The target must be a note tag in a **Plot**
+ type root folder.
``@time``
- The timelines touched by the current section. The target must be a note tag in a
- :guilabel:`Timeline` type root folder.
+ The timelines touched by the current section. The target must be a note tag in a **Timeline**
+ type root folder.
``@location``
The location the current section takes place in. The target must be a note tag in a
- :guilabel:`Locations` type root folder.
+ **Locations** type root folder.
``@object``
- Objects present in the current section. The target must be a note tag in a :guilabel:`Object`
- type root folder.
+ Objects present in the current section. The target must be a note tag in a **Object** type root
+ folder.
``@entity``
- Entities present in the current section. The target must be a note tag in a
- :guilabel:`Entities` type root folder.
+ Entities present in the current section. The target must be a note tag in an **Entities** type
+ root folder.
``@custom``
- Custom references in the current section. The target must be a note tag in a :guilabel:`Custom`
- type root folder. The custom folder are for any other category of notes you may want to use.
+ Custom references in the current section. The target must be a note tag in a **Custom** type
+ root folder. The custom folder are for any other category of notes you may want to use.
The syntax highlighter will alert the user that the tags and references are used correctly, and
that the tags referenced exist.
.. note::
The highlighter may be mistaken if the index of defined tags is out of date. If so, press
- :kbd:`F9` to regenerate it, or select :guilabel:`Rebuild Index` from the :guilabel:`Tools` menu.
- In general, the index for a document is regenerated when it is saved, so this shouldn't normally
- be necessary.
+ :kbd:`F9` to regenerate it, or select **Rebuild Index** from the **Tools** menu. In general, the
+ index for a document is regenerated when it is saved, so this shouldn't normally be necessary.
.. tip::
If you add a reference in the editor to a tag that doesn't yet exist, you can right-click it and
- select :guilabel:`Create Note for Tag`. This will generate a new project note automatically with
- the new tag defined. In order for this to be possible, a root folder for that category of
- references must already exist.
+ select **Create Note for Tag**. This will generate a new project note automatically with the new
+ tag defined. In order for this to be possible, a root folder for that category of references
+ must already exist.
One note can also reference another note in the same way novel documents do. When the note is
opened in the document viewer, the references become clickable links, making it easier to follow
connections in the plot. You can follow links in the document editor by clicking them with the
mouse while holding down the :kbd:`Ctrl` key. Clicked links are always opened in the view panel.
-Project notes don't show up in the :guilabel:`Outline View`, so referencing between notes is only
+Project notes don't show up in the **Outline View**, so referencing between notes is only
meaningful if you want to be able to click-navigate between them, or of course if you just want to
highlight that two notes are related.
.. tip::
If you cross-reference between notes and export your project as an HTML document using the
- :guilabel:`Manuscript Build` tool, the cross-references become clickable links in the exported
- HTML document as well.
+ **Manuscript Build** tool, the cross-references become clickable links in the exported HTML
+ document as well.
Example of a novel document with references to characters and plots:
@@ -217,7 +216,7 @@ character ``@`` on a new line. It will first suggest tag or reference keywords f
after the ``:`` has been added, suggest references from the list of tags you have already defined.
You can use the auto-completer to add multiple references with a ``,`` between them, and even type
-new ones. New references can be created by right-clicking on them and selecting
-:guilabel:`Create Note for Tag` from the menu.
+new ones. New references can be created by right-clicking on them and selecting **Create Note for
+Tag** from the menu.
.. versionadded:: 2.2
diff --git a/docs/source/project_structure.rst b/docs/source/project_structure.rst
index 0763fed7..e344ecd8 100644
--- a/docs/source/project_structure.rst
+++ b/docs/source/project_structure.rst
@@ -6,14 +6,13 @@ Novel Structure
This chapter covers the structure of a novel project.
-There are two different types of documents in a project, :guilabel:`Novel Documents` and
-:guilabel:`Project Notes`. Active novel documents can only live in a :guilabel:`Novel` type root
-folder. You can also move them to :guilabel:`Archive` and :guilabel:`Trash` of course, where they
-become inactive.
+There are two different types of documents in a project, **Novel Documents** and **Project Notes**.
+Active novel documents can only live in a **Novel** type root folder. You can also move them to
+**Archive** and **Trash** of course, where they become inactive.
-The :guilabel:`Project Tree` can distinguish between the different heading levels of the novel
-documents using coloured icons, and optionally add emphasis on the label, set in
-:guilabel:`Preferences`.
+The project tree can distinguish between the different heading levels of the novel documents using
+coloured icons, and optionally add emphasis on the label, set in **Preferences** for easier
+identification.
.. _a_struct_heads:
@@ -29,40 +28,41 @@ title. See also the :ref:`a_fmt` section for more details about the markup synta
.. note::
The heading levels are not only important when generating the manuscript, they are also used by
- the indexer when building the outline tree in the :guilabel:`Outline View` as well as in the
- :guilabel:`Novel Tree`. Each heading also starts a new region where new Tags and References
- can be defined. See :ref:`a_references` for more details.
+ the indexer when building the outline tree in the **Outline View** as well as in the **Novel
+ Tree**. Each heading also starts a new region where new Tags and References can be defined. See
+ :ref:`a_references` for more details.
-The syntax for the four basic heading types, and the two special types, is listed in section
+The syntax for the four basic heading types, and the three special types, is listed in section
:ref:`a_fmt_head`. The meaning of the four levels for the structure of your novel is as follows:
**Heading Level 1: Partition**
- This heading level signifies that the text refers to a top level partition. This is useful when
+ This heading level signifies that the text refers to a top level heading. 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 heading level ``#!`` covered in :ref:`a_fmt_head`.
**Heading Level 2: Chapter**
- This heading 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
- also add a synopsis and reference keywords to the chapter document. If you want to open the
- chapter with a quote or other introductory text that isn't part of a scene, this is also where
- you'd put that text.
+ This heading level signifies a chapter. 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 also add a synopsis and
+ reference keywords to the chapter document. If you want to open the chapter with a quote or
+ other introductory text that isn't part of a scene, this is also where you'd put that text.
**Heading Level 3: Scene**
- This heading 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 build your
- manuscript.
+ This heading level signifies a scene. You must provide a title text, but the title text can be
+ replaced with a scene separator or just skipped entirely when you build your manuscript. If you
+ need to distinguish between hard and soft scene breaks, there is an alternative format for
+ scenes you can use for this distinction. The formatting is covered in :ref:`a_fmt_head`. See
+ also :ref:`a_struct_heads_scenes`.
**Heading Level 4: Section**
- This heading level signifies a sub-scene level partition, usually called a "section" in the
+ This heading level can be used to split up a scene, usually called a "section" in the
documentation and the user interface. These can be useful if you want to change references
mid-scene, like if you change the point-of-view character. You are free to use sections as you
- wish, and you can filter them out of the final manuscript just like with scene titles.
+ wish, and you can filter them out of the final manuscript.
-Page breaks are automatically added before partition and chapter headings when you build your
-project to a format that supports page breaks. If you want page breaks in other places, you have to
-specify them manually. See :ref:`a_fmt_break`.
+Page breaks can be automatically added before partition, chapter and scene headings from the
+**Manuscript Build** tool when you build your project to a format that supports page breaks. 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 headings when building the manuscript. For
@@ -76,9 +76,9 @@ specify them manually. See :ref:`a_fmt_break`.
Novel Title and Front Matter
----------------------------
-It is recommended that you add a document at the very top of each Novel root folder with the novel
-title as the first line. You should modify the level 1 heading format code with an ``!`` in order
-to render it as a document title that is excluded from any automatic Table of Content in a
+It is recommended that you add a document at the very top of each **Novel** root folder with the
+novel title as the first line. You should modify the level 1 heading format code with an ``!`` in
+order to render it as a document title that is excluded from any automatic Table of Content in a
manuscript build document, like so:
.. code-block:: md
@@ -102,7 +102,7 @@ Unnumbered Chapter Headings
If you use the automatic numbering feature for your chapters, but you want to keep some special
chapters separate from this, you can add an ``!`` to the level 2 heading formatting code to tell
-the build tool to skip these chapters.
+the build tool to skip these chapters when adding numbers.
.. code-block:: md
@@ -110,13 +110,31 @@ the build tool to skip these chapters.
Chapter Text
-There is a separate formatting feature for such chapter titles in the :guilabel:`Manuscript Build`
-tool as well. See the :ref:`a_manuscript` page for more details. When building a document of a
-format that supports page breaks, also unnumbered chapters will have a page break added just like
-for normal chapters.
+There is a separate formatting feature for such chapter titles in the **Manuscript Build** tool as
+well. See the :ref:`a_manuscript` page for more details. When building a document of a format that
+supports page breaks, also unnumbered chapters can 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
- the first character of the chapter title itself. This feature has been dropped in favour of the
- current format in order to keep level 1 and 2 headers consistent. Please update your chapter
- headings if you've used this syntax.
+
+.. _a_struct_heads_scenes:
+
+Hard and Soft Scene Breaks
+--------------------------
+
+If you need two different ways to style scenes in your manuscript, like if you want to insert
+different scene separators for soft and hard scene breaks, there is an alternative scene format
+available for scene headings with a ``!`` added to the formatting code.
+
+.. code-block:: md
+
+ ### Soft Scene Transition
+
+ A soft scene break.
+
+ ###! Hard Scene Transition
+
+ A hard scene break.
+
+There is a separate formatting feature for these titles in the **Manuscript Build** tool.
+
+.. versionadded:: 2.4
diff --git a/docs/source/tech_locations.rst b/docs/source/tech_locations.rst
index da199292..3cd09e60 100644
--- a/docs/source/tech_locations.rst
+++ b/docs/source/tech_locations.rst
@@ -15,10 +15,9 @@ file locations are described in this chapter.
Configuration
=============
-The general configuration of novelWriter, including everything that is in :guilabel:`Preferences`,
-is saved in one central configuration file. The location of this file depends on your operating
-system. The system paths are provided by the Qt QStandardPaths_ class and its ``ConfigLocation``
-value.
+The general configuration of novelWriter, including everything that is in **Preferences**, is saved
+in one central configuration file. The location of this file depends on your operating system. The
+system paths are provided by the Qt QStandardPaths_ class and its ``ConfigLocation`` value.
The standard paths are:
@@ -40,9 +39,8 @@ Application Data
================
novelWriter also stores a bit of data that is generated by the user's actions. This includes the
-list of recent projects form the :guilabel:`Open Project` dialog. Custom themes should also be
-saved here. The system paths are provided by the Qt QStandardPaths_ class and its
-``AppDataLocation`` value.
+list of recent projects form the **Welcome** dialog. Custom themes should also be saved here. The
+system paths are provided by the Qt QStandardPaths_ class and its ``AppDataLocation`` value.
The standard paths are:
@@ -56,3 +54,12 @@ user's username on Windows.
.. note::
These are the standard operating system defined locations. If your system has been set up in a
different way, these locations may also be different.
+
+The Application Data location also holds several folders:
+
+``cache``
+ This folder is used to save the preview data for the **Manuscript Build** tool.
+
+``icons``, ``syntax`` and ``themes``
+ These folders are empty by default, but this is where the user can store custom theme files.
+ See :ref:`a_custom` for more details.
diff --git a/docs/source/tech_source.rst b/docs/source/tech_source.rst
index 8c23463e..87d616a3 100644
--- a/docs/source/tech_source.rst
+++ b/docs/source/tech_source.rst
@@ -159,6 +159,5 @@ You can also build a PDF manual from the documentation using the ``pkgutils.py``
python pkgutils.py manual
This will build the documentation as a PDF using LaTeX. The file will then be copied into the
-assets folder and made available in the :guilabel:`Help` menu in novelWriter. The Sphinx build
-system has a few extra dependencies when building the PDF. Please check the `Sphinx Docs`_ for more
-details.
+assets folder and made available in the **Help** menu in novelWriter. The Sphinx build system has a
+few extra dependencies when building the PDF. Please check the `Sphinx Docs`_ for more details.
diff --git a/docs/source/tech_storage.rst b/docs/source/tech_storage.rst
index 7fb9d39b..79d5890a 100644
--- a/docs/source/tech_storage.rst
+++ b/docs/source/tech_storage.rst
@@ -55,10 +55,10 @@ string. The documents are saved with a filename assembled from this handle and t
``.nwd``.
If you wish to find the file system location of a document in the project, you can either look it
-up in the project XML file, select :guilabel:`Show File Details` from the :guilabel:`Document` menu
-when having the document open in the editor, or look in the ``ToC.txt`` file in the root of the
-project folder. The ``ToC.txt`` file has a list of all documents in the project, referenced by
-their label, and where they are saved.
+up in the project XML file, select **Show File Details** from the **Document** menu when having the
+document open in the editor, or look in the ``ToC.txt`` file in the root of the project folder. The
+``ToC.txt`` file has a list of all documents in the project, referenced by their label, and where
+they are saved.
The reason for this cryptic file naming is to avoid issues with file naming conventions and
restrictions on different operating systems, and also to have a file name that does not depend on
@@ -109,7 +109,7 @@ The Project Index
Between writing sessions, the project index is saved in a JSON file in ``meta/index.json``.
This file is not critical. If it is lost, it can be completely rebuilt from within novelWriter from
-the :guilabel:`Tools` menu.
+the **Tools** menu.
The index is maintained and updated whenever a document or note is saved in the editor. It contains
all references and tags in documents and notes, as well as the location of all headers in the
@@ -125,8 +125,8 @@ the index. If this too fails, you have likely encountered a bug.
Build Definitions
-----------------
-The build definitions from the :guilabel:`Manuscript Build` tool are kept in the
-``meta/builds.json`` file. If this file is lost, all custom build definitions are lost too.
+The build definitions from the **Manuscript Build** tool are kept in the ``meta/builds.json`` file.
+If this file is lost, all custom build definitions are lost too.
Cached GUI Options
@@ -144,17 +144,17 @@ Custom Word List
----------------
A file named ``meta/userdict.json`` contains all the custom words you've added to the project for
-spell checking purposes. The content of the file can be edited from the :guilabel:`Tools` menu. If
-you lose this file, all your custom spell check words will be lost too.
+spell checking purposes. The content of the file can be edited from the **Tools** menu. If you lose
+this file, all your custom spell check words will be lost too.
Session Stats
-------------
The writing progress is saved in the ``meta/sessions.jsonl`` file. This file records the length
-and word counts of each writing session on the given project. The file is used by the
-:guilabel:`Writing Statistics` tool. If this file is lost, the history it contains is also lost,
-but it has otherwise no impact on the project.
+and word counts of each writing session on the given project. The file is used by the **Writing
+Statistics** tool. If this file is lost, the history it contains is also lost, but it has otherwise
+no impact on the project.
Each session is recorded as a JSON object on a single line of the file. Each session record is
appended tot he file.
diff --git a/docs/source/usage_breakdown.rst b/docs/source/usage_breakdown.rst
index c0f14968..f34f40ec 100644
--- a/docs/source/usage_breakdown.rst
+++ b/docs/source/usage_breakdown.rst
@@ -21,14 +21,15 @@ GUI Layout and Design
The user interface of novelWriter is intended to be as minimalistic as practically possible, while
at the same time provide useful features needed for writing a novel.
-The main window does not have an editor toolbar like many other applications do. This reduces
-clutter, and since the documents are formatted with style tags, it is more or less redundant.
-Still, a small formatting toolbar can be popped out by clicking the three dots in the header of the
-document editor to give quick access to standard formatting codes.
+The main window does not by default have an editor toolbar like many other applications do. This
+reduces clutter, and since the documents are formatted with style tags, it is not needed most of
+the time. Still, a small formatting toolbar can be popped out by clicking the left-most button in
+the header of the document editor. It gives quick access to standard formatting codes.
Most formatting features supported are available through convenient keyboard shortcuts. They are
-also available in the main menu, so you don't have to look up formatting codes every time you need
-them. For reference, a list of all shortcuts can be found in the :ref:`a_kb` chapter.
+also available in the main menu under **Format**, so you don't have to look up formatting codes
+every time you need them. For reference, a list of all shortcuts can be found in the :ref:`a_kb`
+chapter.
.. note::
novelWriter is not intended to be a full office type word processor. It doesn't support images,
@@ -37,13 +38,13 @@ them. For reference, a list of all shortcuts can be found in the :ref:`a_kb` cha
simple features.
On the left side of the main window, you will find a sidebar. This bar has buttons for the standard
-views you can switch between, a quick link to the :guilabel:`Build Manuscript` tool, and a set of
+views you can switch between, a quick link to the **Build Manuscript** tool, and a set of
project-related tools and quick access to settings at the bottom.
.. versionadded:: 2.2
A number of new formatting options were added in 2.2 to allow for some special formatting cases.
At the same time, a small formatting toolbar was added in the editor. It is hidden by default,
- but can be opened by pressing the three dots icon in the top right corner.
+ but can be opened by pressing the icon button in the top right corner.
Project Tree and Editor View
@@ -53,19 +54,19 @@ Project Tree and Editor View
A screenshot of the Project Tree and Editor View.
-When in :guilabel:`Project Tree View` mode, the main work area of the main window is split in two,
-or optionally three, panels. The left-most panel contains the project tree and all the documents in
-your project. The second panel is the document editor.
+When the application is in **Project Tree View** mode, the main work area of the main window is
+split in two, or optionally three, panels. The left-most panel contains the project tree and all
+the documents in your project. The second panel is the document editor.
An optional third panel on the right side contains a document viewer which can view any document in
your project independently of what is open in the document editor. This panel is not intended as a
-preview window, although you can use it for this purpose if you wish if you need to check that the
-formatting tags behave as you expected. The main purpose of the viewer is for viewing your notes
-next to your editor while you're writing.
+preview window, although you can use it for this purpose if you wish. For instance if you need to
+check that the formatting tags behave as you expect. However, the main purpose of the viewer is for
+viewing your notes next to your editor while you're writing.
-The editor also has a :guilabel:`Focus Mode` you can toggle either from the menu, from the icon in
-the editor's header, or by pressing :kbd:`F8`. When :guilabel:`Focus Mode` is enabled, all the user
-interface elements other than the document editor itself are hidden away.
+The editor also has a **Focus Mode** you can toggle either from the menu, from the icon in the
+editor's header, or by pressing :kbd:`F8`. When **Focus Mode** is enabled, all the user interface
+elements other than the document editor itself are hidden away.
Novel View and Editor View
@@ -73,31 +74,32 @@ Novel View and Editor View
.. figure:: images/fig_novel_tree_view.png
- A screenshot of the Novel Tree View.
+ A screenshot of the Novel Tree and Editor View.
-When in :guilabel:`Novel Tree View` mode, the project tree is replaced by an overview of your novel
-structure for a specific Novel :term:`root folder`. Instead of showing individual documents, the
-tree now shows all headings of your novel text. This includes multiple headings within the same
-document.
+When the application is in **Novel Tree View** mode, the project tree is replaced by an overview of
+your novel structure for a specific Novel :term:`root folder`. Instead of showing individual
+documents, the tree now shows all headings of your novel text. This includes multiple headings
+within the same document.
-Each heading is indented according to the heading level. You can open and edit your novel documents
-from this view as well. All headings contained in the currently open document should be highlighted
-in the view to indicate which ones belong together in the same document.
+Each heading is indented according to the heading level, not its parent/child relationship to other
+elements of your project. You can open and edit your novel documents from this view as well. All
+headings contained in the currently open document should be highlighted in the view to indicate
+which ones belong together in the same document.
-If you have multiple "Novel" type root folders, the header of the novel view becomes a dropdown
+If you have multiple **Novel** type root folders, the header of the novel view becomes a dropdown
box. You can then switch between them by clicking the :guilabel:`Outline of ...` text. You can also
click the novel icon button next to it.
Generally, the novel view should update when you make changes to the novel structure, including
edits of the current document in the editor. The information is only updated when the automatic
save of the document is triggered, or you manually press :kbd:`Ctrl+S` to save changes. (You can
-adjust the auto-save interval in :guilabel:`Preferences`.) You can also regenerate the whole novel
-view by pressing the refresh button in the novel view header.
+adjust the auto-save interval in **Preferences**.) You can also regenerate the whole novel view by
+pressing the refresh button in the novel view header.
It is possible to show an optional third column in the novel view. The settings are available from
the menu button in the toolbar.
-If you click the arrow icon to the right of each item, a tooltip will pop out showing you all the
+If you click the triangular icon to the right of each item, a tooltip will pop out showing all the
meta data collected for that heading.
@@ -108,9 +110,9 @@ Novel Outline View
A screenshot of the Novel Outline View.
-When in :guilabel:`Novel Outline View` mode, the tree, editor and viewer will be replaced by a
-large table that shows the entire novel structure with all the tags and references listed. Pretty
-much all collected meta data is available here in different columns.
+When the application is in **Novel Outline View** mode, the tree, editor and viewer will be
+replaced by a large table that shows the entire novel structure with all the tags and references
+listed. Pretty much all collected meta data is available here in different columns.
You can select which novel root folder to display from the dropdown box, and you can select which
columns to show or hide from the menu button. You can also rearrange the columns by drag and drop.
@@ -122,18 +124,30 @@ Colour Themes
By default, novelWriter will use the colour theme provided by the Qt library, which is determined
by the Fusion_ style setting. You can also choose between a standard dark and light theme that have
-neutral colours from :guilabel:`Preferences`. Other colour themes are also available. More themes
-can be contributed to novelWriter on GitHub.
+neutral colours from **Preferences**.
+
+If you wish, you *can* create your own colour themes, and even have them added to the application.
+See :ref:`a_custom_theme` for more details.
Switching the GUI colour theme does not affect the colours of the editor and viewer. They have
-separate colour selectable from the "Document colour theme" setting in :guilabel:`Preferences`.
-They are separated because there are a lot more options to choose from for the editor and viewer.
+separate colour selectable from the "Document colour theme" setting in **Preferences**. They are
+separated because there are a lot more options to choose from for the editor and viewer.
.. note::
If you switch between light and dark mode on the GUI, you should also switch editor theme to
match, otherwise icons may be hard to see in the editor and viewer.
+Project Search
+--------------
+
+A global search tool is available from the side bar. It allows you to search through your entire
+project. The tool does not provide a replace feature. There is a search and replace tool available
+in the document editor that acts on the open document.
+
+.. versionadded:: 2.4
+
+
.. _a_breakdown_project:
Project Layout
@@ -152,12 +166,12 @@ within those documents.
An illustration of how heading levels correspond to the novel structure.
-The four heading levels (**H1** to **H4**) are treated as follows:
+The four heading levels, **Level 1** to **Level 4**, are treated as follows:
-* **H1** is used for the novel title, and for partitions.
-* **H2** is used for chapter tiles.
-* **H3** is used for scene titles -- optionally replaced by separators.
-* **H4** is for section titles within scenes, if such granularity is needed.
+* **Level 1** is used for the novel title, and for partitions.
+* **Level 2** is used for chapter tiles.
+* **Level 3** is used for scene titles -- optionally replaced by separators.
+* **Level 4** is for section titles within scenes, if such granularity is needed.
The project tree will select an icon for the document based on the first heading in it.
@@ -178,25 +192,25 @@ Building a Manuscript
=====================
The project can at any time be assembled into a range of different formats through the
-:guilabel:`Build Manuscript` tool. Natively, novelWriter supports `Open Document`_, HTML5, and
+**Build Manuscript** tool. Natively, novelWriter supports `Open Document`_, HTML5, and
various flavours of Markdown.
The HTML5 format is suitable for conversion by a number of other tools like Pandoc_, or for
importing into word processors if the Open Document format isn't suitable. The Open Document format
-is supported by most Office type applications. In addition, printing is also possible. Print to PDF
+is supported by most office type applications. In addition, printing is also possible. Print to PDF
is available from the print dialog.
-In addition, you can export the content of the project to a JSON file. This is useful if you want
-to write your own custom processing script in for instance Python, as the entire novel can be read
-into a Python dictionary with a couple of lines of code. The JSON file can be populated with either
-HTML formatted text, or with the raw text as typed into the novel documents.
+For advanced processing, you can export the content of the project to a JSON file. This is useful
+if you want to write your own custom processing script in for instance Python, as the entire novel
+can be read into a Python dictionary with a couple of lines of code. The JSON file can be populated
+with either HTML formatted text, or with the raw text as typed into the novel documents.
See :ref:`a_manuscript` for more details.
.. versionadded:: 2.1
- You can now define multiple build definitions in the :guilabel:`Build Manuscript` tool. This
- allows you to define specific settings for various types of draft documents, outline documents,
- and manuscript formats. See :ref:`a_manuscript` for more details.
+ You can now define multiple build definitions in the **Build Manuscript** tool. This allows you
+ to define specific settings for various types of draft documents, outline documents, and
+ manuscript formats. See :ref:`a_manuscript` for more details.
.. _a_breakdown_storage:
diff --git a/docs/source/usage_format.rst b/docs/source/usage_format.rst
index f452c5fd..85b79c54 100644
--- a/docs/source/usage_format.rst
+++ b/docs/source/usage_format.rst
@@ -10,7 +10,7 @@ values and allowing for some text formatting. The syntax is based on Markdown, b
(bold) and strike through text, as well as four levels of headings. For some further complex
formatting needs, a set of shortcodes can be used.
-In addition to formatting codes, novelWriter allows for comments, a synopsis tag, and a set of
+In addition to formatting codes, novelWriter allows for comments, a synopsis tag, and a number of
keyword and value sets used for :term:`tags` and :term:`references`. There are also
some codes that apply to whole paragraphs. See :ref:`a_fmt_text` for more details.
@@ -35,7 +35,7 @@ have a distinct colour, and the references themselves will get a colour if they
references will get a squiggly error line underneath. The same applies to duplicate tags.
There are a number of syntax highlighter colour themes available, both for light and dark GUIs. You
-can select them from :guilabel:`Preferences`.
+can select them from **Preferences**.
.. _a_fmt_head:
@@ -54,6 +54,9 @@ correctly to produce the intended result. See :ref:`a_struct_heads` for more det
``# Title Text``
Heading level one. For novel documents, the level indicates the start of a new partition.
+ Partitions are for when you want to split your story into "Part 1", "Part 2", etc. You can also
+ choose to use them for splitting the text up into acts, and then hide these headings in your
+ manuscript.
``## Title Text``
Heading level two. For novel documents, the level indicates the start of a new chapter. Chapter
@@ -62,16 +65,17 @@ correctly to produce the intended result. See :ref:`a_struct_heads` for more det
``### Title Text``
Heading level three. For novel documents, the level indicates the start of a new scene. Scene
numbers or scene separators can be inserted automatically when building the manuscript, so you
- can use the title field as a working title for your scenes if you wish.
+ can use the title field as a working title for your scenes if you wish, but you must provide a
+ minimal title.
``#### Title Text``
Heading level four. For novel documents, the level indicates the start of a new section. Section
titles can be replaced by separators or ignored completely when building the manuscript.
-For headings level one through three, adding a ``!`` modifies its meaning:
+For headings level one through three, adding a ``!`` modifies the meaning of the heading:
``#! Title Text``
- This tells the build tool that the level one heading is intended to be used for the novel's or
+ This tells the build tool that the level one heading is intended to be used for the novel or
notes folder's main title, like for instance on the front page. When building the manuscript,
this will use a different styling and will exclude the title from, for instance, a Table of
Contents in Libre Office.
@@ -82,9 +86,10 @@ For headings level one through three, adding a ``!`` modifies its meaning:
:ref:`a_struct_heads_unnum` for more details.
``###! Title Text``
- This is an alternative scene heading that can be formatted differently in the
- :guilabel:`Manuscript Build` tool. It is intended for separating "soft" and "hard" scene breaks.
- Otherwise, it behaves identically to a regular scene heading.
+ This is an alternative scene heading that can be formatted differently in the **Manuscript
+ Build** tool. It is intended for separating "soft" and "hard" scene breaks. Aside from this, it
+ behaves identically to a regular scene heading. See :ref:`a_struct_heads_scenes` for more
+ details.
.. note::
The space after the ``#`` or ``!`` character is mandatory. The syntax highlighter will change
@@ -106,8 +111,8 @@ In addition, the editor supports a few additional types of white spaces:
* Thin spaces are also supported, and can be inserted with :kbd:`Ctrl+K`, :kbd:`Shift+Space`.
* Non-breaking thin space can be inserted with :kbd:`Ctrl+K`, :kbd:`Ctrl+Space`.
-These are all insert features, and the :guilabel:`Insert` menu has more. The keyboard shortcuts for
-them are also listed in :ref:`a_kb_ins`.
+These are all insert features, and the **Insert** menu has more. The keyboard shortcuts for them
+are also listed in :ref:`a_kb_ins`.
Non-breaking spaces are highlighted by the syntax highlighter with an alternate coloured
background, depending on the selected theme.
@@ -129,12 +134,12 @@ A minimal set of Markdown text emphasis styles are supported for text paragraphs
The text is rendered as emphasised text (italicised).
``**text**``
- The text is rendered as strongly important text (bold).
+ The text is rendered as strongly emphasised text (bold).
``~~text~~``
Strike through text.
-In Markdown guides it is often recommended to differentiate between strong importance and emphasis
+In Markdown guides it is often recommended to differentiate between strong emphasis and emphasis
by using ``**`` for strong and ``_`` for emphasis, although Markdown generally also supports ``__``
for strong and ``*`` for emphasis. However, since the differentiation makes the highlighting and
conversion significantly simpler and faster, in novelWriter this is a rule, not just a
@@ -182,14 +187,15 @@ solved with simple Markdown-like formatting codes. Available shortcodes are list
"``[i]text[/i]``", "Text is rendered as italicised text."
"``[s]text[/s]``", "Text is rendered as strike through text."
"``[u]text[/u]``", "Text is rendered as underlined text."
+ "``[m]text[/m]``", "Text is rendered as highlighted text."
"``[sup]text[/sup]``", "Text is rendered as superscript text."
"``[sub]text[/sub]``", "Text is rendered as subscript text."
Unlike Markdown style codes, these can be used anywhere within a paragraph. Even in the middle of a
word if you need to. You can also freely combine them to form more complex formatting.
-The shortcodes are available from the :guilabel:`Format` menu and in the editor toolbar, which can
-be activated by clicking the three dots in the editor header.
+The shortcodes are available from the **Format** menu and in the editor toolbar, which can be
+activated by clicking the left-most icon button in the editor header.
.. versionadded:: 2.2
@@ -199,30 +205,39 @@ be activated by clicking the three dots in the editor header.
Comments and Synopsis
=====================
-In addition to these standard Markdown features, novelWriter also allows for comments in documents.
-The text of a comment is ignored by the word counter. The text can also be filtered out when
-building the manuscript or viewing the document.
+In addition to the above formatting features, novelWriter also allows for comments in documents.
+The text of a comment is always ignored by the word counter. The text can also be filtered out
+when building the manuscript or viewing the document.
-If the first word of a comment is ``Synopsis:`` (with the colon included), the comment is treated
-in a special manner and will show up in the :ref:`a_ui_outline` in a dedicated column. The word
-``synopsis`` is not case sensitive. If it is correctly formatted, the syntax highlighter will
-indicate this by altering the colour of the word.
+The first word of a comment, followed by a colon, can be one of a small set of modifiers that
+indicates the comment is intended for a specific purpose. For instance, if the comment starts with
+``Synopsis:``, the comment is treated in a special manner and will show up in the
+:ref:`a_ui_outline` in a dedicated column. The word ``synopsis`` is not case sensitive. If it is
+correctly formatted, the syntax highlighter will indicate this by altering the colour of the word.
-``% text ...``
+The different styles of comments are as follows:
+
+``% Comment text ...``
This is a comment. The text is not rendered by default (this can be overridden), seen in the
- document viewer, or counted towards word counts.
+ document viewer, or counted towards word counts. It is intended for you to make notes in your
+ text for your own sake, whatever that may be, that isn't part of the story text. This is the
+ general format of a comment.
-``%Synopsis: text ...``
+``%Synopsis: Comment text ...``
This is a synopsis comment. It is generally treated in the same way as a regular comment, except
that it is also captured by the indexing algorithm and displayed in the :ref:`a_ui_outline`. It
can also be filtered separately when building the project to for instance generate an outline
document of the whole project.
-``%Short: text ...``
+``%Short: Comment text ...``
This is a short description comment. It is identical to the synopsis comment (they are
interchangeable), but is intended to be used for project notes. The text shows up in the
- Reference panel below the document viewer in the last column labelled
- :guilabel:`Short Description`.
+ Reference panel below the document viewer in the last column labelled **Short Description**.
+
+``%~ Comment text ...``
+ This can be used to exclude story text from your manuscript without having to delete it from
+ your text. Comments with the ``~`` will *never* be included in the manuscript, even if you have
+ chosen to include comments in it. That is the main difference between these two formats.
.. note::
Only one comment can be flagged as a synopsis or short comment for each heading. If multiple
@@ -245,14 +260,14 @@ heading. Setting it multiple times under the same heading will just override the
A tag keyword followed by the tag value, like for instance the name of a character.
References can be set anywhere within a section, and are collected according to their category.
-References are in the form:
+References are on the form:
-``@keyword: value``
+``@keyword: value1, value2, ..., valueN``
A reference keyword followed by a value, or a comma separated list of values.
Tags and references are covered in detail in the :ref:`a_references` chapter. The keywords can be
-inserted at the cursor position in the editor via the :guilabel:`Insert` menu. If you start typing
-an ``@`` on a new line, and auto-complete menu will also pop up suggesting keywords.
+inserted at the cursor position in the editor via the **Insert** menu. If you start typing an ``@``
+on a new line, and auto-complete menu will also pop up suggesting keywords.
.. _a_fmt_align:
@@ -260,8 +275,8 @@ an ``@`` on a new line, and auto-complete menu will also pop up suggesting keywo
Paragraph Alignment and Indentation
===================================
-All documents have the text by default aligned to the left or justified, depending on your
-settings in :guilabel:`Preferences`.
+All documents have the text by default aligned to the left or justified, depending on your setting
+in **Preferences**.
You can override the default text alignment on individual paragraphs by specifying alignment tags.
These tags are double angle brackets. Either ``>>`` or ``<<``. You put them either before or after
@@ -296,6 +311,10 @@ Examples:
Vertical Space and Page Breaks
==============================
+You can apply page breaks to partition, chapter and scene headings for novel documents from the
+**Manuscript Build** tool. If you need to add a page break or additional vertical spacing in other
+places, there are special codes available for this purpose.
+
Adding more than one line break between paragraphs will **not** increase the space between those
paragraphs when building the project. To add additional space between paragraphs, add the text
``[vspace]`` on a line of its own, and the build tool will insert a blank paragraph in its place.
@@ -303,13 +322,8 @@ paragraphs when building the project. To add additional space between paragraphs
If you need multiple blank paragraphs just add a colon and a number to the above code. For
instance, writing ``[vspace:3]`` will insert three blank paragraphs.
-Normally, the manuscript build tool will insert a page break before all headings of level one and
-for all headings of level two for novel documents, i.e. chapters, but not for project notes.
-
-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.
-
-If you want page breaks for scenes and sections, you must add them manually.
+If you need to add a page break somewhere, put the text ``[new page]`` on a line by itself before
+the text you wish to start on a new page.
.. note::
The page break code is applied to the text that follows it. It adds a "page break before" mark
@@ -325,8 +339,8 @@ If you want page breaks for scenes and sections, you must add them manually.
[vspace:2]
This is another text paragraph, but there will be two empty paragraphs
- in-between them.
+ between them.
[new page]
- This text will always start on a new page if the build format has pages.
+ This text will start on a new page if the build format has pages.
diff --git a/docs/source/usage_project.rst b/docs/source/usage_project.rst
index 76bccb48..fceca8b5 100644
--- a/docs/source/usage_project.rst
+++ b/docs/source/usage_project.rst
@@ -8,7 +8,7 @@ This chapter covers in more detail the different project views available in nove
.. figure:: images/fig_project_tree_detailed.png
- The Project Tree as it appears when loading a sample project.
+ The **Project Content** tree as it appears when loading a sample project.
.. _a_ui_tree:
@@ -21,33 +21,32 @@ the project, and has four columns.
**Column 1**
The first column shows the icon and label of each folder, document, or note in your project. The
- label is not the same as the title you set inside the document. However, the document's label
- will appear in the header above the document text itself so you know where in the project an
- open document belongs. The icon is selected based on the type of item, and for novel documents,
- the level of the first header in the document text.
+ label is not the same as the heading title you set inside the document. However, the document's
+ label will appear in the header above the document text itself so you know where in the project
+ an open document belongs. The icon is selected based on the type of item, and for novel
+ documents, the level of the first heading in the document text.
**Column 2**
The second column shows the word count of the document, or the sum of words of the child items
for folders and documents with sub-documents. If the counts seem incorrect, they can be updated
- by rebuilding the :term:`project index` from the :guilabel:`Tools` menu, or by pressing
- :kbd:`F9`.
+ by rebuilding the :term:`project index` from the **Tools** menu, or by pressing :kbd:`F9`.
**Column 3**
The third column indicates whether the document is considered active or inactive in the project.
You can use this flag to indicate that a document is still in the project, but should not be
- considered an active part of it. When you run the :guilabel:`Build Manuscript` tool, you can
- include or exclude documents based on this flag. You can change this value from the
+ considered an active part of it. When you run the **Build Manuscript** tool, you can include or
+ exclude documents based on this flag. You can change this value from the right-click
:term:`context menu`.
**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 on how to uses these labels. You can
- change these labels from the :term:`context menu`.
+ select these labels from the :term:`context menu`, and define them in **Project Settings**.
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.
-At the top of the tree, you will find a set of buttons.
+At the top of the project tree, you will find a set of buttons.
* The first button is a quick links button that will show you a dropdown menu of all the
:term:`root folders` in your project. Selecting one will move to that position in
@@ -73,10 +72,10 @@ addition to the word count.
Splitting and Merging Documents
-------------------------------
-Under the :guilabel:`Transform` submenu in the context menu of an item in the project tree, you
-will find several options on how to change a document or folder. This includes changing between
-document and note, but also splitting them into multiple documents, or merging child items into a
-single document.
+Under the **Transform** submenu in the context menu of an item in the project tree, you will find
+several options on how to change a document or folder. This includes changing between document and
+note, but also splitting them into multiple documents, or merging child items into a single
+document.
Splitting Documents
@@ -84,12 +83,12 @@ Splitting Documents
.. figure:: images/fig_project_split_tool.png
- The :guilabel:`Split Document` dialog.
+ The **Split Document** dialog.
-The :guilabel:`Split Document by Heading` option will open a dialog that allows you to split the
-selected document into multiple new documents based on the headings it contains. You can select at
-which heading level the split is to be performed from the dropdown box. The list box will preview
-which headings will be split into new documents.
+The **Split Document by Headings** option will open a dialog that allows you to split the selected
+document into multiple new documents based on the headings it contains. You can select at which
+heading level the split is to be performed from the dropdown box. The list box will preview which
+headings will be split into new documents.
You are given the option to create a folder for these new documents, and whether or not to create a
hierarchy of documents. That is, put sections under scenes, and scenes under chapters.
@@ -103,18 +102,18 @@ Merging Documents
.. figure:: images/fig_project_merge_tool.png
- The :guilabel:`Merge Documents` dialog.
+ The **Merge Documents** dialog.
You have two options for merging documents that are child elements of another document. You can
-either :guilabel:`Merge Child Items into Self` and :guilabel:`Merge Child Items into New`. The
-first option will pull all content of child items and merge them into the parent document, while
-the second option will create a new document in the process.
+either **Merge Child Items into Self** and **Merge Child Items into New**. The first option will
+pull all content of child items and merge them into the parent document, while the second option
+will create a new document in the process.
When merging documents in a folder, you only have the latter process is possible, so only the
-choice :guilabel:`Merge Documents in Folder` is available.
+choice **Merge Documents in Folder** is available.
-In either case, the :guilabel:`Merge Documents` dialog will let you exclude documents you don't
-want to include, and it also lets you reorder them if you wish.
+In either case, the **Merge Documents** dialog will let you exclude documents you don't want to
+include, and it also lets you reorder them if you wish.
.. _a_ui_tree_status:
@@ -124,14 +123,14 @@ Document Importance and Status
Each document or folder in your project can have either a "Status" or "Importance" flag set. These
are flags that you control and define yourself, and novelWriter doesn't use them for anything. To
-modify the labels, go to their respective tabs in :guilabel:`Project Settings`.
+modify the labels, go to their respective tabs in **Project Settings**.
The "Status" flag is intended to tag a :term:`novel document` as for instance a
draft or as completed, and the "Importance" flag is intended to tag character notes, or other
:term:`project notes`, as for instance a main, major, or minor character or story element.
Whether a document uses a "Status" or "Importance" flag depends on which :term:`root folder` it
-lives in. If it's in a Novel type folder, it uses the "Status" flag, otherwise it uses an
+lives in. If it's in a **Novel** type folder, it uses the "Status" flag, otherwise it uses an
"Importance" flag.
@@ -142,7 +141,7 @@ Project Tree Drag & Drop
The project tree allows drag & drop to a certain extent to allow you to reorder your documents and
folders. Moving a document in the project tree will affect the text's position when you assemble
-your manuscript in the :guilabel:`Manuscript Build` tool.
+your manuscript in the **Manuscript Build** tool.
.. versionadded:: 2.2
You can now select multiple items in the project tree by holding down the :kbd:`Ctrl` or
@@ -150,14 +149,15 @@ your manuscript in the :guilabel:`Manuscript Build` tool.
You can drag and drop documents and regular folders, but not root folders. If you select multiple
items, they can only be dragged and dropped if they are siblings. That is, they have the same
-parent item in the project. This is due to the way drag and drop is implemented in the user
-interface framework novelWriter is built upon.
+parent item in the project. This limitation is due to the way drag and drop is implemented in the
+user interface framework novelWriter is built upon.
-Documents and their folders can be rearranged freely within their root folders. If you move a Novel
-document out of a Novel folder, it will be converted to a project note. Notes can be moved freely
-between all root folders, but keep in mind that if you move a note into a Novel type root folder,
-its "Importance" setting will be switched with a "Status" setting. See :ref:`a_ui_tree_status`. The
-old value will not be overwritten though, and should be restored if you move it back at some point.
+Documents and their folders can be rearranged freely within their root folders. If you move a
+**Novel Document** out of a **Novel** folder, it will be converted to a **Project Note**. Notes can
+be moved freely between all root folders, but keep in mind that if you move a note into a **Novel**
+type root folder, its "Importance" setting will be switched with a "Status" setting. See
+:ref:`a_ui_tree_status`. The old value will not be overwritten though, and should be restored if
+you move it back at some point.
Root folders in the project tree cannot be dragged and dropped at all. If you want to reorder them,
you can move them up or down with respect to each other from the arrow buttons at the top of the
@@ -175,8 +175,8 @@ The Novel Tree View
An alternative way to view the project structure is the novel view. You can switch to this view by
selecting the :guilabel:`Novel View` button in the sidebar. This view is a simplified version of
-the view in the :guilabel:`Outline View`. It is convenient when you want to browse the structure
-of the story itself rather than the document files.
+the view in the **Outline View**. It is convenient when you want to browse the structure of the
+story itself rather than the document files.
.. note::
You cannot reorganise the entries in the novel view, or add any new documents, as that would
@@ -194,14 +194,14 @@ The Novel Outline View
A screenshot of the Novel Outline View.
-The project's :guilabel:`Novel Outline View` is available as another view option from the sidebar.
-The outline provides an overview of the novel structure, displaying a tree hierarchy of the
-elements of the novel, that is, the level 1 to 4 headings representing partitions, chapters, scenes
-and sections.
+The project's **Novel Outline View** is available as another view option from the sidebar. The
+outline provides an overview of the novel structure, displaying a tree hierarchy of the elements of
+the novel, that is, the level 1 to 4 headings representing partitions, chapters, scenes and
+sections.
The document containing the heading can also be displayed as a separate column, as well as the line
number where the heading is defined. Double-clicking an entry will open the corresponding document
-in the editor and switch to :guilabel:`Project Tree View` mode.
+in the editor and switch to **Project Tree View** mode.
You can select which novel folder to display from the dropdown menu. You can optionally also choose
to show a combination of all novel folders.
@@ -217,7 +217,7 @@ the menu button in the toolbar. The order of the columns can also be rearranged
a different position. You column settings are saved between sessions on a per-project basis.
.. note::
- The :guilabel:`Title` column cannot be disabled or moved.
+ The **Title** column cannot be disabled or moved.
The information viewed in the outline is based on the :term:`project index`. While novelWriter does
its best to keep the index up to date when contents change, you can always rebuild it manually by
@@ -226,5 +226,5 @@ pressing :kbd:`F9` if something isn't right.
The outline view itself can be regenerated by pressing the refresh button. By default, the content
is refreshed each time you switch to this view.
-The :guilabel:`Synopsis` column of the outline view takes its information from a specially
-formatted comment. See :ref:`a_fmt_comm`.
+The **Synopsis** column of the outline view takes its information from a specially formatted
+comment. See :ref:`a_fmt_comm`.
diff --git a/docs/source/usage_shortcuts.rst b/docs/source/usage_shortcuts.rst
index af54254b..a8f8163f 100644
--- a/docs/source/usage_shortcuts.rst
+++ b/docs/source/usage_shortcuts.rst
@@ -20,22 +20,22 @@ Main Window Shortcuts
:header: "Shortcut", "Description"
":kbd:`F1`", "Open the online user manual"
- ":kbd:`F5`", "Open the :guilabel:`Build Manuscript` tool"
- ":kbd:`F6`", "Open the :guilabel:`Writing Statistics` tool"
- ":kbd:`F8`", "Toggle :guilabel:`Focus Mode`"
+ ":kbd:`F5`", "Open the **Build Manuscript** tool"
+ ":kbd:`F6`", "Open the **Writing Statistics** tool"
+ ":kbd:`F8`", "Toggle **Focus Mode**"
":kbd:`F9`", "Re-build the project's index"
":kbd:`F11`", "Toggle full screen mode"
- ":kbd:`Ctrl+,`", "Open the :guilabel:`Preferences` dialog"
+ ":kbd:`Ctrl+,`", "Open the **Preferences** dialog"
":kbd:`Ctrl+E`", "Switch focus to the document editor"
":kbd:`Ctrl+T`", "Switch or toggle focus for the project tree or novel view"
":kbd:`Ctrl+Q`", "Exit novelWriter"
- ":kbd:`Ctrl+Shift+,`", "Open the :guilabel:`Project Settings` dialog"
+ ":kbd:`Ctrl+Shift+,`", "Open the **Project Settings** dialog"
":kbd:`Ctrl+Shift+O`", "Open the Welcome dialog to open or create a project"
":kbd:`Ctrl+Shift+S`", "Save the current project"
":kbd:`Ctrl+Shift+T`", "Switch focus to the outline view"
":kbd:`Ctrl+Shift+W`", "Close the current project"
":kbd:`Shift+F1`", "Open the local user manual (PDF) if it is available"
- ":kbd:`Shift+F6`", "Open the :guilabel:`Project Details` dialog"
+ ":kbd:`Shift+F6`", "Open the **Project Details** dialog"
.. _a_kb_tree:
@@ -53,8 +53,8 @@ Project Tree Shortcuts
":kbd:`Alt+Left`", "Jump to the parent item in the tree"
":kbd:`Alt+Right`", "Jump to the first child item in the project tree"
":kbd:`Ctrl+.`", "Open the context menu on the selected item"
- ":kbd:`Ctrl+L`", "Open the :guilabel:`Quick Links` menu"
- ":kbd:`Ctrl+N`", "Open the :guilabel:`Create New Item` menu"
+ ":kbd:`Ctrl+L`", "Open the **Quick Links** menu"
+ ":kbd:`Ctrl+N`", "Open the **Create New Item** menu"
":kbd:`Ctrl+O`", "Open the selected document in the editor"
":kbd:`Ctrl+R`", "Open the selected document in the viewer"
":kbd:`Ctrl+Up`", "Move selected item one step up in the tree"
@@ -75,11 +75,12 @@ Text Search Shortcuts
:header: "Shortcut", "Description"
":kbd:`F3`", "Find the next occurrence of the search word"
- ":kbd:`Ctrl+F`", "Open the search bar and search for the selected word, if any is selected"
+ ":kbd:`Ctrl+F`", "Open search and look for the selected word"
":kbd:`Ctrl+G`", "Find the next occurrence of the search word"
- ":kbd:`Ctrl+H`", "Open the search tool and populate with the selected word (Mac :kbd:`Cmd+=`)"
- ":kbd:`Ctrl+Shift+1`", "Replace selected occurrence of the search word, and move to the next"
+ ":kbd:`Ctrl+H`", "Open replace and look for the selected word (Mac :kbd:`Cmd+=`)"
+ ":kbd:`Ctrl+Shift+1`", "Replace selected occurrence, and move to the next"
":kbd:`Ctrl+Shift+G`", "Find the previous occurrence of the search word"
+ ":kbd:`Ctrl+Shift+F`", "Open project search and look for the selected word"
":kbd:`Shift+F3`", "Find the previous occurrence of the search word"
@@ -91,8 +92,8 @@ Text Formatting Shortcuts
":kbd:`Ctrl+'`", "Wrap selected text, or word under cursor, in single quotes"
":kbd:`Ctrl+""`", "Wrap selected text, or word under cursor, in double quotes"
- ":kbd:`Ctrl+/`", "Toggle block format as comment for block under cursor, or selected text"
- ":kbd:`Ctrl+0`", "Remove block formatting for block under cursor, or selected text"
+ ":kbd:`Ctrl+/`", "Toggle comment format for block or selected text"
+ ":kbd:`Ctrl+0`", "Remove format for block or selected text"
":kbd:`Ctrl+1`", "Change block format to heading level 1"
":kbd:`Ctrl+2`", "Change block format to heading level 2"
":kbd:`Ctrl+3`", "Change block format to heading level 3"
@@ -102,11 +103,11 @@ Text Formatting Shortcuts
":kbd:`Ctrl+7`", "Change block alignment to right-aligned"
":kbd:`Ctrl+8`", "Add a left margin to the block"
":kbd:`Ctrl+9`", "Add a right margin to the block"
- ":kbd:`Ctrl+B`", "Format selected text, or word under cursor, with strong emphasis (bold)"
+ ":kbd:`Ctrl+B`", "Format selected text, or word under cursor, with bold"
":kbd:`Ctrl+D`", "Format selected text, or word under cursor, with strike through"
- ":kbd:`Ctrl+I`", "Format selected text, or word under cursor, with emphasis (italic)"
- ":kbd:`Ctrl+Shift+/`", "Remove block formatting for block under cursor, or selected text"
- ":kbd:`Ctrl+Shift+D`", "Toggle block format as ignored text for block under cursor, or selected text"
+ ":kbd:`Ctrl+I`", "Format selected text, or word under cursor, with italic"
+ ":kbd:`Ctrl+Shift+/`", "Remove format for block or selected text"
+ ":kbd:`Ctrl+Shift+D`", "Toggle ignored text format for block or selected text"
Other Editor Shortcuts
diff --git a/docs/source/usage_typography.rst b/docs/source/usage_typography.rst
index e96d6185..189e0dd1 100644
--- a/docs/source/usage_typography.rst
+++ b/docs/source/usage_typography.rst
@@ -11,7 +11,7 @@ Typographical Notes
novelWriter has some support for typographical symbols that are not usually easily available in
many text editors. This includes for instance the proper unicode quotation marks, dashes, ellipsis,
-thin spaces, etc. All these symbols are available from the :guilabel:`Insert` menu, and via
+thin spaces, etc. All these symbols are available from the **Insert** menu, and via
keyboard shortcuts. See :ref:`a_kb_ins`.
This chapter provides some additional information on how novelWriter handles these symbols.
@@ -43,22 +43,22 @@ Single and Double Quotes
All the different quotation marks listed on the `Quotation Mark`_ Wikipedia page are available, and
can be selected as auto-replaced symbols for straight single and double quote key strokes. The
-settings can be found in :guilabel:`Preferences`.
+settings can be found in **Preferences**.
Ordinarily, text wrapped in quotes are highlighted by the editor. This is meant as a convenience
for highlighting dialogue between characters. This feature can be disabled in
-:guilabel:`Preferences` if this feature isn't wanted.
+**Preferences** if this feature isn't wanted.
The editor distinguishes between text wrapped in regular straight double quotes and the
user-selected double quote symbols. This is to help the writer recognise which parts of the text
-are not using the chosen quote symbols. Two convenience functions in the :guilabel:`Format` menu
+are not using the chosen quote symbols. Two convenience functions in the **Format** menu
can be used to re-format a selected section of text with the correct quote symbols.
Single and Double Prime
------------------------
-Both single and double prime symbols are available in the :guilabel:`Insert` menu. These symbols
+Both single and double prime symbols are available in the **Insert** menu. These symbols
are the correct symbols to use for unit symbols for feet, inches, minutes, and seconds. The usage
of these is described in more detail on the Wikipedia Prime_ page. They look very similar to single
and double straight quotes, and may be rendered similarly by the font, but they have different
@@ -79,7 +79,7 @@ right single quotation marks, depending on the font. There is a Wikipedia articl
`Modifier letter apostrophe`_ with more details.
.. note::
- On export with the :guilabel:`Build Manuscript` tool, these apostrophes will be replaced
+ On export with the **Build Manuscript** tool, these apostrophes will be replaced
automatically with the corresponding right hand single quote symbol as is generally recommended.
Therefore it doesn't really matter if you only use them to correct syntax highlighting.
diff --git a/docs/source/usage_writing.rst b/docs/source/usage_writing.rst
index d9d6400f..a1b59c67 100644
--- a/docs/source/usage_writing.rst
+++ b/docs/source/usage_writing.rst
@@ -23,13 +23,14 @@ having it selected. This will open the document in the document editor. The edit
Markdown-like syntax for some features, and a novelWriter-specific syntax for others. The syntax
format is described in the :ref:`a_fmt` chapter.
-The editor has a maximise button (toggles the :guilabel:`Focus Mode`) and a close button in the
+The editor has a maximise button, which toggles the **Focus Mode**, and a close button in the
top--right corner. On the top--left side you will find a tools button that opens a toolbar with a
-few buttons for applying text formatting, and a search button to open the search dialog.
+few buttons for applying text formatting, a drop down menu for navigating between headings, and a
+search button to open the search dialog.
Both the document editor and viewer will show the label of the currently open document in the
header at the top of the edit or view panel. Optionally, the full project path to the document can
-be shown. This can be set in :guilabel:`Preferences`.
+be shown. This can be set in **Preferences**.
.. tip::
Clicking on the document title bar will select the document in the project tree and thus reveal
@@ -42,10 +43,10 @@ the label and pressing :kbd:`Ctrl+Return`. You can also control-click them with
Editor Auto-Completer
---------------------
-If you type the character ``@`` on a new line, a menu will appear showing the different available
-keywords. The list will shorten as you type. Once a keyword command has been selected or typed, the
-editor may suggest further content based on your project content. See :ref:`a_references_completer`
-for more details.
+If you type the character ``@`` on a new line, a pop-up menu will appear showing the different
+available keywords. The list will shorten as you type. Once a keyword command has been selected or
+typed, the editor may suggest further options based on your project content. See
+:ref:`a_references_completer` for more details.
.. versionadded:: 2.2
@@ -60,9 +61,9 @@ Viewing a Document
A screenshot of the Document Viewer panel.
Any document in the project tree can also be viewed in parallel in a right hand side document
-viewer. To view a document, press :kbd:`Ctrl+R`, or select :guilabel:`View Document` in the menu or
-context menu. If you have a middle mouse button, middle-clicking on the document will also open it
-in the viewer.
+viewer. To view a document, press :kbd:`Ctrl+R`, or select **View Document** in the menu or context
+menu. If you have a middle mouse button, middle-clicking on the document will also open it in the
+viewer.
The document viewed does not have to be the same document as the one currently being edited.
However, If you *are* viewing the same document, pressing :kbd:`Ctrl+R` again will update the
@@ -75,19 +76,20 @@ content of the viewer with the content of the document the reference points to.
The document viewer keeps a history of viewed documents, which you can navigate with the arrow
buttons in the top--left corner of the viewer. If your mouse has backward and forward navigation
buttons, these can be used as well. They work just like the backward and forward features in a
-browser.
+browser. The left-most button is a dropdown menu for quickly navigation between headings in the
+document.
-At the bottom of the view panel there is a :guilabel:`References` panel. (If it is hidden, click
-the button on the left side of the footer area to reveal it.) This panel contains a References tab
-with links to all documents referring back to the one you're currently viewing, if any has been
-defined. If you have created root folders and tags for various story elements like characters and
-plot points, these will appear as additional tabs in this panel.
+At the bottom of the view panel there is a **References** panel. (If it is hidden, click the button
+on the left side of the footer area to reveal it.) This panel contains a References tab with links
+to all documents referring back to the one you're currently viewing, if any has been defined. If
+you have created root folders and tags for various story elements like characters and plot points,
+these will appear as additional tabs in this panel.
.. note::
- The :guilabel:`References` panel relies on an up-to-date :term:`index` of the
- project. The index is maintained automatically. However, if anything is missing, or seems wrong,
- the index can always be rebuilt by selecting :guilabel:`Rebuild Index` from the
- :guilabel:`Tools` menu, or by pressing :kbd:`F9`.
+ The **References** panel relies on an up-to-date :term:`index` of the project.
+ The index is maintained automatically. However, if anything is missing, or seems wrong, the
+ index can always be rebuilt by selecting **Rebuild Index** from the **Tools** menu, or by
+ pressing :kbd:`F9`.
.. versionadded:: 2.2
The reference panel was redesigned and the additional tabs added.
@@ -131,8 +133,7 @@ Auto-Replace as You Type
========================
A few auto-replace features are supported by the editor. You can control every aspect of the
-auto-replace feature from :guilabel:`Preferences`. You can also disable this feature entirely if
-you wish.
+auto-replace feature from **Preferences**. You can also disable this feature entirely if you wish.
.. tip::
If you don't like auto-replacement, all symbols inserted by this feature are also available in
diff --git a/tests/reference/baseConfig_novelwriter.conf b/tests/reference/baseConfig_novelwriter.conf
index 4e218943..668c3fb9 100644
--- a/tests/reference/baseConfig_novelwriter.conf
+++ b/tests/reference/baseConfig_novelwriter.conf
@@ -1,5 +1,5 @@
[Meta]
-timestamp = 2024-03-25 11:57:35
+timestamp = 2024-04-13 18:57:38
[Main]
theme = default