TexText - Re-editable LaTeX and typst graphics for Inkscape
===========================================================

TexText is a Python extension for the vector graphics editor
`Inkscape <http://www.inkscape.org/>`__ providing the possibility to add
and *re-edit* LaTeX and `typst <https://typst.app/>`__ generated SVG elements
to your drawing (a LaTeX and/or typst distribution is required).

.. figure:: images/textext-with-inkscape.png
   :alt: TexText dialog with Inkscape


Key features
------------

-  Compatible with Inkscape **1.x** and **0.92**. Compatibility chart:

   +---------------------+---------------------------------------------------------------------+
   | Inkscape            | TexText                                                             |
   +=====================+=====================================================================+
   | 1.4.x               | `>=1.11.0 <https://github.com/textext/textext/releases>`_           |
   +---------------------+---------------------------------------------------------------------+
   | 1.3.x               | `1.10.2 <https://github.com/textext/textext/releases/tag/1.10.2>`_  |
   +---------------------+---------------------------------------------------------------------+
   | 1.2.x, 1.1.x, 1.0.x | `1.8.2 <https://github.com/textext/textext/releases/tag/1.8.2>`_    |
   +---------------------+---------------------------------------------------------------------+
   | 0.92.x              |  `0.11 <https://github.com/textext/textext/releases/tag/0.11.0>`_   |
   +---------------------+---------------------------------------------------------------------+
-  Windows/ Linux/ MacOS support
-  LaTeX and typst generated SVG elements can be re-edited later
-  Multi-line editor with syntax highlighting
-  Compilation with **PdfLaTeX**, **XeLaTeX**, **LuaLaTex**, or **typst**
-  Interoperable scaling in TexText and Inkscape
-  Customizable TeX preamble (additional packages, parskip, parindent, etc.)
-  Colorization via TeX commands/ Inkscape is kept after re-editing
-  Alignment anchor of the produced output
-  Font size match with Inkscape text
-  Preview images
-  Compatibility with TexText down to version 0.4.x

.. note::
    - If you are using Inkscape **1.3.x** please use
      the `discontinued release 1.10.2 of TexText <https://github.com/textext/textext/releases/tag/1.10.2>`_
    - If you are using Inkscape **1.2.x**, **1.1.x**, or **1.0.x** please use
      the `discontinued release 1.8.2 of TexText <https://github.com/textext/textext/releases/tag/1.8.2>`_
    - If you are using Inkscape **0.92** please use the :ref:`discontinued release 0.11 of TexText <tt0x>`

.. _installation-toc:

.. toctree::
    :caption: Installation
    :maxdepth: 1

    install/linux
    install/windows
    install/macos
    install/advanced


.. _usage-toc:

.. toctree::
    :caption: Usage
    :maxdepth: 1

    usage/gui
    usage/faq
    usage/troubleshooting


.. toctree::
    :caption: Credits
    :maxdepth: 1

    history.rst
    authors.rst


.. toctree::
    :caption: Changelog
    :maxdepth: 2

    changelog.rst
