emacs-languagetool / eglot-ltex

Eglot Clients for LTEX
GNU General Public License v3.0
34 stars 9 forks source link
checker eglot emacs grammar languagetool ltex

License: GPL v3 JCS-ELPA

eglot-ltex

Eglot Clients for LTEX

CI

Eglot client leveraging LTEX Language Server.

πŸ’Ύ Quickstart

πŸ” Step 1. Install LTEX language server through LTEX's homepage

Link https://github.com/valentjn/ltex-ls

Extract the .tar.gz file to any location you want.

πŸ” Step 2. Configure your Emacs configuration

Consider adding this to your configuration.

(use-package eglot-ltex
  :ensure t
  :hook (text-mode . (lambda ()
                       (require 'eglot-ltex)
                       (eglot-ensure)))
  :init
  (setq eglot-ltex-server-path "path/to/ltex-ls-XX.X.X/"
        eglot-ltex-communication-channel 'stdio))         ; 'stdio or 'tcp

πŸ”§ Configuration

Create .dir-locals.el file in the project root directory to configure the ltex language server, for example:

((nil .
  ((eglot-workspace-configuration
    . (:ltex-ls  (:language  "en-US"
                  :additionalRules (:motherTongue "de-DE")))))))

You can find all possible ltex configuration options here. See the Eglot manual on how to translate the LSP options into the property-list format that Eglot requires.

πŸ› οΈ Contribute

PRs Welcome Elisp styleguide Donate on paypal Become a patron

If you would like to contribute to this project, you may either clone and make pull requests to this repository. Or you can clone the project and establish your own branch of this tool. Any methods are welcome!

πŸ”¬ Development

To run the test locally, you will need the following tools:

Install all dependencies and development dependencies:

$ eask install-deps --dev

To test the package's installation:

$ eask package
$ eask install

To test compilation:

$ eask compile

πŸͺ§ The following steps are optional, but we recommend you follow these lint results!

The built-in checkdoc linter:

$ eask lint checkdoc

The standard package linter:

$ eask lint package

πŸ“ P.S. For more information, find the Eask manual at https://emacs-eask.github.io/.

⚜️ License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

See LICENSE for details.