Release 2.1 (#1533)

Signed-off-by: Veronica Berglyd Olsen <1619840+vkbo@users.noreply.github.com>

.github/workflows/build.yml

@@ -24,7 +24,7 @@ jobs:
         run: pip install -r docs/source/requirements.txt
 
       - name: Build Assets
-        run: python setup.py qtlrelease sample manual
+        run: python pkgutils.py qtlrelease sample manual
 
       - name: Upload Artifacts
         uses: actions/upload-artifact@v3
@@ -42,7 +42,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10"]
+        python-version: ["3.11"]
         linux-tag: ["manylinux_2_24_x86_64", "manylinux_2_28_x86_64"]
     steps:
       - name: Python Setup
@@ -57,13 +57,6 @@ jobs:
       - name: Checkout Source
         uses: actions/checkout@v3
 
-      - name: Get Version
-        shell: bash
-        run: |
-          NW_VER=$(python setup.py version)
-          echo "novelWriter Version: $NW_VER"
-          echo "VERSION=$NW_VER" >> $GITHUB_ENV
-
       - name: Download Artifacts
         uses: actions/download-artifact@v3
         with:
@@ -71,32 +64,25 @@ jobs:
           path: novelwriter/assets
 
       - name: Build AppImage
-        run: python setup.py build-appimage --linux-tag ${{ matrix.linux-tag }} --python-version ${{ matrix.python-version }}
+        run: python pkgutils.py build-appimage --linux-tag ${{ matrix.linux-tag }} --python-version ${{ matrix.python-version }}
 
       - name: Upload Artifacts
         uses: actions/upload-artifact@v3
         with:
-          name: novelWriter-${{ env.VERSION }}-py${{ matrix.python-version }}-${{ matrix.linux-tag }}.AppImage
-          path: dist_appimage/novelWriter-${{ env.VERSION }}-py${{ matrix.python-version }}-${{ matrix.linux-tag }}.AppImage
+          name: novelWriter-Packages
+          path: |
+            dist_appimage/novelWriter*.AppImage
+            dist_appimage/novelWriter*.AppImage.sha256
           if-no-files-found: error
           retention-days: 1
 
   buildMac:
     needs: buildAssets
-    strategy:
-      fail-fast: false
     runs-on: macos-12
     steps:
       - name: Checkout
         uses: actions/checkout@v3
 
-      - name: Get Version
-        shell: bash
-        run: |
-          NW_VER=$(python3 setup.py version)
-          echo "novelWriter Version: $NW_VER"
-          echo "VERSION=$NW_VER" >> $GITHUB_ENV
-
       - name: Download Artifacts
         uses: actions/download-artifact@v3
         with:
@@ -106,17 +92,12 @@ jobs:
       - name: Build App Bundle
         run: ./setup/macos/build.sh
 
-      - name: Upload App Zip
-        uses: actions/upload-artifact@v3
-        with:
-          name: novelWriter-${{ env.VERSION }}-macos.app.zip
-          path: dist_macos/novelWriter-${{ env.VERSION }}-macos.app.zip
-          retention-days: 1
-
       - name: Upload DMG
         uses: actions/upload-artifact@v3
         with:
-          name: novelWriter-${{ env.VERSION }}-macos.dmg
-          path: dist_macos/novelWriter-${{ env.VERSION }}-macos.dmg
+          name: novelWriter-Packages
+          path: |
+            dist_macos/novelWriter*.dmg
+            dist_macos/novelWriter*.dmg.sha256
           if-no-files-found: error
           retention-days: 1

.github/workflows/syntax.yml

@@ -2,7 +2,7 @@ name: flake8
 
 on:
   push:
-    branches: 
+    branches:
       - main
       - dev
   pull_request:
@@ -23,11 +23,8 @@ jobs:
         uses: actions/checkout@v3
       - name: Install flake8
         run: pip install flake8
-      - name: Syntax Error Check
+      - name: Syntax Check
         run: |
-          flake8 novelwriter --count --select=E9,F63,F7,F82 --show-source --statistics
-          flake8 tests --count --select=E9,F63,F7,F82 --show-source --statistics
-      - name: Coding Style Violations
-        run: | 
-          flake8 novelwriter --count --max-line-length=99 --ignore E133,E221,E226,E228,E241,W503 --show-source --statistics
-          flake8 tests --count --max-line-length=99 --ignore E133,E221,E226,E228,E241,W503 --show-source --statistics
+          flake8 --version
+          flake8 novelwriter --count --show-source --statistics
+          flake8 tests --count --show-source --statistics

.github/workflows/test_linux.yml

@@ -2,7 +2,7 @@ name: Linux
 
 on:
   push:
-    branches: 
+    branches:
       - main
       - dev
   pull_request:
@@ -14,7 +14,7 @@ jobs:
   testLinux:
     strategy:
       matrix:
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
     runs-on: ubuntu-latest
     steps:
       - name: Python Setup
@@ -30,11 +30,9 @@ jobs:
         uses: actions/checkout@v3
       - name: Install Dependencies (pip)
         run: |
-          pip install --upgrade pip
-          pip install -r requirements.txt
-          pip install -r requirements-dev.txt
+          pip install -U -r requirements.txt -r tests/requirements.txt
       - name: Run Build Commands
-        run: python setup.py qtlrelease sample
+        run: python pkgutils.py qtlrelease sample
       - name: Run Tests
         run: |
           export QT_QPA_PLATFORM=offscreen

.github/workflows/test_mac.yml

@@ -1,8 +1,8 @@
-name: macOS
+name: MacOS
 
 on:
   push:
-    branches: 
+    branches:
       - main
       - dev
   pull_request:
@@ -17,19 +17,16 @@ jobs:
       - name: Python Setup
         uses: actions/setup-python@v4
         with:
-          python-version: "3.10"
+          python-version: "3.11"
           architecture: x64
-      - name: Install Packages
+      - name: Install Packages (brew)
         run: |
           brew install enchant
       - name: Checkout Source
         uses: actions/checkout@v3
-      - name: Install Dependencies
+      - name: Install Dependencies (pip)
         run: |
-          pip install --upgrade pip
-          pip install -r requirements.txt
-          pip install -r requirements-dev.txt
-          pip install pyobjc
+          pip install -U pyobjc -r requirements.txt -r tests/requirements.txt
       - name: Run Tests
         run: |
           export QT_QPA_PLATFORM=offscreen

.github/workflows/test_win.yml

@@ -2,7 +2,7 @@ name: Windows
 
 on:
   push:
-    branches: 
+    branches:
       - main
       - dev
   pull_request:
@@ -17,15 +17,13 @@ jobs:
       - name: Python Setup
         uses: actions/setup-python@v4
         with:
-          python-version: "3.10"
+          python-version: "3.11"
           architecture: x64
       - name: Checkout Source
         uses: actions/checkout@v3
-      - name: Install Dependencies
+      - name: Install Dependencies (pip)
         run: |
-          pip install --upgrade pip
-          pip install -r requirements.txt
-          pip install -r requirements-dev.txt
+          pip install -U -r requirements.txt -r tests/requirements.txt
       - name: Run Tests
         run: |
           pytest -v --cov=novelwriter --timeout=60

.gitignore

@@ -33,7 +33,6 @@ __pycache__
 /novelwriter/assets/sample.zip
 /sample/cache
 /sample/meta
-/sample/versions
 *.bak
 *.lock
 ToC.txt
@@ -44,9 +43,6 @@ ToC.txt
 /tests/temp
 /tests/lipsum/cache
 /tests/lipsum/meta
-/tests/minimal/cache
-/tests/minimal/meta
-/tests/oldproj/cache
 /.pytest_cache
 /pytestdebug.log
 

CHANGELOG.md

@@ -1,5 +1,190 @@
 # novelWriter Changelog
 
+## Version 2.1 [2023-10-17]
+
+### Release Notes
+
+The primary focus of this release has been a complete redesign of the Build Tool, that is, the tool
+that assembles your project into a manuscript document. The new tool, called the "Manuscript Build
+Tool" allows you to define multiple build definitions for your project. The build definitions are
+edited in a new Manuscript Build Settings dialog, with a lot more options than the old tool.
+
+The reason for this redesign is a long list of feature requests that could not easily be
+accommodated in the old, much simpler tool. Far from all the features have been added yet, but now
+that the new tool is in place, they will be gradually added in the coming releases.
+
+The key feature added in this release is the extended control you now have for selecting exactly
+what part of your project is included in a given build definition. You have the same filters for
+selecting documents and notes, and turning on or off root folders as before, but you can now easily
+override on a per-document basis what is included or excluded in addition to the filter.
+
+A second major improvement is a better tool to format your manuscript headings. You no longer have
+to look up formatting codes and add them manually. Instead, there is now a heading format editor in
+the Build Settings dialog for creating the header format, with syntax highlighting included.
+
+#### Other Changes
+
+Among other features is a new option to duplicate documents and folders in the project tree. The
+duplicate feature is available from the right-click menu. A proper light colour theme has also been
+added. In most cases it will be the same as the default theme, depending on your platform.
+
+There are other, minor improvements as well, and a lot of code improvements under the hood. For a
+full list of changes, see the detailed changelogs.
+
+_These Release Notes also include the changes from the 2.1 Beta 1 and 2.1 RC 1 releases._
+
+### Detailed Changelog
+
+**Usability**
+
+* A widget has been added to the Build Manuscript tool main window to show some select build
+  settings for the selected build definition. This should make it a little easier to find the
+  wanted build definition if there are many available. PR #1516.
+* All columns on the Writing Stats tool now uses the same fixed width font. Issue #1442, PR #1518.
+
+**Documentation**
+
+* The documentation has received significant updates for the 2.1 release. PR #1531.
+
+**Packaging and Installation**
+
+* Python 3.7 support has officially been dropped. Python 3.7 has reached end of life, and dropping
+  it relaxes some restrictions on development. PR #1515.
+* MacOS and Windows is now tested against Python 3.11, and 3.12 has been added to Linux. PR #1515.
+
+----
+
+## Version 2.1 RC 1 [2023-08-31]
+
+### Release Notes
+
+This is a release candidate of the next release version, and is intended for testing purposes.
+Please be careful when using this version on live writing projects, and make sure you take frequent
+backups.
+
+Please check the changelog for an overview of changes. The full release notes will be added to the
+final release.
+
+### Detailed Changelog
+
+**Bugfixes**
+
+* Fixed an issue where closing modal dialogs would close their parent. Issue #1494. PR #1496.
+* The log output no longer prints an error message if the project does not have anything in its
+  custom dictionary. PR #1495.
+
+**Usability**
+
+* novelWriter will no longer try to restore full screen mode if full screen was activated when it
+  was last closed. This never worked right anyway. PR #1498.
+* There are several usability updates for the Build Settings tool. Please check the PR for details.
+  Some key changes are that the build dialogs are now children of the main GUI, so they can be
+  moved freely from each other. The Selection page has been given a new look that should hopefully
+  make it easier to understand, and the side bar for the tool has been redesigned. A few labels
+  have also been changed to be easier to understand. Issue #1497. PR #1499.
+* The alert and message boxes have been reimplemented with the full feature set of the Qt message
+  box dialog instead of using the quick access functions with limited functionality. PR #1501.
+* A project's spell check dictionary can now be set directly from the Tools menu. Issue #1260.
+  PR #1508.
+* The document details dialog box now shows a document's creation and update date if that has been
+  set. Issue #1423. PR #1510.
+* Moving the mouse wheel on any area within the border of the text editor or viewer will now scroll
+  the document. Issue #1425. PR #1511.
+
+**Code Improvements**
+
+* A new shared data instance now owns the Gui Theme, the Project class and holds a link to the main
+  Gui instance as well. This new class also handles message and alert boxes. The project instance
+  is now destroyed and recreated between each project close/open cycle. This should guard better
+  from project to project data leakage. PRs #1502 and #1504.
+* The spell checker instance has been moved to the new shared data instance where it is destroyed
+  and recreated together with the project instance. This blocks against bleed-through of the user's
+  custom dictionary. PR #1508.
+* Text hash (SHA1) and creation and update time stamps are now added to the document file's meta
+  data section. The hash is used to detect file changes outside of novelWriter while documents are
+  open. The old checker has been deleted. Issue #1423. PR #1509.
+
+----
+
+## Version 2.1 Beta 1 [2023-07-30]
+
+### Release Notes
+
+This is a beta release of the next release version, and is intended for testing purposes. Please be
+careful when using this version on live writing projects, and make sure you take frequent backups.
+
+Please check the changelog for an overview of changes. The full release notes will be added to the
+final release.
+
+### Detailed Changelog
+
+**Usability**
+
+* When the main window is resized, the change in size is only assigned to the editor and viewer. To
+  resize the project tree area, its slider needs to be moved. PR #1388.
+* The default text font on MacOS is now Helvetica instead of Courier. Issue #1463. PR #1479.
+* Backup files now contain the project name again. Issue #1476. PR #1484.
+* The backup success dialog now displays the file size of the backup file. Issue #1453. PR #1484.
+* New root folders in the Project Tree now appear next to the root folder of the item selected when
+  the request to make the root folder was made. Previously, it would appear at the bottom of the
+  Project Tree. Issue #1259. PR #1487.
+
+**Features**
+
+* A new Manuscript Build Tool has been added. The new tool allows for detailed handling of which
+  documents are included in a build, as well as a much better tool for formatting headers. It also
+  allows for saving multiple build presets. PRs #1389 and #1466. Issues #971, #1315 and #1448.
+* Exported ODT documents now have an accessible style for scene separators. It is also possible to
+  define page size and margin sizes from the new build tool. Issue #622. PR #1477.
+* A proper light colour theme has been added. The default theme will usually default to light
+  colours, but in Qt6 it will not depending on host OS settings, so creating a proper light theme
+  is needed. This also allows for some tweaking of the colours. The contrast of the dark theme has
+  been improved a bit as well, and a default icon theme is now selected based on the lightness of
+  the background if an icon theme is not specified in the theme definition file.
+  Issues #1472 and #1473. PR #1475.
+* Documents, folders and root folders can now be duplicated from the Project Tree, including all
+  child elements. The duplicated content is stored next to the source items, and can then be moved
+  to wherever the user wants a copy. Issue #1469. PR #1480.
+* A set of new keyboard shortcuts have been added to make some types of navigation in the Project
+  Tree easier. `Alt+Up` and `Alt+Down` will move between sibling items in the tree, skipping child
+  items. `Alt+Left` will move to the parent of the selected item without triggering the collapse of
+  the node like the `Left` key does. `Alt+Right` does the reverse, and both expands the node and
+  moves to the first child in one click. Issue #1348. PRs #1488 and #1489.
+
+**Packaging and Installation**
+
+* Support for Python 3.7 is no longer maintained, but has not officially been dropped. It is
+  expected to be dropped for the final release of 2.1. PR #1452.
+* The `lxml` package has been removed from the source code, dropping it as a dependency of
+  novelWriter. The standard Python `xml` library is used instead. The standard library is somewhat
+  limited, which is why it wasn't originally used, but when dropping support for Python 3.7, it is
+  now good alternative. Issue #1257. PR #1452.
+* The `setup.py` file has been removed. The custom packaging utilities in the old `setup.py` file
+  are now available in `pkgutils.py` instead. Issues #1437 and #1438. PR #1483.
+
+**Code Improvements**
+
+* All imports of modules are now direct imports instead of going via init files. All subfolder init
+  files have been reduced to empty files. PR #1262.
+* The mocking of the main config object in the test suite has been rewritten to be easier to deal
+  with when writing tests. The new approach also removes the need to access the config object via
+  an attribute in many classes, and is now instead accessed directly. This should give a tiny
+  performance boost as a bonus. PR #1447.
+* The building of manuscript documents from novelWriter source text is now handled by a core
+  builder class, thus separating it from any GUI module. Previously, this was baked into the build
+  tool. PR #1316.
+* SVG icons have been optimised in terms of storage size and object complexity. PR #1456.
+* The file names for the project meta data files have been simplified and references to legacy
+  formats removed. The wordlist has been converted to a JSON file, and the session log to a JSON
+  Lines file. All old files are renamed or converted on the fly when opening the project. PR #1464.
+* The core project item and tree classes have been modified to improve how items, and in
+  particular, orphaned items are handled. These are mostly internal changes that simplifies how
+  items are accessed in the source code. Issue #1481. PR #1482.
+* Many of the above PRs adds type annotations to classes and functions in the source code. These
+  will be added gradually to the entire source code going forward.
+
+----
+
 ## Version 2.0.7 [2023-04-16]
 
 ### Release Notes
@@ -29,7 +214,7 @@ such a document. In addition, the "Change Label" context menu entry has been cha
   underscores. The spell checker relies on RegEx for splitting words, and RegEx considers the
   underscore a word character. Issue #1415. PR #1417.
 * Fixed an issue where escaped markup characters were not being cleaned up when building HTML and
-    ODT outputs. Issue #1412. PR #1418.
+  ODT outputs. Issue #1412. PR #1418.
 
 **Usability Fixes**
 
@@ -208,7 +393,7 @@ dialog box, replacing the Credits section on the main About tab.
 * Update Chinese translation. PR #1298.
 * Update Norwegian, US English, German and Spanish translations. PR #1311.
 
-**Other CHanges**
+**Other Changes**
 
 * An icon theme can now be loaded from the user's data folder alongside a custom user theme.
   Issue #1297. PR #1299.

CREDITS.md

@@ -40,7 +40,6 @@ The following libraries are dependencies of novelWriter:
 
 * [Qt5](https://www.qt.io) by Qt Company
 * [PyQt5](https://www.riverbankcomputing.com/software/pyqt) by Riverbank Computing
-* [lxml](https://lxml.de) by Martijn Faassen
 * [Enchant](https://abiword.github.io/enchant) by Dom Lachowicz
 * [PyEnchant](https://pyenchant.github.io/pyenchant) by Dimitri Merejkowsky
 

MANIFEST.in

@@ -1,7 +1,6 @@
-include setup.py
+include pkgutils.py
 include LICENSE.md
 include CREDITS.md
 include CHANGELOG.md
-recursive-include setup *
 recursive-include novelwriter/assets *
-recursive-include sample *.nwx *.nwd
+recursive-include setup *

README.md

@@ -32,7 +32,7 @@ documentation.
 
 ## Implementation
 
-novelWriter is written with Python 3 (3.7+) using Qt5 and PyQt5 (5.10+), and is released on Linux,
+novelWriter is written with Python 3 (3.8+) using Qt5 and PyQt5 (5.10+), and is released on Linux,
 Windows and macOS. It can in principle run on any Operating System that also supports Qt, PyQt and
 Python.
 

docs/source/conf.py

@@ -35,7 +35,7 @@ os.environ["TZ"] = "Europe/Oslo"
 time.tzset()
 
 needs_sphinx = "5.0"
-extensions = []
+extensions = ["sphinx_design"]
 templates_path = ["_templates"]
 source_suffix = ".rst"
 master_doc = "index"

docs/source/index.rst

@@ -18,18 +18,13 @@ storage for robustness.
 
 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 primarily saved as
-JSON files. See the :ref:`a_breakdown_storage` section for more details.
+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.
 
 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
+novelWriter. It runs fine on Linux, Windows and MacOS, and users have tested it on other platforms
 as well. novelWriter can also be run directly from the Python source, or installed from packages or
-the pip tool. See :ref:`a_started` for more details.
-
-.. note::
-   Release 1.5 introduced a few changes that will require you to make some minor modifications to
-   some of the headings in your project. It should be fairly quick and straightforward. Please see
-   the :ref:`a_prjfmt_1_3` section for more details.
+with pip. See :ref:`a_started` for more details.
 
 **Useful Links**
 
@@ -56,9 +51,9 @@ the pip tool. See :ref:`a_started` for more details.
    int_introduction
    int_overview
    int_started
-   int_source
    int_howto
    int_customise
+   int_glossary
 
 .. toctree::
    :maxdepth: 1
@@ -66,7 +61,8 @@ the pip tool. See :ref:`a_started` for more details.
    :hidden:
 
    usage_breakdown
-   usage_interface
+   usage_project
+   usage_writing
    usage_format
    usage_shortcuts
    usage_typography
@@ -79,14 +75,15 @@ the pip tool. See :ref:`a_started` for more details.
 
    project_overview
    project_structure
-   project_notes
-   project_export
+   project_references
+   project_manuscript
 
 .. toctree::
    :maxdepth: 1
-   :caption: Under the Hood
+   :caption: Additional Topics
    :hidden:
 
    tech_locations
    tech_storage
+   tech_source
    tech_tests

docs/source/int_customise.rst

@@ -17,14 +17,14 @@ Spell Check Dictionaries
 ========================
 
 novelWriter uses Enchant_ as the spell checking tool. Depending on your operating system, it may or
-may not load installed spell check dictionaries.
+may not load all installed spell check dictionaries automatically.
 
 Linux and MacOS
 ---------------
 
 On Linux and MacOS, you generally only have to install hunspell or aspell dictionaries on your
 system like you do for other applications. See your distro or OS documentation for how to do this.
-These dictionaries should then show up as available spell check languages in novelWriter.
+These dictionaries should show up as available spell check languages in novelWriter.
 
 Windows
 -------
@@ -40,7 +40,6 @@ This assumes your user profile is stored at ``C:\Users\<USER>``. The last one or
 not exist, so you may need to create them.
 
 .. note::
-
    The Free Desktop link points to a repository, and what may look like file links inside the
    dictionary folder are actually links to web pages. If you right-click and download those, you
    get HTML files, not dictionaries!
@@ -54,8 +53,9 @@ not exist, so you may need to create them.
 Syntax and GUI Themes
 =====================
 
-Adding your own GUI and syntax themes is relatively easy. The themes are defined by simple plain
-text config files with meta data and colour settings.
+Adding your own GUI and syntax themes is relatively easy, altough it requires that you manually
+edit config files with colour values. The themes are defined by simple plain text config files with
+meta data and colour settings.
 
 In order to make your own versions, first copy one of the existing files to your local computer and
 modify it as you like.
@@ -78,16 +78,16 @@ 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
 set as ``name`` inside the file.
 
-.. note::
-   In novelWriter 2.0 the ``icontheme`` value was added to GUI themes. Make sure you set this value
-   in existing custom themes. Otherwise it defaults to ``typicons_light``, which may not match your
-   theme colour scheme.
+.. versionadded:: 2.0
+   The ``icontheme`` value was added to GUI themes. Make sure you set this value in existing custom
+   themes. Otherwise, novelWriter will try to guess your icon theme, and may not pick the most
+   suitable one.
 
 
 Gustom GUI and Icons Theme
 --------------------------
 
-A GUI theme conf file consists of the follwing settings:
+A GUI theme ``.conf`` file consists of the follwing settings:
 
 .. code-block:: cfg
 
@@ -136,7 +136,7 @@ Omitted values are not loaded and will use default values.
 Custom Syntax Theme
 -------------------
 
-A syntax theme conf file consists of the follwing settings:
+A syntax theme ``.conf`` file consists of the follwing settings:
 
 .. code-block:: cfg
 
@@ -166,7 +166,6 @@ A syntax theme conf file consists of the follwing settings:
    replacetag     =   0,   0,   0
    modifier       =   0,   0,   0
 
-
 In the Main section, you must define at least the ``name`` setting. The Syntax colour values are
-RGB numbers on the format ``r, g, b`` where each is an integer from  to 255. Omitted values are set
+RGB numbers on the format ``r, g, b`` where each is an integer from  to 255. Omitted values default
 to black, except ``background`` which defaults to white,

docs/source/int_glossary.rst

@@ -0,0 +1,64 @@
+.. _a_glossary:
+
+********
+Glossary
+********
+
+.. glossary::
+   :sorted:
+
+   Root Folder
+      A "Root Folder" is a top level folder of the project tree in novelWriter. Each type of root
+      folder has a specific icon to identify it. For an overview of available root folder types,
+      see :ref:`a_proj_roots`.
+
+   Novel Documents
+      These are documents that are created under a "Novel" :term:`root folder`. They behave
+      differently than :term:`Project Notes`, and have some more restrictions. For instance, they
+      can not exist in folders intended only for project notes. See the :ref:`a_struct` chapter for
+      more details.
+
+   Project Notes
+      Project Notes are unrestricted documents that can be placed anywhere in your project. You
+      should not use these documents for story elements, only for notes. Project notes are the
+      source files used by the Tags and References system. See the :ref:`a_references` chapter for
+      more details on how to use them.
+
+   Tag
+      A tag is a user defined value assigned as a tag to a section of your :term:`Project Notes`.
+      It is optional, and can be defined once per heading. It is set using the :term:`keyword`
+      syntax ``@tag: value``, where ``value`` is the user defined part. Each tag can be referenced
+      in another file using one of the :term:`reference` keywords. See :ref:`a_references` chapter
+      for more details.
+
+   Reference
+      A references is one of a set of :term:`keywords<keyword>` that can be used to link to a
+      :term:`tag` in another document. The reference keywords are specific to the different
+      :term:`root folder` types. A full overview is available in the :ref:`a_references` chapter.
+
+   Project Index
+      The project index is a record of all headings in a project, with all their meta data like
+      synopsis comments, :term:`tags<tag>` and :term:`references<reference>`. The project index is
+      kept up to date automatically, but can also be regenerated manually from the
+      :guilabel:`Tools` menu or by pressing :kbd:`F9`.
+
+   Context Menu
+      A context menu is a menu that pops up when you right click something in the user interface.
+      In novelWriter, you can often also open a context menu by pressing the keyboard shortcut
+      :kbd:`Ctrl+.`.
+
+   Headings
+      Each level of headings in :term:`Novel Documents` have a specific meaning in terms of the
+      structure of the story. That is, they determine what novelWriter considers a partition, a
+      chapter, a scene or a text section. For :term:`Project Notes`, the header levels don't
+      matter. For more details on headings in novel documents, see :ref:`a_struct_heads`.
+
+   Keyword
+      A keyword in novelWriter is a special command you put in the text of your documents. They are
+      not standard Markdown, but is used in novelWriter to add information that is interpreted by
+      the application. For instance, keywords are used for :term:`tags<tag>` and
+      :term:`references<reference>`.
+
+      Keywords must always be on their own line, and the first character of the line must always be
+      the ``@`` character. The keyword must also always be followed by a ``:`` character, and the
+      values passed to the command are added after this, separated by commas.

docs/source/int_howto.rst

@@ -9,117 +9,75 @@ Tips & Tricks
 This is a list of hopefully helpful little tips on how to get the most out of novelWriter.
 
 .. note::
-
-    This section will be expanded over time, and if you would like to have something added, feel
-    free to contribute, or start a discussion on the project's `Discussions Page`_
-
-
-Overview
-========
-
-**Managing the Project**
-
-* :ref:`a_howto_merge_documents`
-
-**Layout Tricks**
-
-* :ref:`a_howto_simple_table`
-
-**Organising Your Text**
-
-* :ref:`a_howto_chapter_intro`
-* :ref:`a_howto_soft_hard_breaks`
-
-**Other Tools**
-
-* :ref:`a_howto_convert_ywriter`
-
-
-How-Tos
-=======
+   This section will be expanded over time, and if you would like to have something added, feel
+   free to contribute, or start a discussion on the project's `Discussions Page`_.
 
 
 Managing the Project
---------------------
+====================
 
+.. dropdown:: Merge Multiple Documents Into One
+   :animate: fade-in-slide-down
 
-.. _a_howto_merge_documents:
+   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
+   :guilabel:`Merge Documents in Folder`.
 
-Merge Multiple Documents Into One
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-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
-: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 can
-also rearrange them here of you wish.
+   In the dialog that pops up, the documents will be in the same order as in the folder, but you
+   can also rearrange them here of you wish. See :ref:`a_ui_tree_split_merge` for more details.
 
 
 Layout Tricks
--------------
+=============
 
+.. dropdown:: Create a Simple Table
+   :animate: fade-in-slide-down
 
-.. _a_howto_simple_table:
+   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`.
 
-Create a Simple Table
-^^^^^^^^^^^^^^^^^^^^^
+   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.
 
-The formatting tools available in novelWriter don't allow for complex structures like tables.
-However, the editor does render tabs in a similar way to regular word processors. You can set the
-width of a tab in :guilabel:`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.
-
-This is most suitable for your notes, as the result in exported documents cannot be guaranteed to
-match.
+   This is most suitable for your notes, as the result in exported documents cannot be guaranteed
+   to match.
 
 
 Organising Your Text
---------------------
+====================
 
+.. dropdown:: Add Introductory Text to Chapters
+   :animate: fade-in-slide-down
 
-.. _a_howto_chapter_intro:
+   Sometimes chapters have a short preface, like a brief piece of text or a quote to set the stage
+   before the first scene begins.
 
-Add Introductory Text to Chapters
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+   If you add separate files for chapters and scenes, the chapter file is the perfect place to add
+   such text. Separating chapter and scene files also allows you to make scene files child
+   documents of the chapter (added in novelWriter 2.0).
 
-Sometimes chapters have a short preface, like a brief piece of text or a quote to set the stage
-before the first scene -- Some text that may not be a part of the actual following scene.
+.. dropdown:: Distinguishing Soft and Hard Scene Breaks
+   :animate: fade-in-slide-down
 
-If you add separate files for chapters and scenes, this is the perfect place to add such text.
-Separating chapter and scene files also allows you to set meta data for the whole chapter. Like
-list all characters present in the chapter, etc.
+   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.
 
-
-.. _a_howto_soft_hard_breaks:
-
-Distinguishing Soft and Hard Scene Breaks
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-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 the scene heading for hard scene breaks and section headings for
-soft scene breaks. the :guilabel:`Project Build 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.
+   In such cases you may want to use the scene heading for hard scene breaks and section headings
+   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.
 
 
 Other Tools
------------
+===========
 
+.. dropdown:: Convert Project to/from yWriter Format
+   :animate: fade-in-slide-down
 
-.. _a_howto_convert_ywriter:
+   There is a tool available that lets you convert a `yWriter <http://spacejock.com/yWriter7.html>`_
+   project to a novelWriter project, and vice versa.
 
-Convert Project to/from yWriter Format
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. _yWriter: http://spacejock.com/yWriter7.html
-
-There is a tool available that lets you convert a yWriter_ project to a novelWriter project, and
-vice versa.
-
-The tool is available at `peter88213.github.io/yw2nw <https://peter88213.github.io/yw2nw/>`__
+   The tool is available at `peter88213.github.io/yw2nw <https://peter88213.github.io/yw2nw/>`__

docs/source/int_introduction.rst

@@ -4,19 +4,26 @@
 Key Features
 ************
 
-.. _Snowflake : https://www.advancedfictionwriting.com/articles/snowflake-method/
+.. _Snowflake: https://www.advancedfictionwriting.com/articles/snowflake-method/
+.. _Markdown: https://en.wikipedia.org/wiki/Markdown
 
-At the 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 is designed for writing fiction, so the
-formatting features are limited to those relevant for this purpose. It is not suitable for
-technical writing.
+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 is designed for writing fiction, so the
+formatting features available are limited to those relevant for this purpose. It is *not* suitable
+for technical writing, and it is *not* a full-feature Markdown editor.
 
 Your novel project is organised as a collection of separate plain text documents instead of a
 single, large document. The idea here is to make it easier to reorganise your project structure
-without having to cut and paste text.
+without having to cut and paste text between chapters.
 
-You can at any point split documents by their header, or merge multiple documents into single
-documents. This makes it easier to use variations of the popular Snowflake_ method for writing.
+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 headers up into multiple documents, or
+merge multiple documents into single documents. This makes it easier to use variations of the
+Snowflake_ method for writing. You can focus on writing larger structure-focused documents, like
+one per act for instance, and later effortlessly split these up into scenes by their headers.
 
 Below are some key features of novelWriter.
 
@@ -24,43 +31,48 @@ Below are some key features of novelWriter.
    The aim of the user interface is to let the user 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 window
-   itself is vissible.
+   writing, you can switch the editor into :guilabel:`Focus Mode` where only the text editor panel
+   itself is vissible, 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, you character notes, plot notes, or any
-   other document you may need to reference while writing.
+   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.
 
 **Organise your documents how you like**
    You can split your novel project up into as many individual documents as you want to. When you
-   build the project, they are all glued together in the top-to-bottom order in which they appear
-   in the project tree. You can use as few text documents as you like, but splitting the project up
-   into chapters and scenes means you can easily reorder them using the drag and drop feature. You
-   can start out with a few documents and then later split the document into multiple documents
-   based on its headers.
+   build the project into a manuscript, they are all glued together in the top-to-bottom order in
+   which they appear in the project tree. You can use as few text documents as you like, but
+   splitting the project up into chapters and scenes means you can easily reorder them using the
+   drag-and-drop feature. You can also start out with a few documents and then later split them
+   into multiple documents based on their headers.
+
+**Multi-novel project support**
+   As of novelWriter 2.0, 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.
 
 **Keep track of your plot elements**
-   All notes in your project can be assigned a *tag* you can *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 a specific section. Note tags are organised into categories with specific reference
-   keywords.
+   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 ot.
 
 **Get an overview of your plot elements**
    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 document, 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 a replacement for the
-   main project tree.
+   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.
 
 **Building your manuscript**
-   Whether you want to compile 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 Novel Project` tool.
-   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 as HTML, or
-   Markdown, both suitable for further conversion to other formats.
+   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
+   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
+   as HTML, or Markdown, both suitable for further conversion to other formats.
 
 
 .. _a_intro_screenshots:

docs/source/int_overview.rst

@@ -10,59 +10,59 @@ Overview
       :align: right
       :width: 220
 
-novelWriter is built on `Python 3 <https://www.python.org/>`_, a cross platform programming
-language that doesn't require a compiler to build and run. That means that the code can run on your
-computer right out of the box, or from a zip file.
+novelWriter is built as a cross-platform application using `Python 3 <https://www.python.org/>`_ as
+the programming language, and `Qt 5 <https://www.qt.io/>`_ for the user interface.
 
-While it is developed for Linux primarily, it runs just fine on Windows as well. It also works fine
-on macOS, but the author is not a mac user, so support for mac is dependant on user feedback and
+novelWriter is built for Linux first, and this is where it works best. However, it also runs fine
+on Windows and MacOS due to the cross-platform framework it's build on. The author of the
+application doesn't own a Mac, so on-going Mac support is dependant on user feedback and user
 contributions.
 
-In order to run novelWriter, you also need a few additional packages. The user interface is built
-with `Qt 5 <https://www.qt.io/>`_, a cross platform library for building graphical user interface
-applications. It also uses a third party XML package. If you want spell checking, you also need the
-spell check package Enchant developed for AbiWord
+Spell checking in novelWriter is provided by a third party library called
+`Enchant <https://abiword.github.io/enchant/>`_. Please see the section on :ref:`a_custom_dict` for
+how to install spell checking languages.
 
 For install instructions, see :ref:`a_started`.
 
-For information on how to add spell check dictionaries, see :ref:`a_custom_dict`.
-
 
 Using novelWriter
 =================
 
 In order to use novelWriter effectively, you need to know the basics of how it works. The following
-sections will explain the main principles. It starts with the basics, and gets more detailed as you
+chapters will explain the main principles. It starts with the basics, and gets more detailed as you
 read on.
 
 :ref:`a_breakdown` – Essential Information
-   This section explains the basics of how the application works and what it can and cannot do.
+   This chapter explains the basics of how the application works and what it can and cannot do.
 
-:ref:`a_ui` – Recommended Reading
-   This section will give you a more detailed explanation of what the various elements on the user
-   interface do and how you can use them more effectively.
+:ref:`a_ui_project` – Recommended Reading
+   This chapter will give you a more detailed explanation of how you the user interface components
+   to organise and view your project work.
+
+:ref:`a_ui_writing` – Recommended Reading
+   This chapter will give you a more detailed explanation of how the text editor and viewer work.
 
 :ref:`a_fmt` – Essential Information
-   This section covers how you should format your text. The editor is plain text, so text
+   This chapter covers how you should format your text. The editor is plain text, so text
    formatting requires some basic markup. The structure of your novel is also inferred by how you
-   use headings. Tags and references are implemented by simple codes.
+   use headings. Tags and references are implemented by special keywords.
 
 :ref:`a_kb` – Optional / Lookup
-   This section lists all the keyboard shortcuts in novelWriter and what they do. Most of the
-   shortcuts are also listed next to the menu items inside the app, or in tool tips, so this
-   section is mostly for reference.
+   This chapter lists all the keyboard shortcuts in novelWriter and what they do. Most of the
+   shortcuts are also listed next to their menu entries inside the app, or in tool tips. This
+   chapter is mostly for reference.
 
 :ref:`a_typ` – Optional
-   This section gives you an overview of the special typographical symbols available in
+   This chapter gives you an overview of the special typographical symbols available in
    novelWriter. The auto-replace feature can handle the insertion of standard quote symbols for
    your language, and other special characters. If you use any symbols aside from these. their
    intended use is explained here.
 
 :ref:`a_prjfmt` – Optional
-   This section is more technical and has an overview of changes made to the way your project data
+   This chapter is more technical and has an overview of changes made to the way your project data
    is stored. The format has changed a bit from time to time, and sometimes the changes require
    that you make small modifications to your project. Everything you need to know is listed in this
-   section.
+   chapter.
 
 
 Organising Your Projects
@@ -74,19 +74,19 @@ to take advantage of these features, you must structure your text in a specific
 meta data for it to extract.
 
 :ref:`a_proj` – Essential Information
-   This section explains how you organise the content of your project, and how to set up automated
+   This chapter explains how you organise the content of your project, and how to set up automated
    backups of your work.
 
 :ref:`a_struct` – Essential Information
-   This section covers the way your novel's structure is encoded into the text documents. It
-   explains how the different levels of headings are used, and how you can include information
-   about characters, plot elements, and other meta data in your text.
+   This chapter covers the way your novel's structure is encoded into the text documents. It
+   explains how the different levels of headings are used, and some special formatting for
+   different kinds of headings.
 
-:ref:`a_notes` - Recommended Reading
-   This section briefly describes what novelWriter does with the note files you add to your
-   project. Generally, the application doesn't do much with them at all aside from looking through
-   them for tags you've set so that it knows which file to open when you click on a reference.
+:ref:`a_references` - Recommended Reading
+   This chapter explains how you organise your notes, and how the Tags and References system works.
+   This system lets you cross-link your documents in your project, and display these references in
+   the application interface.
 
-:ref:`a_export` - Recommended Reading
-   This section explains in more detail how the build tool works. In particular how you can
-   control the way chapter titles are formatted, and how scene and section breaks are handled.
+: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.

docs/source/int_started.rst

@@ -10,16 +10,16 @@ Getting Started
 .. _PPA: https://launchpad.net/~vkbo/+archive/ubuntu/novelwriter
 .. _Pre-Release PPA: https://launchpad.net/~vkbo/+archive/ubuntu/novelwriter-pre
 .. _PyPi: https://pypi.org/project/novelWriter/
-.. _python.org: https://www.python.org/downloads/windows
+.. _python.org: https://www.python.org/downloads/
 .. _Releases: https://github.com/vkbo/novelWriter/releases
 .. _AppImage: https://appimage.org/
 
-Package installers are available for all major platforms, including Linux, Windows and MacOS. See
-below for install instructions for each platform.
+Package installers for novelWriter are available for all major platforms, including Linux, Windows
+and MacOS. See below for install 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,
-or start novelWriter from command line.
+or start novelWriter from the command line.
 
 Spell checking in novelWriter is provided by a third party library called Enchant_. Generally, it
 should pull dictionaries from your operating system automatically. However, on Windows they must be
@@ -36,7 +36,14 @@ Installer (setup.exe) file from the `main website`_, or from the Releases_ page
 Installing it should be straightforward.
 
 If you have any issues, try uninstalling the previous version and making a fresh install. If you
-already had a version installed via a different method, you should uninstall that first.
+already had a version installed via a different method, you should uninstall that first as having
+multiple installations has been known to cause problems.
+
+.. note::
+   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.
 
 
 .. _a_started_linux:
@@ -68,7 +75,7 @@ Debian and Mint
 ---------------
 
 Since this is a pure Python package, the Launchpad PPA can in principle also be used on Debian or
-Mint. However, the above command will fail to add the signing key.
+Mint. However, the above command will fail to add the signing key, as it is Ubuntu-specific.
 
 Instead, run the following commands to add the repository and key:
 
@@ -85,12 +92,10 @@ Then run the update and install commands as for Ubuntu:
    sudo apt install novelwriter
 
 .. note::
-
    You may need to use the Ubuntu 20.04 (focal) packages for Debian 11 or earlier. The newer Ubuntu
    packages use a different compression algorithm that may not be supported.
 
 .. tip::
-
    If you get an error message like ``gpg: failed to create temporary file`` when importing the key
    from the Ubuntu keyserver, try creating the folder it fails on, and import the key again:
 
@@ -106,6 +111,11 @@ For other Linux distros than the ones mentioned above, the primary option is App
 completely standalone images for the app that include the necessary environment to run novelWriter.
 They can of course be run on any Linux distro, if you prefer this to native packages.
 
+.. note::
+   novelWriter generally don't support Python versions that have reached end of life. If your Linux
+   distro still uses older Python versions and novelWriter won't run, you may want to try the
+   AppImage instead.
+
 
 .. _a_started_macos:
 
@@ -127,6 +137,11 @@ it should be straightforward.
 The context menu can also be accessed by option-clicking if you have a one button mouse. This is
 done by holding down the option key on your keyboard and clicking on the application in Finder.
 
+.. note::
+   The novelWriter DMG is not signed because Apple 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.
+
 
 .. _a_started_pip:
 
@@ -137,8 +152,9 @@ novelWriter is also available on the Python Package Index, or PyPi_. This instal
 all supported operating systems.
 
 To install from PyPi you must first have the ``python`` and ``pip`` commands available on your
-system. If you are on Windows, and don't have Python installed, see :ref:`a_started_win_py` for
-help.
+system. You can download Python from `python.org`_. It is recommended that you install the latest
+version. If you are on Windows, also make sure to select the "Add Python to PATH" option during
+installation.
 
 To install novelWriter from PyPi, use the following command:
 
@@ -159,38 +175,4 @@ When installing via pip, novelWriter can be launched from command line with:
    novelwriter
 
 Make sure the install location for pip is in your PATH variable. This is not always the case by
-default.
-
-.. note::
-
-   On systems with both Python 2 and 3, you may have to replace the ``pip`` command with ``pip3``.
-
-
-.. _a_started_win_py:
-
-Installing Python on Windows
-----------------------------
-
-In order to run novelWriter from source, or install from PyPi, you need to have Python set up on
-your system. Unlike Linux and MacOS, Windows does not come with Python pre-installed.
-
-You can download Python from `python.org`_. Python 3.7 or higher is required for running
-novelWriter, but it is recommended that you install the latest version.
-
-Make sure you select the "Add Python to PATH" option during installation, otherwise the ``python``
-command will not work in the command line window.
-
-.. figure:: images/python_win_install.png
-   :align: center
-   :width: 500
-
-   Screenshot of the Python installer on Windows.
-
-When Python is installed, you should be able to run Python commands from the COmmand Prompt or
-from PowerShell. You can verify this by running:
-
-.. code-block:: bash
-
-   python --version
-
-This should print out the version number of the Python installation.
+default, and then you may get a "Not Found" error when running the ``novelwriter`` command.

docs/source/project_export.rst

@@ -1,159 +0,0 @@
-.. _a_export:
-
-***********************
-Building the Manuscript
-***********************
-
-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:`Build Novel Project` tool.
-You can activate it from the sidebar, the :guilabel:`Tools` menu, or by pressing :kbd:`F5`.
-
-.. note::
-   This tool is scheduled to receive a full update in novelWriter 2.1, adding many new features
-   requested by users. See the `2.1 Milestone <https://github.com/vkbo/novelWriter/milestone/43>`_
-   for an overview.
-
-
-.. _a_export_headers:
-
-Header Formatting
-=================
-
-The titles for the five types of headings (the chapter headings come in a numbered and unnumbered
-version) of story structure can be formatted collectively in the build tool. This is done through
-a series of keyword–replace steps. They are all on the format ``%keyword%``.
-
-``%title%``
-   This keyword will always be replaced with the title text you put after the ``#`` characters in
-   your document.
-
-``%ch%``
-   This will be replaced by a chapter number. The number is incremented by one each time the build
-   tool sees a new heading of level two in a document, unless the heading formatting code has the
-   added ``!``. In the latter case, the counter is *not* incremented. This is useful for for
-   instance Prologue and Epilogue chapters.
-
-``%chw%``
-   Behaves like ``%ch%``, but the number is represented as a number word. You can select between a
-   number of different languages.
-
-``%chi%``
-   Begaves like ``%ch%``, but represented as a lower case Roman number from 1 to 4999.
-
-``%chI%``
-   Behaves like ``%ch%``, but represented as an upper case Roman number from 1 to 4999.
-
-``%sc%``
-   This is the number counter equivalent for scenes. These are incremented each time a heading of
-   level three is encountered, but reset to 1 each time a chapter is encountered. They can thus be
-   used for counting scenes within a chapter.
-
-``%sca%``
-   Behaves like ``%sc%``, but the number is *not* reset to 1 for each chapter. Instead it runs from
-   1 from the beginning of the novel to produce an absolute scene count.
-
-``\\``
-   This inserts a line break within the title.
-
-.. note::
-   Header formatting only applies to novel documents. Headings in notes will be left as-is.
-
-**Example**
-
-* The format ``%title%`` just reproduces the title you set in the document.
-* The format ``Chapter %ch%: %title%`` produces something like "Chapter 1: My Chapter Title".
-* The format ``Scene %ch%.%sc%`` produces something like "Scene 1.2" for scene 2 in chapter 1.
-
-
-.. _a_export_scenes:
-
-Scene Separators
-================
-
-If you don't want any titles for your scenes (or for your sections if you have them), you can leave
-the formatting boxes empty. If so, an empty paragraph will be inserted between the scenes or
-sections instead, resulting in a gap in the text.
-
-Alternatively, if you want a separator between them, like the common ``* * *``, you can enter the
-desired separator text in the formatting box. In fact, if the format is a piece of static text, it
-will always be treated as a separator.
-
-
-.. _a_export_files:
-
-File Selection
-==============
-
-Which documents and notes are selected for the build can be controlled from the options on the left
-side of the dialog window. In addition, you can select to include the synopsis comments, regular
-comments, keywords, and even exclude the body text itself if you just want an outline.
-
-.. tip::
-   If you for instance want to export a document with an outline of the novel, you can enable
-   keywords and synopsis export and disable body text, thus getting a document with each heading
-   followed by the tags and references and the synopsis.
-
-If you need to exclude specific documents from your exports, like draft documents or documents you
-want to take out of your manuscript, but don't want to delete, you can set the documents as
-"inactive" in the project tree. :guilabel:`Build Novel Project` tool has a switch to collectively
-exclude inactive documents.
-
-
-.. _a_export_print:
-
-Printing
-========
-
-The print button allows you to print the content in the preview window. You can either print to one
-of your system's printers, or print directly to a file as PDF. You can also print to file from the
-regular print dialog. The direct to file option is just a shortcut.
-
-.. note::
-   The paper format should in all cases default to whatever your system default is. Of you want to
-   change it, you have to select it from the :guilabel:`Print Preview`` dialog.
-
-
-.. _a_export_formats:
-
-Export Formats
-==============
-
-Currently, six formats are supported.
-
-Open Document Format
-   The Build tool can produce either an ``.odt`` file, or an ``.fodt`` file. The latter is just a
-   flat version of the document format as a single XML file. Most rich text editors support the
-   former, and a few the latter.
-
-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
-   word processors, or for printing from browser.
-
-novelWriter Markdown
-   This is simply a concatenation of the project documents selected by the filters. The documents
-   are stacked together in the order they appear in the project tree, with comments, tags, etc.
-   included if they are selected. This is a useful format for exporting the project for later
-   import back into novelWriter.
-
-Standard/GitHub Markdown
-   The Markdown format comes in both Standard and GitHub flavour. The *only* difference in terms of
-   novelWriter functionality is the support for strikethrough text, which is not supported by the
-   Standard flavour, but *is* supported by the GitHub flavour.
-
-
-.. _a_export_options:
-
-Additional Formats
-==================
-
-In addition to the above document formats, the novelWriter HTML and Markdown formats can also be
-wrapped in a JSON file. These files will have a meta data entry and a body entry. For HTML, also
-the accompanying css styles are included.
-
-The text body is saved in a two-level list. The outer list contains one entry per document, in the
-order they appear in the project tree. Each document is then split up into a list as well, with one
-entry per paragraph it contains.
-
-These files are mainly intended for scripted post-processing for those who want that option. A JSON
-file can be imported directly into a Python dict object or a PHP array, to mentions a few options.

docs/source/project_manuscript.rst

@@ -0,0 +1,185 @@
+.. _a_manuscript:
+
+***********************
+Building the Manuscript
+***********************
+
+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`.
+
+.. versionadded:: 2.1
+   This tool is new for version 2.1. A simpler tool was used for earlier versions. The simpler tool
+   only allows you to define a single set of options for the build, but otherwise has much the same
+   functionality.
+
+
+.. _a_manuscript_main:
+
+The Manuscript Build Tool
+=========================
+
+.. figure:: images/fig_manuscript_build.png
+
+   The :guilabel:`Manuscript Build` tool main window.
+
+The main window of the :guilabel:`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.
+
+
+.. _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.
+
+.. 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.
+
+
+Document Selection
+------------------
+
+.. figure:: images/fig_build_settings_selections.png
+
+   The :guilabel:`Selections` page of the :guilabel:`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.
+
+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
+used to reset the override and return control to the filter settings.
+
+In the figure, the green arrow icon and the blue pin icon indicates which documents are included,
+and the red forbidden icon indicates that a document is explicitly excluded.
+
+
+Formatting Headings
+-------------------
+
+.. figure:: images/fig_build_settings_headings.png
+
+   The :guilabel:`Headings` page of the :guilabel:`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 like shown int he 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
+generated by the build tool. The :guilabel:`Insert` button is a dropdown list of these formats, and
+selecting one will insert it at the position of the cursor.
+
+Any text you add that isn't highlighted in colours will remain in your formatted titles.
+``{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.
+
+Scene Separators
+^^^^^^^^^^^^^^^^
+
+If you don't want any titles for your scenes (or for your sections if you have them), you can leave
+the formatting boxes empty. If so, an empty paragraph will be inserted between the scenes or
+sections instead, resulting in a gap in the text. You can also switch on the :guilabel:`Hide`
+setting, which will ignore them completely. That is, there won't even be an extra gap inserted.
+
+Alternatively, if you want a separator text between them, like the common ``* * *``, you can enter
+the desired separator text as the format. If the format is any piece of static text, it will always
+be treated as a separator.
+
+
+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.
+
+
+.. _a_manuscript_build:
+
+Building Manuscript Documents
+=============================
+
+.. figure:: images/fig_build_build.png
+
+   The :guilabel:`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.
+
+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
+an output path, and set a base file name as well. The file extension will be added automatically.
+
+To generate the manuscript document, press the :guilabel:`Build` button. A small progress bar will
+show the build progress, but for small projects it may pass very fast.
+
+
+File Formats
+------------
+
+Currently, four document formats are supported.
+
+Open Document Format
+   The Build tool can produce either an ``.odt`` file, or an ``.fodt`` file. The latter is just a
+   flat version of the document format as a single XML file. Most rich text editors support the
+   former, and only a few the latter.
+
+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
+   word processors, or for printing from browser.
+
+novelWriter Markup
+   This is simply a concatenation of the project documents selected by the filters into a ``.txt``
+   file. The documents are stacked together in the order they appear in the project tree, with
+   comments, tags, etc. included if they are selected. This is a useful format for exporting the
+   project for later import back into novelWriter.
+
+Standard/Extended Markdown
+   The Markdown format comes in both Standard and Extended flavour. The *only* difference in terms
+   of novelWriter functionality is the support for strikethrough text, which is not supported by
+   the Standard flavour.
+
+
+Additional Formats
+------------------
+
+In addition to the above document formats, the novelWriter HTML and Markup formats can also be
+wrapped in a JSON file. These files will have a meta data entry and a body entry. For HTML, also
+the accompanying CSS styles used by the preview are included.
+
+The text body is saved in a two-level list. The outer list contains one entry per document, in the
+order they appear in the project tree. Each document is then split up into a list as well, with one
+entry per paragraph it contains.
+
+These files are mainly intended for scripted post-processing for those who want that option. A JSON
+file can be imported directly into a Python dict object or a PHP array, to mentions a few options.
+
+
+.. _a_manuscript_print:
+
+Print and PDF
+=============
+
+The :guilabel:`Print` button allows you to print the content in the preview window. You can either
+print to one of your system's printers, or select PDF as your output format from the printer icon
+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.

docs/source/project_notes.rst

@@ -1,72 +0,0 @@
-.. _a_notes:
-
-*************
-Project Notes
-*************
-
-novelWriter doesn't have a database and complicated forms for filling in details about plot
-elements, characters, and all sorts of additional information that isn't a part of the novel text
-itself. Instead, all such information is saved in notes that are written and maintained just like
-all other text in your project.
-
-The relation between all these additional elements is extracted from the documents and notes by the
-project indexer, based on the tags and references you set within them.
-
-Using notes is not required, but making at least minimal notes for each plot element, and adding a
-tag to them, makes it possible to use the Outline View to see how each element intersects with each
-section of the novel itself, and adds clickable cross-references between documents in the editor
-and viewer.
-
-
-.. _a_notes_tags:
-
-Tags in Notes
-=============
-
-Each new heading in a note can have a tag associated with it. The format of a tag is
-``@tag: tagname``, where tagname is a unique identifier of your choosing. Tags can then be
-referenced in the novel documents, or cross-referenced in other notes, and will show up in the
-Outline View and in the back-reference panel when a document is opened in the viewer. See
-:ref:`a_struct_tags` for how to reference notes.
-
-The syntax highlighter will alert the user that the keyword is correctly used and that the tag is
-allowed, that is, the tag is unique. Duplicate tags should be detected as long as the index is up
-to date. An invalid tag should have a green wiggly line under it, and will not receive the syntax
-colour that valid tags do.
-
-The tag is the only part of these notes that the application uses. The rest of the document content
-is there for the writer to use in whatever way they 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:`Build Novel Project` tool.
-
-One note can also reference another note in the same way novel documents do. When the note is
-opened in the view panel, the references become clickable links, making it easier to follow
-connections in the plot. Notes don't show up in the Outline View though, 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:`Build Novel Project` tool, the cross-references become clickable links in the
-   exported HTML document.
-
-Example of a project note with two headers, with separate tags, and with references to other notes:
-
-.. code-block:: none
-   :linenos:
-
-   # Main Characters
-
-   ## Jane Doe
-
-   @tag: Jane
-   @location: Earth
-
-   Something about Jane ...
-
-   ## John Doh
-
-   @tag: John
-   @location: Mars
-
-   Something about John ...

docs/source/project_overview.rst

@@ -9,7 +9,7 @@ This will open the :guilabel:`New Project Wizard` that will assist you in creati
 project suited to your needs.
 
 A novelWriter project requires a dedicated folder for storing its files on the local file system.
-See :ref:`a_storage` for further details on how files are organised.
+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:`Open Project`
 dialog. A project can be removed from this list by selecting it and pressing the :kbd:`Del` key or
@@ -29,92 +29,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 novel documents go into a root folder of type :guilabel:`Novel`. 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 :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.
 
 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 reference 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
+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
 application on what you put in them. You can use them however you want.
 
-.. tip::
-   You can make multiple root folders of each kind if you wish to split up your notes.
-
-.. note::
-   It is not the notes themselves that are referenced by the listed reference keywords, but tags
-   set within the notes. See the examples below and in :ref:`a_struct_tags`.
+The root folder system is closesly connected to how the Tags and References system works. For more
+details, see the :ref:`a_references` chapter.
 
 :guilabel:`Novel`
-   This is the root folder of all text that goes into the final novel or novels. This class of
+   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`
-   This is the root folder 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 Outline View. Tags in this
-   folder can be references using the ``@plot`` keyword.
+   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.
 
 :guilabel:`Characters`
-   Character notes go in this root folder. These are especially important if you want to use the
-   Outline View to see which character appears where, and which part of the story is told from a
-   specific character's point-of-view, or focusing on a particular character's storyline. Tags in
-   this 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 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. 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`
-   The locations folder is for various scene locations that you want to track. Tags in this folder
-   can be references using the ``@location`` keyword.
+   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`
-   If the story has multiple plot timelines or jumps in time within the same plot, this class of
-   notes can be used to track this. Tags in this folder can be references using the ``@time``
+   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 important objects that change hands often, can be
-   tracked here. Tags in this folder can be references using the ``@object`` keyword.
+   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.
 
 :guilabel:`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 folder can be references using the
+   the plot? They can be organised here. Tags in this type of folder can be references using the
    ``@entity`` keyword.
 
 :guilabel:`Custom`
-   The custom root folder can be used for tracking anything else not covered by the above options.
-   Tags in this folder can be references using the ``@custom`` keyword.
+   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_struct_tags`.
+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
-   keyword.
+   keyword or what they do.
 
-Example of a character note:
-
-.. code-block:: none
-   :linenos:
-
-   # Jane Doe
-
-   @tag: Jane
-
-   Some information about the character Jane Doe.
-
-Example of a novel scene referencing the above character:
-
-.. code-block:: none
-   :linenos:
-
-   ### Chapter 1, Scene 1
-
-   @pov: Jane
-
-   When Jane woke up that morning ...
+.. versionadded:: 2.0
+   As of version 2.0, you can make multiple root folders of each kind to split up your project.
 
 
 .. _a_proj_roots_del:
@@ -124,11 +102,11 @@ 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 project index and cannot be
+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 deleted from the :guilabel:`Project` menu, or by pressing
-:kbd:`Ctrl`:kbd:`Shift`:kbd:`Del`. Root folders can only be deleted when they are empty.
+:kbd:`Ctrl+Shift+Del`. Root folders can only be deleted when they are empty.
 
 
 .. _a_proj_roots_out:
@@ -137,15 +115,15 @@ Archived Documents
 ------------------
 
 If you don't want to delete a document, or put it in the :guilabel:`Trash` folder where it may be
-deleted, but still want it out of your main project tree, you can create an :guilabel:`Archive`
-root folder.
+deleted accidentally, but still want it out of your main project tree, you can create an
+:guilabel:`Archive` root folder and move it there.
 
 You can drag any document to this folder and preserve its settings. The document will always be
-excluded from the :guilabel:`Build Novel Project` builds. It is also removed from the project
-index, so the tags and references defined in it will not show up anywhere else.
+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.
 
 
-.. _a_proj_roots_orph:
+.. _a_proj_roots_orphaned:
 
 Recovered Documents
 -------------------
@@ -153,19 +131,19 @@ Recovered Documents
 If novelWriter crashes or otherwise exits without saving the project state, or if you're using a
 file synchronisation tool that runs out of sync, there may be files in the project folder that
 aren't tracked in the core project file. These files, when discovered, are recovered and added back
-into the project if possible.
+into the project.
 
-The discovered files are scanned for meta information that give clues as to where the document may
-previously have been located in the project. The project loading routines will try to put them back
+The discovered files are scanned for metadata that give clues as to where the document may
+previously have been located in the project. The project loading routine will try to put them back
 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. If it cannot figure out which root folder is correct, the document
-will be added to the :guilabel:`Novel` root folder. Only if the :guilabel:`Novel` folder is
-missing will it give up.
+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.
 
-If the title of the document can be recovered, the word "Recovered:" will be added as a prefix. If
-the title cannot be determined, the document will be named "Recovered File N" where N is a
-sequential number.
+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
+be named after its internal key, which is a string of characters and numbers.
 
 
 .. _a_proj_roots_lock:
@@ -173,11 +151,11 @@ sequential number.
 Project Lockfile
 ----------------
 
-To prevent lost documents caused by file conflicts when novelWriter projects are synced with file
-synchronisation tools, a project lockfile is written to the project 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 give the option to ignore
-this warning, and continue opening the project at your own risk.
+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 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.
 
 .. note::
    If, for some reason, novelWriter crashes, the lock file may remain even if there are no other
@@ -198,18 +176,18 @@ 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 the novel, like for instance during export, these folders are
-ignored. Only the order of the documents themselves matter.
+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 the user 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
+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.
 
-.. tip::
-   You can 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.
+.. 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:
@@ -217,15 +195,17 @@ documents.
 Project Documents
 =================
 
-New documents can be created from the tool bar in the Project Tree, or by pressing
-:kbd:`Ctrl`:kbd:`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`.
+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.
+
+You can always rename an item by selecting :guilabel:`Rename Item` from the :guilabel:`Project`
+menu, or by pressing :kbd:`F2`.
 
 Other settings for project items are available from the context menu that you can activate by
-right-clicking on an item in the Project Tree. The :guilabel:`Transform` submenu includes options
-for converting, splitting, or merging items.
+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.
 
 
 .. _a_proj_files_counts:
@@ -234,17 +214,18 @@ Word Counts
 -----------
 
 A character, word and paragraph count is maintained for each document, as well as for each section
-of a document following a header. 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 project tree for any document selected in the project or novel tree.
+of a document following a :term:`heading<headings>`. 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.
 
 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.
 
 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 index. If the counts seem
-wrong, a full project word recount can be initiated by rebuilding the project's index. Either form
-the :guilabel:`Tools` menu, or by pressing :kbd:`F9`.
+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`.
 
 
 .. _a_proj_settings:
@@ -253,7 +234,7 @@ Project Settings
 ================
 
 The :guilabel:`Project Settings` can be accessed from the :guilabel:`Project` menu, or by pressing
-:kbd:`Ctrl`:kbd:`Shift`:kbd:`,`. This will open a dialog box, with a set of tabs.
+:kbd:`Ctrl+Shift+,`. This will open a dialog box, with a set of tabs.
 
 
 Settings Tab
@@ -263,26 +244,26 @@ The :guilabel:`Settings` tab holds the project name, title, and author settings.
 
 The :guilabel:`Project Name` can be set to a different value than the :guilabel:`Novel Title`. The
 difference between them is simply that the :guilabel:`Project Name` is used for the GUI (main
-window title) and for generating the backup files. The intention is that the
-:guilabel:`Project Name` should remain unchanged throughout the project's lifetime, otherwise the
-name of exported files and backup files may change too.
+window title) and for generating backup files. The intention is that the :guilabel:`Project Name`
+should remain unchanged throughout the project's lifetime, otherwise the name of exported files and
+backup files may change too.
 
 The :guilabel:`Novel Title` and :guilabel:`Authors` settings are used when building the manuscript,
 for some formats.
 
-If your project is in a different language than your main spell checking is set to, you can
-override the default spell checking language here. You can also override the automatic backup
-setting.
+If your project is in a different language than your main spell checking language is set to, you
+can override the default setting here. You can also override the automatic backup setting. The
+project language can also be changed from the :guilabel:`Tools` menu.
 
 
 Status and Importance Tabs
 --------------------------
 
-Each document or folder of type :guilabel:`Novel` can be given a *Status*_* label accompanied by a
+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.
 
-These are purely there for the user's convenience, and you are not required to use them for any
+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
 use these to indicate at what stage of completion each novel document is, or how important the
 content of a note is to the story. You don't have to use them this way, that's just what they were
@@ -302,7 +283,7 @@ A set of automatically replaced keywords can be added in this tab. The keywords
 will be replaced by the text in the right column when documents are opened in the viewer. They will
 also be applied to manuscript builds.
 
-The auto-replace feature will replace text in angle brackets that are in this list. The syntax
+The auto-replace feature will replace text in angle brackets that is in this list. The syntax
 highlighter will add an alternate colour to text matching the syntax, but it doesn't check if the
 text is in this list.
 
@@ -332,7 +313,7 @@ It is also possible to disable automated backups for a given project in
 
 .. 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 folder name for the zip files.
+   :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.
 
 
@@ -343,19 +324,19 @@ Writing Statistics
 
 When you work on a project, a log file records when you opened it, when you closed it, and the
 total word counts of your novel documents and notes at the end of the session, provided that the
-session lasted either more than 5 minutes, or that the total word count changed. You can view this
-file in the ``meta`` folder in the directory where you saved your project. The file is named
-``sessionStats.log``.
+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 this file is available in the :guilabel:`Tools` menu under
+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.
+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
-application like for instance Libre Office Calc.
+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`.
+.. versionadded:: 1.2
+   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`.

docs/source/project_references.rst

@@ -0,0 +1,178 @@
+.. _a_references:
+
+*******************
+Tags and References
+*******************
+
+In novelWriter there are no forms or tables to fill in to define the characters, locations and
+other elements of your story. Instead, you can mark your :term:`project notes` as representing
+these story elements by creating a :term:`tag`. Whenever you want to link a piece of your story to
+a note defining a story element, like a character, you create a :term:`reference` back to that tag.
+You can also cross-link your project notes in the same way.
+
+This is perhaps one of the features that makes novelWriter different from other, similar
+applications. It is therefore not always obvious to new users how this is supposed to work, so
+this chapter hopes to explains in more detail how to use the tags and references system.
+
+.. tip::
+   If you find the Tags and Reference system difficult to follow just from reading this chapter,
+   you can create a new project in novelWriter and select to "Fill the project with example files"
+   in the :guilabel:`New Project Wizard`. The example project contains several examples of tags and
+   references.
+
+
+.. _a_references_metadata:
+
+Metadata in novelWriter
+=======================
+
+The structure of your novelWriter project is inferred from the :term:`headings` within the
+documents, not the documents themselves. See :ref:`a_struct_heads` for more details. Therefore,
+metadata is also associated with headings, and not documents.
+
+If you split your project into separate documents for each scene, this distinction may not matter.
+However, there are several benefits to using documents at a larger structural scale when starting
+your project. For instance, it may make more sense to define all your scenes, and even chapters, in
+a single document at first, or perhaps a document per act. You can later split these documents up
+using the document split feature. See :ref:`a_ui_tree_split_merge` for more details.
+
+The implication here is that you can treat each heading as an independent element of your notes
+that can be referenced somewhere else. In order to make it possible to reference a header section,
+you need to assign it a tag.
+
+
+.. _a_references_tags:
+
+How to Use Tags
+===============
+
+A "tag" in novelWriter is a word or phrase that you define as belonging to a heading. Tags are set
+by using the ``@tags`` :term:`keyword`. The full format of a tag is ``@tag: tagname``, where
+``tagname`` is an identifier of your choosing. You can only set *one* tag per heading, and the tag
+has to be unique across all documents in the project.
+
+.. note::
+   In version 2.2, tags will be made case insensitive, but as of novelWriter 2.1 they are not. You
+   should however avoid using tags that are only distinguished by case.
+
+After the tags have been defined, they can then be referenced in the novel documents, or
+cross-referenced in other notes. they will also show up in the :guilabel:`Outline View` and in the
+back-reference panel when a document is opened in the viewer.
+
+The syntax highlighter will indicate to you that the keyword is correctly used and that the tag is
+allowed, that is, the tag is unique. Duplicate tags should be detected as long as the index is up
+to date. An invalid tag should have a green wiggly line under it, and will not receive the syntax
+colour that valid tags do.
+
+The tag is the only part of these notes that the novelWriter uses. The rest of the document content
+is there for the writer to use in whatever way they 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.
+
+Example of a heading with a tag for a character of the story:
+
+.. code-block:: none
+
+   # Jane Doe
+
+   @tag: Jane
+
+   Some information about the character Jane Doe.
+
+When this is done in a document in a :term:`Root Folder` of type "Characters", the tag is
+automatically treated as an available character in your project, and you will be able to reference
+it in any of your other documents using the reference keywords for characters.
+
+It is the root folder type that defines what category of story elements the tag is indexed under.
+See the :ref:`a_proj_roots` section for an overview of availabe root folder types. They are also
+covered in the next section.
+
+
+.. _a_references_references:
+
+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 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
+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.
+
+``@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.
+
+``@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.
+
+``@plot``
+   The plot or subplot advanced in the current section. The target must be a note tag in a
+   :guilabel:`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.
+
+``@location``
+   The location the current section takes place in. The target must be a note tag in a
+   :guilabel:`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.
+
+``@entity``
+   Entities present in the current section. The target must be a note tag in a
+   :guilabel:`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.
+
+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.
+
+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
+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.
+
+Example of a novel document with references to characters and plots:
+
+.. code-block:: none
+
+   ## Chapter 1
+
+   @pov: Jane
+
+   ### Scene 1
+
+   @char: John, Sam
+   @plot: Main
+
+   Once upon a time ...

docs/source/project_structure.rst

@@ -4,10 +4,15 @@
 Novel Structure
 ***************
 
-This section covers the structure of a novel project.
+This chapter covers the structure of a novel project.
 
-It concerns documents under the :guilabel:`Novel` type root folder only. There are some
-restrictions and features that only apply to these types of documents.
+There are two different types of documents in a project, :guilabel:`Novel Documents` and
+:guilabel:`Project Notes`. 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.
+
+The :guilabel:`Project Tree` can distinguish between the different header levels of the novel
+documents using coloured icons, and optionally add emphasis on the label, set in
+:guilabel:`Preferences`.
 
 
 .. _a_struct_heads:
@@ -16,15 +21,16 @@ Importance of Headings
 ======================
 
 Subfolders under root folders have no impact on the structure of the novel itself. The structure is
-instead dictated by the heading level of the headers within the documents.
+instead dictated by the heading level of the headings within the documents.
 
 Four levels of headings are supported, signified by the number of hashes (``#``) preceding the
-title. See also the :ref:`a_fmt` section for more details about the markdown syntax.
+title. See also the :ref:`a_fmt` section for more details about the markup syntax.
 
 .. note::
    The header levels are not only important when generating the manuscript, they are also used by
-   the indexer when building the outline tree in the Outline as well as the Novel Tree. Each
-   heading also starts a new region where new references and tags can be defined.
+   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 syntax for the four basic header types, and the two special header types, is listed in section
 :ref:`a_fmt_head`. The meaning of the four levels for the structure of your novel is as follows:
@@ -32,7 +38,7 @@ The syntax for the four basic header types, and the two special header types, is
 **Header Level 1: Partition**
    This header level signifies that the text refers to a top level partition. This is useful when
    you want to split the manuscript up into books, parts, or acts. These headings are not required.
-   The novel title itself should use the special header level explained in :ref:`a_fmt_head`.
+   The novel title itself should use the special header level ``#!`` covered in :ref:`a_fmt_head`.
 
 **Header Level 2: Chapter**
    This header level signifies a chapter level partition. Each time you want to start a new
@@ -49,18 +55,19 @@ The syntax for the four basic header types, and the two special header types, is
 
 **Header Level 4: Section**
    This header level signifies a sub-scene level partition, usually called a "section" in the
-   documentation and the user interface. These can be useful if you want to change tag references
+   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.
 
 Page breaks are automatically added before level 1 and 2 headers when you build your project to a
-format that supports page breaks, or when you print the document directly from the build tool. If
-you want page breaks in other places, you have to specify them manually. See :ref:`a_fmt_break`.
+format that supports page breaks, or when you print the document directly from the
+:guilabel:`Manuscript Build` tool. If you want page breaks in other places, you have to specify
+them manually. See :ref:`a_fmt_break`.
 
 .. tip::
    There are multiple options of how to process novel titles when building the manuscript. For
    instance, chapter numbers can be applied automatically, and so can scene numbers if you want
-   them in a draft manuscript. See the :ref:`a_export` page for more details.
+   them in a draft manuscript. See the :ref:`a_manuscript` page for more details.
 
 
 .. _a_struct_heads_title:
@@ -89,13 +96,13 @@ 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 cam add a ``!`` to the level 2 header formatting code to tell the
+chapters separate from this, you cam add an ``!`` to the level 2 header formatting code to tell the
 build tool to skip these chapters.
 
 ``##! Unnumbered Chapter Title``
 
-There is a separate formatting feature for such chapters in the :guilabel:`Build Novel Project`
-tool as well. See the :ref:`a_export` page for more details. When building a document of a format
+There is a separate formatting feature for such chapters 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.
 
@@ -104,105 +111,3 @@ normal chapters.
    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_tags:
-
-Note References
-===============
-
-Each text partition, indicated by a heading of any level, can contain references to tags set in the
-project notes of the project. The references are gathered by the indexer and used to generate the
-Outline View. This section covers how to make references to tags. See :ref:`a_notes_tags` for how
-to define tags the references can point to.
-
-References and tags are also clickable in the document editor and viewer, making it easy to
-navigate between reference notes while writing. Clicked links are always opened in the view panel.
-
-References are set as a 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 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.
-
-``@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.
-
-``@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.
-
-``@plot``
-   The plot or subplot advanced in the current section. The target must be a note tag in a
-   :guilabel:`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.
-
-``@location``
-   The location the current section takes place in. The target must be a note tag in a
-   :guilabel:`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.
-
-``@entity``
-   Entities present in the current section. The target must be a note tag in a
-   :guilabel:`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.
-
-The syntax highlighter will alert the user that the tags and references are used correctly, and
-that the tags referenced exist.
-
-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.
-
-Example of a novel document with references to characters and plots:
-
-.. code-block:: none
-   :linenos:
-
-   ## Chapter 1
-
-   @pov: Jane
-
-   ### Scene 1
-
-   @char: John, Sam
-   @plot: Main
-
-   Once upon a time ...
-
-
-.. _a_struct_layout:
-
-Document Layout
-===============
-
-All documents in the project can have a layout format set. Previously, there were multiple layouts
-available to change how the documents where formatted on export. These have now been reduced to
-just two layouts: :guilabel:`Novel Document` and :guilabel:`Project Note`.
-
-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. Project notes can be added anywhere in the
-project.
-
-The project tree can distinguish between the different layouts and header levels of the documents
-using coloured icons, and optionally add emphasis on the label (See the :guilabel:`Preferences`.)
-For novel documents, the heading level of the first heading is recorded, and indicated by the icon.
-
-.. tip::
-   You can always start writing with a coarse setup with one or a few documents, and then later use
-   the split tool to split the documents into separate chapter and scene documents. You can split a
-   document on any of the four header levels.

docs/source/requirements.txt

@@ -1,5 +1,6 @@
 sphinx-book-theme
 sphinx>=5.0
 sphinx-favicon
+sphinx-design
 pygments>=2.7
 docutils>=0.17.1

docs/source/tech_locations.rst

@@ -7,7 +7,7 @@ File Locations
 .. _QStandardPaths: https://doc.qt.io/qt-5/qstandardpaths.html
 
 novelWriter will create a few files on your system outside of the application folder itself. These
-file locations are described in this document.
+file locations are described in this chapter.
 
 
 .. _a_locations_conf:
@@ -17,15 +17,16 @@ 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.
+system. The system paths are provided by the Qt QStandardPaths_ class and its ``ConfigLocation``
+value.
 
 The standard paths are:
 
 * Linux: ``~/.config/novelwriter/novelwriter.conf``
-* macOS: ``~/Library/Preferences/novelwriter/novelwriter.conf``
+* MacOS: ``~/Library/Preferences/novelwriter/novelwriter.conf``
 * Windows: ``C:\Users\<USER>\AppData\Local\novelwriter\novelwriter.conf``
-   
-Here, ``~`` corresponds to the user's home directory on Linux and macOS, and ``<USER>`` is the
+
+Here, ``~`` corresponds to the user's home directory on Linux and MacOS, and ``<USER>`` is the
 user's username on Windows.
 
 .. note::
@@ -40,15 +41,16 @@ 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.
+saved here. The system paths are provided by the Qt QStandardPaths_ class and its
+``AppDataLocation`` value.
 
 The standard paths are:
 
 * Linux: ``~/.local/share/novelwriter/``
-* macOS: ``~/Library/Application Support/novelwriter/``
+* MacOS: ``~/Library/Application Support/novelwriter/``
 * Windows: ``C:\Users\<USER>\AppData\Roaming\novelwriter\``
-   
-Here, ``~`` corresponds to the user's home directory on Linux and macOS, and ``<USER>`` is the
+
+Here, ``~`` corresponds to the user's home directory on Linux and MacOS, and ``<USER>`` is the
 user's username on Windows.
 
 .. note::

docs/source/tech_source.rst

@@ -4,18 +4,25 @@
 Running from Source
 *******************
 
-.. _main website: https://novelwriter.io
 .. _GitHub: https://github.com/vkbo/novelWriter/releases
 .. _PyPi: https://pypi.org/project/novelWriter/
 .. _Sphinx Docs: https://www.sphinx-doc.org/
 
-This section describes various ways of running novelWriter directly from the source code, and how
+This chapter describes various ways of running novelWriter directly from the source code, and how
 to build the various components like the translation files and documentation.
 
 .. note::
    The text below assumes the command ``python`` corresponds to a Python 3 executable. Python 2 is
-   now deprecated, but many systems still have both Python 2 and 3. For such systems, the command
-   ``python3`` may be needed instead. Likewise, ``pip`` may need to be replaced with ``pip3``.
+   now deprecated, but on many systems the command ``python3`` may be needed instead. Likewise,
+   ``pip`` may need to be replaced with ``pip3``.
+
+Most of the custom commands for building packages of novelWriter, or building assets, are contained
+in the ``pkgutils.py`` script in the root of the source code. You can list the available commands
+by running:
+
+.. code-block:: bash
+
+   python pkgutils.py help
 
 
 .. _a_source_depend:
@@ -23,20 +30,17 @@ to build the various components like the translation files and documentation.
 Dependencies
 ============
 
-novelWriter has been designed to rely on as few dependencies as possible. Aside from the packages
-needed to communicate with the Qt GUI libraries, only one package is required for handling the XML
-format of the main project file. Everything else is handled with standard Python libraries.
+novelWriter has been designed to rely on as few dependencies as possible. Only the Python wrapper
+for the Qt GUI libraries is required. The package for spell checking is optional, but recommended.
+Everything else is handled with standard Python libraries.
 
-The following Python packages are needed to run novelWriter:
+The following Python packages are needed to run all features of novelWriter:
 
 * ``PyQt5`` – needed for connecting with the Qt5 libraries.
-* ``lxml`` – needed for full XML support.
 * ``PyEnchant`` – needed for spell checking (optional).
 
 PyQt/Qt should be at least 5.10, but ideally 5.13 or higher for all features to work. For instance,
-searching using regular expressions with full Unicode support requires 5.13. There is no known
-minimum version requirement for package ``lxml``, but the code was originally written with 4.2,
-which is therefore set as the minimum. It may work on lower versions. You have to test it.
+searching using regular expressions with full Unicode support requires 5.13.
 
 If you want spell checking, you must install the ``PyEnchant`` package. The spell check library
 must be at least 3.0 to work with Windows. On Linux, 2.0 also works fine.
@@ -49,7 +53,6 @@ source, dependencies can still be installed from PyPi with:
    pip install -r requirements.txt
 
 .. note::
-
    On Linux distros, the Qt library is usually split up into multiple packages. In some cases,
    secondary dependencies may not be installed automatically. For novelWriter, the library files
    for renderring the SVG icons may be left out and needs to be installed manually. This is the
@@ -58,37 +61,35 @@ source, dependencies can still be installed from PyPi with:
 
 .. _a_source_install:
 
-Install from Source
-===================
+Build and Install from Source
+=============================
 
-You can download the latest version of novelWriter from the source repository on GitHub_ and run
-the setup manually. It is equivalent to what the ``pip install`` command does, and it installs
-novelWriter to the default location for Python packages.
-
-This step requires that you have ``setuptools`` installed on your system. If you don't have it
-installed, it can usually be installed from your distro's repository. For Debian and Ubuntu this is
-achieved with:
+If you want to install novelWriter directly from the source available on GitHub_, you must first
+build the package using the Python Packaging Authority's build tool. It can be installed with:
 
 .. code-block:: bash
 
-   sudo apt install python3-setuptools
+   pip install build
 
-The package is also available from PyPi:
+On Debian-based systems the tool can also be installed with:
 
 .. code-block:: bash
 
-   pip install --user setuptools
+   sudo apt install python3-build
 
-With ``setuptools`` in place, novelWriter can be installed to the user space with:
+With the tool installed, run the following command from the root of the novelWriter source code:
 
 .. code-block:: bash
 
-   python setup.py install --user
+   python -m build --wheel
 
-.. tip::
+This should generate a ``.whl`` file in the ``dist/`` folder at your current location. The wheel
+file can then be installed on your system. Here with example version number 2.0.7, but yours may be
+different:
 
-   The main setup script has a number of options that may be useful to you. You can list them by
-   running ``python setup.py help``.
+.. code-block:: bash
+
+   pip install --user dist/novelWriter-2.0.7-py3-none-any.whl
 
 
 .. _a_source_i18n:
@@ -105,7 +106,7 @@ You can build the ``.qm`` files with:
 
 .. code-block:: bash
 
-   python setup.py qtlrelease
+   python pkgutils.py qtlrelease
 
 This requires that the Qt Linguist tool is installed on your system. On Ubuntu and Debian, the
 needed package is called ``qttools5-dev-tools``.
@@ -122,11 +123,12 @@ Building the Example Project
 ============================
 
 In order to be able to create new projects from example files, you need a ``sample.zip`` file in
-the ``assets`` folder of the source. This file can be built from setup script by running:
+the ``assets`` folder of the source. This file can be built from the ``pkgutils.py`` script by
+running:
 
 .. code-block:: bash
 
-   python setup.py sample
+   python pkgutils.py sample
 
 
 .. _a_source_docs:
@@ -134,12 +136,12 @@ the ``assets`` folder of the source. This file can be built from setup script by
 Building the Documentation
 ==========================
 
-A local copy of this documentation can be generated as HTML. This requires the following Python
+A local copy of this documentation can be generated as HTML. This requires installing some Python
 packages from PyPi:
 
 .. code-block:: bash
 
-   pip install furo sphinx
+   pip install -r docs/source/requirements.txt
 
 The documentation can then be built from the root folder in the source code by running:
 
@@ -150,11 +152,11 @@ The documentation can then be built from the root folder in the source code by r
 If successful, the documentation should be available in the ``docs/build/html`` folder and you can
 open the ``index.html`` file in your browser.
 
-You can also build a PDF manual from the documentation using the setup script:
+You can also build a PDF manual from the documentation using the ``pkgutils.py`` script:
 
 .. code-block:: bash
 
-   python setup.py manual
+   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

docs/source/tech_storage.rst

@@ -6,7 +6,7 @@ How Data is Stored
 
 .. _documentation: https://docs.novelwriter.io/
 
-This section contains details of how novelWriter stores and handles the project data.
+This chapter contains details of how novelWriter stores and handles the project data.
 
 
 Project Structure
@@ -23,20 +23,15 @@ Main Project File
 -----------------
 
 The project itself requires a dedicated folder for storing its files, where novelWriter will create
-its own "file system" where the folder and file hierarchy is described in a project XML file. This
-is the main project file in the project's root folder with the name ``nwProject.nwx``. This file
-also contains all the meta data required for the project, and a number of related project settings.
+its own "file system" where the project's folder and file hierarchy is described in a project XML
+file. This is the main project file in the project's root folder with the name ``nwProject.nwx``.
+This file also contains all the meta data required for the project (except the index data), and a
+number of related project settings.
 
 If this file is lost or corrupted, the structure of the project is lost, although not the text
 itself. It is important to keep this file backed up, either through the built-in backup tool, or
 your own backup solution.
 
-.. tip::
-   The novelWriter project folder is structured so that it can easily be added to a version control
-   system like git. If you do so, you may want to add a `.gitignore` file to exclude files with the
-   extensions `.json` as JSON files are used to cache the index and various run-time settings and
-   are generally large files that change often.
-
 The project XML file is indent-formatted, and is suitable for diff tools and version control since
 most of the file will stay static, although a timesetamp is set in the meta section on line 2, and
 various meta data entries incremented, on each save.
@@ -54,34 +49,35 @@ various meta data entries incremented, on each save.
 Project Documents
 =================
 
-All the project documents are saved in a folder in the main project folder named ``content``. Each
-document has a file handle based on a 52 bit random number, represented as a hexadecimal string.
-The documents are saved with a filename assembled from this handle and the file extension ``.nwd``.
+All the project documents are saved in a subfolder of the main project folder named ``content``.
+Each document has a file handle based on a 52 bit random number, represented as a hexadecimal
+string. The documents are saved with a filename assembled from this handle and the file extension
+``.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, 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.
+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
-what the user names the document within the project, or changes it to. This is particularly useful
-when using a versioning system.
+what you name the document within the project, or changes it to. This is particularly useful when
+using a versioning system.
 
 Each document file contains a plain text version of the text from the editor. The file can in
 principle be edited in any text editor, and is suitable for diffing and version control if so
 desired. Just make sure the file remains in utf-8 encoding, otherwise unicode characters may
 become mangled when the file is opened in novelWriter again.
 
-Editing these files is generally not recommended outside of special circumstances, whatever they
-may be. The reason for this is that the index will not be automatically updated when doing so,
-which means novelWriter doesn't know you've altered the file. If you do edit a file in this manner,
-you should rebuild the index when you next open the project in novelWriter.
+Editing these files is generally not recommended. The reason for this is that the index will not be
+automatically updated when doing so, which means novelWriter doesn't know you've altered the file.
+If you *do* edit a file in this manner, you should rebuild the index when you next open the project
+in novelWriter.
 
 The first lines of the file may contain some meta data starting with the characters ``%%~``. These
-lines are mainly there to restore some information if it is lost from the project file, and the
-information may be helpful if you do open the file in an external editor as it contains the
+lines are mainly there to restore some information if the file is lost from the main project file,
+and the information may be helpful if you do open the file in an external editor as it contains the
 document label and the document class and layout. The lines can be deleted without any consequences
 to the rest of the content of the file, and will be added back the next time the document is saved
 in novelWriter.
@@ -91,9 +87,9 @@ The File Saving Process
 -----------------------
 
 When saving the project file, or any of the documents, the data is first saved to a temporary file.
-If successful, the old data file is then removed, and the temporary file becomes the new file. This
-ensures that the previously saved data is only replaced when the new data has been successfully
-saved to the storage medium.
+If successful, the old data file is then removed, and the temporary file replaces it. This ensures
+that the previously saved data is only replaced when the new data has been successfully saved to
+the storage medium.
 
 For the project XML file, a ``.bak`` file is in addition kept, which will always contain the
 previous version of the file, although when auto-save is enabled, they may have the same content.
@@ -106,19 +102,19 @@ Project Meta Data
 
 The project folder contains a subfolder named ``meta``, containing a number of files. The meta
 folder contains semi-important files. That is, they can be lost with only minor impact to the
-project.
+project. All files in this folder are JSON or JSON Lines files, although some other files may
+remain from earlier versions of novelWriter as they haven't all been JSON files in the past.
 
 If you use version control software on your project, you can exclude this folder, although you may
-want to track the session log file and the custom words list. The JSON files within this folder can
-safely be ignored as they will be automatically regenerated if lost.
+want to track the session log file and the custom words list.
 
 
 The Project Index
 -----------------
 
-Between writing sessions, the project index is saved in a JSON file in ``meta/tagsIndex.json``.
-This file is not critical. If it is lost, it can be rebuilt from within novelWriter from the
-:guilabel:`Tools` menu.
+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 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
@@ -131,10 +127,17 @@ check somehow fails and novelWriter keeps crashing, you can delete the file manu
 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.
+
+
 Cached GUI Options
 ------------------
 
-A file named ``meta/guiOptions.json`` contains the latest state of various GUI buttons, switches,
+A file named ``meta/options.json`` contains the latest state of various GUI buttons, switches,
 dialog window sizes, column sizes, etc, from the GUI. These are the GUI settings that are specific
 to the project. Global GUI settings are stored in the main config file.
 
@@ -145,7 +148,7 @@ settings.
 Custom Word List
 ----------------
 
-A file named ``meta/wordlist.txt`` contains all the custom words you've added to the project for
+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.
 
@@ -153,18 +156,10 @@ you lose this file, all your custom spell check words will be lost too.
 Session Stats
 -------------
 
-The writing progress is saved in the ``meta/sessionStats.log`` file. This file records the length
+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.
 
-
-Project Cache
-=============
-
-The project ``cache`` folder contains non-critical files. If these files are lost, there is no
-impact on the functionality of novelWriter or the history of the project. It contains temporary
-files, like the preview document in the :guilabel:`Build Novel Project` tool.
-
-It should be excluded from version control tools if such are used. The folder will be removed
-entirely in novelWriter 2.1.
+Each session is recorded as a JSON object on a single line of the file. Each session record is
+appended tot he file.

docs/source/tech_tests.rst

@@ -15,7 +15,7 @@ The dependencies for running the tests can be installed with:
 
 .. code-block:: bash
 
-   pip install -r requirements-dev.txt
+   pip install -r tests/requirements.txt
 
 This will install a couple of extra packages for coverage and test management. The minimum
 requirement is ``pytest`` and ``pytest-qt``.
@@ -34,12 +34,11 @@ Since several of the tests involve opening up the novelWriter GUI, you may want
 for the duration of the test run. Moving your mouse while the tests are running may otherwise
 interfere with the execution of some tests.
 
-You can disable the renderring of the GUI by setting the flag ``export QT_QPA_PLATFORM=offscreen``,
-or alternatively run the tests with the ``xvfb`` package, like so:
+You can disable the renderring of the GUI by setting the flag ``QT_QPA_PLATFORM=offscreen``:
 
 .. code-block:: bash
 
-   xvfb-run pytest
+   export QT_QPA_PLATFORM=offscreen pytest
 
 
 Advanced Options
@@ -51,7 +50,7 @@ You can also add coverage report generation. For instance to HTML:
 
 .. code-block:: bash
 
-   xvfb-run pytest -v --cov=novelwriter --cov-report=html
+   export QT_QPA_PLATFORM=offscreen pytest -v --cov=novelwriter --cov-report=html
 
 Other useful report formats are ``xml``, and ``term`` for terminal output.
 
@@ -60,7 +59,7 @@ subpackage groups are ``base``, ``core``, and ``gui``. Consider for instance:
 
 .. code-block:: bash
 
-   xvfb-run pytest -v --cov=novelwriter --cov-report=html -m core
+   export QT_QPA_PLATFORM=offscreen pytest -v --cov=novelwriter --cov-report=html -m core
 
 This will only run the tests of the "core" package, that is, all the classes that deal with the
 project data of a novelWriter project. The "gui" tests, likewise, will run the tests for the GUI
@@ -71,7 +70,7 @@ You can also filter the tests with the ``-k`` switch. The following will do the
 
 .. code-block:: bash
 
-   xvfb-run pytest -v --cov=novelwriter --cov-report=html -k testCore
+   export QT_QPA_PLATFORM=offscreen pytest -v --cov=novelwriter --cov-report=html -k testCore
 
 All tests are named in such a way that you can filter them by adding more bits of the test names.
 They all start with the word "test". Then comes the group: "Core", "Base", "Dlg", "Tool", or "Gui".
@@ -80,6 +79,6 @@ file. For instance, running the following will run all tests for the document ed
 
 .. code-block:: bash
 
-   xvfb-run pytest -v --cov=novelwriter --cov-report=html -k testGuiEditor
+   export QT_QPA_PLATFORM=offscreen pytest -v --cov=novelwriter --cov-report=html -k testGuiEditor
 
 To run a single test, simply add the full test name to the ``-k`` switch.

docs/source/usage_breakdown.rst

@@ -6,12 +6,11 @@ How it Works
 
 .. _Fusion: https://doc.qt.io/qt-6/gallery.html
 .. _Pandoc: https://pandoc.org/
-.. _Typicons: https://github.com/stephenhutchings/typicons.font
 .. _Open Document: https://en.wikipedia.org/wiki/OpenDocument
 
-The main features of novelWriter are listed in the :ref:`a_intro` section. Here, we go into some
-more details on how they are implemented. This is intended as an overview. Later on in this
-documentation, these features will be covered in even more detail.
+The main features of novelWriter are listed in the :ref:`a_intro` chapter. In this chapter, we go
+into some more details on how they are implemented. This is intended as an overview. Later on in
+this documentation, these features will be covered in more detail.
 
 
 .. _a_breakdown_design:
@@ -20,71 +19,86 @@ GUI Layout and Design
 =====================
 
 The user interface of novelWriter is intended to be as minimalistic as practically possible, while
-at the same time provide a complete set of features needed for writing a novel.
+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, is more or less redundant. However,
-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` section.
+clutter, and since the documents are formatted with style tags, it is more or less redundant.
+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.
 
 .. note::
    novelWriter is not intended to be a full office type word processor. It doesn't support images,
    links, tables, and other complex structures and objects often needed for such documents.
    Formatting is limited to headers, emphasis, text alignment, and a few other simple features.
 
-On the left edge 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 Novel Project` tool, and a set
-of project-related tools as well as quick access to settings at the bottom.
+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
+project-related tools and quick access to settings at the bottom.
 
 
 Project Tree View
 -----------------
 
+.. figure:: images/fig_project_tree_view.png
+
+   A screenshot of the Project Tree 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. An optional third panel on the right is 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
-if you wish as it will apply the formatting tags you have specified. The main purpose of the viewer
-is for viewing your notes next to your editor while you're writing.
+your project. The second panel is the document editor.
+
+An optional third panel on the right 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 as it will apply the
+formatting tags you have specified. 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 header, or by pressing :kbd:`F8`. When :guilabel:`Focus Mode` is enabled, all the user
+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.
 
 
 Novel Tree View
 ---------------
 
-When in :guilabel:`Novel Tree View` mode, the project tree is replaces by an overview of your novel
-structure. Instead of showing individual documents, the tree now shows all headings of your novel
-text. This includes multiple headings within the same document.
+.. figure:: images/fig_novel_tree_view.png
+
+   A screenshot of the Novel Tree 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.
 
 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 view to indicate which ones belong together in the same document.
 
-If you have multiple Novel root folders, the header of the novel view becomes a droopdown box. You
-can then switch between them by clicking the "Outline of ..." text. You can also click the novel
-icon button next to it.
+If you have multiple Novel 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 initiated though. You can adjust the aut-save interval in
-:guilabel:`Preferences`. You can also regenerate the whole novel view by pressing the refresh
-button at the top.
+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 at the top of the side panel.
 
 It is possible to show an optional third column in the novel view, The settings are available from
-the menu button ath the top.
+the menu button in the toolbar.
 
-If you click the arrow icon to the right of each item, a tooltip will pop up showing you all the
-meta data collected for that heading entry.
+If you click the arrow icon to the right of each item, a tooltip will pop out showing you all the
+meta data collected for that heading.
 
 
 Novel Outline View
 ------------------
 
+.. figure:: images/fig_outline_view.png
+
+   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.
@@ -97,20 +111,18 @@ The app will remember you column order and size between sessions, and for each i
 Colour Themes
 -------------
 
-The default colour theme of the user interface is the default theme from the Qt library. By
-default, novelWriter is loaded with the Fusion_ style setting. (You can override this with the
-``--style=`` setting when starting novelWriter.)
+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.
 
-There is a standard dark theme provided as well, which is similar to the default Qt theme. Some
-other light and dark colour themes are also provided. You can select which one you prefer from in
-:guilabel:`Preferences` .
-
-A number of syntax highlighting themes are also available in :guilabel:`Preferences`. These are
-separate settings because there are a lot more options for syntax highlighting.
+Switching the GUI colour theme does not affect the colours of the editor and viewer. They have
+separate colour themes called :guilabel:`Editor Themes`. They are separated because there are a lot
+more options to choose from for the editor and viewer.
 
 .. note::
-   If you switch to dark mode on the GUI, you should also switch syntax highlighting theme to
-   match, otherwise icons may be hard to see in the editor and viewer.
+   If you switch to 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.
 
 
 .. _a_breakdown_project:
@@ -127,23 +139,28 @@ you. All that matters to novelWriter is the linear order the documents appear at
 tree (top to bottom). The chapters, scenes and sections of the novel are determined by the headings
 within those documents.
 
+.. figure:: images/fig_header_levels.png
+
+   An illustration of how header levels correspond to the novel structure.
+
 The four heading levels (**H1** to **H4**) are treated as follows:
 
-* **H1** is used for the book title, and for partitions.
+* **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.
+* **H3** is used for scene titles -- optionally replaced by separators.
 * **H4** 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.
 
-This header level structure is only taken into account for novel documents. For the project notes,
-the header levels have no structural meaning, and the user is free to do whatever they want. See
-:ref:`a_struct` and :ref:`a_notes` for more details.
+This header level structure is only taken into account for :term:`novel documents`. For
+:term:`project notes`, the header levels have no structural meaning, and the user is free to do
+whatever they want. See :ref:`a_struct` and :ref:`a_references` for more details.
 
-.. note::
-   You can add documents as child items of other documents if you wish. This is often more useful
-   than adding folders, since you anyway may want to have the chapter heading in a separate
-   document from your individual scene documents.
+.. versionadded:: 2.0
+   You can add documents as child items of other documents. This is often more useful than adding
+   folders, since you anyway may want to have the chapter heading in a separate document from your
+   individual scene documents so that you can rearrange scene documents freely without affecting
+   chapter placement.
 
 
 .. _a_breakdown_export:
@@ -152,23 +169,24 @@ Building the Manuscript
 =======================
 
 The project can at any time be assembled into a range of different formats through the
-:guilabel:`Build Novel Project` tool. Natively, novelWriter supports `Open Document`_, HTML5, and
+:guilabel:`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. In addition, printing
-and printing to PDF is also possible. 
+is also possible. Print to PDF is available from the print dialog.
 
-You can also export the content of the project to a JSON file. This is useful if you want to write
-your own 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 either with HTML
-formatted text, or with the raw text as typed into the novel documents. See :ref:`a_export_options`
-for more details.
+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.
 
-A number of filter options can be applied to the :guilabel:`Build Novel Project` tool, allowing you
-to make a draft manuscript, a reference document of notes, an outline based on chapter and scene
-titles with a synopsis each, and so on. See :ref:`a_export` for more details on build features and
-formats.
+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.
 
 
 .. _a_breakdown_storage:
@@ -178,32 +196,35 @@ Project Storage
 
 The files of a novelWriter project are stored in a dedicated project folder. The project structure
 is kept in a file at the root of this folder called ``nwProject.nwx``. All the document files and
-associated meta data is stored in the other folders below the project folder. For more technical
+associated meta data is stored in other folders below the project folder. For more technical
 details about what all the files mean and how they're organised, see the :ref:`a_storage` section.
 
-This way of storing data was chosen for several reasons. Firstly, all the text you add to your
-project is saved directly to your project folder in separate files. Only the project structure and
-the text you are currently editing is stored in memory at any given time. Secondly, having multiple
-small files means it is very easy to sync them between computers with standard file synchronisation
-tools. Thirdly, if you use version control software to track the changes to your project, the file
-formats used for the files are well suited. Also the JSON documents have line breaks and indents,
-which makes it easier to track them with version control software.
+This way of storing data was chosen for several reasons.
+
+Firstly, all the text you add to your project is saved directly to your project folder in separate
+files. Only the project structure and the text you are currently editing is stored in memory at any
+given time, which means there is a smaller risk of losing data if the application or your computer
+crashes.
+
+Secondly, having multiple small files means it is very easy to synchronise them between computers
+with standard file synchronisation tools.
+
+Thirdly, if you use version control software to track the changes to your project, the file formats
+used for the files are well suited. Also the JSON documents have line breaks and indents, which
+makes it easier to track them with version control software.
 
 .. note::
-
    Since novelWriter has to keep track of a bunch of files and folders when a project is open, it
    may not run well on some virtual file systems. A file or folder must be accessible with exactly
    the path it was saved or created with. An example where this is not the case is the way Google
    Drive is mapped on Linux Gnome desktops using gvfs/gio.
 
 .. caution::
+   You should not add additional files to the project folder yourself. Nor should you,a s a rule,
+   manually edit files within it. If you really must manually edit the text files, e.g. with some
+   automated task you want to perform, you need to rebuild the :term:`Project Index` when you open
+   the project again.
 
-   You should not add additional files to the project folder yourself. Nor should you manually edit
-   files within it as a general rule. If you really must manually edit the text files, e.g. with
-   some automated task you want to perform, you need to rebuild the index when you open the project
-   again.
-
-   Editing text files in the ``content`` folder is less risky as they are just plain text. Editing
+   Editing text files in the ``content`` folder is less risky as these are just plain text. Editing
    the main project XML file, however, may make the project file unreadable and you may crash
    novelWriter and lose project structure information and project settings.
-

docs/source/usage_format.rst

@@ -10,8 +10,8 @@ values and allowing for some text formatting. The syntax is based on Markdown, b
 (bold) and strikethrough text, as well as four levels of headings.
 
 In addition to formatting codes, novelWriter allows for comments, a synopsis tag, and a set of
-keyword and value sets used for tags and references. There are also some codes that apply two whole
-paragraphs. See :ref:`a_fmt_text` below for more details.
+keyword and value sets used for :term:`tags<tag>` and :term:`references<reference>`. There are also
+some codes that apply to whole paragraphs. See :ref:`a_fmt_text` for more details.
 
 
 .. _a_fmt_hlight:
@@ -24,8 +24,13 @@ formtatting tags or other features correctly. It will change the colour and font
 headings, change the text colour of emphasised text, and it can also show you where you have
 dialogue in your text.
 
+.. figure:: images/fig_references.png
+
+   An example of the colour highlighting of references. "Bob" is not defined, and "@blabla" is not
+   a valid reference type.
+
 When you use the commands to set tags and references, these also change colour. Correct commands
-have a dedicated colour, and the references themselves will get a colour if they are valid. Invalid
+have a distinct colour, and the references themselves will get a colour if they are valid. Invalid
 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
@@ -37,10 +42,14 @@ can select them for :guilabel:`Preferences`.
 Headings
 ========
 
-Four levels of headings are allowed. For project notes, they are free to be used as you see fit.
-That is, novelWriter doesn't assign the different headings any particular meaning. However, for
-novel documents they indicate the structural level of the novel and must be used correctly to
-produce the intended result. See :ref:`a_struct_heads` for more details.
+.. figure:: images/fig_header_levels.png
+
+   An illustration of how header levels correspond to the novel structure.
+
+Four levels of headings are allowed. For :term:`project notes`, they are free to be used as you see
+fit. That is, novelWriter doesn't assign the different headings any particular meaning. However,
+for :term:`novel documents` they indicate the structural level of the novel and must be used
+correctly to produce the intended result. See :ref:`a_struct_heads` for more details.
 
 ``# Title Text``
    Heading level one. For novel documents, the header level indicates the start of a new partition.
@@ -56,7 +65,7 @@ produce the intended result. See :ref:`a_struct_heads` for more details.
 
 ``#### Title Text``
    Heading level four. For novel documents, the header level indicates the start of a new section.
-   Section titles can be replaced by separators or removed completely when building the manuscript.
+   Section titles can be replaced by separators or ignored completely when building the manuscript.
 
 For headers level one and two, adding a ``!`` modifies the behaviour of the heading:
 
@@ -87,10 +96,9 @@ paragraph.
 
 In addition, the editor supports a few additional types of whitespaces:
 
-* A non-breaking space can be inserted with :kbd:`Ctrl`:kbd:`K`, :kbd:`Space`.
-* Thin spaces are also supported, and can be inserted with :kbd:`Ctrl`:kbd:`K`, 
-  :kbd:`Shift`:kbd:`Space`.
-* Non-breaking thin space can be inserted  with :kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`Space`.
+* A non-breaking space can be inserted with :kbd:`Ctrl+K`, :kbd:`Space`.
+* 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. They are also listed
 in :ref:`a_kb_ins`.
@@ -109,7 +117,7 @@ background, depending on the selected theme.
 Text Emphasis
 =============
 
-A minimal set of text emphasis styles are supported.
+A minimal set of text emphasis styles are supported for text paragraphs.
 
 ``_text_``
    The text is rendered as emphasised text (italicised).
@@ -120,7 +128,7 @@ A minimal set of text emphasis styles are supported.
 ``~~text~~``
    Strikethrough 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 importance 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
@@ -132,11 +140,19 @@ In addition, the following rules apply:
    itself. That is, ``**text**`` is valid, ``**text **`` is not.
 2. More generally, the delimiters must be on the outer edge of words. That is, ``some **text in
    bold** here`` is valid, ``some** text in bold** here`` is not.
-3. If using both ``**`` and ``_`` to wrap the same text, the underscore must be the inner wrapper.
-   This is due to the underscore also being a valid word character, so if they are on the outside,
-   they violate rule 2.
+3. If using both ``**`` and ``_`` to wrap the same text, the underscore must be the *inner*
+   wrapper. This is due to the underscore also being a valid word character, so if they are on the
+   outside, they violate rule 2.
 4. Text emphasis does not span past line breaks. If you need to add emphasis to multiple lines or
    paragraphs, you must apply it to each of them in turn.
+5. Text emphasis can only be used in plain paragraphs. Comments, titles, and meta data tags don't
+   allow for formatting, and any formatting markup will be renderred as-is.
+
+.. tip::
+   novelWriter supports standard escape syntax for the emphasis markup characters in case the
+   editor misunderstands your intended usage of them. That is, ``\*``, ``\_`` and ``\~`` will
+   generate a plain ``*``, ``_`` and ``~``, respectively, without interpreting them as part of the
+   markup.
 
 
 .. _a_fmt_comm:
@@ -149,9 +165,9 @@ The text of a comment is ignored by the word counter. The text can also be filte
 building the manuscript or viewing the document.
 
 If the first word of a comment is ``Synopsis:`` (with the colon included), the comment is treated
-specially 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.
+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...``
    This is a comment. The text is not renderred by default (this can be overridden), seen in the
@@ -174,15 +190,22 @@ Tags and References
 ===================
 
 The document editor supports a set of keywords used for setting tags, and making references between
-documents. The tag can be set once per section defined by a heading. Setting it multiple times
-under the same heading will just override the previous setting. References can be set anywhere
-within a section, and are collected according to their category.
+documents.
+
+Tags use the command ``@tag:`` to define a tag. The tag can be set once per section defined by a
+heading. Setting it multiple times under the same heading will just override the previous setting.
+
+``@tag: value``
+   A tag commad 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 on the form:
 
 ``@keyword: value``
-   A keyword argument followed by a value, or a comma separated list of values.
+   A reference keyword followed by a value, or a comma separated list of values.
 
-The available tag and reference keywords are listed in the :ref:`a_struct_tags` section. They can
-also be inserted at the cursor position in the editor via the :guilabel:`Insert` menu.
+Tags andreferences 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.
 
 
 .. _a_fmt_align:
@@ -191,7 +214,7 @@ Paragraph Alignment and Indentation
 ===================================
 
 All documents have the text by default aligned to the left or justified, depending on your
-Preferences.
+settings in :guilabel:`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
@@ -239,10 +262,24 @@ headers of level two for novel documents, i.e. chapters, but not for project not
 If you need to add a page break somewhere else, put the text ``[NEW PAGE]`` on a line by itself
 before the text you wish to start on a new page.
 
-Page breaks are automatically added to partition, chapter and unnumbered chapter headers of novel
-documents. If you want such breaks for scenes and sections, you must add them manually.
+If you want page breaks for scenes and sections, you must add them manually.
 
 .. note::
    The page break code is applied to the text that follows it. It adds a "page break before" mark
    to the text when exporting to HTML or Open Document. This means that a ``[NEW PAGE]`` which has
    no text following it, it will not result in a page break.
+
+**Example:**
+
+.. code-block:: markdown
+
+   This is a text paragraph.
+
+   [VSPACE:2]
+
+   This is another text paragraph, but there will be two empty paragraphs
+   in-between them.
+
+   [NEWPAGE]
+
+   This text will always start on a new page if the build format has pages.

docs/source/usage_interface.rst

@@ -1,271 +0,0 @@
-.. _a_ui:
-
-******************
-The User Interface
-******************
-
-.. _Compose Key: https://en.wikipedia.org/wiki/Compose_key
-
-This sections covers in more detail what all the information on the user interface is for, and how
-you can organise your project, and how you use the editor, viewer and outline panel.
-
-
-.. _a_ui_tree:
-
-The Project Tree
-================
-
-The main window contains a project tree in the left-most panel. It shows the entire structure of
-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.
-
-**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 subdocuments. If the counts seem incorrect, they can be updated
-   by rebuilding the project index from the :guilabel:`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 Novel Project` tool, you can
-   filter based on this flag. You can change this value from the 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. You can change these labels from the
-   context menu.
-
-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.
-
-* The first button is a quick links button that will show you a dropdown menu of all the root 
-  folders in your project. Selecting one will move to that position in the tree. You can also
-  activate this menu by pressing :kbd:`Ctrl`:kbd:`L`.
-* The next two buttons can be used to move items up and down in the project tree. This is the only 
-  way to move root folders.
-* The next button opens a dropdown menu for adding new items to the tree. This includes root 
-  folders. You can also activate this dropdown menu by pressing :kbd:`Ctrl`:kbd:`N`.
-* The last button is a menu of further actions on the entire project tree.
-
-.. tip::
-   Under the :guilabel:`Transform` submenu in the context menu of an item, you will find several
-   options on how to change a document or folder. This includes changing between document and note,
-   splitting them into multiple documents, or merging child items into a single document.
-
-Below the project tree you will find a small details panel showing the full information of the
-currently selected item. This panel also includes the latest paragraph and character counts in
-addition to the word count.
-
-
-.. _a_ui_tree_novel:
-
-The Novel Tree
---------------
-
-An alternative way to view the project structure is the novel tree. You can switch to this view by
-selecting the :guilabel:`Novel Tree View` button in the sidebar. This view is a simplified version
-of the view in the :guilabel:`Outline`. 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 tree, or add any new documents, as that would
-   imply restructuring the content of the document files. Any editing must be done in the project
-   tree. However, you can add new headings to existing documents, or change references, which will
-   be updated in this view.
-
-
-.. _a_ui_tree_status:
-
-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. The app doesn't do anything with them at all. To
-modify the labels, go to their respective tabs in :guilabel:`Project Settings`.
-
-The "Status" flag is intended to tag a Novel document as for instance a draft or as completed, and
-the "Importance" flag is intended to tag character notes, or other notes, as for instance a main,
-major or minor character.
-
-Whether a document uses a "Status" or "Importance" flag depends on which root folder it lives in.
-If it's in the :guilabel:`Novel` folder, it uses the "Status" flag, otherwise it uses an
-"Importance" flag. Some folders, like :guilabel:`Trash` and :guilabel:`Archive` allow both.
-
-
-.. _a_ui_tree_dnd:
-
-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 build tool.
-
-Drag & drop has only limited support for moving documents. In general, bulk actions are not
-allowed. This is deliberate to avoid accidentally messing up your project. If you make a mistake,
-the last move action can be undone by pressing :kbd:`Ctrl`:kbd:`Shift`:kbd:`Z`.
-
-Documents and their folders can be rearranged freely within their root folders. If you move a Novel
-documents 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 :guilabel:`Novel` 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 & dropped at all. If you want to reorder them,
-you can move them up or down with respect to eachother from the arrow buttons at the top of the
-project tree, or by pressing :kbd:`Ctrl`:kbd:`Shift` and the :kbd:`Up` or :kbd:`Down` key.
-
-
-.. _a_ui_edit:
-
-Editing and Viewing Documents
-=============================
-
-To edit a document, double-click it in the project tree, or press the :kbd:`Return` key while
-having it selected. This will open the document in the document editor. The editor uses a
-Markdown-like syntax for some features, and a novelWriter-specific syntax for others. The syntax
-format is described in the :ref:`a_fmt` section.
-
-The editor has a maximise button (toggles the :guilabel:`Focus Mode`) and a close button in the
-top–right corner. On the top–left side you will find an edit button that opens the
-:guilabel:`Item Label` dialog for the currently open document, and a search button to open the
-search dialog.
-
-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`:kbd:`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.
-
-The document viewed does not have to be the same document as currently being edited. However, If
-you *are* viewing the same document, pressing :kbd:`Ctrl`:kbd:`R` again will update the document
-with your latest changes. You can also press the reload button in the top–right corner of the view
-panel, next to the close button, to achieve the same thing.
-
-Both the document editor and viewer will show the label of the 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`.
-
-.. tip::
-   Clicking on the document title bar will select the document in the project tree and reveal its
-   location, making it easier to locate in a large project.
-
-Any tag reference in the editor can be opened in the viewer by moving the cursor to the label and
-pressing :kbd:`Ctrl`:kbd:`Return`. You can also control-click them with your mouse. In the viewer,
-the references become clickable links. Clicking them will replace the 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.
-
-At the bottom of the view panel there is a :guilabel:`References` panel. (If it is hidden, click
-the icon to reveal it.) This panel will show links to all documents referring back to the one
-you're currently viewing, if any has been defined. The :guilabel:`Sticky` button will freeze the
-content of the panel to the current document, even if you navigate to another document. This is
-convenient if you want to quickly look through all documents in the list in the
-:guilabel:`References` panel without losing the list in the process.
-
-.. note::
-   The :guilabel:`References` panel relies on an up-to-date 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`.
-
-
-.. _a_ui_edit_search:
-
-Search & Replace
-----------------
-
-The document editor has a search and replace tool that can be activated with :kbd:`Ctrl`:kbd:`F`
-for search mode or :kbd:`Ctrl`:kbd:`H` for search and replace mode.
-
-Pressing :kbd:`Return` while in the search box will search for the next occurrence of the word, and
-:kbd:`Shift`:kbd:`Return` for the previous. Pressing :kbd:`Return` in the replace box, will replace
-the highlighted text and move to the next result.
-
-There are a number of settings for the search tool available as toggle switches above the search
-box. They allow you to search for, in order: matched case only, whole word results only, search
-using regular expressions, loop search when reaching the end of the document, and move to the next
-document when reaching the end. There is also a switch that will try to match the case of the word
-when the replacement is made. That is, it will try to keep the word upper, lower, or capitalised to
-match the word being replaced.
-
-The regular expression search is somewhat dependant on which version of Qt your system has. If you
-have Qt 5.13 or higher, there is better support for unicode symbols in the search.
-
-
-.. _a_ui_edit_auto:
-
-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.
-
-.. tip::
-   If you don't like auto-replacement, all symbols inserted by this feature are also available in
-   the :guilabel:`Insert` menu, and via convenient :ref:`a_kb_ins`. You may also be using a
-   `Compose Key`_ setup, which means you may not need the auto-replace feature.
-
-The editor is able to replace two and three hyphens with short and long dashes, triple points with
-ellipsis, and replace straight single and double quotes with user-defined quote symbols. It will
-also try to determine whether to use the opening or closing symbol, although this feature isn't
-always accurate. Especially distinguishing between closing single quote and apostrophe can be
-tricky for languages that use the same symbol for these, like English does.
-
-.. tip::
-   If the auto-replace feature changes a symbol when you did not want it to change, pressing
-   :kbd:`Ctrl`:kbd:`Z` immediately after the auto-replacement will undo it without undoing the
-   character you typed.
-
-
-.. _a_ui_outline:
-
-Project Outline View
-====================
-
-The project's Outline view is available as another view option from the views bar. 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 it occurs. Double-clicking an entry will open the corresponding document in the
-editor.
-
-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.
-
-.. note::
-   Since the internal structure of the novel does not depend directly on the folder and document
-   structure of the project tree, these will not necessarily look the same, depending on how you
-   choose to organise your documents. See the :ref:`a_struct` page for more details.
-
-Various meta data and information extracted from tags can be displayed in columns in the outline.
-A default set of such columns is visible, but you can turn on or off more columns from the menu
-button in the toolbar. The order of the columns can also be rearranged by dragging them to 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 information viewed in the outline is based on the project's main index. While novelWriter does
-its best to keep the index up to date when contents change, you can always rebuild it manually by
-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`.

docs/source/usage_project.rst

@@ -0,0 +1,220 @@
+.. _a_ui_project:
+
+*************
+Project Views
+*************
+
+This chapter covers in more detail the different project views available in novelWriter.
+
+.. figure:: images/fig_project_tree_detailed.png
+
+   The Project Tree as it appears when loading a sample project.
+
+
+.. _a_ui_tree:
+
+The Project Tree
+================
+
+The main window contains a project tree in the left-most panel. It shows the entire structure of
+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.
+
+**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 subdocuments. 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`.
+
+**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
+   :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`.
+
+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.
+
+* The first button is a quick links button that will show you a dropdown menu of all the
+  :term:`root folders<root folder>` in your project. Selecting one will move to that position in
+  the tree. You can also activate this menu by pressing :kbd:`Ctrl+L`.
+* The next two buttons can be used to move items up and down in the project tree. This is the only
+  way to move root folders.
+* The next button opens a dropdown menu for adding new items to the tree. This includes root
+  folders. You can also activate this dropdown menu by pressing :kbd:`Ctrl+N`.
+* The last button is a menu of further actions you can apply to the project tree.
+
+Below the project tree you will find a small details panel showing the full information of the
+currently selected item. This panel also includes the latest paragraph and character counts in
+addition to the word count.
+
+
+.. _a_ui_tree_split_merge:
+
+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.
+
+Splitting Documents
+^^^^^^^^^^^^^^^^^^^
+
+.. figure:: images/fig_project_split_tool.png
+
+   The :guilabel:`Split Document` dialog.
+
+The :guilabel:`Split Document by Header` 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.
+
+The source document *is not* deleted in the process, but you have the option to let the tool move
+the source document to the :guilabel:`Trash` folder.
+
+Merging Documents
+^^^^^^^^^^^^^^^^^
+
+.. figure:: images/fig_project_merge_tool.png
+
+   The :guilabel:`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.
+
+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.
+
+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.
+
+
+.. _a_ui_tree_status:
+
+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. novelWriter doesn't do anything with them at all.
+To modify the labels, go to their respective tabs in :guilabel:`Project Settings`.
+
+The "Status" flag is intended to tag a :term:`novel document<novel documents>` 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 :guilabel:`Novel` folder, it uses the "Status" flag, otherwise it uses an
+"Importance" flag. Some folders, like :guilabel:`Trash` and :guilabel:`Archive` allow both.
+
+
+.. _a_ui_tree_dnd:
+
+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.
+
+Drag & drop has only limited support for moving documents. In general, bulk actions are not
+allowed. This is deliberate to avoid accidentally messing up your project. If you make a mistake,
+the last move action can be undone by pressing :kbd:`Ctrl+Shift+Z` or from the menu icon in the
+project tree's toolbar.
+
+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 :guilabel:`Novel` 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 & dropped at all. If you want to reorder them,
+you can move them up or down with respect to eachother from the arrow buttons at the top of the
+project tree, or by pressing :kbd:`Ctrl+Shift+Up` or :kbd:`Ctrl+Shift+Down` when they are selected.
+
+
+.. _a_ui_tree_novel:
+
+The Novel Tree
+==============
+
+.. figure:: images/fig_novel_tree_view.png
+
+   A screenshot of the Novel Tree View.
+
+An alternative way to view the project structure is the novel tree. You can switch to this view by
+selecting the :guilabel:`Novel Tree 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.
+
+.. note::
+   You cannot reorganise the entries in the novel tree, or add any new documents, as that would
+   imply restructuring the content of the document files themselves. Any such editing must be done
+   in the project tree. However, you can add new headings to existing documents, or change
+   references, which will be updated in this view when the document is saved.
+
+
+.. _a_ui_outline:
+
+Project Outline View
+====================
+
+.. figure:: images/fig_outline_view.png
+
+   A screenshot of the Novel Outline View.
+
+The project's :guilabel:`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.
+
+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.
+
+.. note::
+   Since the internal structure of the novel does not depend directly on the folder and document
+   structure of the project tree, this view will not necessarily look the same, depending on how
+   you choose to organise your documents. See the :ref:`a_struct` page for more details.
+
+Various meta data and information extracted from :term:`tags<tag>` can be displayed in columns in
+the outline. A default set of such columns is visible, but you can turn on or off more columns from
+the menu button in the toolbar. The order of the columns can also be rearranged by dragging them to
+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 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
+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`.

docs/source/usage_projectformat.rst

@@ -8,18 +8,17 @@ Project Format Changes
 .. _documentation: https://docs.novelwriter.io/
 
 Most of the changes to the file formats over the history of novelWriter have no impact on the
-user-side of things. The project files are generally updated automatically. However, some of the
+user side of things. The project files are generally updated automatically. However, some of the
 changes require minor actions from the user.
 
-The key changes in the formats are listed below, as well as the user actions required, where
-applicable.
+The key changes in the formats are listed in this chapter, as well as the user actions required,
+where applicable.
 
 .. only:: not html
 
    A full project file format specification is available in the online documentation_.
 
 .. caution::
-
    When you update a project from one format version to the next, the project can no longer be
    opened by a version of novelWriter prior to the version where the new file format was
    introduced. You will get a notification about any updates to your project file format and will
@@ -71,7 +70,7 @@ Format 1.3 Changes
 
 This project format was introduced in novelWriter version 1.5.
 
-With this format, the number of document layouts was reduced from 8 to 2. The conversion of
+With this format, the number of document layouts was reduced from eight to two. The conversion of
 document layouts is performed automatically when the project is opened.
 
 Due to the reduction of layouts, some features that were previously controlled by these layouts
@@ -85,7 +84,7 @@ should be used only a few places in any given project. These are as follows:
 
 * The formatting of the level one title on the title page must be changed from ``# Title Text`` to
   ``#! Title Text`` in order to retain the previous functionality. See :ref:`a_fmt_head`.
-* Any text that was previously centred on the page must be manually centred using the new text
+* Any text that was previously centred on the page must be manually centred using the text
   alignment feature. See :ref:`a_fmt_align`.
 
 **Unnumbered Chapters**

docs/source/usage_shortcuts.rst

@@ -5,142 +5,192 @@ Keyboard Shortcuts
 ******************
 
 Most features in novelWriter are available as keyboard shortcuts. This is a reference list if these
-shortcuts. Most of them are also listed in the application.
+shortcuts. Most of them are also listed in the application's user interface.
+
+.. note::
+   On MacOS, replace :kbd:`Ctrl` with :kbd:`Cmd`.
 
 
 .. _a_kb_main:
 
-Main Shortcuts
-==============
+Main Window Shortcuts
+=====================
 
-The main shorcuts are as follows:
-
-.. csv-table:: Keyboard Shortcuts
+.. csv-table::
    :header: "Shortcut", "Description"
-   :widths: 22, 78
-   :class: "tight-table"
 
-   ":kbd:`F1`",                          "Open the online user manual."
-   ":kbd:`F2`",                          "If in the project tree, edit an item's label."
-   ":kbd:`F3`",                          "Find next occurrence of search word in current document."
-   ":kbd:`F5`",                          "Open the :guilabel:`Build Novel Project` dialog."
-   ":kbd:`F6`",                          "Open the :guilabel:`Writing Statistics` dialog."
-   ":kbd:`F7`",                          "Re-run spell checker."
-   ":kbd:`F8`",                          "Toggle :guilabel:`Focus Mode`."
-   ":kbd:`F9`",                          "Re-build the project index."
-   ":kbd:`F11`",                         "Toggle full screen mode."
-   ":kbd:`Return`",                      "If in the project tree, open a document for editing."
-   ":kbd:`Alt`:kbd:`1`",                 "Switch focus to the project tree. On Windows, use :kbd:`Ctrl`:kbd:`Alt`:kbd:`1`."
-   ":kbd:`Alt`:kbd:`2`",                 "Switch focus to document editor. On Windows, use :kbd:`Ctrl`:kbd:`Alt`:kbd:`2`."
-   ":kbd:`Alt`:kbd:`3`",                 "Switch focus to document viewer. On Windows, use :kbd:`Ctrl`:kbd:`Alt`:kbd:`3`."
-   ":kbd:`Alt`:kbd:`4`",                 "Switch focus to outline view. On Windows, use :kbd:`Ctrl`:kbd:`Alt`:kbd:`4`."
-   ":kbd:`Alt`:kbd:`Left`",              "Move backward in the view history of the document viewer."
-   ":kbd:`Alt`:kbd:`Right`",             "Move forward in the view history of the document viewer."
-   ":kbd:`Ctrl`:kbd:`.`",                "Open the context menu in the project tree or the document editor."
-   ":kbd:`Ctrl`:kbd:`,`",                "Open the :guilabel:`Preferences` dialog."
-   ":kbd:`Ctrl`:kbd:`/`",                "Toggle block format as comment."
-   ":kbd:`Ctrl`:kbd:`0`",                "Remove block formatting for block under cursor."
-   ":kbd:`Ctrl`:kbd:`1`",                "Change block format to header level 1."
-   ":kbd:`Ctrl`:kbd:`2`",                "Change block format to header level 2."
-   ":kbd:`Ctrl`:kbd:`3`",                "Change block format to header level 3."
-   ":kbd:`Ctrl`:kbd:`4`",                "Change block format to header level 4."
-   ":kbd:`Ctrl`:kbd:`5`",                "Change block alignment to left-aligned."
-   ":kbd:`Ctrl`:kbd:`6`",                "Change block alignment to centred."
-   ":kbd:`Ctrl`:kbd:`7`",                "Change block alignment to right-aligned."
-   ":kbd:`Ctrl`:kbd:`8`",                "Add a left margin to the block."
-   ":kbd:`Ctrl`:kbd:`9`",                "Add a right margin to the block."
-   ":kbd:`Ctrl`:kbd:`A`",                "Select all text in the document."
-   ":kbd:`Ctrl`:kbd:`B`",                "Format selected text, or word under cursor, with strong emphasis (bold)."
-   ":kbd:`Ctrl`:kbd:`C`",                "Copy selected text to clipboard."
-   ":kbd:`Ctrl`:kbd:`D`",                "Strikethrough selected text, or word under cursor."
-   ":kbd:`Ctrl`:kbd:`F`",                "Open the search bar and search for the selected word, if any is selected."
-   ":kbd:`Ctrl`:kbd:`G`",                "Find next occurrence of search word in current document."
-   ":kbd:`Ctrl`:kbd:`H`",                "Open the search and replace tool and search for the selected word, if any is selected. (On Mac, this is :kbd:`Cmd`:kbd:`=`.)"
-   ":kbd:`Ctrl`:kbd:`I`",                "Format selected text, or word under cursor, with emphasis (italic)."
-   ":kbd:`Ctrl`:kbd:`K`",                "Activate the insert commands. The commands are listed in :ref:`a_kb_ins`."
-   ":kbd:`Ctrl`:kbd:`L`",                "Open the :guilabel:`Quick Links` menu in the Project Tree."
-   ":kbd:`Ctrl`:kbd:`N`",                "Open the Create New Item menu in the Project Tree."
-   ":kbd:`Ctrl`:kbd:`O`",                "Open selected document."
-   ":kbd:`Ctrl`:kbd:`Q`",                "Exit novelWriter."
-   ":kbd:`Ctrl`:kbd:`R`",                "If in the project tree, open a document for viewing. If in the editor, open current document for viewing."
-   ":kbd:`Ctrl`:kbd:`S`",                "Save the current document in the document editor."
-   ":kbd:`Ctrl`:kbd:`V`",                "Paste text from clipboard to cursor position."
-   ":kbd:`Ctrl`:kbd:`W`",                "Close the current document in the document editor."
-   ":kbd:`Ctrl`:kbd:`X`",                "Cut selected text to clipboard."
-   ":kbd:`Ctrl`:kbd:`Y`",                "Redo latest undo."
-   ":kbd:`Ctrl`:kbd:`Z`",                "Undo latest changes."
-   ":kbd:`Ctrl`:kbd:`F7`",               "Toggle spell checking."
-   ":kbd:`Ctrl`:kbd:`Up`",               "Move item one step up in the project tree."
-   ":kbd:`Ctrl`:kbd:`Down`",             "Move item one step down in the project tree."
-   ":kbd:`Ctrl`:kbd:`Del`",              "Delete next word in editor."
-   ":kbd:`Ctrl`:kbd:`Backspace`",        "Delete previous word in editor."
-   ":kbd:`Ctrl`:kbd:`'`",                "Wrap selected text, or word under cursor, in single quotes."
-   ":kbd:`Ctrl`:kbd:`""`",               "Wrap selected text, or word under cursor, in double quotes."
-   ":kbd:`Ctrl`:kbd:`Return`",           "Open the tag or reference under the cursor in the Viewer."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`,`",    "Open the :guilabel:`Project Settings` dialog."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`/`",    "Remove block formatting for block under cursor."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`1`",    "Replace occurrence of search word in current document, and search for next occurrence."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`A`",    "Select all text in current paragraph."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`G`",    "Find previous occurrence of search word in current document."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`I`",    "Import text to the current document from a text file."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`O`",    "Open a project."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`R`",    "Close the document viewer."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`S`",    "Save the current project."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`W`",    "Close the current project."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`Z`",    "Undo move of project tree item."
-   ":kbd:`Ctrl`:kbd:`Shift`:kbd:`Del`",  "If in the project tree, move an item to Trash."
-   ":kbd:`Shift`:kbd:`F1`",              "Open the local user manual (PDF) if it is available."
-   ":kbd:`Shift`:kbd:`F3`",              "Find previous occurrence of search word in current document."
-   ":kbd:`Shift`:kbd:`F6`",              "Open the :guilabel:`Project Details` dialog."
+   ":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:`F9`",           "Re-build the project index"
+   ":kbd:`F11`",          "Toggle full screen mode"
+   ":kbd:`Alt+1`",        "Switch focus to the project tree (Windows :kbd:`Ctrl+Alt+1`)"
+   ":kbd:`Alt+2`",        "Switch focus to document editor (Windows :kbd:`Ctrl+Alt+2`)"
+   ":kbd:`Alt+3`",        "Switch focus to document viewer (Windows :kbd:`Ctrl+Alt+3`)"
+   ":kbd:`Alt+4`",        "Switch focus to outline view (Windows :kbd:`Ctrl+Alt+4`)"
+   ":kbd:`Ctrl+,`",       "Open the :guilabel:`Preferences` dialog"
+   ":kbd:`Ctrl+Q`",       "Exit novelWriter"
+   ":kbd:`Ctrl+Shift+,`", "Open the :guilabel:`Project Settings` dialog"
+   ":kbd:`Ctrl+Shift+O`", "Open a project"
+   ":kbd:`Ctrl+Shift+S`", "Save the current project"
+   ":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"
 
-.. note::
-   On macOS, replace :kbd:`Ctrl` with :kbd:`Cmd`.
+.. _a_kb_tree:
 
+Project Tree Shortcuts
+======================
+
+.. csv-table::
+   :header: "Shortcut", "Description"
+
+   ":kbd:`F2`",             "Edit the label of the selected item"
+   ":kbd:`Return`",         "Open the selected document in the editor"
+   ":kbd:`Alt+Up`",         "Jump or go to the previous item at same level in the tree"
+   ":kbd:`Alt+Down`",       "Jump or go to the next item at same level in the tree"
+   ":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+O`",         "Open selected document"
+   ":kbd:`Ctrl+R`",         "Open the selected document in the viewer"
+   ":kbd:`Ctrl+Up`",        "Move selected item one step up in the tree"
+   ":kbd:`Ctrl+Down`",      "Move selected item one step down in the tree"
+   ":kbd:`Ctrl+Shift+Z`",   "Undo the last move of a project item, if possible"
+   ":kbd:`Ctrl+Shift+Del`", "Move the selected item to Trash"
+
+
+.. _a_kb_editor:
+
+Document Editor Shortcuts
+=========================
+
+
+Text Search Shortcuts
+---------------------
+
+.. csv-table::
+   :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+G`",       "Find next occurrence of search word in current document"
+   ":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+Shift+G`", "Find previous occurrence of the search word"
+   ":kbd:`Shift+F3`",     "Find the previous occurrence of the search word"
+
+
+Text Formatting Shortcuts
+-------------------------
+
+.. csv-table::
+   :header: "Shortcut", "Description"
+
+   ":kbd:`Ctrl+/`",       "Toggle block format as comment"
+   ":kbd:`Ctrl+0`",       "Remove block formatting for block under cursor"
+   ":kbd:`Ctrl+1`",       "Change block format to header level 1"
+   ":kbd:`Ctrl+2`",       "Change block format to header level 2"
+   ":kbd:`Ctrl+3`",       "Change block format to header level 3"
+   ":kbd:`Ctrl+4`",       "Change block format to header level 4"
+   ":kbd:`Ctrl+5`",       "Change block alignment to left-aligned"
+   ":kbd:`Ctrl+6`",       "Change block alignment to centred"
+   ":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+D`",       "Strikethrough selected text, or word under cursor"
+   ":kbd:`Ctrl+I`",       "Format selected text, or word under cursor, with emphasis (italic)"
+   ":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+Shift+/`", "Remove block formatting for block under cursor"
+
+
+Other Editor Shortcuts
+----------------------
+
+.. csv-table::
+   :header: "Shortcut", "Description"
+
+   ":kbd:`F7`",             "Re-run the spell checker"
+   ":kbd:`Ctrl+.`",         "Open the context menu at the current cursor location"
+   ":kbd:`Ctrl+A`",         "Select all text in the document"
+   ":kbd:`Ctrl+C`",         "Copy selected text to clipboard"
+   ":kbd:`Ctrl+K`",         "Activate the insert commands (see list in :ref:`a_kb_ins`)"
+   ":kbd:`Ctrl+R`",         "Open or reload the current document in the viewer"
+   ":kbd:`Ctrl+S`",         "Save the current document"
+   ":kbd:`Ctrl+V`",         "Paste text from clipboard to cursor position"
+   ":kbd:`Ctrl+W`",         "Close the current document"
+   ":kbd:`Ctrl+X`",         "Cut selected text to clipboard"
+   ":kbd:`Ctrl+Y`",         "Redo latest undo"
+   ":kbd:`Ctrl+Z`",         "Undo latest changes"
+   ":kbd:`Ctrl+Del`",       "Delete the word after the cursor"
+   ":kbd:`Ctrl+Backspace`", "Delete the word before the cursor"
+   ":kbd:`Ctrl+Return`",    "Open the tag or reference under the cursor in the viewer"
+   ":kbd:`Ctrl+F7`",        "Toggle spell checking"
+   ":kbd:`Ctrl+Shift+A`",   "Select all text in the current paragraph"
+   ":kbd:`Ctrl+Shift+I`",   "Import text to the current document from a text file"
 
 .. _a_kb_ins:
 
 Insert Shortcuts
-================
+----------------
 
 A set of insert features are also available through shortcuts, but they require a double
-combination of key sequences. The insert feature is activated with :kbd:`Ctrl`:kbd:`K`, followed by
+combination of key sequences. The insert feature is activated with :kbd:`Ctrl+K`, followed by
 a key or key combination for the inserted content.
 
-.. csv-table:: Keyboard Shortcuts
+.. csv-table::
    :header: "Shortcut", "Description"
-   :widths: 30, 70
-   :class: "tight-table"
 
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`−`",                 "Insert a short dash (en dash)."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`_`",                 "Insert a long dash (em dash)."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`_`",      "Insert a horizontal bar (quotation dash)."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`~`",                 "Insert a figure dash (same width as a number)."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`1`",                 "Insert a left single quote."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`2`",                 "Insert a right single quote."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`3`",                 "Insert a left double quote."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`4`",                 "Insert a right double quote."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`'`",                 "Insert a modifier apostrophe."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`.`",                 "Insert an ellipsis."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`'`",      "Insert a prime."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`""`",     "Insert a double prime."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Space`",             "Insert a non-breaking space."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Shift`:kbd:`Space`", "Insert a thin space."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`Space`",  "Insert a thin non-breaking space."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`*`",                 "Insert a list bullet."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`−`",      "Insert a hyphen bullet (alternative bullet)."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`*`",      "Insert a flower mark (alternative bullet)."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`%`",                 "Insert a per mille symbol."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`O`",      "Insert a degree symbol."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`X`",      "Insert a times sign."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`Ctrl`:kbd:`D`",      "Insert a division sign."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`G`",                 "Insert a ``@tag`` keyword."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`V`",                 "Insert a ``@pov`` keyword."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`F`",                 "Insert a ``@focus`` keyword."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`C`",                 "Insert a ``@char`` keyword."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`P`",                 "Insert a ``@plot`` keyword."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`S`",                 "Insert a synopsis comment."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`T`",                 "Insert a ``@time`` keyword."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`L`",                 "Insert a ``@location`` keyword."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`O`",                 "Insert an ``@object`` keyword."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`E`",                 "Insert an ``@entity`` keyword."
-   ":kbd:`Ctrl`:kbd:`K`, :kbd:`X`",                 "Insert a ``@custom`` keyword."
+   ":kbd:`Ctrl+K`, :kbd:`−`",           "Insert a short dash (en dash)"
+   ":kbd:`Ctrl+K`, :kbd:`_`",           "Insert a long dash (em dash)"
+   ":kbd:`Ctrl+K`, :kbd:`Ctrl+_`",      "Insert a horizontal bar (quotation dash)"
+   ":kbd:`Ctrl+K`, :kbd:`~`",           "Insert a figure dash (same width as a number)"
+   ":kbd:`Ctrl+K`, :kbd:`1`",           "Insert a left single quote"
+   ":kbd:`Ctrl+K`, :kbd:`2`",           "Insert a right single quote"
+   ":kbd:`Ctrl+K`, :kbd:`3`",           "Insert a left double quote"
+   ":kbd:`Ctrl+K`, :kbd:`4`",           "Insert a right double quote"
+   ":kbd:`Ctrl+K`, :kbd:`'`",           "Insert a modifier apostrophe"
+   ":kbd:`Ctrl+K`, :kbd:`.`",           "Insert an ellipsis"
+   ":kbd:`Ctrl+K`, :kbd:`Ctrl+'`",      "Insert a prime"
+   ":kbd:`Ctrl+K`, :kbd:`Ctrl+""`",     "Insert a double prime"
+   ":kbd:`Ctrl+K`, :kbd:`Space`",       "Insert a non-breaking space"
+   ":kbd:`Ctrl+K`, :kbd:`Shift+Space`", "Insert a thin space"
+   ":kbd:`Ctrl+K`, :kbd:`Ctrl+Space`",  "Insert a thin non-breaking space"
+   ":kbd:`Ctrl+K`, :kbd:`*`",           "Insert a list bullet"
+   ":kbd:`Ctrl+K`, :kbd:`Ctrl+−`",      "Insert a hyphen bullet (alternative bullet)"
+   ":kbd:`Ctrl+K`, :kbd:`Ctrl+*`",      "Insert a flower mark (alternative bullet)"
+   ":kbd:`Ctrl+K`, :kbd:`%`",           "Insert a per mille symbol"
+   ":kbd:`Ctrl+K`, :kbd:`Ctrl+O`",      "Insert a degree symbol"
+   ":kbd:`Ctrl+K`, :kbd:`Ctrl+X`",      "Insert a times sign"
+   ":kbd:`Ctrl+K`, :kbd:`Ctrl+D`",      "Insert a division sign"
+   ":kbd:`Ctrl+K`, :kbd:`G`",           "Insert a ``@tag`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`V`",           "Insert a ``@pov`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`F`",           "Insert a ``@focus`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`C`",           "Insert a ``@char`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`P`",           "Insert a ``@plot`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`S`",           "Insert a synopsis comment"
+   ":kbd:`Ctrl+K`, :kbd:`T`",           "Insert a ``@time`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`L`",           "Insert a ``@location`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`O`",           "Insert an ``@object`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`E`",           "Insert an ``@entity`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`X`",           "Insert a ``@custom`` keyword"
+
+
+.. _a_kb_viewer:
+
+Document Viewer Shortcuts
+=========================
+
+.. csv-table::
+   :header: "Shortcut", "Description"
+
+   ":kbd:`Alt+Left`",     "Move backward in the view history"
+   ":kbd:`Alt+Right`",    "Move forward in the view history"
+   ":kbd:`Ctrl+C`",       "Copy selected text to clipboard"
+   ":kbd:`Ctrl+Shift+A`", "Select all text in the current paragraph"
+   ":kbd:`Ctrl+Shift+R`", "Close the document viewer"

docs/source/usage_typography.rst

@@ -30,8 +30,8 @@ Dashes and Ellipsis
 
 With the auto-replace feature enabled (see :ref:`a_ui_edit_auto`), multiple hyphens are converted
 automatically to short and long dashes, and three dots to ellipsis. The last auto-replace can
-always be reverted with the undo command :kbd:`Ctrl`:kbd:`Z`, reverting the text to what you typed
-before the automatic replacement occurred.
+always be reverted with the undo command :kbd:`Ctrl+Z`, reverting the text to what you typed before
+the automatic replacement occurred.
 
 In addition, "Figure Dash" is available. The Figure Dash is a dash that has the same width as the
 numbers of the same font, for most fonts. It helps to align numbers nicely in columns when you need
@@ -59,8 +59,8 @@ Single and Double Prime
 ------------------------
 
 Both single and double prime symbols are available in the :guilabel:`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
+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 renderred similarly by the font, but they have different
 codes. Using these correctly will also prevent the auto-replace and dialogue highlighting features
 misunderstanding their meaning in the text.
@@ -79,9 +79,9 @@ 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 Novel Project` tool, these apostrophes will be replaced
+   On export with the :guilabel:`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 highlighting.
+   Therefore it doesn't really matter if you only use them to correct syntax highlighting.
 
 
 Special Space Symbols

docs/source/usage_writing.rst

@@ -0,0 +1,139 @@
+.. _a_ui_writing:
+
+*********************
+The Editor and Viewer
+*********************
+
+.. _Compose Key: https://en.wikipedia.org/wiki/Compose_key
+
+This chapter covers in more detail how the document editor and viewer panels work.
+
+
+.. _a_ui_edit:
+
+Editing a Document
+==================
+
+.. figure:: images/fig_editor.png
+
+   A screenshot of the Document Editor panel.
+
+To edit a document, double-click it in the project tree, or press the :kbd:`Return` key while
+having it selected. This will open the document in the document editor. The editor uses a
+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
+top--right corner. On the top--left side you will find an edit button that opens the
+:guilabel:`Item Label` dialog for the currently open document, 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`.
+
+.. tip::
+   Clicking on the document title bar will select the document in the project tree and thus reveal
+   its location there, making it easier to find in a large project.
+
+Any :term:`references<reference>` in the editor can be opened in the viewer by moving the cursor to
+the label and pressing :kbd:`Ctrl+Return`. You can also control-click them with your mouse.
+
+
+.. _a_ui_view:
+
+Viewing a Document
+==================
+
+.. figure:: images/fig_viewer.png
+
+   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.
+
+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
+document with your latest changes. You can also press the reload button in the top--right corner of
+the viewer panel, next to the close button, to achieve the same thing.
+
+In the viewer :term:`references<reference>` become clickable links. Clicking them will replace the
+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.
+
+At the bottom of the view panel there is a :guilabel:`References` panel. (If it is hidden, click
+the icon next to it to reveal it.) This panel will show links to all documents referring back to
+the one you're currently viewing, if any has been defined. The :guilabel:`Sticky` button will
+freeze the content of the panel to the current document, even if you navigate to another document.
+This is convenient if you want to quickly look through all documents in the list in the
+:guilabel:`References` panel without losing the list in the process.
+
+.. note::
+   The :guilabel:`References` panel relies on an up-to-date :term:`index<project 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`.
+
+
+.. _a_ui_edit_search:
+
+Search & Replace
+================
+
+.. figure:: images/fig_editor_search.png
+
+   A screenshot of the Document Editor search box.
+
+The document editor has a search and replace tool that can be activated with :kbd:`Ctrl+F` for
+search mode or :kbd:`Ctrl+H` for search and replace mode.
+
+Pressing :kbd:`Return` while in the search box will search for the next occurrence of the word, and
+:kbd:`Shift+Return` for the previous. Pressing :kbd:`Return` in the replace box, will replace the
+highlighted text and move to the next result.
+
+There are a number of settings for the search tool available as toggle switches above the search
+box. They allow you to search for, in order: matched case only, whole word results only, search
+using regular expressions, loop search when reaching the end of the document, and move to the next
+document when reaching the end. There is also a switch that will try to match the case of the word
+when the replacement is made. That is, it will try to keep the word upper, lower, or capitalised to
+match the word being replaced.
+
+The regular expression search is somewhat dependant on which version of Qt your system has. If you
+have Qt 5.13 or higher, there is better support for Unicode symbols in the search.
+
+.. seealso::
+   For more information on the capabilities of the Regular Expression option, see the Qt
+   documentation for the `QRegularExpression <https://doc.qt.io/qt-5/qregularexpression.html>`_
+   class.
+
+
+.. _a_ui_edit_auto:
+
+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.
+
+.. tip::
+   If you don't like auto-replacement, all symbols inserted by this feature are also available in
+   the :guilabel:`Insert` menu, and via :ref:`a_kb_ins`. You may also be using a `Compose Key`_
+   setup, which means you may not need the auto-replace feature at all.
+
+The editor is able to replace two and three hyphens with short and long dashes, triple points with
+ellipsis, and replace straight single and double quotes with user-defined quote symbols. It will
+also try to determine whether to use the opening or closing symbol, although this feature isn't
+always accurate. Especially distinguishing between closing single quote and apostrophe can be
+tricky for languages that use the same symbol for these, like English does.
+
+.. tip::
+   If the auto-replace feature changes a symbol when you did not want it to change, pressing
+   :kbd:`Ctrl+Z` once after the auto-replacement will undo it without undoing the character
+   you typed before it.

i18n/README.md

@@ -76,7 +76,7 @@ The `i18n` folder at the root of the repository contains the `nw_XX.ts` translat
 Whether to add a new language to the translation framework, or to  update the file against the
 current source code, you must first run the `qtlupdate` command:
 ```bash
-python3 setup.py qtlupdate i18n/nw_XX.ts
+python3 pkgutils.py qtlupdate i18n/nw_XX.ts
 ```
 
 The file name must be in the correct format. All translation files must be located in the `i18n`
@@ -101,7 +101,7 @@ The application does not use `.ts` files directly. The `novelwriter/assets/i18n/
 the actual files used to translate the GUI into another language other than the default British
 English. These files are not generated by default, but they can be built with:
 ```bash
-python3 setup.py qtlrelease
+python3 pkgutils.py qtlrelease
 ```
 
 You can now test the translation in novelWriter. The Preferences dialog should list the newly added

i18n/pylupdate6/README.md

@@ -1,7 +0,0 @@
-# PyQt6 Linguist Tool
-
-This is a copy of the `pylupdate` tool from PyQt6 version 6.2.1 from
-[PyPi](https://pypi.org/project/PyQt6/).
-The tool is stripped down to run for novelWriter.
-
-PyQt6 is licensed under GPL 3.0

i18n/pylupdate6/__init__.py

@@ -1,22 +0,0 @@
-# Copyright (c) 2021 Riverbank Computing Limited <info@riverbankcomputing.com>
-#
-# This file is part of PyQt6.
-#
-# This file may be used under the terms of the GNU General Public License
-# version 3.0 as published by the Free Software Foundation and appearing in
-# the file LICENSE included in the packaging of this file.  Please review the
-# following information to ensure the GNU General Public License version 3.0
-# requirements will be met: http://www.gnu.org/copyleft/gpl.html.
-#
-# If you do not wish to use this file under the terms of the GPL version 3.0
-# then you may purchase a commercial license.  For more information contact
-# info@riverbankcomputing.com.
-#
-# This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-# WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-
-
-# The public API.
-from .lupdate import lupdate
-
-__all__ = ["lupdate"]

i18n/pylupdate6/lupdate.py

@@ -1,90 +0,0 @@
-# Copyright (c) 2021 Riverbank Computing Limited <info@riverbankcomputing.com>
-#
-# This file is part of PyQt6.
-#
-# This file may be used under the terms of the GNU General Public License
-# version 3.0 as published by the Free Software Foundation and appearing in
-# the file LICENSE included in the packaging of this file.  Please review the
-# following information to ensure the GNU General Public License version 3.0
-# requirements will be met: http://www.gnu.org/copyleft/gpl.html.
-#
-# If you do not wish to use this file under the terms of the GPL version 3.0
-# then you may purchase a commercial license.  For more information contact
-# info@riverbankcomputing.com.
-#
-# This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-# WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-
-
-import fnmatch
-import os
-
-# from .designer_source import DesignerSource
-from .python_source import PythonSource
-from .translation_file import TranslationFile
-from .user import UserException
-
-
-def lupdate(
-    sources, translation_files, no_obsolete=False, no_summary=True, verbose=False, excludes=None
-):
-    """ Update a sequence of translation (.ts) files from a sequence of Python
-    source (.py) files, Designer source (.ui) files or directories containing
-    source files.
-    """
-
-    if excludes is None:
-        excludes = ()
-
-    # Read the .ts files.
-    translations = [
-        TranslationFile(ts, no_obsolete=no_obsolete, no_summary=no_summary, verbose=verbose)
-        for ts in translation_files
-    ]
-
-    # Read the sources.
-    source_files = []
-    for source in sources:
-        if os.path.isdir(source):
-            for dirpath, _, filenames in os.walk(source):
-                for fn in filenames:
-                    # Apply any exclusion patterns.
-                    for exclude in excludes:
-                        if fnmatch.fnmatch(fn, exclude):
-                            fn = None
-                            break
-
-                    if fn is None:
-                        continue
-
-                    filename = os.path.join(dirpath, fn)
-
-                    if filename.endswith('.py'):
-                        source_files.append(PythonSource(filename=filename, verbose=verbose))
-
-                    # UI file support is disabled
-                    # elif filename.endswith('.ui'):
-                    #     source_files.append(
-                    #             DesignerSource(filename=filename,
-                    #                     verbose=verbose))
-
-                    elif verbose:
-                        print("Ignoring", filename)
-
-        elif source.endswith('.py'):
-            source_files.append(PythonSource(filename=source, verbose=verbose))
-
-        # UI file support is disabled
-        # elif source.endswith('.ui'):
-        #     source_files.append(
-        #             DesignerSource(filename=source, verbose=verbose))
-
-        else:
-            raise UserException("{0} must be a directory or a .py or a .ui file".format(source))
-
-    # Update each translation for each source.
-    for t in translations:
-        for s in source_files:
-            t.update(s)
-
-        t.write()

i18n/pylupdate6/python_source.py

@@ -1,362 +0,0 @@
-# Copyright (c) 2021 Riverbank Computing Limited <info@riverbankcomputing.com>
-#
-# This file is part of PyQt6.
-#
-# This file may be used under the terms of the GNU General Public License
-# version 3.0 as published by the Free Software Foundation and appearing in
-# the file LICENSE included in the packaging of this file.  Please review the
-# following information to ensure the GNU General Public License version 3.0
-# requirements will be met: http://www.gnu.org/copyleft/gpl.html.
-#
-# If you do not wish to use this file under the terms of the GPL version 3.0
-# then you may purchase a commercial license.  For more information contact
-# info@riverbankcomputing.com.
-#
-# This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-# WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-
-
-import ast
-import re
-import tokenize
-
-from .source_file import SourceFile
-from .translations import Context, EmbeddedComments, Message
-from .user import User, UserException
-
-
-class PythonSource(SourceFile, User):
-    """ Encapsulate a Python source file. """
-
-    # The regular expression to extract a PEP 263 encoding.
-    _PEP_263 = re.compile(rb'^[ \t\f]*#.*?coding[:=][ \t]*([-_.a-zA-Z0-9]+)')
-
-    def __init__(self, **kwargs):
-        """ Initialise the object. """
-
-        super().__init__(**kwargs)
-
-        # Read the source file.
-        self.progress("Reading {0}...".format(self.filename))
-        with open(self.filename, 'rb') as f:
-            source = f.read()
-
-        # Implement universal newlines.
-        source = source.replace(b'\r\n', b'\n').replace(b'\r', b'\n')
-
-        # Try and extract a PEP 263 encoding.
-        encoding = 'UTF-8'
-
-        for line_nr, line in enumerate(source.split(b'\n')):
-            if line_nr > 1:
-                break
-
-            match = re.match(self._PEP_263, line)
-            if match:
-                encoding = match.group(1).decode('ascii')
-                break
-
-        # Decode the source according to the encoding.
-        try:
-            source = source.decode(encoding)
-        except LookupError:
-            raise UserException("Unsupported encoding '{0}'".format(encoding))
-
-        # Parse the source file.
-        self.progress("Parsing {0}...".format(self.filename))
-
-        try:
-            tree = ast.parse(source, filename=self.filename)
-        except SyntaxError as e:
-            raise UserException(
-                "Invalid syntax at line {0} of {1}:\n{2}".format(
-                    e.lineno, e.filename, e.text.rstrip()
-                )
-            )
-
-        # Look for translation contexts and their contents.
-        visitor = Visitor(self)
-        visitor.visit(tree)
-
-        # Read the file again as a sequence of tokens so that we see the
-        # comments.
-        with open(self.filename, 'rb') as f:
-            current = None
-
-            for token in tokenize.tokenize(f.readline):
-                if token.type == tokenize.COMMENT:
-                    # See if it is an embedded comment.
-                    parts = token.string.split(' ', maxsplit=1)
-                    if len(parts) == 2:
-                        if parts[0] == '#:':
-                            if current is None:
-                                current = EmbeddedComments()
-
-                            current.extra_comments.append(parts[1])
-                        elif parts[0] == '#=':
-                            if current is None:
-                                current = EmbeddedComments()
-
-                            current.message_id = parts[1]
-                        elif parts[0] == '#~':
-                            parts = parts[1].split(' ', maxsplit=1)
-                            if len(parts) == 1:
-                                parts.append('')
-
-                            if current is None:
-                                current = EmbeddedComments()
-
-                            current.extras.append(parts)
-
-                elif token.type == tokenize.NL:
-                    continue
-
-                elif current is not None:
-                    # Associate the embedded comment with the line containing
-                    # this token.
-                    line_nr = token.start[0]
-
-                    # See if there is a message on that line.
-                    for context in self.contexts:
-                        for message in context.messages:
-                            if message.line_nr == line_nr:
-                                break
-                        else:
-                            message = None
-
-                        if message is not None:
-                            message.embedded_comments = current
-                            break
-
-                    current = None
-
-
-class Visitor(ast.NodeVisitor):
-    """ A visitor that extracts translation contexts. """
-
-    def __init__(self, source):
-        """ Initialise the visitor. """
-
-        self._source = source
-        self._context_stack = []
-
-        super().__init__()
-
-    def visit_Call(self, node):
-        """ Visit a call. """
-
-        # Parse the arguments if a translation function is being called.
-        call_args = None
-
-        if isinstance(node.func, ast.Attribute):
-            name = node.func.attr
-
-            if name == 'tr':
-                call_args = self._parse_tr(node)
-            elif name == 'translate':
-                call_args = self._parse_translate(node)
-
-        elif isinstance(node.func, ast.Name):
-            name = node.func.id
-
-            if name == 'QT_TR_NOOP':
-                call_args = self._parse_QT_TR_NOOP(node)
-            elif name == 'QT_TRANSLATE_NOOP':
-                call_args = self._parse_QT_TRANSLATE_NOOP(node)
-
-        # Update the context if the arguments are usable.
-        if call_args is not None and call_args.source != '':
-            call_args.context.messages.append(
-                Message(
-                    self._source.filename, node.lineno,
-                    call_args.source, call_args.disambiguation,
-                    (call_args.numerus)
-                )
-            )
-
-        self.generic_visit(node)
-
-    def visit_ClassDef(self, node):
-        """ Visit a class. """
-
-        try:
-            name = self._context_stack[-1].name + '.' + node.name
-        except IndexError:
-            name = node.name
-
-        self._context_stack.append(Context(name))
-
-        self.generic_visit(node)
-
-        context = self._context_stack.pop()
-
-        if context.messages:
-            self._source.contexts.append(context)
-
-    def _get_current_context(self):
-        """ Return the current Context object if there is one. """
-
-        return self._context_stack[-1] if self._context_stack else None
-
-    @classmethod
-    def _get_first_str(cls, args):
-        """ Get the first of a list of arguments as a str. """
-
-        # Check that there is at least one argument.
-        if not args:
-            return None
-
-        return cls._get_str(args[0])
-
-    def _get_or_create_context(self, name):
-        """ Return the Context object for a name, creating it if necessary. """
-
-        for context in self._source.contexts:
-            if context.name == name:
-                return context
-
-        context = Context(name)
-        self._source.contexts.append(context)
-
-        return context
-
-    @staticmethod
-    def _get_str(node, allow_none=False):
-        """ Return the str from a node or None if it wasn't an appropriate
-        node.
-        """
-
-        if isinstance(node, ast.Str):
-            return node.s
-
-        if isinstance(node, ast.Constant):
-            if isinstance(node.value, str):
-                return node.value
-
-            if allow_none and node.value is None:
-                return ''
-
-        return None
-
-    def _parse_QT_TR_NOOP(self, node):
-        """ Parse the arguments to QT_TR_NOOP(). """
-
-        # Ignore unless there is a current context.
-        context = self._get_current_context()
-        if context is None:
-            return None
-
-        call_args = self._parse_noop_without_context(node.args, node.keywords)
-        if call_args is None:
-            return None
-
-        call_args.context = context
-
-        return call_args
-
-    def _parse_QT_TRANSLATE_NOOP(self, node):
-        """ Parse the arguments to QT_TRANSLATE_NOOP(). """
-
-        # Get the context.
-        name = self._get_first_str(node.args)
-        if name is None:
-            return None
-
-        call_args = self._parse_noop_without_context(node.args[1:], node.keywords)
-        if call_args is None:
-            return None
-
-        call_args.context = self._get_or_create_context(name)
-
-        return call_args
-
-    def _parse_tr(self, node):
-        """ Parse the arguments to tr(). """
-
-        # Ignore unless there is a current context.
-        context = self._get_current_context()
-        if context is None:
-            return None
-
-        call_args = self._parse_without_context(node.args, node.keywords)
-        if call_args is None:
-            return None
-
-        call_args.context = context
-
-        return call_args
-
-    def _parse_translate(self, node):
-        """ Parse the arguments to translate(). """
-
-        # Get the context.
-        name = self._get_first_str(node.args)
-        if name is None:
-            return None
-
-        call_args = self._parse_without_context(node.args[1:], node.keywords)
-        if call_args is None:
-            return None
-
-        call_args.context = self._get_or_create_context(name)
-
-        return call_args
-
-    def _parse_without_context(self, args, keywords):
-        """ Parse arguments for a message source and optional disambiguation
-        and n.
-        """
-
-        # The source is required.
-        source = self._get_first_str(args)
-        if source is None:
-            return None
-
-        if len(args) > 1:
-            disambiguation = self._get_str(args[1], allow_none=True)
-        else:
-            for kw in keywords:
-                if kw.arg == 'disambiguation':
-                    disambiguation = self._get_str(kw.value, allow_none=True)
-                    break
-            else:
-                disambiguation = ''
-
-        # Ignore if the disambiguation is specified but isn't a string.
-        if disambiguation is None:
-            return None
-
-        if len(args) > 2:
-            numerus = True
-        else:
-            numerus = 'n' in keywords
-
-        if len(args) > 3:
-            return None
-
-        return CallArguments(source, disambiguation, numerus)
-
-    def _parse_noop_without_context(self, args, keywords):
-        """ Parse arguments for a message source. """
-
-        # There must be exactly one positional argument.
-        if len(args) != 1 or len(keywords) != 0:
-            return None
-
-        source = self._get_str(args[0])
-        if source is None:
-            return None
-
-        return CallArguments(source)
-
-
-class CallArguments:
-    """ Encapsulate the possible arguments of a translation function. """
-
-    def __init__(self, source, disambiguation='', numerus=False):
-        """ Initialise the object. """
-
-        self.context = None
-        self.source = source
-        self.disambiguation = disambiguation
-        self.numerus = numerus

i18n/pylupdate6/source_file.py

@@ -1,29 +0,0 @@
-# Copyright (c) 2021 Riverbank Computing Limited <info@riverbankcomputing.com>
-#
-# This file is part of PyQt6.
-#
-# This file may be used under the terms of the GNU General Public License
-# version 3.0 as published by the Free Software Foundation and appearing in
-# the file LICENSE included in the packaging of this file.  Please review the
-# following information to ensure the GNU General Public License version 3.0
-# requirements will be met: http://www.gnu.org/copyleft/gpl.html.
-#
-# If you do not wish to use this file under the terms of the GPL version 3.0
-# then you may purchase a commercial license.  For more information contact
-# info@riverbankcomputing.com.
-#
-# This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-# WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-
-
-class SourceFile:
-    """ The base class for any source file that provides translation contexts.
-    """
-
-    def __init__(self, filename, **kwargs):
-        """ Initialise the object. """
-
-        super().__init__(**kwargs)
-
-        self.filename = filename
-        self.contexts = []

i18n/pylupdate6/translation_file.py

@@ -1,390 +0,0 @@
-# Copyright (c) 2021 Riverbank Computing Limited <info@riverbankcomputing.com>
-#
-# This file is part of PyQt6.
-#
-# This file may be used under the terms of the GNU General Public License
-# version 3.0 as published by the Free Software Foundation and appearing in
-# the file LICENSE included in the packaging of this file.  Please review the
-# following information to ensure the GNU General Public License version 3.0
-# requirements will be met: http://www.gnu.org/copyleft/gpl.html.
-#
-# If you do not wish to use this file under the terms of the GPL version 3.0
-# then you may purchase a commercial license.  For more information contact
-# info@riverbankcomputing.com.
-#
-# This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-# WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-
-
-import os
-from xml.etree import ElementTree
-
-from .user import User, UserException
-
-
-class TranslationFile(User):
-    """ Encapsulate a translation file. """
-
-    def __init__(self, ts_file, no_obsolete, no_summary, **kwargs):
-        """ Initialise the translation file. """
-
-        super().__init__(**kwargs)
-
-        if os.path.isfile(ts_file):
-            self.progress("Reading {0}...".format(ts_file))
-
-            try:
-                self._root = ElementTree.parse(ts_file).getroot()
-            except Exception as e:
-                raise UserException(
-                    "{}: {}: {}".format(ts_file, "invalid translation file", str(e))
-                )
-        else:
-            self._root = ElementTree.fromstring(_EMPTY_TS)
-
-        self._ts_file = ts_file
-        self._no_obsolete = no_obsolete
-        self._no_summary = no_summary
-        self._updated_contexts = {}
-
-        # Create a dict of contexts keyed by the context name and having the
-        # list of message elements as the value.
-        self._contexts = {}
-
-        # Also create a dict of existing translations so that they can be
-        # re-used.
-        self._translations = {}
-
-        context_els = []
-        for context_el in self._root:
-            if context_el.tag != 'context':
-                continue
-
-            context_els.append(context_el)
-
-            name = ''
-            message_els = []
-
-            for el in context_el:
-                if el.tag == 'name':
-                    name = el.text
-                elif el.tag == 'message':
-                    message_els.append(el)
-
-            if name:
-                self._contexts[name] = message_els
-
-                for message_el in message_els:
-                    source_el = message_el.find('source')
-                    if source_el is None or not source_el.text:
-                        continue
-
-                    translation_el = message_el.find('translation')
-                    if translation_el is None or not translation_el.text:
-                        continue
-
-                    self._translations[source_el.text] = translation_el.text
-
-        # Remove the context elements but keep everything else in the root
-        # (probably set by Linguist).
-        for context_el in context_els:
-            self._root.remove(context_el)
-
-        # Clear the summary statistics.
-        self._nr_new = 0
-        self._nr_new_duplicates = 0
-        self._nr_new_using_existing_translation = 0
-        self._nr_existing = 0
-        self._nr_kept_obsolete = 0
-        self._nr_discarded_obsolete = 0
-        self._nr_discarded_untranslated = 0
-
-        # Remember all new messages so we can make the summary less confusing
-        # than it otherwise might be.
-        self._new_message_els = []
-
-    def update(self, source):
-        """ Update the translation file from a SourceFile object. """
-
-        self.progress("Updating {0} from {1}...".format(self._ts_file, source.filename))
-
-        for context in source.contexts:
-            # Get the messages that we already know about for this context.
-            try:
-                message_els = self._contexts[context.name]
-            except KeyError:
-                message_els = []
-
-            # Get the messages that have already been updated.
-            updated_message_els = self._get_updated_message_els(context.name)
-
-            for message in context.messages:
-                message_el = self._find_message(message, message_els)
-
-                if message_el is not None:
-                    # Move the message to the updated list.
-                    message_els.remove(message_el)
-                    self._add_message_el(message_el, updated_message_els)
-                else:
-                    # See if this is a new message.  If not then we just have
-                    # another location for an existing message.
-                    message_el = self._find_message(message, updated_message_els)
-
-                if message_el is None:
-                    message_el = self._make_message_el(message)
-                    updated_message_els.append(message_el)
-
-                    self.progress("Added new message '{0}'".format(self.pretty(message.source)))
-                    self._nr_new += 1
-                else:
-                    self.progress("Updated message '{0}'".format(self.pretty(message.source)))
-
-                    # Don't count another copy of a new message as an existing
-                    # one.
-                    if message_el in self._new_message_els:
-                        self._nr_new_duplicates += 1
-                    else:
-                        self._nr_existing += 1
-
-                message_el.insert(0, self._make_location_el(message))
-
-    def write(self):
-        """ Write the translation file back to the filesystem. """
-
-        # If we are keeping obsolete messages then add them to the updated
-        # message elements list.
-        for name, message_els in self._contexts.items():
-            updated_message_els = None
-
-            for message_el in message_els:
-                source = self.pretty(message_el.find('source').text)
-
-                translation_el = message_el.find('translation')
-                if translation_el is not None and translation_el.text:
-                    if self._no_obsolete:
-                        self.progress("Discarded obsolete message '{0}'".format(source))
-                        self._nr_discarded_obsolete += 1
-                    else:
-                        translation_el.set('type', 'vanished')
-
-                        if updated_message_els is None:
-                            updated_message_els = self._get_updated_message_els(name)
-
-                        self._add_message_el(message_el, updated_message_els)
-
-                        self.progress("Kept obsolete message '{0}'".format(source))
-                        self._nr_kept_obsolete += 1
-                else:
-                    self.progress("Discarded untranslated message '{0}'".format(source))
-                    self._nr_discarded_untranslated += 1
-
-        # Created the sorted context elements.
-        for name in sorted(self._updated_contexts.keys()):
-            context_el = ElementTree.Element('context')
-
-            name_el = ElementTree.Element('name')
-            name_el.text = name
-            context_el.append(name_el)
-
-            context_el.extend(self._updated_contexts[name])
-
-            self._root.append(context_el)
-
-        self.progress("Writing {0}...".format(self._ts_file))
-        with open(self._ts_file, 'w', encoding='utf-8', newline='\n') as f:
-            f.write('<?xml version="1.0" encoding="utf-8"?>\n')
-            f.write('<!DOCTYPE TS>\n')
-
-            # Python v3.9 and later.
-            if hasattr(ElementTree, 'indent'):
-                ElementTree.indent(self._root)
-
-            ElementTree.ElementTree(self._root).write(f, encoding='unicode')
-            f.write('\n')
-
-        if not self._no_summary:
-            self._summary()
-
-    @staticmethod
-    def _add_message_el(message_el, updated_message_els):
-        """ Add a message element to a list of updated message elements. """
-
-        # Remove all the location elements.
-        for location_el in message_el.findall('location'):
-            message_el.remove(location_el)
-
-        # Add the message to the updated list.
-        updated_message_els.append(message_el)
-
-    @classmethod
-    def _find_message(cls, message, message_els):
-        """ Return the message element for a message from a list. """
-
-        for message_el in message_els:
-            source = ''
-            comment = ''
-            extra_comment = ''
-            extras = []
-
-            # Extract the data from the element.
-            for el in message_el:
-                if el.tag == 'source':
-                    source = el.text
-                elif el.tag == 'comment':
-                    comment = el.text
-                elif el.tag == 'extracomment':
-                    extra_comment = el.text
-                elif el.tag.startswith('extra-'):
-                    extras.append([el.tag[6:], el.text])
-
-            # Compare with the message.
-            if source != message.source:
-                continue
-
-            if comment != message.comment:
-                continue
-
-            if extra_comment != cls._get_message_extra_comments(message):
-                continue
-
-            if extras != message.embedded_comments.extras:
-                continue
-
-            return message_el
-
-        return None
-
-    @staticmethod
-    def _get_message_extra_comments(message):
-        """ Return a message's extra comments as they appear in a .ts file. """
-
-        return ' '.join(message.embedded_comments.extra_comments)
-
-    def _get_updated_message_els(self, name):
-        """ Return the list of updated message elements for a context. """
-
-        try:
-            updated_message_els = self._updated_contexts[name]
-        except KeyError:
-            updated_message_els = []
-            self._updated_contexts[name] = updated_message_els
-
-        return updated_message_els
-
-    def _make_location_el(self, message):
-        """ Return a 'location' element. """
-
-        return ElementTree.Element(
-            'location',
-            filename=os.path.relpath(
-                message.filename, start=os.path.dirname(os.path.abspath(self._ts_file))
-            ),
-            line=str(message.line_nr)
-        )
-
-    def _make_message_el(self, message):
-        """ Return a 'message' element. """
-
-        attrs = {}
-
-        if message.embedded_comments.message_id:
-            attrs['id'] = message.embedded_comments.message_id
-
-        if message.numerus:
-            attrs['numerus'] = 'yes'
-
-        message_el = ElementTree.Element('message', attrs)
-
-        source_el = ElementTree.Element('source')
-        source_el.text = message.source
-        message_el.append(source_el)
-
-        if message.comment:
-            comment_el = ElementTree.Element('comment')
-            comment_el.text = message.comment
-            message_el.append(comment_el)
-
-        if message.embedded_comments.extra_comments:
-            extracomment_el = ElementTree.Element('extracomment')
-            extracomment_el.text = self._get_message_extra_comments(message)
-            message_el.append(extracomment_el)
-
-        translation_el = ElementTree.Element('translation', type='unfinished')
-
-        # Try and find another message with the same source and use its
-        # translation if it has one.
-        translation = self._translations.get(message.source)
-        if translation:
-            translation_el.text = translation
-
-            self.progress("Reused existing translation for '{0}'".format(
-                self.pretty(message.source))
-            )
-            self._nr_new_using_existing_translation += 1
-
-        if message.numerus:
-            translation_el.append(ElementTree.Element('numerusform'))
-
-        message_el.append(translation_el)
-
-        for field, value in message.embedded_comments.extras:
-            el = ElementTree.Element('extra-' + field)
-            el.text = value
-            message_el.append(el)
-
-        self._new_message_els.append(message_el)
-
-        return message_el
-
-    def _summary(self):
-        """ Display the summary of changes to the user. """
-
-        summary_lines = []
-
-        # Display a line of the summary and the heading if not already done.
-        def summary(line):
-            nonlocal summary_lines
-
-            if not summary_lines:
-                summary_lines.append("Summary of changes to {ts}:".format(ts=self._ts_file))
-
-            summary_lines.append("    " + line)
-
-        if self._nr_new:
-            if self._nr_new_duplicates:
-                summary("{0} new messages were added (and {1} duplicates)".format(
-                        self._nr_new, self._nr_new_duplicates))
-            else:
-                summary("{0} new messages were added".format(self._nr_new))
-
-        if self._nr_new_using_existing_translation:
-            summary("{0} messages reused existing translations".format(
-                    self._nr_new_using_existing_translation))
-
-        if self._nr_existing:
-            summary("{0} existing messages were found".format(
-                    self._nr_existing))
-
-        if self._nr_kept_obsolete:
-            summary("{0} obsolete messages were kept".format(
-                    self._nr_kept_obsolete))
-
-        if self._nr_discarded_obsolete:
-            summary("{0} obsolete messages were discarded".format(
-                    self._nr_discarded_obsolete))
-
-        if self._nr_discarded_untranslated:
-            summary("{0} untranslated messages were discarded".format(
-                    self._nr_discarded_untranslated))
-
-        if not summary_lines:
-            summary_lines.append("{ts} was unchanged".format(ts=self._ts_file))
-
-        print(os.linesep.join(summary_lines))
-
-
-# The XML of an empty .ts file.  This is what a current lupdate will create
-# with an empty C++ source file.
-_EMPTY_TS = '''<TS version="2.1">
-</TS>
-'''

i18n/pylupdate6/translations.py

@@ -1,51 +0,0 @@
-# Copyright (c) 2021 Riverbank Computing Limited <info@riverbankcomputing.com>
-#
-# This file is part of PyQt6.
-#
-# This file may be used under the terms of the GNU General Public License
-# version 3.0 as published by the Free Software Foundation and appearing in
-# the file LICENSE included in the packaging of this file.  Please review the
-# following information to ensure the GNU General Public License version 3.0
-# requirements will be met: http://www.gnu.org/copyleft/gpl.html.
-#
-# If you do not wish to use this file under the terms of the GPL version 3.0
-# then you may purchase a commercial license.  For more information contact
-# info@riverbankcomputing.com.
-#
-# This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-# WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-
-
-class Context:
-    """ Encapsulate a message context. """
-
-    def __init__(self, name):
-        """ Initialise the context. """
-
-        self.name = name
-        self.messages = []
-
-
-class EmbeddedComments:
-    """ Encapsulate information for a translator embedded in comments. """
-
-    def __init__(self):
-        """ Initialise the object. """
-
-        self.message_id = ''
-        self.extra_comments = []
-        self.extras = []
-
-
-class Message:
-    """ Encapsulate a message. """
-
-    def __init__(self, filename, line_nr, source, comment, numerus):
-        """ Initialise the message. """
-
-        self.filename = filename
-        self.line_nr = line_nr
-        self.source = source
-        self.comment = comment
-        self.numerus = numerus
-        self.embedded_comments = EmbeddedComments()

i18n/pylupdate6/user.py

@@ -1,47 +0,0 @@
-# Copyright (c) 2021 Riverbank Computing Limited <info@riverbankcomputing.com>
-#
-# This file is part of PyQt6.
-#
-# This file may be used under the terms of the GNU General Public License
-# version 3.0 as published by the Free Software Foundation and appearing in
-# the file LICENSE included in the packaging of this file.  Please review the
-# following information to ensure the GNU General Public License version 3.0
-# requirements will be met: http://www.gnu.org/copyleft/gpl.html.
-#
-# If you do not wish to use this file under the terms of the GPL version 3.0
-# then you may purchase a commercial license.  For more information contact
-# info@riverbankcomputing.com.
-#
-# This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-# WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-
-
-class UserException(Exception):
-    """ Encapsulate an exception ultimate caused by the user. """
-
-    pass
-
-
-class User:
-    """ A mixin that provides methods for communicating with the user. """
-
-    def __init__(self, verbose, **kwargs):
-        """ Initialise the object. """
-
-        super().__init__(**kwargs)
-
-        self._verbose = verbose
-
-    @staticmethod
-    def pretty(text):
-        """ Returns a pretty-fied version of some text suitable for displaying
-        to the user.
-        """
-
-        return text.replace('\n', '\\n')
-
-    def progress(self, message):
-        """ Display a progress message. """
-
-        if self._verbose:
-            print(message)

novelwriter/__init__.py

@@ -1,7 +1,6 @@
 """
 novelWriter – Init File
 =======================
-Application initialisation
 
 File History:
 Created: 2018-09-22 [0.0.1]
@@ -22,6 +21,7 @@ General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with this program. If not, see <https://www.gnu.org/licenses/>.
 """
+from __future__ import annotations
 
 import sys
 import getopt
@@ -31,6 +31,7 @@ from PyQt5.QtWidgets import QApplication, QErrorMessage
 
 from novelwriter.error import exceptionHandler, logException
 from novelwriter.config import Config
+from novelwriter.shared import SharedData
 
 ##
 #  Version Scheme
@@ -40,7 +41,7 @@ from novelwriter.config import Config
 #  - Digit 1,2 : Major Version (01-ff)
 #  - Digit 3,4 : Minor Version (01-ff)
 #  - Digit 5,6 : Patch Version (01-ff)
-#  - Digit 7   : Release Type (a: aplha, b: beta, c: candidate, f: final)
+#  - Digit 7   : Release Type (a: alpha, b: beta, c: candidate, f: final)
 #  - Digit 8   : Release Number (0-f)
 #
 #  Example    : Full        Short   Description
@@ -59,17 +60,11 @@ __license__    = "GPLv3"
 __author__     = "Veronica Berglyd Olsen"
 __maintainer__ = "Veronica Berglyd Olsen"
 __email__      = "code@vkbo.net"
-__version__    = "2.0.7"
-__hexversion__ = "0x020007f0"
-__date__       = "2023-04-16"
+__version__    = "2.1"
+__hexversion__ = "0x020100f0"
+__date__       = "2023-10-17"
 __status__     = "Stable"
 __domain__     = "novelwriter.io"
-__url__        = "https://novelwriter.io"
-__docurl__     = "https://docs.novelwriter.io/"
-__sourceurl__  = "https://github.com/vkbo/novelWriter"
-__issuesurl__  = "https://github.com/vkbo/novelWriter/issues"
-__helpurl__    = "https://github.com/vkbo/novelWriter/discussions"
-__releaseurl__ = "https://github.com/vkbo/novelWriter/releases/latest"
 
 logger = logging.getLogger(__name__)
 
@@ -78,13 +73,13 @@ logger = logging.getLogger(__name__)
 #  Main Program
 ##
 
-# Load the main config as a global object
+# Global config singleton
 CONFIG = Config()
+SHARED = SharedData()
 
 
-def main(sysArgs=None):
-    """Parse command line, set up logging, and launch main GUI.
-    """
+def main(sysArgs: list | None = None):
+    """Parse command line, set up logging, and launch main GUI."""
     if sysArgs is None:
         sysArgs = sys.argv[1:]
 
@@ -161,22 +156,23 @@ def main(sysArgs=None):
         elif inOpt == "--testmode":
             testMode = True
 
-    # Set Logging
-    cHandle = logging.StreamHandler()
-    cHandle.setFormatter(logging.Formatter(fmt=logFormat, style="{"))
-
+    # Setup Logging
     pkgLogger = logging.getLogger(__package__)
-    pkgLogger.addHandler(cHandle)
     pkgLogger.setLevel(logLevel)
+    if len(pkgLogger.handlers) == 0:
+        # Make sure we only create one logger (mostly an issue with tests)
+        cHandle = logging.StreamHandler()
+        cHandle.setFormatter(logging.Formatter(fmt=logFormat, style="{"))
+        pkgLogger.addHandler(cHandle)
 
     logger.info("Starting novelWriter %s (%s) %s", __version__, __hexversion__, __date__)
 
     # Check Packages and Versions
     errorData = []
     errorCode = 0
-    if sys.hexversion < 0x030700f0:
+    if sys.hexversion < 0x030800f0:
         errorData.append(
-            "At least Python 3.7 is required, found %s" % CONFIG.verPyString
+            "At least Python 3.8 is required, found %s" % CONFIG.verPyString
         )
         errorCode |= 0x04
     if CONFIG.verQtValue < 0x050a00:
@@ -190,18 +186,12 @@ def main(sysArgs=None):
         )
         errorCode |= 0x10
 
-    try:
-        import lxml  # noqa: F401
-    except ImportError:
-        errorData.append("Python module 'lxml' is missing")
-        errorCode |= 0x20
-
     if errorData:
         errApp = QApplication([])
         errDlg = QErrorMessage()
         errDlg.resize(500, 300)
         errDlg.showMessage((
-            "<h3>A critical error has been encountered</h3>"
+            "<h3>A critical error was encountered</h3>"
             "<p>novelWriter cannot start due to the following issues:<p>"
             "<p>&nbsp;-&nbsp;%s</p>"
             "<p>Shutting down ...</p>"
@@ -252,8 +242,11 @@ def main(sysArgs=None):
         # Connect the exception handler before making the main GUI
         sys.excepthook = exceptionHandler
 
-        # Launch main GUI
+        # Run Config steps that require the QApplication
         CONFIG.initLocalisation(nwApp)
+        CONFIG.setTextFont(CONFIG.textFont, CONFIG.textSize)  # Makes sure these are valid
+
+        # Launch main GUI
         nwGUI = GuiMain()
         nwGUI.postLaunchTasks(cmdOpen)
 

novelwriter/assets/icons/typicons_dark/icons.conf

@@ -17,8 +17,16 @@ licenseurl  = https://creativecommons.org/licenses/by-sa/4.0/
 
 [Map]
 add             = typ_plus.svg
+alert_error     = typ_delete-full.svg
+alert_info      = typ_lightbulb-full.svg
+alert_question  = typ_directions-full.svg
+alert_warn      = typ_warning-full.svg
 backward        = typ_chevron-left.svg
 bookmark        = typ_bookmark.svg
+browse          = typ_folder-open.svg
+build_excluded  = typ_cancel.svg
+build_filtered  = typ_arrow-forward.svg
+build_included  = typ_pin.svg
 bullet-off      = typ_media-record-outline.svg
 bullet-on       = typ_media-record.svg
 checked         = mixed_input-checked.svg
@@ -37,6 +45,7 @@ cls_world       = typ_location.svg
 cross           = typ_times.svg
 down            = typ_chevron-down.svg
 edit            = typ_pencil.svg
+export          = typ_export.svg
 forward         = typ_chevron-right.svg
 maximise        = typ_arrow-maximise.svg
 menu            = typ_th-menu.svg
@@ -54,6 +63,7 @@ proj_title      = mixed_document-title.svg
 reference       = typ_at.svg
 refresh         = typ_refresh.svg
 remove          = typ_minus.svg
+revert          = typ_refresh-flipped.svg
 search          = typ_search.svg
 search_cancel   = typ_cancel-grey.svg
 search_case     = nw_search-case.svg
@@ -73,7 +83,7 @@ sticky-off      = typ_pin-outline.svg
 sticky-on       = typ_pin.svg
 unchecked       = mixed_input-unchecked.svg
 up              = typ_chevron-up.svg
-view_build      = typ_export.svg
+view_build      = typ_export-grey.svg
 view_editor     = mixed_edit.svg
 view_novel      = typ_book-grey.svg
 view_outline    = typ_puzzle-outline.svg

novelwriter/assets/icons/typicons_dark/mixed_document-chapter.svg

@@ -1,47 +1,12 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   version="1.2"
-   width="24"
-   height="24"
-   viewBox="0 0 24 24"
-   id="svg2161">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <path
-     id="rect12986"
-     style="display:inline;opacity:0.95;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.88635;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 19.333984 C 4.6660156 20.007428 5.2152275 20.554687 5.8886719 20.554688 L 18.111328 20.554688 C 18.784774 20.554688 19.333984 20.007428 19.333984 19.333984 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="rect935"
-     style="fill:#d64848;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 6 L 4.6660156 7.1894531 L 4.6660156 10.058594 L 19.333984 10.058594 L 19.333984 7.1894531 L 19.333984 6 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="path2157"
-     style="display:inline;fill:#595959;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281,13.222656 C 6.7739949,13.222656 6.5,13.49665 6.5,13.833984 c 0,0.337332 0.2739949,0.611328 0.6113281,0.611328 h 9.7773439 c 0.337334,1e-6 0.611328,-0.273996 0.611328,-0.611328 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z m 0,3.666016 C 6.7739949,16.888672 6.5,17.162666 6.5,17.5 c 0,0.337334 0.2739949,0.611328 0.6113281,0.611328 H 16.888672 C 17.226006,18.111328 17.5,17.837334 17.5,17.5 c 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z" />
-  <path
-     id="path902"
-     style="display:inline;fill:#848484;fill-opacity:1;stroke-width:1.22222"
-     d="M 5.8886719,1 C 3.8671165,1 2.2226562,2.6444602 2.2226562,4.6660156 V 19.333984 C 2.2226563,21.355538 3.8671165,23 5.8886719,23 H 18.111328 c 2.021556,0 3.666016,-1.644462 3.666016,-3.666016 V 4.6660156 C 21.777344,2.6444602 20.132884,1 18.111328,1 Z m 0,2.4453125 H 18.111328 c 0.673446,0 1.222656,0.5472587 1.222656,1.2207031 V 19.333984 c 0,0.673444 -0.54921,1.220704 -1.222656,1.220704 H 5.8886719 c -0.6734444,-10e-7 -1.2226563,-0.54726 -1.2226563,-1.220704 V 4.6660156 c 0,-0.6734444 0.5492119,-1.2207031 1.2226563,-1.2207031 z" />
-  <path
-     id="path2157-0"
-     style="display:inline;fill:#ffffff;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281 5.8886719 C 6.7739949 5.8886719 6.5 6.1626667 6.5 6.5 C 6.5 6.837334 6.7739949 7.1113281 7.1113281 7.1113281 L 16.888672 7.1113281 C 17.226006 7.1113281 17.5 6.837334 17.5 6.5 C 17.5 6.1626667 17.226006 5.8886719 16.888672 5.8886719 L 7.1113281 5.8886719 z " />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <g>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v14.668c0 0.67344 0.54921 1.2207 1.2227 1.2207h12.223c0.67345 0 1.2227-0.54726 1.2227-1.2207v-14.668c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#fff" opacity=".95"/>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v1.334 1.1895 2.8691h14.668v-2.8691-1.1895-1.334c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#d64848" stroke-width="0"/>
+  <g stroke-width="1.2222">
+   <path d="m7.1113 13.223c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 1e-6 0.61133-0.274 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133zm0 3.666c-0.33733 0-0.61133 0.27399-0.61133 0.61133s0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133s-0.27399-0.61133-0.61133-0.61133z" fill="#595959"/>
+   <path d="m5.8887 1c-2.0216 0-3.666 1.6445-3.666 3.666v14.668c1e-7 2.0216 1.6445 3.666 3.666 3.666h12.223c2.0216 0 3.666-1.6445 3.666-3.666v-14.668c0-2.0216-1.6445-3.666-3.666-3.666zm0 2.4453h12.223c0.67345 0 1.2227 0.54726 1.2227 1.2207v14.668c0 0.67344-0.54921 1.2207-1.2227 1.2207h-12.223c-0.67344-1e-6 -1.2227-0.54726-1.2227-1.2207v-14.668c0-0.67344 0.54921-1.2207 1.2227-1.2207z" fill="#848484"/>
+   <path d="m7.1113 5.8887c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133h-9.7773z" fill="#fff"/>
+  </g>
+ </g>
 </svg>

novelwriter/assets/icons/typicons_dark/mixed_document-note.svg

@@ -1,47 +1,12 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   version="1.2"
-   width="24"
-   height="24"
-   viewBox="0 0 24 24"
-   id="svg2161">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <path
-     id="rect12986"
-     style="display:inline;opacity:0.95;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.88635;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 19.333984 C 4.6660156 20.007428 5.2152275 20.554687 5.8886719 20.554688 L 18.111328 20.554688 C 18.784774 20.554688 19.333984 20.007428 19.333984 19.333984 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="rect935"
-     style="fill:#ffff84;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 6 L 4.6660156 7.1894531 L 4.6660156 10.058594 L 19.333984 10.058594 L 19.333984 7.1894531 L 19.333984 6 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="path2157"
-     style="display:inline;fill:#595959;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281,13.222656 C 6.7739949,13.222656 6.5,13.49665 6.5,13.833984 c 0,0.337332 0.2739949,0.611328 0.6113281,0.611328 h 9.7773439 c 0.337334,1e-6 0.611328,-0.273996 0.611328,-0.611328 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z m 0,3.666016 C 6.7739949,16.888672 6.5,17.162666 6.5,17.5 c 0,0.337334 0.2739949,0.611328 0.6113281,0.611328 H 16.888672 C 17.226006,18.111328 17.5,17.837334 17.5,17.5 c 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z" />
-  <path
-     id="path902"
-     style="display:inline;fill:#848484;fill-opacity:1;stroke-width:1.22222"
-     d="M 5.8886719,1 C 3.8671165,1 2.2226562,2.6444602 2.2226562,4.6660156 V 19.333984 C 2.2226563,21.355538 3.8671165,23 5.8886719,23 H 18.111328 c 2.021556,0 3.666016,-1.644462 3.666016,-3.666016 V 4.6660156 C 21.777344,2.6444602 20.132884,1 18.111328,1 Z m 0,2.4453125 H 18.111328 c 0.673446,0 1.222656,0.5472587 1.222656,1.2207031 V 19.333984 c 0,0.673444 -0.54921,1.220704 -1.222656,1.220704 H 5.8886719 c -0.6734444,-10e-7 -1.2226563,-0.54726 -1.2226563,-1.220704 V 4.6660156 c 0,-0.6734444 0.5492119,-1.2207031 1.2226563,-1.2207031 z" />
-  <path
-     id="path2157-0"
-     style="display:inline;fill:#ffffff;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281 5.8886719 C 6.7739949 5.8886719 6.5 6.1626667 6.5 6.5 C 6.5 6.837334 6.7739949 7.1113281 7.1113281 7.1113281 L 16.888672 7.1113281 C 17.226006 7.1113281 17.5 6.837334 17.5 6.5 C 17.5 6.1626667 17.226006 5.8886719 16.888672 5.8886719 L 7.1113281 5.8886719 z " />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <g>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v14.668c0 0.67344 0.54921 1.2207 1.2227 1.2207h12.223c0.67345 0 1.2227-0.54726 1.2227-1.2207v-14.668c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#fff" opacity=".95"/>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v1.334 1.1895 2.8691h14.668v-2.8691-1.1895-1.334c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#ffff84" stroke-width="0"/>
+  <g stroke-width="1.2222">
+   <path d="m7.1113 13.223c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 1e-6 0.61133-0.274 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133zm0 3.666c-0.33733 0-0.61133 0.27399-0.61133 0.61133s0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133s-0.27399-0.61133-0.61133-0.61133z" fill="#595959"/>
+   <path d="m5.8887 1c-2.0216 0-3.666 1.6445-3.666 3.666v14.668c1e-7 2.0216 1.6445 3.666 3.666 3.666h12.223c2.0216 0 3.666-1.6445 3.666-3.666v-14.668c0-2.0216-1.6445-3.666-3.666-3.666zm0 2.4453h12.223c0.67345 0 1.2227 0.54726 1.2227 1.2207v14.668c0 0.67344-0.54921 1.2207-1.2227 1.2207h-12.223c-0.67344-1e-6 -1.2227-0.54726-1.2227-1.2207v-14.668c0-0.67344 0.54921-1.2207 1.2227-1.2207z" fill="#848484"/>
+   <path d="m7.1113 5.8887c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133h-9.7773z" fill="#fff"/>
+  </g>
+ </g>
 </svg>

novelwriter/assets/icons/typicons_dark/mixed_document-scene.svg

@@ -1,47 +1,12 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   version="1.2"
-   width="24"
-   height="24"
-   viewBox="0 0 24 24"
-   id="svg2161">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <path
-     id="rect12986"
-     style="display:inline;opacity:0.95;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.88635;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 19.333984 C 4.6660156 20.007428 5.2152275 20.554687 5.8886719 20.554688 L 18.111328 20.554688 C 18.784774 20.554688 19.333984 20.007428 19.333984 19.333984 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="rect935"
-     style="fill:#6699cc;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 6 L 4.6660156 7.1894531 L 4.6660156 10.058594 L 19.333984 10.058594 L 19.333984 7.1894531 L 19.333984 6 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="path2157"
-     style="display:inline;fill:#595959;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281,13.222656 C 6.7739949,13.222656 6.5,13.49665 6.5,13.833984 c 0,0.337332 0.2739949,0.611328 0.6113281,0.611328 h 9.7773439 c 0.337334,1e-6 0.611328,-0.273996 0.611328,-0.611328 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z m 0,3.666016 C 6.7739949,16.888672 6.5,17.162666 6.5,17.5 c 0,0.337334 0.2739949,0.611328 0.6113281,0.611328 H 16.888672 C 17.226006,18.111328 17.5,17.837334 17.5,17.5 c 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z" />
-  <path
-     id="path902"
-     style="display:inline;fill:#848484;fill-opacity:1;stroke-width:1.22222"
-     d="M 5.8886719,1 C 3.8671165,1 2.2226562,2.6444602 2.2226562,4.6660156 V 19.333984 C 2.2226563,21.355538 3.8671165,23 5.8886719,23 H 18.111328 c 2.021556,0 3.666016,-1.644462 3.666016,-3.666016 V 4.6660156 C 21.777344,2.6444602 20.132884,1 18.111328,1 Z m 0,2.4453125 H 18.111328 c 0.673446,0 1.222656,0.5472587 1.222656,1.2207031 V 19.333984 c 0,0.673444 -0.54921,1.220704 -1.222656,1.220704 H 5.8886719 c -0.6734444,-10e-7 -1.2226563,-0.54726 -1.2226563,-1.220704 V 4.6660156 c 0,-0.6734444 0.5492119,-1.2207031 1.2226563,-1.2207031 z" />
-  <path
-     id="path2157-0"
-     style="display:inline;fill:#ffffff;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281 5.8886719 C 6.7739949 5.8886719 6.5 6.1626667 6.5 6.5 C 6.5 6.837334 6.7739949 7.1113281 7.1113281 7.1113281 L 16.888672 7.1113281 C 17.226006 7.1113281 17.5 6.837334 17.5 6.5 C 17.5 6.1626667 17.226006 5.8886719 16.888672 5.8886719 L 7.1113281 5.8886719 z " />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <g>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v14.668c0 0.67344 0.54921 1.2207 1.2227 1.2207h12.223c0.67345 0 1.2227-0.54726 1.2227-1.2207v-14.668c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#fff" opacity=".95"/>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v1.334 1.1895 2.8691h14.668v-2.8691-1.1895-1.334c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#69c" stroke-width="0"/>
+  <g stroke-width="1.2222">
+   <path d="m7.1113 13.223c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 1e-6 0.61133-0.274 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133zm0 3.666c-0.33733 0-0.61133 0.27399-0.61133 0.61133s0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133s-0.27399-0.61133-0.61133-0.61133z" fill="#595959"/>
+   <path d="m5.8887 1c-2.0216 0-3.666 1.6445-3.666 3.666v14.668c1e-7 2.0216 1.6445 3.666 3.666 3.666h12.223c2.0216 0 3.666-1.6445 3.666-3.666v-14.668c0-2.0216-1.6445-3.666-3.666-3.666zm0 2.4453h12.223c0.67345 0 1.2227 0.54726 1.2227 1.2207v14.668c0 0.67344-0.54921 1.2207-1.2227 1.2207h-12.223c-0.67344-1e-6 -1.2227-0.54726-1.2227-1.2207v-14.668c0-0.67344 0.54921-1.2207 1.2227-1.2207z" fill="#848484"/>
+   <path d="m7.1113 5.8887c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133h-9.7773z" fill="#fff"/>
+  </g>
+ </g>
 </svg>

novelwriter/assets/icons/typicons_dark/mixed_document-section.svg

@@ -1,47 +1,12 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   version="1.2"
-   width="24"
-   height="24"
-   viewBox="0 0 24 24"
-   id="svg2161">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <path
-     id="rect12986"
-     style="display:inline;opacity:0.95;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.88635;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 19.333984 C 4.6660156 20.007428 5.2152275 20.554687 5.8886719 20.554688 L 18.111328 20.554688 C 18.784774 20.554688 19.333984 20.007428 19.333984 19.333984 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="rect935"
-     style="fill:#999999;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 6 L 4.6660156 7.1894531 L 4.6660156 10.058594 L 19.333984 10.058594 L 19.333984 7.1894531 L 19.333984 6 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="path2157"
-     style="display:inline;fill:#595959;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281,13.222656 C 6.7739949,13.222656 6.5,13.49665 6.5,13.833984 c 0,0.337332 0.2739949,0.611328 0.6113281,0.611328 h 9.7773439 c 0.337334,1e-6 0.611328,-0.273996 0.611328,-0.611328 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z m 0,3.666016 C 6.7739949,16.888672 6.5,17.162666 6.5,17.5 c 0,0.337334 0.2739949,0.611328 0.6113281,0.611328 H 16.888672 C 17.226006,18.111328 17.5,17.837334 17.5,17.5 c 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z" />
-  <path
-     id="path902"
-     style="display:inline;fill:#848484;fill-opacity:1;stroke-width:1.22222"
-     d="M 5.8886719,1 C 3.8671165,1 2.2226562,2.6444602 2.2226562,4.6660156 V 19.333984 C 2.2226563,21.355538 3.8671165,23 5.8886719,23 H 18.111328 c 2.021556,0 3.666016,-1.644462 3.666016,-3.666016 V 4.6660156 C 21.777344,2.6444602 20.132884,1 18.111328,1 Z m 0,2.4453125 H 18.111328 c 0.673446,0 1.222656,0.5472587 1.222656,1.2207031 V 19.333984 c 0,0.673444 -0.54921,1.220704 -1.222656,1.220704 H 5.8886719 c -0.6734444,-10e-7 -1.2226563,-0.54726 -1.2226563,-1.220704 V 4.6660156 c 0,-0.6734444 0.5492119,-1.2207031 1.2226563,-1.2207031 z" />
-  <path
-     id="path2157-0"
-     style="display:inline;fill:#ffffff;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281 5.8886719 C 6.7739949 5.8886719 6.5 6.1626667 6.5 6.5 C 6.5 6.837334 6.7739949 7.1113281 7.1113281 7.1113281 L 16.888672 7.1113281 C 17.226006 7.1113281 17.5 6.837334 17.5 6.5 C 17.5 6.1626667 17.226006 5.8886719 16.888672 5.8886719 L 7.1113281 5.8886719 z " />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <g>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v14.668c0 0.67344 0.54921 1.2207 1.2227 1.2207h12.223c0.67345 0 1.2227-0.54726 1.2227-1.2207v-14.668c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#fff" opacity=".95"/>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v1.334 1.1895 2.8691h14.668v-2.8691-1.1895-1.334c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#999" stroke-width="0"/>
+  <g stroke-width="1.2222">
+   <path d="m7.1113 13.223c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 1e-6 0.61133-0.274 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133zm0 3.666c-0.33733 0-0.61133 0.27399-0.61133 0.61133s0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133s-0.27399-0.61133-0.61133-0.61133z" fill="#595959"/>
+   <path d="m5.8887 1c-2.0216 0-3.666 1.6445-3.666 3.666v14.668c1e-7 2.0216 1.6445 3.666 3.666 3.666h12.223c2.0216 0 3.666-1.6445 3.666-3.666v-14.668c0-2.0216-1.6445-3.666-3.666-3.666zm0 2.4453h12.223c0.67345 0 1.2227 0.54726 1.2227 1.2207v14.668c0 0.67344-0.54921 1.2207-1.2227 1.2207h-12.223c-0.67344-1e-6 -1.2227-0.54726-1.2227-1.2207v-14.668c0-0.67344 0.54921-1.2207 1.2227-1.2207z" fill="#848484"/>
+   <path d="m7.1113 5.8887c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133h-9.7773z" fill="#fff"/>
+  </g>
+ </g>
 </svg>

novelwriter/assets/icons/typicons_dark/mixed_document-title.svg

@@ -1,47 +1,12 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   version="1.2"
-   width="24"
-   height="24"
-   viewBox="0 0 24 24"
-   id="svg2161">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <path
-     id="rect12986"
-     style="display:inline;opacity:0.95;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.88635;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 19.333984 C 4.6660156 20.007428 5.2152275 20.554687 5.8886719 20.554688 L 18.111328 20.554688 C 18.784774 20.554688 19.333984 20.007428 19.333984 19.333984 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="rect935"
-     style="fill:#99cc99;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     d="M 5.8886719 3.4453125 C 5.2152275 3.4453125 4.6660156 3.9925712 4.6660156 4.6660156 L 4.6660156 6 L 4.6660156 7.1894531 L 4.6660156 10.058594 L 19.333984 10.058594 L 19.333984 7.1894531 L 19.333984 6 L 19.333984 4.6660156 C 19.333984 3.9925712 18.784774 3.4453125 18.111328 3.4453125 L 5.8886719 3.4453125 z " />
-  <path
-     id="path2157"
-     style="display:inline;fill:#595959;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281,13.222656 C 6.7739949,13.222656 6.5,13.49665 6.5,13.833984 c 0,0.337332 0.2739949,0.611328 0.6113281,0.611328 h 9.7773439 c 0.337334,1e-6 0.611328,-0.273996 0.611328,-0.611328 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z m 0,3.666016 C 6.7739949,16.888672 6.5,17.162666 6.5,17.5 c 0,0.337334 0.2739949,0.611328 0.6113281,0.611328 H 16.888672 C 17.226006,18.111328 17.5,17.837334 17.5,17.5 c 0,-0.337334 -0.273994,-0.611328 -0.611328,-0.611328 z" />
-  <path
-     id="path902"
-     style="display:inline;fill:#848484;fill-opacity:1;stroke-width:1.22222"
-     d="M 5.8886719,1 C 3.8671165,1 2.2226562,2.6444602 2.2226562,4.6660156 V 19.333984 C 2.2226563,21.355538 3.8671165,23 5.8886719,23 H 18.111328 c 2.021556,0 3.666016,-1.644462 3.666016,-3.666016 V 4.6660156 C 21.777344,2.6444602 20.132884,1 18.111328,1 Z m 0,2.4453125 H 18.111328 c 0.673446,0 1.222656,0.5472587 1.222656,1.2207031 V 19.333984 c 0,0.673444 -0.54921,1.220704 -1.222656,1.220704 H 5.8886719 c -0.6734444,-10e-7 -1.2226563,-0.54726 -1.2226563,-1.220704 V 4.6660156 c 0,-0.6734444 0.5492119,-1.2207031 1.2226563,-1.2207031 z" />
-  <path
-     id="path2157-0"
-     style="display:inline;fill:#ffffff;fill-opacity:1;stroke-width:1.22222"
-     d="M 7.1113281 5.8886719 C 6.7739949 5.8886719 6.5 6.1626667 6.5 6.5 C 6.5 6.837334 6.7739949 7.1113281 7.1113281 7.1113281 L 16.888672 7.1113281 C 17.226006 7.1113281 17.5 6.837334 17.5 6.5 C 17.5 6.1626667 17.226006 5.8886719 16.888672 5.8886719 L 7.1113281 5.8886719 z " />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <g>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v14.668c0 0.67344 0.54921 1.2207 1.2227 1.2207h12.223c0.67345 0 1.2227-0.54726 1.2227-1.2207v-14.668c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#fff" opacity=".95"/>
+  <path d="m5.8887 3.4453c-0.67344 0-1.2227 0.54726-1.2227 1.2207v1.334 1.1895 2.8691h14.668v-2.8691-1.1895-1.334c0-0.67344-0.54921-1.2207-1.2227-1.2207h-12.223z" fill="#9c9" stroke-width="0"/>
+  <g stroke-width="1.2222">
+   <path d="m7.1113 13.223c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 1e-6 0.61133-0.274 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133zm0 3.666c-0.33733 0-0.61133 0.27399-0.61133 0.61133s0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133s-0.27399-0.61133-0.61133-0.61133z" fill="#595959"/>
+   <path d="m5.8887 1c-2.0216 0-3.666 1.6445-3.666 3.666v14.668c1e-7 2.0216 1.6445 3.666 3.666 3.666h12.223c2.0216 0 3.666-1.6445 3.666-3.666v-14.668c0-2.0216-1.6445-3.666-3.666-3.666zm0 2.4453h12.223c0.67345 0 1.2227 0.54726 1.2227 1.2207v14.668c0 0.67344-0.54921 1.2207-1.2227 1.2207h-12.223c-0.67344-1e-6 -1.2227-0.54726-1.2227-1.2207v-14.668c0-0.67344 0.54921-1.2207 1.2227-1.2207z" fill="#848484"/>
+   <path d="m7.1113 5.8887c-0.33733 0-0.61133 0.27399-0.61133 0.61133 0 0.33733 0.27399 0.61133 0.61133 0.61133h9.7773c0.33733 0 0.61133-0.27399 0.61133-0.61133 0-0.33733-0.27399-0.61133-0.61133-0.61133h-9.7773z" fill="#fff"/>
+  </g>
+ </g>
 </svg>

novelwriter/assets/icons/typicons_dark/mixed_edit.svg

@@ -1,31 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   version="1.2"
-   width="24"
-   height="24"
-   viewBox="0 0 24 24"
-   id="svg7536">
-  <metadata
-     id="metadata7542">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs7540" />
-  <path
-     id="path7534"
-     style="display:inline;fill:#aeaeae;fill-opacity:1;stroke-width:1.10527"
-     d="M 19.160156 0 C 18.73463 0 18.312122 0.160533 17.988281 0.484375 L 14.052734 4.421875 L 4.1054688 4.421875 C 3.4953635 4.421875 3 4.9141801 3 5.5253906 L 3 17.037109 L 3 18.429688 L 3 22.894531 C 3 23.505741 3.4953635 24 4.1054688 24 L 18.474609 24 C 19.084713 24 19.578125 23.505741 19.578125 22.894531 L 19.578125 18.429688 L 19.578125 17.037109 L 19.578125 9.9472656 L 23.515625 6.0117188 C 23.839466 5.6878766 24 5.2623116 24 4.8378906 C 24 4.4134695 23.839466 3.9918109 23.515625 3.6679688 L 20.332031 0.484375 C 20.008189 0.160533 19.584576 0 19.160156 0 z M 19.160156 2.4394531 L 21.560547 4.8398438 L 20.130859 6.2695312 L 17.730469 3.8691406 L 19.160156 2.4394531 z M 16.949219 4.6503906 L 19.349609 7.0507812 L 12.394531 14.005859 L 9.9941406 11.605469 L 16.949219 4.6503906 z M 5.2109375 6.6308594 L 11.841797 6.6308594 L 8.328125 10.146484 C 8.0042828 10.470327 7.7997073 11.043101 7.6328125 11.570312 C 7.4559704 12.122943 7.421875 12.737735 7.421875 13.195312 L 7.421875 16.578125 L 10.804688 16.578125 C 11.262267 16.578125 12.02928 16.467813 12.541016 16.257812 C 13.053858 16.047812 13.530778 15.874623 13.853516 15.550781 L 17.369141 12.158203 L 17.369141 17.037109 L 17.369141 18.429688 L 17.369141 21.789062 L 5.2109375 21.789062 L 5.2109375 18.429688 L 5.2109375 17.037109 L 5.2109375 6.6308594 z M 9.5644531 12.525391 L 11.505859 14.435547 L 9.6308594 14.369141 L 9.5644531 12.525391 z " />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <path d="m19.16 0c-0.42553 0-0.84803 0.16053-1.1719 0.48438l-3.9355 3.9375h-9.9473c-0.61011 0-1.1055 0.49231-1.1055 1.1035v11.512 1.3926 4.4648c0 0.61121 0.49536 1.1055 1.1055 1.1055h14.369c0.6101 0 1.1035-0.49426 1.1035-1.1055v-4.4648-1.3926-7.0898l3.9375-3.9355c0.32384-0.32384 0.48438-0.74941 0.48438-1.1738 0-0.42442-0.16053-0.84608-0.48438-1.1699l-3.1836-3.1836c-0.32384-0.32384-0.74746-0.48438-1.1719-0.48438zm0 2.4395 2.4004 2.4004-1.4297 1.4297-2.4004-2.4004 1.4297-1.4297zm-2.2109 2.2109 2.4004 2.4004-6.9551 6.9551-2.4004-2.4004 6.9551-6.9551zm-11.738 1.9805h6.6309l-3.5137 3.5156c-0.32384 0.32384-0.52842 0.89662-0.69531 1.4238-0.17684 0.55263-0.21094 1.1674-0.21094 1.625v3.3828h3.3828c0.45758 0 1.2246-0.11031 1.7363-0.32031 0.51284-0.21 0.98976-0.38319 1.3125-0.70703l3.5156-3.3926v4.8789 1.3926 3.3594h-12.158v-3.3594-1.3926-10.406zm4.3535 5.8945 1.9414 1.9102-1.875-0.066406-0.066406-1.8438z" fill="#aeaeae" stroke-width="1.1053"/>
 </svg>

novelwriter/assets/icons/typicons_dark/mixed_input-checked.svg

@@ -1,39 +1,5 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   width="24"
-   height="24"
-   version="1.2"
-   viewBox="0 0 24 24"
-   id="svg2287">
-  <defs
-     id="defs2291" />
-  <metadata
-     id="metadata2281">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <path
-     d="m17.714 22h-11.429c-2.3629 0-4.2857-1.9229-4.2857-4.2857v-11.429c0-2.3629 1.9229-4.2857 4.2857-4.2857h7.1429c0.79 0 1.4286 0.64 1.4286 1.4286 0 0.78857-0.63857 1.4286-1.4286 1.4286h-7.1429c-0.78857 0-1.4286 0.64143-1.4286 1.4286v11.429c0 0.78714 0.64 1.4286 1.4286 1.4286h11.429c0.78857 0 1.4286-0.64143 1.4286-1.4286v-4.2857c0-0.78857 0.63857-1.4286 1.4286-1.4286s1.4286 0.64 1.4286 1.4286v4.2857c0 2.3629-1.9229 4.2857-4.2857 4.2857z"
-     fill="#848484"
-     stroke-width="1.4286"
-     id="path2283" />
-  <path
-     d="m19.02 3.3503c-0.60933 0.010623-1.2003 0.31545-1.5586 0.86719l-5.0977 7.8477-2.3672-3.6445c-0.57329-0.88278-1.7442-1.1319-2.627-0.55859-0.88278 0.57329-1.1319 1.7461-0.55859 2.6289l3.9199 6.0391c0.38514 0.59307 1.0409 0.88965 1.6973 0.85352 0.03023-2.78e-4 0.05972-0.0041 0.08984-0.0059 0.0556-0.0057 0.11074-0.0088 0.16602-0.01953 0.52104-0.07621 1.0077-0.36147 1.3184-0.83984l6.6445-10.23c0.57329-0.88278 0.32419-2.0556-0.55859-2.6289-0.33104-0.21498-0.70276-0.31497-1.0684-0.30859z"
-     fill="#9c9"
-     stroke-linecap="round"
-     stroke-linejoin="round"
-     stroke-width="1.111"
-     id="path2285" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <path d="m17.714 22h-11.429c-2.3629 0-4.2857-1.9229-4.2857-4.2857v-11.429c0-2.3629 1.9229-4.2857 4.2857-4.2857h7.1429c0.79 0 1.4286 0.64 1.4286 1.4286 0 0.78857-0.63857 1.4286-1.4286 1.4286h-7.1429c-0.78857 0-1.4286 0.64143-1.4286 1.4286v11.429c0 0.78714 0.64 1.4286 1.4286 1.4286h11.429c0.78857 0 1.4286-0.64143 1.4286-1.4286v-4.2857c0-0.78857 0.63857-1.4286 1.4286-1.4286s1.4286 0.64 1.4286 1.4286v4.2857c0 2.3629-1.9229 4.2857-4.2857 4.2857z" fill="#848484" stroke-width="1.4286"/>
+ <path d="m19.02 3.3503c-0.60933 0.010623-1.2003 0.31545-1.5586 0.86719l-5.0977 7.8477-2.3672-3.6445c-0.57329-0.88278-1.7442-1.1319-2.627-0.55859-0.88278 0.57329-1.1319 1.7461-0.55859 2.6289l3.9199 6.0391c0.38514 0.59307 1.0409 0.88965 1.6973 0.85352 0.03023-2.78e-4 0.05972-0.0041 0.08984-0.0059 0.0556-0.0057 0.11074-0.0088 0.16602-0.01953 0.52104-0.07621 1.0077-0.36147 1.3184-0.83984l6.6445-10.23c0.57329-0.88278 0.32419-2.0556-0.55859-2.6289-0.33104-0.21498-0.70276-0.31497-1.0684-0.30859z" fill="#9c9" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.111"/>
 </svg>

novelwriter/assets/icons/typicons_dark/mixed_input-none.svg

@@ -1,43 +1,5 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   width="24"
-   height="24"
-   version="1.2"
-   viewBox="0 0 24 24"
-   id="svg2931">
-  <defs
-     id="defs2935" />
-  <metadata
-     id="metadata2925">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <path
-     id="path2927"
-     style="fill:#848484;fill-opacity:1"
-     d="M 6.2851562,2 C 3.9296438,1.9318024 1.8530839,4.1116184 2,6.4548618 2.0068983,10.304935 1.9861657,14.15563 2.0104329,18.005313 2.1401885,20.174302 4.0868901,22.059322 6.2851562,22 c 3.8832648,-0.0037 7.7667178,0.0074 11.6498648,-0.0056 C 20.253096,21.935675 22.190613,19.73469 22,17.432001 21.996299,13.643017 22.007418,9.8538453 21.994414,6.0649793 21.935675,3.7469037 19.734691,1.8093866 17.432001,2 13.716386,2 10.000771,2 6.2851562,2 Z m 7.1621098,2.8554688 c 1.517767,0.018193 3.040205,-0.037158 4.55493,0.029088 0.831903,0.1432784 1.247019,1.0200413 1.140382,1.796579 -0.0049,3.726426 0.0098,7.453347 -0.0074,11.179464 -0.06228,0.897202 -0.990183,1.406807 -1.816343,1.281978 -3.726391,-0.005 -7.4532932,0.0099 -11.1793638,-0.0075 -0.8893499,-0.06498 -1.4061831,-0.991209 -1.2820783,-1.81622 0.00424,-3.720679 -0.00847,-7.4417768 0.00635,-11.1621953 0.056947,-0.8627405 0.9413144,-1.4230927 1.7608001,-1.2992468 2.2741995,-0.00131 4.5486615,0.00261 6.8226985,-0.00195 z" />
-  <rect
-     x="7"
-     y="10.1"
-     width="10"
-     height="3.8"
-     rx="1.9"
-     ry="1.9"
-     fill="#f99157"
-     stroke-linecap="round"
-     stroke-linejoin="round"
-     stroke-width="1.111"
-     id="rect2929" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <path d="m6.2852 2c-2.3555-0.068198-4.4321 2.1116-4.2852 4.4549 0.0068983 3.8501-0.013834 7.7008 0.010433 11.55 0.12976 2.169 2.0765 4.054 4.2747 3.9947 3.8833-0.0037 7.7667 0.0074 11.65-0.0056 2.3181-0.058725 4.2556-2.2597 4.065-4.5624-0.003701-3.789 0.007418-7.5782-0.005586-11.367-0.058739-2.3181-2.2597-4.2556-4.5624-4.065h-11.147zm7.1621 2.8555c1.5178 0.018193 3.0402-0.037158 4.5549 0.029088 0.8319 0.14328 1.247 1.02 1.1404 1.7966-0.0049 3.7264 0.0098 7.4533-0.0074 11.179-0.06228 0.8972-0.99018 1.4068-1.8163 1.282-3.7264-5e-3 -7.4533 0.0099-11.179-0.0075-0.88935-0.06498-1.4062-0.99121-1.2821-1.8162 0.00424-3.7207-0.00847-7.4418 0.00635-11.162 0.056947-0.86274 0.94131-1.4231 1.7608-1.2992 2.2742-0.00131 4.5487 0.00261 6.8227-0.00195z" fill="#848484"/>
+ <rect x="7" y="10.1" width="10" height="3.8" rx="1.9" ry="1.9" fill="#f99157" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.111"/>
 </svg>

novelwriter/assets/icons/typicons_dark/mixed_input-unchecked.svg

@@ -1,39 +1,5 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   width="24"
-   height="24"
-   version="1.2"
-   viewBox="0 0 24 24"
-   id="svg3574">
-  <defs
-     id="defs3578" />
-  <metadata
-     id="metadata3568">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <path
-     d="m17.714 22h-11.429c-2.3629 0-4.2857-1.9229-4.2857-4.2857v-11.429c0-2.3629 1.9229-4.2857 4.2857-4.2857h7.1429c0.79 0 1.4286 0.64 1.4286 1.4286 0 0.78857-0.63857 1.4286-1.4286 1.4286h-7.1429c-0.78857 0-1.4286 0.64143-1.4286 1.4286v11.429c0 0.78714 0.64 1.4286 1.4286 1.4286h11.429c0.78857 0 1.4286-0.64143 1.4286-1.4286v-4.2857c0-0.78857 0.63857-1.4286 1.4286-1.4286s1.4286 0.64 1.4286 1.4286v4.2857c0 2.3629-1.9229 4.2857-4.2857 4.2857z"
-     fill="#848484"
-     stroke-width="1.4286"
-     id="path3570" />
-  <path
-     d="m17.99 3.3379c-0.48501 0.025418-0.96034 0.23584-1.3125 0.62695l-4.6777 5.1953-1.332-1.4785c-0.70433-0.78223-1.9014-0.84495-2.6836-0.14062-0.78223 0.70433-0.84495 1.9014-0.14062 2.6836l1.5996 1.7754-1.5977 1.7754c-0.70433 0.78223-0.64161 1.9793 0.14062 2.6836 0.78223 0.70433 1.9773 0.64161 2.6816-0.14062l1.332-1.4785 1.332 1.4785c0.70433 0.78224 1.9014 0.84495 2.6836 0.14062 0.78223-0.70433 0.84495-1.9014 0.14062-2.6836l-1.5996-1.7754 4.9453-5.4922c0.70433-0.78223 0.64161-1.9793-0.14062-2.6836-0.39112-0.35216-0.88608-0.51175-1.3711-0.48633z"
-     fill="#d64848"
-     stroke-linecap="round"
-     stroke-linejoin="round"
-     stroke-width="1.111"
-     id="path3572" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <path d="m17.714 22h-11.429c-2.3629 0-4.2857-1.9229-4.2857-4.2857v-11.429c0-2.3629 1.9229-4.2857 4.2857-4.2857h7.1429c0.79 0 1.4286 0.64 1.4286 1.4286 0 0.78857-0.63857 1.4286-1.4286 1.4286h-7.1429c-0.78857 0-1.4286 0.64143-1.4286 1.4286v11.429c0 0.78714 0.64 1.4286 1.4286 1.4286h11.429c0.78857 0 1.4286-0.64143 1.4286-1.4286v-4.2857c0-0.78857 0.63857-1.4286 1.4286-1.4286s1.4286 0.64 1.4286 1.4286v4.2857c0 2.3629-1.9229 4.2857-4.2857 4.2857z" fill="#848484" stroke-width="1.4286"/>
+ <path d="m17.99 3.3379c-0.48501 0.025418-0.96034 0.23584-1.3125 0.62695l-4.6777 5.1953-1.332-1.4785c-0.70433-0.78223-1.9014-0.84495-2.6836-0.14062-0.78223 0.70433-0.84495 1.9014-0.14062 2.6836l1.5996 1.7754-1.5977 1.7754c-0.70433 0.78223-0.64161 1.9793 0.14062 2.6836 0.78223 0.70433 1.9773 0.64161 2.6816-0.14062l1.332-1.4785 1.332 1.4785c0.70433 0.78224 1.9014 0.84495 2.6836 0.14062 0.78223-0.70433 0.84495-1.9014 0.14062-2.6836l-1.5996-1.7754 4.9453-5.4922c0.70433-0.78223 0.64161-1.9793-0.14062-2.6836-0.39112-0.35216-0.88608-0.51175-1.3711-0.48633z" fill="#d64848" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.111"/>
 </svg>

novelwriter/assets/icons/typicons_dark/mixed_search-replace.svg

@@ -1,39 +1,6 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   version="1.2"
-   width="24"
-   height="24"
-   viewBox="0 0 24 24"
-   id="svg873">
-  <metadata
-     id="metadata879">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs877" />
-  <path
-     id="path871"
-     style="display:inline;fill:#6699cc;fill-opacity:1;stroke-width:1.19007"
-     d="m 10.330622,1.9999997 c -4.5924663,0 -8.3306193,3.738153 -8.3306193,8.3306193 0,1.391929 0.3467825,2.702587 0.9532665,3.857242 0.084308,-0.108411 0.1590865,-0.228838 0.2534294,-0.323181 L 4.7482003,12.323178 C 4.5237338,11.697056 4.378519,11.032991 4.3785189,10.330619 c 0,-3.2810129 2.6710902,-5.949778 5.9521031,-5.949778 0.702303,0 1.36649,0.1429324 1.992559,0.3673563 L 14.141363,2.9300158 C 12.997884,2.3384803 11.704084,1.9999997 10.330622,1.9999997 Z m 5.635898,3.4852355 -0.60451,0.6045104 2.545919,2.5482442 0.460357,-0.4626829 C 18.332278,8.0413114 18.299136,7.9066594 18.256684,7.7754 Z m 0.292955,4.4245521 c 0.0083,0.1189097 0.01733,0.2373427 0.01861,0.3580557 l 0.169728,-0.169728 z m 2.059986,2.6993717 -5.710299,5.710299 c 0.105352,-0.03032 0.217183,-0.04484 0.320855,-0.07906 l 0.892816,0.89049 1.799581,1.797261 0.07208,0.07208 0.07672,0.06743 C 16.486443,21.66984 17.375591,22 18.275281,22 c 2.054056,0 3.724716,-1.671795 3.724716,-3.72704 0,-0.999657 -0.390465,-1.936781 -1.099745,-2.638921 l -1.129969,-1.174145 -0.639387,-0.639386 -0.890489,-0.892815 c 0.03403,-0.103138 0.04885,-0.213757 0.07906,-0.318531 z m -11.7600542,2.28784 -0.4929085,0.492908 0.5417343,0.541734 0.57196,-0.571959 C 6.960254,15.221393 6.7588057,15.062002 6.5594068,14.896999 Z m 2.7179722,1.285747 -1.209021,1.209021 0.5417345,0.541734 1.6577535,-1.655429 c -0.3372847,-0.0036 -0.668706,-0.03764 -0.990467,-0.09533 z" />
-  <path
-     d="m 15.96652,2.4766329 c -0.396657,0 -0.792437,0.1507259 -1.095095,0.4533829 L 3.57173,14.229712 c -0.3026571,0.302657 -0.5759103,0.751428 -0.7742385,1.227621 -0.1983282,0.47826 -0.3208556,0.99063 -0.3208556,1.418274 v 4.647756 h 4.6477558 c 0.427645,0 0.9376894,-0.122526 1.4159495,-0.320855 0.4782601,-0.198328 0.9272894,-0.471583 1.2299463,-0.774239 L 21.069984,9.1285734 c 0.302656,-0.302657 0.453382,-0.7017958 0.453382,-1.0974191 0,-0.3966562 -0.150726,-0.7924369 -0.453382,-1.0950939 L 17.063939,2.9300158 C 16.761281,2.6273588 16.362143,2.4766329 15.96652,2.4766329 Z m 0,2.2785396 3.275981,3.2759818 -1.334572,1.3368983 -3.275982,-3.2759819 z M 13.901884,6.8221334 15.173682,8.0939305 6.6082326,16.661704 5.3364357,15.387582 Z m 2.004185,2.0041848 1.271796,1.2717968 -8.5654475,8.565448 -1.2741221,-1.271796 z M 4.7063497,16.250176 c 0.010333,-0.02065 3.0644031,3.034179 3.0644031,3.034179 C 7.43814,19.422771 7.2039295,19.456408 7.1243917,19.456408 H 5.5759147 L 4.5435968,18.424084 v -1.548477 c 0,-0.07953 0.033633,-0.315548 0.1627529,-0.625436 z"
-     style="display:inline;fill:#99cc99;fill-opacity:1;stroke-width:1.19007"
-     id="path15590" />
-  <path
-     id="rect19553"
-     d="m 2.4766359,18.937425 v 2.585938 h 2.5605469 z"
-     style="display:inline;opacity:0.95;fill:#0a0a0a;fill-opacity:1;stroke:none;stroke-width:1.88249397;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
-</svg>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <path d="m10.331 2c-4.5925 0-8.3306 3.7382-8.3306 8.3306 0 1.3919 0.34678 2.7026 0.95327 3.8572 0.084308-0.10841 0.15909-0.22884 0.25343-0.32318l1.5415-1.5415c-0.22447-0.62612-0.36968-1.2902-0.36968-1.9926 0-3.281 2.6711-5.9498 5.9521-5.9498 0.7023 0 1.3665 0.14293 1.9926 0.36736l1.8182-1.8182c-1.1435-0.59154-2.4373-0.93002-3.8107-0.93002zm5.6359 3.4852-0.60451 0.60451 2.5459 2.5482 0.46036-0.46268c-0.036008-0.134-0.06915-0.26865-0.1116-0.39991zm0.29296 4.4246c0.0083 0.11891 0.01733 0.23734 0.01861 0.35806l0.16973-0.16973zm2.06 2.6994-5.7103 5.7103c0.10535-0.03032 0.21718-0.04484 0.32086-0.07906l0.89282 0.89049 1.7996 1.7973 0.07208 0.07208 0.07672 0.06743c0.71523 0.60218 1.6044 0.93234 2.5041 0.93234 2.0541 0 3.7247-1.6718 3.7247-3.727 0-0.99966-0.39046-1.9368-1.0997-2.6389l-1.13-1.1741-0.63939-0.63939-0.89049-0.89282c0.03403-0.10314 0.04885-0.21376 0.07906-0.31853zm-11.76 2.2878-0.49291 0.49291 0.54173 0.54173 0.57196-0.57196c-0.21994-0.13829-0.42139-0.29768-0.62079-0.46268zm2.718 1.2857-1.209 1.209 0.54173 0.54173 1.6578-1.6554c-0.33728-0.0036-0.66871-0.03764-0.99047-0.09533z" fill="#69c" stroke-width="1.1901"/>
+ <path d="m15.967 2.4766c-0.39666 0-0.79244 0.15073-1.0951 0.45338l-11.3 11.3c-0.30266 0.30266-0.57591 0.75143-0.77424 1.2276-0.19833 0.47826-0.32086 0.99063-0.32086 1.4183v4.6478h4.6478c0.42764 0 0.93769-0.12253 1.4159-0.32086 0.47826-0.19833 0.92729-0.47158 1.2299-0.77424l11.3-11.3c0.30266-0.30266 0.45338-0.7018 0.45338-1.0974 0-0.39666-0.15073-0.79244-0.45338-1.0951l-4.006-4.006c-0.30266-0.30266-0.7018-0.45338-1.0974-0.45338zm0 2.2785 3.276 3.276-1.3346 1.3369-3.276-3.276zm-2.0646 2.067 1.2718 1.2718-8.5654 8.5678-1.2718-1.2741zm2.0042 2.0042 1.2718 1.2718-8.5654 8.5654-1.2741-1.2718zm-11.2 7.4239c0.010333-0.02065 3.0644 3.0342 3.0644 3.0342-0.33261 0.13842-0.56682 0.17205-0.64636 0.17205h-1.5485l-1.0323-1.0323v-1.5485c0-0.07953 0.033633-0.31555 0.16275-0.62544z" fill="#9c9" stroke-width="1.1901"/>
+ <path d="m2.4766 18.937v2.5859h2.5605z" fill="#0a0a0a" opacity=".95"/>
+</svg>

novelwriter/assets/icons/typicons_dark/nw_deco-h0.svg

@@ -1,35 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   version="1.2"
-   width="4"
-   height="24"
-   viewBox="0 0 4 24"
-   id="svg2161"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:dc="http://purl.org/dc/elements/1.1/">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <rect
-     style="fill:#848484;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     id="rect1955"
-     width="4"
-     height="22"
-     x="0"
-     y="1"
-     rx="2"
-     ry="2" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="4" height="24" version="1.2" viewBox="0 0 4 24" xmlns="http://www.w3.org/2000/svg">
+ <rect y="1" width="4" height="22" rx="2" ry="2" fill="#848484" stroke-width="0"/>
 </svg>

novelwriter/assets/icons/typicons_dark/nw_deco-h1.svg

@@ -1,35 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   version="1.2"
-   width="4"
-   height="24"
-   viewBox="0 0 4 24"
-   id="svg2161"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:dc="http://purl.org/dc/elements/1.1/">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <rect
-     style="fill:#99cc99;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     id="rect1955"
-     width="4"
-     height="22"
-     x="0"
-     y="1"
-     rx="2"
-     ry="2" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="4" height="24" version="1.2" viewBox="0 0 4 24" xmlns="http://www.w3.org/2000/svg">
+ <rect y="1" width="4" height="22" rx="2" ry="2" fill="#9c9" stroke-width="0"/>
 </svg>

novelwriter/assets/icons/typicons_dark/nw_deco-h2.svg

@@ -1,35 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   version="1.2"
-   width="20"
-   height="24"
-   viewBox="0 0 20 24"
-   id="svg2161"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:dc="http://purl.org/dc/elements/1.1/">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <rect
-     style="fill:#d64848;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     id="rect1955"
-     width="4"
-     height="22"
-     x="16"
-     y="1"
-     rx="2"
-     ry="2" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="20" height="24" version="1.2" viewBox="0 0 20 24" xmlns="http://www.w3.org/2000/svg">
+ <rect x="16" y="1" width="4" height="22" rx="2" ry="2" fill="#d64848" stroke-width="0"/>
 </svg>

novelwriter/assets/icons/typicons_dark/nw_deco-h3.svg

@@ -1,35 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   version="1.2"
-   width="36"
-   height="24"
-   viewBox="0 0 36 24"
-   id="svg2161"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:dc="http://purl.org/dc/elements/1.1/">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <rect
-     style="fill:#6699cc;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     id="rect1955"
-     width="4"
-     height="22"
-     x="32"
-     y="1"
-     rx="2"
-     ry="2" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="36" height="24" version="1.2" viewBox="0 0 36 24" xmlns="http://www.w3.org/2000/svg">
+ <rect x="32" y="1" width="4" height="22" rx="2" ry="2" fill="#69c" stroke-width="0"/>
 </svg>

novelwriter/assets/icons/typicons_dark/nw_deco-h4.svg

@@ -1,35 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   version="1.2"
-   width="52"
-   height="24"
-   viewBox="0 0 52 24"
-   id="svg2161"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:dc="http://purl.org/dc/elements/1.1/">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <rect
-     style="fill:#ffffff;fill-opacity:1;stroke-width:0;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:0.2"
-     id="rect1955"
-     width="4"
-     height="22"
-     x="48"
-     y="1"
-     rx="2"
-     ry="2" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="52" height="24" version="1.2" viewBox="0 0 52 24" xmlns="http://www.w3.org/2000/svg">
+ <rect x="48" y="1" width="4" height="22" rx="2" ry="2" fill="#fff" stroke-width="0"/>
 </svg>

novelwriter/assets/icons/typicons_dark/nw_deco-noveltree-more.svg

@@ -1,30 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   version="1.2"
-   width="24"
-   height="24"
-   viewBox="0 0 24 24"
-   id="svg2161"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:dc="http://purl.org/dc/elements/1.1/">
-  <metadata
-     id="metadata2167">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs2165" />
-  <path
-     d="M 9.7,18.2 16,12 9.7,5.8 C 9.5,5.6 9.2,5.5 9,5.5 8.8,5.5 8.5,5.6 8.3,5.8 8.1,6 8,6.2 8,6.5 v 11 c 0,0.3 0.1,0.5 0.3,0.7 0.2,0.2 0.5,0.3 0.7,0.3 0.2,0 0.5,-0.1 0.7,-0.3 z"
-     id="path3096"
-     style="fill:#848484;fill-opacity:1" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <path d="m9.7 18.2 6.3-6.2-6.3-6.2c-0.2-0.2-0.5-0.3-0.7-0.3s-0.5 0.1-0.7 0.3-0.3 0.4-0.3 0.7v11c0 0.3 0.1 0.5 0.3 0.7s0.5 0.3 0.7 0.3 0.5-0.1 0.7-0.3z" fill="#848484"/>
 </svg>

novelwriter/assets/icons/typicons_dark/nw_search-case.svg

@@ -1,49 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   width="24"
-   height="24"
-   viewBox="0 0 6.3499999 6.3500002"
-   version="1.1"
-   id="svg8">
-  <defs
-     id="defs2" />
-  <metadata
-     id="metadata5">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <g
-     style="fill:#aeaeae;fill-opacity:1"
-     id="layer1"
-     transform="translate(0,-290.64999)">
-    <g
-       aria-label="Aa"
-       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:5.64444px;line-height:1.25;font-family:Roboto;-inkscape-font-specification:Roboto;letter-spacing:0px;word-spacing:0px;fill:#aeaeae;fill-opacity:1;stroke:none;stroke-width:0.264583"
-       id="text817">
-      <g
-         id="g968"
-         style="fill:#aeaeae;fill-opacity:1">
-        <path
-           id="path961"
-           style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:4.93889px;font-family:Cantarell;-inkscape-font-specification:'Cantarell, Bold';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;writing-mode:lr-tb;text-anchor:start;fill:#aeaeae;fill-opacity:1;stroke-width:0.264583"
-           d="M 0.35983601,295.49539 H 1.0364638 l 0.2815167,-0.85936 H 2.631725 l 0.2815166,0.85936 H 3.6195028 L 2.4292305,292.0678 H 1.6143138 Z m 1.14582229,-1.42734 0.4741333,-1.45203 0.4691945,1.45203 z" />
-        <path
-           id="path963"
-           style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:4.93889px;font-family:Cantarell;-inkscape-font-specification:'Cantarell, Bold';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;writing-mode:lr-tb;text-anchor:start;fill:#aeaeae;fill-opacity:1;stroke-width:0.264583"
-           d="m 4.701114,295.54478 c 0.3062111,0 0.5679722,-0.10372 0.7507111,-0.29139 l 0.0889,0.242 H 5.990164 v -1.44215 c 0,-0.65194 -0.3704167,-1.00754 -1.0766778,-1.00754 -0.3457222,0 -0.7112,0.084 -0.9927167,0.23213 l 0.1481667,0.43956 c 0.2469444,-0.0988 0.48895,-0.14816 0.7112,-0.14816 0.3852334,0 0.5926667,0.14816 0.5926667,0.43462 v 0.0642 c -1.0421056,0.0148 -1.5014223,0.25189 -1.5014223,0.76059 0,0.43462 0.3259667,0.71614 0.8297334,0.71614 z m -0.1975556,-0.8001 c 0,-0.21731 0.2518834,-0.31609 0.8692445,-0.32597 v 0.45438 c -0.1185333,0.1136 -0.2815167,0.1778 -0.4642556,0.1778 -0.2420055,0 -0.4049889,-0.12347 -0.4049889,-0.30621 z" />
-      </g>
-    </g>
-  </g>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.1" viewBox="0 0 6.35 6.35" xmlns="http://www.w3.org/2000/svg">
+ <path d="m0.35984 4.85h0.67663l0.28152-0.85936h1.3137l0.28152 0.85936h0.70626l-1.1903-3.4276h-0.81492zm1.1458-1.4273 0.47413-1.452 0.46919 1.452zm3.1955 1.4674c0.30621 0 0.56797-0.10372 0.75071-0.29139l0.0889 0.242h0.44944v-1.4422c0-0.65194-0.37042-1.0075-1.0767-1.0075-0.34572 0-0.7112 0.084-0.99272 0.23213l0.14817 0.43956c0.24694-0.0988 0.48895-0.14816 0.7112-0.14816 0.38523 0 0.59267 0.14816 0.59267 0.43462v0.0642c-1.0421 0.0148-1.5014 0.25189-1.5014 0.76059 0 0.43462 0.32597 0.71614 0.82973 0.71614zm-0.19756-0.8001c0-0.21731 0.25188-0.31609 0.86924-0.32597v0.45438c-0.11853 0.1136-0.28152 0.1778-0.46426 0.1778-0.24201 0-0.40499-0.12347-0.40499-0.30621z" fill="#aeaeae" style="font-feature-settings:normal;font-variant-caps:normal;font-variant-ligatures:normal;font-variant-numeric:normal"/>
 </svg>

novelwriter/assets/icons/typicons_dark/nw_search-preserve.svg

@@ -1,40 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   id="svg8"
-   version="1.1"
-   viewBox="0 0 6.3499999 6.3500002"
-   height="24"
-   width="24">
-  <g
-     style="font-size:5.64444px;line-height:1.25;font-family:'Fira Sans';-inkscape-font-specification:'Fira Sans, Normal';letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
-     id="text1549"
-     aria-label="AB">
-    <path
-       id="path1551"
-       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:4.93889px;font-family:Cantarell;-inkscape-font-specification:'Cantarell, Bold';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;stroke-width:0.251875;fill:#aeaeae;fill-opacity:1"
-       d="M 0.52916667,4.8827979 H 1.1423606 L 1.397485,4.023431 H 2.588066 L 2.8431905,4.8827979 H 3.4832396 L 2.4045554,1.4552083 H 1.6660372 Z M 1.5675681,3.4554587 1.9972514,2.003425 2.4224589,3.4554587 Z" />
-    <path
-       id="path1553"
-       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:4.93889px;font-family:Cantarell;-inkscape-font-specification:'Cantarell, Bold';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;stroke-width:0.25188;fill:#aeaeae;fill-opacity:1"
-       d="m 3.4395834,4.8827979 h 1.1592928 c 0.7519737,0 1.2219572,-0.4099279 1.2219572,-1.0618613 0,-0.4296835 -0.2058975,-0.7408335 -0.5639802,-0.8840614 0.1969454,-0.1432278 0.3177984,-0.3951112 0.3177984,-0.6667501 0,-0.5284612 -0.389415,-0.8149168 -1.1055804,-0.8149168 H 3.4395834 Z M 4.0125157,1.9688528 h 0.4117952 c 0.3625587,0 0.5639802,0.1679223 0.5639802,0.4642557 0,0.1778 -0.076092,0.3160889 -0.2506578,0.4247445 H 4.0125157 Z m 0,2.4003005 V 3.3566809 h 0.6714051 c 0.3357025,0 0.5416002,0.2173112 0.5416002,0.5482168 0,0.3160889 -0.1745654,0.4642556 -0.5505523,0.4642556 z" />
-  </g>
-  <defs
-     id="defs2" />
-  <metadata
-     id="metadata5">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.1" viewBox="0 0 6.35 6.35" xmlns="http://www.w3.org/2000/svg">
+ <path d="m0.52917 4.8828h0.61319l0.25512-0.85937h1.1906l0.25512 0.85937h0.64005l-1.0787-3.4276h-0.73852zm1.0384-1.4273 0.42968-1.452 0.42521 1.452zm1.872 1.4273h1.1593c0.75197 0 1.222-0.40993 1.222-1.0619 0-0.42968-0.2059-0.74083-0.56398-0.88406 0.19695-0.14323 0.3178-0.39511 0.3178-0.66675 0-0.52846-0.38942-0.81492-1.1056-0.81492h-1.0295zm0.57293-2.9139h0.4118c0.36256 0 0.56398 0.16792 0.56398 0.46426 0 0.1778-0.076092 0.31609-0.25066 0.42474h-0.72512zm0 2.4003v-1.0125h0.67141c0.3357 0 0.5416 0.21731 0.5416 0.54822 0 0.31609-0.17457 0.46426-0.55055 0.46426z" fill="#aeaeae" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal"/>
 </svg>

novelwriter/assets/icons/typicons_dark/nw_search-regex.svg

@@ -1,49 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   width="24"
-   height="24"
-   viewBox="0 0 6.3499999 6.3500002"
-   version="1.1"
-   id="svg8">
-  <defs
-     id="defs2" />
-  <metadata
-     id="metadata5">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <g
-     style="fill:#aeaeae;fill-opacity:1"
-     id="layer1"
-     transform="translate(0,-290.64999)">
-    <g
-       aria-label=".*"
-       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:5.64444px;line-height:1.25;font-family:Roboto;-inkscape-font-specification:Roboto;letter-spacing:0px;word-spacing:0px;fill:#aeaeae;fill-opacity:1;stroke:none;stroke-width:0.264583"
-       id="text817">
-      <g
-         id="g1606"
-         style="fill:#aeaeae;fill-opacity:1">
-        <path
-           id="path1599"
-           style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:4.93889px;font-family:Cantarell;-inkscape-font-specification:'Cantarell, Bold';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;writing-mode:lr-tb;text-anchor:start;fill:#aeaeae;fill-opacity:1;stroke-width:0.264583"
-           d="m 1.9550981,295.54478 c 0.2518833,0 0.4198055,-0.18274 0.4198055,-0.4198 0,-0.25189 -0.1679222,-0.43463 -0.4198055,-0.43463 -0.2568223,0 -0.4247445,0.18274 -0.4247445,0.43463 0,0.23706 0.1679222,0.4198 0.4247445,0.4198 z" />
-        <path
-           id="path1601"
-           style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:4.93889px;font-family:Cantarell;-inkscape-font-specification:'Cantarell, Bold';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;writing-mode:lr-tb;text-anchor:start;fill:#aeaeae;fill-opacity:1;stroke-width:0.264583"
-           d="m 3.5108408,294.12732 h 0.5482167 l -0.1234722,-0.77541 0.6124222,0.49883 0.2568223,-0.43956 -0.7655278,-0.32103 0.7803444,-0.29139 -0.2518833,-0.43956 -0.6371167,0.48401 0.1284111,-0.8001 H 3.5108408 l 0.1382889,0.79516 -0.6223,-0.50377 -0.2518833,0.43956 0.7704667,0.31609 -0.7754056,0.30621 0.2469444,0.4445 0.6321778,-0.50376 z" />
-      </g>
-    </g>
-  </g>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.1" viewBox="0 0 6.35 6.35" xmlns="http://www.w3.org/2000/svg">
+ <path d="m3.5108 3.5121h0.54822l-0.12347-0.77541 0.61242 0.49883 0.25682-0.43956-0.76553-0.32103 0.78034-0.29139-0.25188-0.43956-0.63712 0.48401 0.12841-0.8001h-0.54822l0.13829 0.79516-0.6223-0.50377-0.25188 0.43956 0.77047 0.31609-0.77541 0.30621 0.24694 0.4445 0.63218-0.50376zm-1.5557 1.41c0.25188 0 0.41981-0.18274 0.41981-0.4198 0-0.25189-0.16792-0.43463-0.41981-0.43463-0.25682 0-0.42474 0.18274-0.42474 0.43463 0 0.23706 0.16792 0.4198 0.42474 0.4198z" fill="#aeaeae" style="font-feature-settings:normal;font-variant-caps:normal;font-variant-ligatures:normal;font-variant-numeric:normal"/>
 </svg>

novelwriter/assets/icons/typicons_dark/nw_search-word.svg

@@ -1,45 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   id="svg8"
-   version="1.1"
-   viewBox="0 0 6.3499999 6.3500002"
-   height="24"
-   width="24">
-  <defs
-     id="defs2" />
-  <metadata
-     id="metadata5">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <g
-     transform="translate(0,-290.64999)"
-     id="layer1">
-    <g
-       id="text817"
-       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:5.64444px;line-height:1.25;font-family:Roboto;-inkscape-font-specification:Roboto;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
-       aria-label=".*">
-      <g
-         style="fill:#000000;fill-opacity:0.780392"
-         id="g1606">
-        <path
-           id="rect1629"
-           transform="matrix(0.26458334,0,0,0.26458334,0,290.64999)"
-           d="m 2,11.5 v 4 1 2 h 20 v -3 -4 h -3 v 4 H 5 v -4 z"
-           style="fill:#aeaeae;fill-opacity:1;stroke:none;stroke-width:1.76363;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
-      </g>
-    </g>
-  </g>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.1" viewBox="0 0 6.35 6.35" xmlns="http://www.w3.org/2000/svg">
+ <path d="m0.52915 3.0427v1.8521h5.2917v-1.8521h-0.79375v1.0583h-3.7042v-1.0583z" fill="#aeaeae"/>
 </svg>

novelwriter/assets/icons/typicons_dark/typ_arrow-down-thick-grey.svg

@@ -1,31 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   id="svg8301"
-   viewBox="0 0 24 24"
-   height="24"
-   width="24"
-   version="1.2">
-  <metadata
-     id="metadata8307">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs8305" />
-  <path
-     style="stroke-width:1.18357;fill:#aeaeae;fill-opacity:1"
-     id="path8299"
-     d="m 19.591431,11.061428 c -0.92437,-0.92437 -2.422771,-0.92437 -3.347141,0 l -1.877146,1.877144 V 4.367144 C 14.367144,3.059297 13.306664,2 12,2 10.692153,2 9.6328557,3.059297 9.6328557,4.367144 v 8.571428 l -1.877145,-1.877144 c -0.9243698,-0.92437 -2.4227719,-0.92437 -3.3471417,0 -0.9243697,0.924369 -0.9243697,2.422771 0,3.347141 L 12,22 19.591431,14.408569 c 0.92437,-0.92437 0.92437,-2.421588 0,-3.347141 z" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <path d="m19.591 11.061c-0.92437-0.92437-2.4228-0.92437-3.3471 0l-1.8771 1.8771v-8.5714c0-1.3078-1.0605-2.3671-2.3671-2.3671-1.3078 0-2.3671 1.0593-2.3671 2.3671v8.5714l-1.8771-1.8771c-0.92437-0.92437-2.4228-0.92437-3.3471 0-0.92437 0.92437-0.92437 2.4228 0 3.3471l7.5914 7.5914 7.5914-7.5914c0.92437-0.92437 0.92437-2.4216 0-3.3471z" fill="#aeaeae" stroke-width="1.1836"/>
 </svg>

novelwriter/assets/icons/typicons_dark/typ_arrow-forward.svg

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <path d="m13.25 3.5625c-0.32 0-0.64 0.12125-0.88375 0.365-0.24375 0.245-0.36625 0.565-0.36625 0.885v3.1988c-5.625 0.6225-10 5.3862-10 11.176v1.25c2.8062-4.2788 6.5625-4.9 10-4.9862v3.1112c0 0.31875 0.1225 0.64 0.36625 0.88375s0.56375 0.36625 0.88375 0.36625 0.64-0.1225 0.88375-0.36625l7.8662-7.7588-7.8662-7.76c-0.24375-0.24375-0.56375-0.365-0.88375-0.365z" fill="#9c9" stroke-width="1.25"/>
+</svg>

novelwriter/assets/icons/typicons_dark/typ_arrow-maximise.svg

@@ -1,31 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   id="svg7486"
-   viewBox="0 0 24 24"
-   height="24"
-   width="24"
-   version="1.2">
-  <metadata
-     id="metadata7492">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs7490" />
-  <path
-     style="stroke-width:1.25;fill:#6699cc;fill-opacity:1"
-     id="path7484"
-     d="m 15.75,2 c -0.69125,0 -1.25,0.56 -1.25,1.25 0,0.69 0.55875,1.25 1.25,1.25 h 1.9825 l -4.11625,4.11625 c -0.48875,0.48875 -0.48875,1.27875 0,1.7675 C 13.86,10.6275 14.18,10.75 14.5,10.75 c 0.32,0 0.64,-0.1225 0.88375,-0.36625 L 19.5,6.2675 V 8.25 c 0,0.69 0.55875,1.25 1.25,1.25 C 21.44125,9.5 22,8.94 22,8.25 V 2 Z M 8.61625,13.61625 4.5,17.7325 V 15.75 C 4.5,15.06 3.94125,14.5 3.25,14.5 2.55875,14.5 2,15.06 2,15.75 v 6.24875 H 3.245 L 8.25,22 C 8.94,22 9.5,21.44 9.5,20.75 9.5,20.06 8.94125,19.5 8.25,19.5 H 6.2675 l 4.11625,-4.115 c 0.48875,-0.48875 0.48875,-1.27875 0,-1.7675 C 9.895,13.12875 9.105,13.1275 8.61625,13.6163 Z M 5.75,12 C 6.44,12 7,11.44 7,10.75 V 7 h 3.75 C 11.44125,7 12,6.44 12,5.75 12,5.06 11.44125,4.5 10.75,4.5 H 4.50125 L 4.5,10.75 C 4.5,11.44 5.05875,12 5.75,12 Z m 12.5,0 C 17.55875,12 17,12.56 17,13.25 V 17 H 13.25 C 12.55875,17 12,17.56 12,18.25 c 0,0.69 0.55875,1.25 1.25,1.25 H 19.5 V 13.25 C 19.5,12.56 18.94125,12 18.25,12 Z" />
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="24" height="24" version="1.2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+ <path d="m15.75 2c-0.69125 0-1.25 0.56-1.25 1.25s0.55875 1.25 1.25 1.25h1.9825l-4.1162 4.1162c-0.48875 0.48875-0.48875 1.2788 0 1.7675 0.24375 0.24375 0.56375 0.36625 0.88375 0.36625s0.64-0.1225 0.88375-0.36625l4.1162-4.1162v1.9825c0 0.69 0.55875 1.25 1.25 1.25s1.25-0.56 1.25-1.25v-6.25zm-7.1338 11.616-4.1162 4.1162v-1.9825c0-0.69-0.55875-1.25-1.25-1.25s-1.25 0.56-1.25 1.25v6.2488h1.245l5.005 0.00125c0.69 0 1.25-0.56 1.25-1.25s-0.55875-1.25-1.25-1.25h-1.9825l4.1162-4.115c0.48875-0.48875 0.48875-1.2788 0-1.7675s-1.2788-0.49-1.7675-0.0012zm-2.8662-1.6162c0.69 0 1.25-0.56 1.25-1.25v-3.75h3.75c0.69125 0 1.25-0.56 1.25-1.25s-0.55875-1.25-1.25-1.25h-6.2488l-0.00125 6.25c0 0.69 0.55875 1.25 1.25 1.25zm12.5 0c-0.69125 0-1.25 0.56-1.25 1.25v3.75h-3.75c-0.69125 0-1.25 0.56-1.25 1.25s0.55875 1.25 1.25 1.25h6.25v-6.25c0-0.69-0.55875-1.25-1.25-1.25z" fill="#69c" stroke-width="1.25"/>
 </svg>