Download Providers

Requirements

How to Install and Use

  1. Install the requirements listed above
  2. Install this extension
  3. Reload the VS Code window if necessary
  4. Open a LATEX or a Markdown document, or open a new file and change the language mode to LATEX or Markdown (open the Command Palette and select Change Language Mode)
  5. Wait until ltex-ls has been found; if necessary, LTEX+ downloads it for you. Alternatively, you can choose offline installation.
  6. Grammar/spelling errors will be displayed! (if there are any)

Offline Installation

The key component of LTEX+, the LTEX+ Language Server (ltex-ls), which also includes Java and LanguageTool, cannot be included in the LTEX+ version distributed on the Visual Studio Marketplace due to file size restrictions.

When activated for the first time, LTEX+ will automatically download and use a hard-coded ltex-ls-plus release from GitHub. It will be stored in the extension folder. Note that after this initial installation, no connection to the Internet is necessary. Checking your documents is completely offline.

If you don’t have an Internet connection, or if you simply don’t want this, there are two alternatives.

In case there are any problems, you will find additional debug info in View → Output → LTeX+ Language Server and LTeX+ Language Client.

First Alternative: Download the Offline Version of LTEX+

Download the offline version of LTEX+ at the Releases page on GitHub and install it via Extensions: Install from VSIX... on the Command Palette. The offline version already includes ltex-ls-plus (and the portable Java distribution). Reload the Visual Studio Code window after installing the offline version. It’s important to choose the right offline version. If you have an AMD or Intel processor, you need the x64 version. The aarch64 version is the right choice for ARM processors like Apple Silicon M series or Qualcomm Snapdragon. For LTEX+ prior 15.0.0, aarch64 is not available.

Second Alternative: Download ltex-ls-plus/Java Manually

Download ltex-ls-plus and/or a Java distribution (e.g., Eclipse Adoptium) individually and set ltex.ltex-ls-plus.path and/or ltex.java.path to the respective locations. If you download a binary release of ltex-ls-plus (those include a platform in the archive file name), then that release already includes Java and you don’t need to set ltex.java.path.

Note that the versions of ltex-ls-plus and/or Java have to satisfy the following requirements:

  • Each version of LTEX+ has been tested with exactly one version of ltex-ls, which is the version that LTEX+ automatically downloads. If you download ltex-ls-plus manually, be sure to use this version of ltex-ls. An older or a newer version of ltex-ls-plus might work, or it might not.

    For this reason, this approach is not recommended as automatically updated versions of LTEX+ (by Visual Studio Code) might not be compatible anymore with your manually downloaded version of ltex-ls. If you choose this approach, remember to update ltex-ls-plus if LTEX+ doesn’t work anymore.

    To find out which version a particular version of LTEX+ uses, check the changelog for Update LTEX+ LS to X.Y.Z. If there is no entry of this form in the changelog for the version of LTEX+ you want to use, use the entry of the first previous version of LTEX+ that has such an entry.

  • The version of Java must be at least 11. Some Java distributions offer a JRE (Java Runtime Environment) and a JDK (Java Development Kit); in this case, the JRE is sufficient.

If you download Java, you can also decide to install it system-wide. In this case, LTEX+ should be able to automatically detect its location. If not, you can still set ltex.java.path to the location of your system-wide installation.

Reload the Visual Studio Code window after installing ltex-ls-plus and/or Java.