Skip to content

Commit

Permalink
fix: Update README to include Docker (#189)
Browse files Browse the repository at this point in the history
  • Loading branch information
Jason3S authored Jul 27, 2022
1 parent d0a710f commit 22cb783
Show file tree
Hide file tree
Showing 2 changed files with 84 additions and 1 deletion.
82 changes: 82 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,88 @@ This repo also allows installing the `cspell-cli` directly from GitHub:
npm install -g git+https://github.com/streetsidesoftware/cspell-cli
```

## Docker

```sh
docker run -v $PWD:/workdir ghcr.io/streetsidesoftware/cspell:latest "**"
```

## Usage

```
Usage: cspell lint [options] [globs...]

Check spelling

Options:
-c, --config <cspell.json> Configuration file to use. By default cspell
looks for cspell.json in the current directory.

-v, --verbose Display more information about the files being
checked and the configuration.

--locale <locale> Set language locales. i.e. "en,fr" for English
and French, or "en-GB" for British English.

--language-id <language> Force programming language for unknown
extensions. i.e. "php" or "scala"

--words-only Only output the words not found in the
dictionaries.

-u, --unique Only output the first instance of a word not
found in the dictionaries.

-e, --exclude <glob> Exclude files matching the glob pattern. This
option can be used multiple times to add
multiple globs.

--file-list <path or stdin> Specify a list of files to be spell checked. The
list is filtered against the glob file patterns.
Note: the format is 1 file path per line.

--no-issues Do not show the spelling errors.
--no-progress Turn off progress messages
--no-summary Turn off summary message in console.
-s, --silent Silent mode, suppress error messages.
--fail-fast Exit after first file with an issue or error.
-r, --root <root folder> Root directory, defaults to current directory.
--relative Issues are displayed relative to root.
--show-context Show the surrounding text around an issue.
--show-suggestions Show spelling suggestions.
--no-must-find-files Do not error if no files are found.
--cache Use cache to only check changed files.
--no-cache Do not use cache.
--cache-reset Reset the cache file.
--cache-strategy <strategy> Strategy to use for detecting changed files.
(choices: "metadata", "content")
--cache-location <path> Path to the cache file or directory. (default:
".cspellcache")
--dot Include files and directories starting with `.`
(period) when matching globs.
--gitignore Ignore files matching glob patterns found in
.gitignore files.
--no-gitignore Do NOT use .gitignore files.
--gitignore-root <path> Prevent searching for .gitignore files past
root.
--no-color Turn off color.
--color Force color.
--no-default-configuration Do not load the default configuration and
dictionaries.
--debug Output information useful for debugging
cspell.json files.
-h, --help display help for command


Examples:
cspell "*.js" Check all .js files in the current directory
cspell "**/*.js" Check all .js files from the current directory
cspell "src/**/*.js" Only check .js under src
cspell "**/*.txt" "**/*.js" Check both .js and .txt files.
cspell "**/*.{txt,js,md}" Check .txt, .js, and .md files.
cat LICENSE | cspell stdin Check stdin
```
## Versioning
The major version of `cspell-cli` tries to match the major version of `cspell`.
Expand Down
3 changes: 2 additions & 1 deletion cspell.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@
],
"words": [
"codeql",
"streetsidesoftware"
"streetsidesoftware",
"workdir"
]
}

0 comments on commit 22cb783

Please sign in to comment.