Grammalecte wrapper for Visual Studio Code/Wrapper pour Grammalecte

French version below. Version française plus bas.

English version

This is a wrapper for the Grammalecte French spell and grammar checker. It will only work on French text as it doesn't support any other languages. Just like Grammalecte itself, it runs entirely on your machine and doesn't send anything to a server.

Requirements

To make it run, you will need:

Python 3.
- If you are on Linux, it is probably already installed and the default settings will work just fine. If it is not the case, install it with the standard way to install packages on your distribution.
- If you are on Windows:
  - I suggest you install it from the Microsoft Store if don't already have Python.
  - You will have to change the value of grammalecte.pythonPath to use python.exe instead of the default.
Grammalecte: You must download it, un-compress it and change the value of grammalecte.pathToGrammalecteCli so that it points to the grammalecte-cli.py script.
- If you are on Linux, something like the default value of grammalecte.pathToGrammalecteCli will work.
- If you are on Windows, something like this will work C:\Users\Bob\Downloads\grammalecte-v2.1.1\grammalecte-cli.py.

Features

Spell and grammar checking. Checking is done on the fly as you type, open a new document or save. The errors are marked in the text and reported in the bottom panel of VSCode. You will also find there the suggestion made by Grammalecte.
A command named grammalecte.format to format your files with Grammalecte so they respect French typography standard. For instance, it will replace base quotes ' with a typographic version ’, add unbreakable spaces before French quotes (« and »), question mark, exclamation mark…
A command named grammalecte.check to manually check a file. This is meant to work with the grammalecte.runOnTheFly option.
A command named grammalecte.clear to force a clearing of all errors in all documents.
Unbreakable spaces are highlighted so you can spot them more easily.

Settings

Name	Description	Default Value	Recommandation
`grammalecte.allowedExtension`	Comma separated list of file extensions on which to enable the extension.	`.md,.rst,.adoc,.asciidoc,.creole`
`grammalecte.pythonPath`	Path to the Python 3 implementation to run Grammalecte.	`python3`	If Python 3 is in your PATH, you don't need to use an absolute path.
`grammalecte.pathToGrammalecteCli`	Absolute path to the Grammalecte CLI script	`~/.local/grammalecte/grammalecte-cli.py`	Unless you unpack it at the default location, it must be changed.
`grammalecte.reportSpacesOnLineStart`	Whether to report starting white spaces as errors.	`false`	If you work on Markdown files with indented lines, it's better to keep this at `false`.
`grammalecte.restoreInitialWhitespacesAfterFormat`	Whether to restore initial indentation on line after formatting a file.	`true`	If you work on Markdown files with indented lines, it's better to keep this at `true` otherwise formatted document will be messed up.
`grammalecte.reportFormatError`	Whether to report formatting error that would be fixed by the format command.	`true`
`grammalecte.reportComma`	Whether to report missing comas.	`true`
`grammalecte.runOnTheFly`	Whether to run Grammalecte on the fly, as you type or save.	`true`	If you find this confusing and want to see and handle errors only when you choose, disable this and use the `grammalecte.check` and `grammalecte.clear` commands.

Licensing

This plugin is not affiliated with Grammalecte.
This plugin is licensed under the MIT license, the text is present in this repository.
Grammalecte is publish under the GPLv3 license.
- The fact that the programs have different licenses isn't be a problem: this VSCode extension only make basic calls to the Grammalecte CLI. This case is covered here if you want to learn more about this.

Version française

Cette extension est un wrapper pour le correcteur orthographique et grammatical Grammalecte. Elle ne peut fonctionner que sur des textes français, seule langue supportée par Grammalecte. Comme Grammalecte, tout est exécuté sur votre machine, rien n'est envoyés sur des serveurs distants.

Prérequis

Pour faire fonctionner cette extension, il faut:

