Merge branch 'develop'

CHANGELOG.rst

@@ -1,3 +1,10 @@
+Version 1.1.0 (2020-07-17)
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+- New: Possibility to set a white background for preview images (favourably
+  for dark mode themes)
+- New: Added instructions how to install Inkscape 1.0 on Ubuntu 18.04/ 20.04
+  since it is not shipped by default with these distributions
+
 Version 1.0.1 (2020-05-12)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 - Fixed: List index out of range if latex compilation fails 

docs/source/install/linux.rst

@@ -21,26 +21,45 @@
 Preparation
 ===========
 
-1. Make sure that Inkscape version 1.0 or later is installed on your system via your favorite
-   package manager, e.g.
+1. Make sure that |Inkscape| or later is installed on your system via your favorite
+   package manager.
 
-   .. code-block:: bash
+   On **Ubuntu 18.04** + **20.04** and its derivates |Inkscape| is not part of
+   the default distribution. Perform the following steps to install it:
+
+   - Remove any old version of Inkscape
+
+       .. code-block:: bash
+
+            sudo apt remove inkscape
+
+   - Add the Inkscape repository to your apt package manager:
+
+       .. code-block:: bash
+
+            sudo add-apt-repository ppa:inkscape.dev/stable
+            sudo apt update
+
+   - Install |Inkscape|
+
+       .. code-block:: bash
 
-        sudo apt install inkscape
+            sudo apt install inkscape
 
    Check if it is able to launch. You can verify this by invoking :bash:`inkscape --version` from
    a terminal. It should output :bash:`1.0`.
 
    .. important::
-       |TexText| will not function properly if you installed |Inkscape| via **SNAP** or **FLATPACK**.
+       |TexText| will not function if you installed |Inkscape| via **SNAP** or **FLATPACK**.
        The reason is that |Inkscape| will run in sandboxed mode in these environments and, hence,
-       cannot access you LaTeX distribution to compile your snippets!
+       cannot access you LaTeX distribution to compile your snippets! This is a conceptional
+       problem of snap/ flatpack, not of |TexText|.
 
 2. Make sure that an operational LaTeX distribution is installed on your system. You can verify
    this by invoking at least one of :bash:`pdflatex --version`, :bash:`xelatex --version`, and
    :bash:`lualatex --version` in a terminal.
 
-3. Optional: If you whish to have syntax highlighting and some other :ref:`nice features <usage-gui-config>`
+3. Optional: If you wish to have syntax highlighting and some other :ref:`nice features <usage-gui-config>`
    enabled in the |TexText|-Gui install GTKSourceView:
 
    .. code-block:: bash

docs/source/usage/gui.rst

@@ -309,6 +309,16 @@ output.
 .. figure:: ../images/textext-dialog-preview.png
    :alt: Annotated TexText dialog
 
+If you are using a darkmode theme you can select the option ``White preview background``
+option from the ``View`` menu |usage-label-8|:
+
+.. image:: ../images/textext-dialog-preview-standardmode.png
+   :width: 45%
+   :alt: Selection of white preview background
+.. image:: ../images/textext-dialog-preview-darkmode.png
+   :width: 45%
+   :alt: Selection of white preview background
+
 Finally, click the ``Save`` button to insert the compiled code into your document.
 
 .. note::

textext/VERSION

@@ -1 +1 @@
-1.0.1
+1.1.0