From a3fdb3cfc44171b53002ad8513e8c4b805c806b8 Mon Sep 17 00:00:00 2001 From: Veronica Berglyd Olsen <1619840+vkbo@users.noreply.github.com> Date: Sun, 8 Oct 2023 18:50:33 +0200 Subject: [PATCH] Update the introduction section of the docs --- docs/source/conf.py | 2 +- docs/source/images/python_win_install.png | Bin 98735 -> 0 bytes docs/source/int_customise.rst | 12 +- docs/source/int_howto.rst | 130 ++++++------------ docs/source/int_introduction.rst | 58 ++++---- docs/source/int_overview.rst | 22 ++- docs/source/int_started.rst | 68 ++++----- docs/source/requirements.txt | 1 + .../{int_source.rst => tech_source.rst} | 4 +- 9 files changed, 124 insertions(+), 173 deletions(-) delete mode 100644 docs/source/images/python_win_install.png rename docs/source/{int_source.rst => tech_source.rst} (96%) diff --git a/docs/source/conf.py b/docs/source/conf.py index 20a8c2ab..176c13b8 100644 --- a/docs/source/conf.py +++ b/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" diff --git a/docs/source/images/python_win_install.png b/docs/source/images/python_win_install.png deleted file mode 100644 index 320305d0631c49523d32daff88101e8bef5b00f7..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 98735 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≥gYCt&cOFSej4fv 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 L=G$`lFG2qU0Qyc; diff --git a/docs/source/int_customise.rst b/docs/source/int_customise.rst index 9cb4819c..4c82cc80 100644 --- a/docs/source/int_customise.rst +++ b/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 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 ------- @@ -54,8 +54,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 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. @@ -81,7 +82,8 @@ 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. + theme colour scheme. Otherwise, novelWriter will try to guess your icon theme, and may not pick + the most suitable one. Gustom GUI and Icons Theme diff --git a/docs/source/int_howto.rst b/docs/source/int_howto.rst index cccdf99d..b0be358d 100644 --- a/docs/source/int_howto.rst +++ b/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. 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. 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 `_ + 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 `__ + The tool is available at `peter88213.github.io/yw2nw `__ diff --git a/docs/source/int_introduction.rst b/docs/source/int_introduction.rst index 9b3bc4cf..b595d296 100644 --- a/docs/source/int_introduction.rst +++ b/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 +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. +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 +popular 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. + can 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. **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. + 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: diff --git a/docs/source/int_overview.rst b/docs/source/int_overview.rst index 7cbb146d..a43e7949 100644 --- a/docs/source/int_overview.rst +++ b/docs/source/int_overview.rst @@ -10,23 +10,19 @@ Overview :align: right :width: 220 -novelWriter is built on `Python 3 `_, 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 `_ as +the programming language, and `Qt 5 `_ 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 -contributions. +novelWriter is built for Linux first, and this is where it works best. However, it also runs fine +on Windows and MacOS due to being built with cross-platform tools. 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 `_, 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 `_. Please see the section on :ref:`a_custom_dict` for +how to handle spell checking in different languages. For install instructions, see :ref:`a_started`. -For information on how to add spell check dictionaries, see :ref:`a_custom_dict`. - Using novelWriter ================= @@ -45,7 +41,7 @@ read on. :ref:`a_fmt` – Essential Information This section 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 diff --git a/docs/source/int_started.rst b/docs/source/int_started.rst index 2db89a96..1d00aab7 100644 --- a/docs/source/int_started.rst +++ b/docs/source/int_started.rst @@ -10,7 +10,7 @@ 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/ @@ -19,7 +19,7 @@ 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 issues. + +.. 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 stops supporting Python versions that have reached end of life. If your + Linux distro still uses older Python versions, 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.8 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. diff --git a/docs/source/requirements.txt b/docs/source/requirements.txt index 19fc1423..ad8c84ca 100644 --- a/docs/source/requirements.txt +++ b/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 diff --git a/docs/source/int_source.rst b/docs/source/tech_source.rst similarity index 96% rename from docs/source/int_source.rst rename to docs/source/tech_source.rst index 42009995..29fc2907 100644 --- a/docs/source/int_source.rst +++ b/docs/source/tech_source.rst @@ -13,8 +13,8 @@ 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