Python 3.
- Si vous utilisez Linux, Python 3 est probablement déjà installé et la configuration par défaut trouvera cette installation. Si ce n'est pas le cas, utilisez la méthode standard d'installation de votre distribution.
- Si vous utilisez Windows:
  - Je vous conseille d'installer Python via le Microsoft Store si vous ne l'avez pas déjà.
  - Vous devez changer la valeur de grammalecte.pythonPath pour utiliser python.exe.
Grammalecte: vous devez le télécharger, le décompresser et changer la valeur de grammalecte.pathToGrammalecteCli pour y mettre le chemin vers le script grammalecte-cli.py.
- Sous Linux, vous pouvez vous inspirer de la valeur par défaut.
- Sous Windows, il faut utiliser quelque chose comme ça: C:\Users\Bob\Downloads\grammalecte-v2.1.1\grammalecte-cli.py

Fonctionnalités

Correction orthographique et grammaticale. La correction est lancée au fur et à mesure de la frappe, quand vous ouvrez un nouveau document ou sauvegardez. Les erreurs sont marquées sous le texte et listées dans le panneau inférieur de VSCode. Vous y verrez aussi les suggestions de Grammalecte.
Une commande nommée grammalecte.format qui va formatter le fichier courant suivant les règles de typographie française. Par exemple, elle va remplacer les apostrophes simples par des apostrophes typographiques, ajouter une espace insécable avant les guillemets, les points d'exclamations…
Une commande nommée grammalecte.check pour lancer les vérifications sur un fichier manuellement. Cette commande va de pair avec l'option grammalecte.runOnTheFly (voir plus bas).
Une commande nommée grammalecte.clear pour forcer la suppression de toutes les erreurs dans tous les documents. Cette commande va de pair avec la commande précédente.
Les espaces insécables sont mises en avant pour faciliter leur identification.

Paramètres

Name	Description	Default Value	Recommandation
`grammalecte.allowedExtension`	Liste d'extensions de fichier chacune séparées par des virgules pour lesquelles l'extension sera active.	`.md,.rst,.adoc,.asciidoc,.creole`
`grammalecte.pythonPath`	Chemin vers la version de Python 3 à utiliser pour lancer Grammalecte.	`python3`	Si Python 3 est dans votre PATH, vous n'avez pas besoin d'utiliser un chemin absolu.
`grammalecte.pathToGrammalecteCli`	Chemin absolu vers la CLI de Grammalecte.	`~/.local/grammalecte/grammalecte-cli.py`	Il faut changer cette valeur à moins d'utiliser l'emplacement par défaut et d'être sous Linux
`grammalecte.reportSpacesOnLineStart`	Rapporter les espaces en début de ligne comme une erreur.	`false`	Si vous travailler avec des fichiers Markdown qui ont fréquemment des espaces attendus en début de ligne, mieux vaut laisser cette option à faux.
`grammalecte.restoreInitialWhitespacesAfterFormat`	Conserver les indentations initiales de chaque ligne après un formatage du fichier.	`true`	Si vous travaillez avec des fichiers Markdown qui ont fréquemment des espaces attendus en début de ligne, mieux vaut laisser cette option à vrai sous peine de perdre l'indentation du document après un formatage.
`grammalecte.reportFormatError`	Montrer les erreurs de formatage qui seraient corrigées par la commande de formatage.	`true`
`grammalecte.reportComma`	Montrer les soucis avec les virgules.	`true`
`grammalecte.runOnTheFly`	Lancer Grammalecte au fur et à mesure quand vous tapez le texte ou sauvegardez le document.	`true`	Si vous trouvez que voir les erreurs au fur et à mesure est un problème et que vous préférez voir et traiter les erreurs quand vous voulez, désactivez cette option et utilisez les commandes `grammalecte.check` et `grammalecte.clear`.

Licence

Cette extension n'est pas liée à Grammalecte.
Cette extension est publiée sous la licence MIT dont le texte est inclus dans ce dépôt.
Grammalecte est publiée sous la license GPLv3.
- Cette différence de license n'est pas un problème : cette extension fait des apples basiques à la CLI de Grammalecte. Ce cas est couvert par la GPL, voir ici pour en savoir plus.

grammalecte

jenselme