FarNet.RightWords 5.0.0

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package FarNet.RightWords --version 5.0.0                
NuGet\Install-Package FarNet.RightWords -Version 5.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FarNet.RightWords" Version="5.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FarNet.RightWords --version 5.0.0                
#r "nuget: FarNet.RightWords, 5.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install FarNet.RightWords as a Cake Addin
#addin nuget:?package=FarNet.RightWords&version=5.0.0

// Install FarNet.RightWords as a Cake Tool
#tool nuget:?package=FarNet.RightWords&version=5.0.0                

RightWords

RightWords is the FarNet module for Far Manager. It provides the spell-checker based on WeCantSpell.Hunspell. Hunspell dictionaries are used by OpenOffice and may be found on OpenOffice.org.

Interface

Project

Credits

WeCantSpell.Hunspell - A port of Hunspell for .NET https://github.com/aarondandy/WeCantSpell.Hunspell


Installation

Contents

How to install and update FarNet and modules: https://github.com/nightroman/FarNet#readme

OpenOffice dictionaries: http://wiki.services.openoffice.org/wiki/Dictionaries

Dictionary structure (example):

%FARPROFILE%\FarNet\RightWords\

    English\
        en_GB.aff  (Hunspell affix file)
        en_GB.dic  (Hunspell words file)

    Russian\
        ru_RU.aff  (Hunspell affix file)
        ru_RU.dic  (Hunspell words file)

    RightWords.dic          (user common words)
    RightWords.English.dic  (user words for English)
    RightWords.Russian.dic  (user words for Russian)

Language dictionaries are up to a user. Directories may have any names, e.g. above English, Russian. These names are used in the dictionary menu and as suffixes in user dictionary names (English ~ RightWords.English.dic).

Encoding (UTF-8 is recommended)

FarNet 6 and .NET Core do not support so much encodings as .NET Framework. UTF-8 is recommended for all dictionaries. How to convert dictionaries in Far Manager editor:

  • .aff - open, find and change SET ... to SET UTF-8, save as UTF-8
  • .dic - open and save as UTF-8

Options

Contents

[F11] \ FarNet \ Drawers \ Spelling mistakes

Switches "Spelling mistakes" highlighting in the current editor.

Options \ Plugin configuration \ FarNet \ Drawers \ Spelling mistakes

The dialog with permanent options:

  • Mask

    Specifies the files for "Spelling mistakes" highlighting turned on.

  • Priority

    Specifies the color priority.


Settings

Contents

Module settings: [F11] \ FarNet \ Settings \ RightWords

WordPattern

Defines the regular expression pattern for word recognition in texts.

The default pattern: [\p{Lu}\p{Ll}]\p{Ll}+ (words with 2+ letters, "RightWords" is treated as "Right" and "Words")

All capturing groups (...) are removed from the word before spell-checking. This is used for checking spelling of words with embedded "noise" parts, like the hotkey markers & in .lng or .restext files. Use not capturing groups (?:) in all other cases where grouping is needed.

Nested capturing groups are not supported and they are not really needed.

Example pattern for .lng and .restext files: [\p{Lu}\p{Ll}](?:\p{Ll}|(&))+

SkipPattern

Defines the regular expression pattern for text areas to be ignored. The default pattern is null (not specified, nothing is ignored).

Sample pattern (using (?x:) for comments and ignored white spaces):

(?x:
    \w*\d\w* # words with digits
    | "(?:\w+:|\.+)?[\\/][^"]+" # quoted path-like text
    | (?:\w+:|\.+)?[\\/][^\s]+ # simple path-like text
)

HighlightingBackgroundColor
HighlightingForegroundColor

Highlighting colors: Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White.

UserDictionaryDirectory

The custom directory of user dictionaries. Environment variables are expanded. The default is the module roaming directory.

MaximumLineLength

If it is set to a positive value then it tells to not check too long lines and highlight them all. Otherwise too long lines may cause lags on highlighting.


Contents

This menu is called by [F11] \ RightWords.

Commands:

  • Correct word (editor, dialog, command line)

    Checks spelling and shows suggestions for the current word. See Correction list.

  • Correct text (editor)

    Checks spelling and shows suggestions in the selected text or starting from the caret position. See Correction list.

See also Options.


Correction list

Contents

This list shows suggestions for correcting a misspelled word and additional commands.

Additional commands:

  • Ignore

    Ignores the word once.

  • Ignore All

    Ignores the word in the current session.

  • Add to Dictionary

    Adds the word to the user dictionary.


Add to Dictionary

Contents

Add to Dictionary supports the common and language dictionaries.

On adding a word to the common dictionary, choose one of the suggested variants.

On adding to a language dictionary, provide two stems: the new word and sample existing in the dictionary. If the sample stem is empty the word is added as is.

Examples:

English stems: "plugin" and "pin". These forms become correct:

plugin   plugins   Plugin   Plugins

Russian stems: "плагин" and "камин". These forms become correct:

плагин   плагины   Плагин   Плагины
плагина  плагинов  Плагина  Плагинов
плагину  плагинам  Плагину  Плагинам
плагином плагинами Плагином Плагинами
плагине  плагинах  Плагине  Плагинах

CAUTION: Mind capitalization, e.g. "plugin", not "Plugin".

User dictionaries are UTF-8 text files in the module roaming directory: RightWords.dic (common) and files like RightWords.English.dic (languages).


There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
5.1.0 40 12/6/2024
5.0.0 391 11/19/2023
4.0.1 590 1/1/2023
4.0.0 366 11/18/2022
3.0.1 474 8/25/2022
3.0.0 453 7/19/2022
2.5.2 476 6/11/2022
2.5.1 498 6/8/2022
2.5.0 464 5/18/2022
2.4.0 1,055 12/3/2021
2.3.3 525 1/8/2021
2.3.2 504 1/1/2021
2.3.1 416 12/27/2020
2.3.0 514 10/27/2020
2.2.0 697 2/1/2020
2.1.7 1,312 8/9/2016
2.1.6 1,273 2/13/2016
2.1.5 1,888 3/28/2014
2.1.4 1,155 12/31/2013