Skip to content

Latest commit

 

History

History
140 lines (103 loc) · 9.38 KB

README.md

File metadata and controls

140 lines (103 loc) · 9.38 KB

Build SpellChecker-Plugin

SpellChecker Plugin

1. Introduction

The SpellChecker Plugin is a spellchecker plugin for the Qt Creator IDE. This plugin spell checks Comments and String Literals in source files for spelling mistakes and suggest the correct spelling for misspelled words, if possible.

Currently the plugin only checks C++ files and uses the Hunspell Spell Checker to check words for spelling mistakes. The plugin provides an options page in Qt Creator that can be used to configure the parsers as well as the spell checkers available.

To download a pre-built version of the plugin, refer to section 2.

To build the plugin self, see section 6.

The motivation for this plugin is that my spelling is terrible and I was looking for a plugin that could spell check my Doxygen comments. I feel that good comments are essential to any piece of software. I could not find one suitable to my needs so I decided to challenge myself to see if I can implement one myself. In one of my courses on varsity I investigated the Qt Creator source code and was amazed with the whole plugin system, thus it also inspired me to try and contribute to such a project.

I did look a lot at the code in the TODO plugin as a basis for my own implementation. I do not think that I have violated any licenses doing so since I have never just copied code from the plugin. If there are any places that can be problematic regarding any licenses, please contact me so that I can resolve the issues. I want to contribute to the Open Source Community, but it is not my intention to step on any toes in the process.

Buy Me A Coffee

Build with conan

# Set up venv
C:\Python\3.11\python.exe
python.exe -m venv .venv
# ps1
.\.venv\Scripts\Activate.ps1
# bash
source ...

# Setup conan
python -m pip install conan
conan profile detect
conan config install .conan

# Build
conan install . -pr cpp20
cmake --preset conan-default
cmake --build --preset conan-release

2. Pre-Built Plugins

I do create pre-built releases for each version of the plugin that I tag. The latest release can be obtained from the Releases page. Read the README.txt file associated with the release for information on how to install the plugin into the relevant Release version of Qt Creator.

Although I try to create binaries for the latest version of QtCreator, there is a bit of a delay from when a new version of QtCreator is released and a new version of the plugin is released. I started using GitHub Actions to build and package the releases and hope this will reduce the delay.

3. Using The Plugin

For a video demonstrating how to set up and use the plugin check out the following link: https://youtu.be/3Dg5u1Mrj0I (Thank you Jesper from KDAB).

If you want to read the steps yourself (probably with spelling mistakes): After opening Qt Creator and the plugin loaded successfully the following steps must be performed before starting to use the SpellChecker plugin:

  1. Make sure the plugin is enabled
    • Go to "Help" -> "About Plugins..." and make sure the SpellChecker plugin under Utilities is enabled.
  2. Set the Spell Checker
    • Go to "Tools" -> "Options..."
    • In the Options page, go to the "Spell Checker" options page.
    • On the "SpellChecker" tab, select the required Spell Checker in the dropdown box. Currently only the Hunspell Spell Checker will be available, but perhaps in future more might be added.
    • Set the "Dictionary" and "User Dictionary" paths for the spell checker to use.
      • English Dictionaries can be downloaded from: http://cgit.freedesktop.org/libreoffice/dictionaries/tree/en
      • Both the *.dic and *.aff files for the selected dictionary must be downloaded to the same folder.
      • NB: Make sure to use the "plain" link on the above page when downloading the dictionary files and not the file names directly.
      • The User Dictionary is a custom file used to store words added to the dictionary of the spell checker. If such a file does not exist, the plugin will create the file for this purpose. The plugin will attempt to create this file in the User Resource path. On Windows this is in %APPDATA%\QtProject\ and on Linux this is in ~/.config/QtProject/.
    • After setting the Spell Checker, restart QtCreator.
  3. Set the Parser Options
    • For the different available parsers there will be tabs with the settings for the parser. Currently there is only one parser available, a C++ Parser. Change its settings according to what is required. For more information regarding this parser, refer to section 5.
  4. Get commenting
    • While typing comments or opening a C++ text editor, the plugin will parse the comments and check words. If a spelling mistake is made the spell checker will add it to the output pane at the bottom of the page. There a user can perform the following actions on a misspelled word:
      • Give Suggestions: The spell checker will suggest alternative spellings for the misspelled word. The user can then replace the misspelled word with a suggested word.
      • Ignore Word: The word will be ignored for the current Qt Creator instance. Closing and opening Qt Creator will once again flag the word as a spelling mistake
      • Add Word: The word will be added to the user dictionary and will be not again be marked as a spelling mistake until the word is manually removed from the user dictionary.
      • Feeling Lucky: The word will be replaced with the first suggestion for the word. This option will only be available if there are at least one suggestion for the word.
    • Right clicking on a misspelled word will also allow the user to perform the above actions using the popup menu.
    • Under "Tools" -> "Spell Checker" the above actions can also be performed.
    • When the cursor is on a misspelled word the Qt Creator quick fix action will also pop up a menu to perform the above actions (Alt + Enter by default on most systems)

📖 Make sure to check out the wiki page 📖

4. Useful Widgets

The following useful widgets are added to the QtCreator user interface to allows the user to interact with the plugin:

  • Output Pane at the bottom of the IDE that shows the number of mistakes in the current editor, the misspelled words as well as suggestions for the words. From the pane there are controls to handle the mistakes.
  • Navigation Widget that can be added that shows all documents that have mistakes along with the number of mistakes on that page. Note that this widget will only show parsed files based on the "Only check current editor" setting of the plugin.
  • Give Suggestions Widget will give the user the option to replace all occurrences of a mistake in the current file with the specified word.

5. Settings

The following settings are available to the plugin

5.1. Parse current file vs current project

On the "SpellChecker" tab of the Spell Checker Options page is a setting "Only check current editor". If this setting is set the plugin will only parse the current open editor, reparsing it when changes are made. The results of parsed files will be remembered and still get listed in the Navigation Widget when a new file is opened.

When this setting is not set the plugin will parse all files in the project when a new project is switched to. For large projects this might take a bit of time to parse all files in the project. This has been successfully tested with the QtCreator sources.

5.2. Projects to ignore

A list of projects that will not be checked for spelling mistakes if opened, even of the setting is enabled to scan complete projects.

5.3. C++ Document Parser

The C++ parser can be configured to parse only Comments, only String Literals or both.

The parser also has settings that affects how the following types of words will be handled:

  • Email Addresses
  • Qt Keywords
  • Words in CAPS
  • Words containing numb3ers
  • Words_with_underscores
  • CamelCase words
  • Words that appear in source
  • Words.with.dots
  • Website Addresses
  • First comment in file (File license headers)

Apart from these settings, the plugin also attempts to remove Doxygen Tags in Doxygen comments, in an effort to reduce the number of false positives.

6. Building The Plugin

Since version 2.0.7 GitHub Actions are used to build the plugin in the cloud.

Since Qt Creator v7.0 qmake was removed as the build system and replaced it with cmake. In reaction the version of the plugin was stepped to version 3. With this a lot of effort went into getting the GitHub Action updated to build the plugin and documented steps were removed from this README. Please refer to the GitHub Action script for the steps to build.

TODO

The following list is a list with a hint into priority of some outstanding tasks I want to do.

  • Parse and ignore website URLs correctly. (Some work done on this but needs more testing/tweaks)
  • Add checking for QML files.