From 524b965665286a761fb9c5103203ade8d7ef39c7 Mon Sep 17 00:00:00 2001 From: Veronica Berglyd Olsen <1619840+vkbo@users.noreply.github.com> Date: Sat, 13 Apr 2024 18:32:29 +0200 Subject: [PATCH] Update the remaining docs --- docs/source/index.rst | 3 +-- docs/source/more_counting.rst | 44 +++++++++++++++++----------------- docs/source/more_customise.rst | 18 +++++++------- docs/source/tech_locations.rst | 21 ++++++++++------ docs/source/tech_overview.rst | 20 ---------------- docs/source/tech_source.rst | 5 ++-- docs/source/tech_storage.rst | 24 +++++++++---------- 7 files changed, 60 insertions(+), 75 deletions(-) delete mode 100644 docs/source/tech_overview.rst diff --git a/docs/source/index.rst b/docs/source/index.rst index 51c1226d..7c8d75c3 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -18,7 +18,7 @@ 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, and your project data as standard -data formats in XML and JSON. See :ref:`a_tech_overview` for more details. +data formats in XML and JSON. See :ref:`a_storage` for more details. Any operating system that has Python 3 and the Qt 5 libraries should be able to run novelWriter. It runs fine on Linux, Windows and MacOS, and users have tested it on other platforms as well. @@ -89,7 +89,6 @@ See :ref:`a_started` for more details. :caption: Technical Topics :hidden: - tech_overview tech_locations tech_storage tech_source diff --git a/docs/source/more_counting.rst b/docs/source/more_counting.rst index ac408937..7272c9fc 100644 --- a/docs/source/more_counting.rst +++ b/docs/source/more_counting.rst @@ -8,8 +8,8 @@ This is an overview of how words and other counts of your text are performed. Th should be relatively standard, and are compared to Libre Office Writer rules. The counts provided in the app on the raw text is meant to be approximate. For more accurate -counts, you need to build your manuscript in the :guilabel:`Manuscript Tool` and check the counts -on the generated preview. +counts, you need to build your manuscript in the **Manuscript Tool** and check the counts on the +generated preview. Text Word Counts and Stats @@ -31,11 +31,11 @@ After the above preparation of the text, the following counts are available. **Character Count** The character count is the sum of characters per line, including leading and in-text white space characters, but excluding trailing white space characters. Shortcodes in the text are not - included, but Markdown codes are. Only headers and text are counted. + included, but Markdown codes are. Only headings and text are counted. **Word Count** The words count is the sum of blocks of continuous character per line separated by any number of - white space characters or dashes. Only headers and text are counted. + white space characters or dashes. Only headings and text are counted. **Paragraph Count** The paragraph count is the number of text blocks separated by one or more empty line. A line @@ -45,10 +45,10 @@ After the above preparation of the text, the following counts are available. Manuscript Counts ================= -These are the rules for the counts available for a manuscript in the :guilabel:`Manuscript Tool`. -The rules have been tuned to agree with LibreOffice Writer, but will vary slightly depending on the -content of your text. LibreOffice Writer also counts the text in the page header, which the -Manuscript Tool does not. +These are the rules for the counts available for a manuscript in the **Manuscript Tool**. The rules +have been tuned to agree with LibreOffice Writer, but will vary slightly depending on the content +of your text. LibreOffice Writer also counts the text in the page header, which the **Manuscript +Tool** does not. The content of each line is counted after all formatting has been processed, so the result will be more accurate than the counts for text documents elsewhere in the app. The following rules apply: @@ -63,36 +63,36 @@ more accurate than the counts for text documents elsewhere in the app. The follo The following counts are available: -**Header Count** - The number of headers in the manuscript. +**Headings** + The number of headings in the manuscript. -**Paragraph Count** +**Paragraphs** The number of body text paragraphs in the manuscript. -**Total Word Count** +**Words** The number of words in the manuscript, including any comments and meta data text. -**Text Word Count** +**Words in Text** The number of words in body text paragraphs, excluding all other text. -**Header Word Count** - The number of words in headers, including inserted formatting like chapter numbers, etc. +**Words in Headings** + The number of words in headings, including inserted formatting like chapter numbers, etc. -**Total Character Count** - The number of characters on all lines, including any comments and meta data text. Paragraph +**Characters** + The number of characters in all lines, including any comments and meta data text. Paragraph breaks are not counted, but in-paragraph hard line breaks are. -**Text Character Count** +**Character in Text** The number of characters in body text paragraphs. Paragraph breaks are not counted, but in-paragraph hard line breaks are. -**Header Character Count** +**Characters in Headings** The number of characters in headings. -**Text Words Character Count** +**Character in Text, No Spaces** The number of characters in body text paragraphs considered part of a word or punctuation. That is, white space characters are not counted. -**Header Words Character Count** - The number of characters in headers considered part of a word or punctuation. That is, white +**Character in Headings, No Spaces** + The number of characters in headings considered part of a word or punctuation. That is, white space characters are not counted. diff --git a/docs/source/more_customise.rst b/docs/source/more_customise.rst index f9a3b9fe..6e6c09da 100644 --- a/docs/source/more_customise.rst +++ b/docs/source/more_customise.rst @@ -34,10 +34,10 @@ and add dictionaries yourself. **Install Tool** -A small tool to assist with this can be found under :guilabel:`Tools > Add Dictionaries`. It will -import spell checking dictionaries from Free Office or Libre Office extensions. The dictionaries -are then installed in the install location for the Enchant library and should thus work for any -application that uses Enchant for spell checking. +A small tool to assist with this can be found under **Tools > Add Dictionaries**. It will import +spell checking dictionaries from Free Office or Libre Office extensions. The dictionaries are then +installed in the install location for the Enchant library and should thus work for any application +that uses Enchant for spell checking. **Manual Install** @@ -81,14 +81,14 @@ modify it as you like. `novelwriter/assets/icons `_. Remember to also change the name of your theme by modifying the ``name`` setting at the top of the -file, otherwise you may not be able to distinguish them in :guilabel:`Preferences`. +file, otherwise you may not be able to distinguish them in **Preferences**. For novelWriter to be able to locate the custom theme files, you must copy them to the :ref:`a_locations_data` location in your home or user area. There should be a folder there named ``syntax`` for syntax themes, just ``themes`` for GUI themes, and ``icons`` for icon themes. These folders are created the first time you start novelWriter. -Once the files are copied there, they should show up in :guilabel:`Preferences` with the label you +Once the files are copied there, they should show up in **Preferences** with the label you set as ``name`` inside the file. .. versionadded:: 2.0 @@ -190,10 +190,10 @@ Omitted syntax colours default to black, except ``background`` which defaults to ``texthighlight`` which defaults to white with half transparency. .. versionadded:: 2.2 - The `shortcode` syntax colour entry was added. + The ``shortcode`` syntax colour entry was added. .. versionadded:: 2.3 - The `optional` syntax colour entry was added. + The ``optional`` syntax colour entry was added. .. versionadded:: 2.4 - The `texthighlight` syntax colour entry was added. + The ``texthighlight`` syntax colour entry was added. diff --git a/docs/source/tech_locations.rst b/docs/source/tech_locations.rst index da199292..3cd09e60 100644 --- a/docs/source/tech_locations.rst +++ b/docs/source/tech_locations.rst @@ -15,10 +15,9 @@ file locations are described in this chapter. Configuration ============= -The general configuration of novelWriter, including everything that is in :guilabel:`Preferences`, -is saved in one central configuration file. The location of this file depends on your operating -system. The system paths are provided by the Qt QStandardPaths_ class and its ``ConfigLocation`` -value. +The general configuration of novelWriter, including everything that is in **Preferences**, is saved +in one central configuration file. The location of this file depends on your operating system. The +system paths are provided by the Qt QStandardPaths_ class and its ``ConfigLocation`` value. The standard paths are: @@ -40,9 +39,8 @@ Application Data ================ novelWriter also stores a bit of data that is generated by the user's actions. This includes the -list of recent projects form the :guilabel:`Open Project` dialog. Custom themes should also be -saved here. The system paths are provided by the Qt QStandardPaths_ class and its -``AppDataLocation`` value. +list of recent projects form the **Welcome** dialog. Custom themes should also be saved here. The +system paths are provided by the Qt QStandardPaths_ class and its ``AppDataLocation`` value. The standard paths are: @@ -56,3 +54,12 @@ user's username on Windows. .. note:: These are the standard operating system defined locations. If your system has been set up in a different way, these locations may also be different. + +The Application Data location also holds several folders: + +``cache`` + This folder is used to save the preview data for the **Manuscript Build** tool. + +``icons``, ``syntax`` and ``themes`` + These folders are empty by default, but this is where the user can store custom theme files. + See :ref:`a_custom` for more details. diff --git a/docs/source/tech_overview.rst b/docs/source/tech_overview.rst deleted file mode 100644 index b6851333..00000000 --- a/docs/source/tech_overview.rst +++ /dev/null @@ -1,20 +0,0 @@ -.. _a_tech_overview: - -****************** -Technical Overview -****************** - - -novelWriter is built as a cross-platform application using `Python 3 `_ as -the programming language, and `Qt 5 `_ framework for the user interface. - -novelWriter is built for Linux first, so this is where it works best. However, it also runs fine -on Windows and MacOS due to the cross-platform framework it's built on. The author of the -application doesn't own a Mac, so on-going Mac support is dependent on user feedback and user -contributions. - -Spell checking in novelWriter is provided by a third party library called -`Enchant `_. Please see the section on :ref:`a_custom_dict` for -how to install spell checking languages. - -For install instructions for novelWriter, see :ref:`a_started`. diff --git a/docs/source/tech_source.rst b/docs/source/tech_source.rst index 8c23463e..87d616a3 100644 --- a/docs/source/tech_source.rst +++ b/docs/source/tech_source.rst @@ -159,6 +159,5 @@ You can also build a PDF manual from the documentation using the ``pkgutils.py`` python pkgutils.py manual This will build the documentation as a PDF using LaTeX. The file will then be copied into the -assets folder and made available in the :guilabel:`Help` menu in novelWriter. The Sphinx build -system has a few extra dependencies when building the PDF. Please check the `Sphinx Docs`_ for more -details. +assets folder and made available in the **Help** menu in novelWriter. The Sphinx build system has a +few extra dependencies when building the PDF. Please check the `Sphinx Docs`_ for more details. diff --git a/docs/source/tech_storage.rst b/docs/source/tech_storage.rst index 7fb9d39b..79d5890a 100644 --- a/docs/source/tech_storage.rst +++ b/docs/source/tech_storage.rst @@ -55,10 +55,10 @@ string. The documents are saved with a filename assembled from this handle and t ``.nwd``. If you wish to find the file system location of a document in the project, you can either look it -up in the project XML file, select :guilabel:`Show File Details` from the :guilabel:`Document` menu -when having the document open in the editor, or look in the ``ToC.txt`` file in the root of the -project folder. The ``ToC.txt`` file has a list of all documents in the project, referenced by -their label, and where they are saved. +up in the project XML file, select **Show File Details** from the **Document** menu when having the +document open in the editor, or look in the ``ToC.txt`` file in the root of the project folder. The +``ToC.txt`` file has a list of all documents in the project, referenced by their label, and where +they are saved. The reason for this cryptic file naming is to avoid issues with file naming conventions and restrictions on different operating systems, and also to have a file name that does not depend on @@ -109,7 +109,7 @@ The Project Index Between writing sessions, the project index is saved in a JSON file in ``meta/index.json``. This file is not critical. If it is lost, it can be completely rebuilt from within novelWriter from -the :guilabel:`Tools` menu. +the **Tools** menu. The index is maintained and updated whenever a document or note is saved in the editor. It contains all references and tags in documents and notes, as well as the location of all headers in the @@ -125,8 +125,8 @@ the index. If this too fails, you have likely encountered a bug. Build Definitions ----------------- -The build definitions from the :guilabel:`Manuscript Build` tool are kept in the -``meta/builds.json`` file. If this file is lost, all custom build definitions are lost too. +The build definitions from the **Manuscript Build** tool are kept in the ``meta/builds.json`` file. +If this file is lost, all custom build definitions are lost too. Cached GUI Options @@ -144,17 +144,17 @@ Custom Word List ---------------- A file named ``meta/userdict.json`` contains all the custom words you've added to the project for -spell checking purposes. The content of the file can be edited from the :guilabel:`Tools` menu. If -you lose this file, all your custom spell check words will be lost too. +spell checking purposes. The content of the file can be edited from the **Tools** menu. If you lose +this file, all your custom spell check words will be lost too. Session Stats ------------- The writing progress is saved in the ``meta/sessions.jsonl`` file. This file records the length -and word counts of each writing session on the given project. The file is used by the -:guilabel:`Writing Statistics` tool. If this file is lost, the history it contains is also lost, -but it has otherwise no impact on the project. +and word counts of each writing session on the given project. The file is used by the **Writing +Statistics** tool. If this file is lost, the history it contains is also lost, but it has otherwise +no impact on the project. Each session is recorded as a JSON object on a single line of the file. Each session record is appended tot he file.