• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

lukeapage/node-markdown-spellcheck: spellchecks markdown files

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

lukeapage/node-markdown-spellcheck

开源软件地址(OpenSource Url):

https://github.com/lukeapage/node-markdown-spellcheck

开源编程语言(OpenSource Language):

JavaScript 100.0%

开源软件介绍(OpenSource Introduction):

Build Status Build status npm version Dependencies devDependency Status

Reads markdown files and spellchecks them, using open source Hunspell dictionary files.

CLI Usage

There are two modes, interactive fixing, which will allow you to fix mistakes and add exceptions to a custom dictionary and a report mode which will just report the list of errors.

# install
npm i markdown-spellcheck -g

# run in interactive mode
mdspell "**/*.md"

# see help & options
mdspell

CLI Options

Excluding patterns

Multiple patterns can be used on the command line and can use ! for negation. E.g.

mdspell '**/*.md' '!**/node_modules/**/*.md'

Ignore numbers (-n, --ignore-numbers)

Ignores numbers like 1.2 and 1,2.4.

Ignore acronyms (-a, --ignore-acronyms)

Ignores acronyms like NPM. Also ignores numbers. Does not ignore single letters e.g. U.

No suggestions (-x, --no-suggestions)

Suggestions are slow at present, so use this to remove them.

American English (--en-us)

Use the American English dictionary. We default to British English but will change in the next major to American.

British English (--en-gb)

Use the British English dictionary. We default to British English but will change in the next major to American.

Australian English (--en-au)

Use the Australian English dictionary.

Spanish (--es-es)

Use the Spanish dictionary.

Dictionary (-d, --dictionary)

Specify a custom Hunspell dictionary to load. The passed filename should not include a file extension and markdown-spellcheck will attempt to load the file with .aff and .dic extensions.

Interactive Mode

The default interactive mode shows you the context of the spelling mistake and gives you options with what to do about it. E.g.

Spelling - readme.md
 shows you the context of the speling mistake and gives you options
?   (Use arrow keys)
  Ignore
  Add to file ignores
  Add to dictionary - case insensitive
> Enter correct spelling
  spelling
  spieling
  spewing
  selling
  peeling

Where speling will be highlighted in red.

  • "Ignore" will ignore that word and not ask about it again in the current run. If you re-run the command again though, it will appear.
  • "Add to file ignores" will ignore the word in this file only.
  • "Add to dictionary - case insensitive" will add to the dictionary for all files and match any case. E.g. with the word Microsoft both Microsoft and microsoft would match.
  • "Add to dictionary - case sensitive" will add to the dictionary for all files and match the case that has been used. E.g. with the word Microsoft, the word microsoft will not match.

All exclusions will be stored in a .spelling file in the directory from which you run the command.

Target Relative Mode

Using the --target-relative (-t) option will augment the shared .spelling file with a relative .spelling file (sibling of the .md file) and give you the additional options with the interactive mode:

  • "Add to file ignores" will be replaced with "[Relative] Add to file ignores". There is no need to add file ignores into the shared .spelling file.
  • "[Relative] Add to dictionary - case insensitive" will add to the dictionary for all files within the current .md file and match any case.
  • "[Relative] Add to dictionary - case sensitive" will add to the dictionary for all files within the folder of the current .md file.

Report Mode

Using the --report (-r) option will show a report of all the spelling mistakes that have been found. This mode is useful for CI build reports.

.spelling files

The .spelling file is self documenting as it includes...

# markdown-spellcheck spelling configuration file
# Format - lines begining # are comments
# global dictionary is at the start, file overrides afterwards
# one word per line, to define a file override use ' - filename'
# where filename is relative to this configuration file

Use To Stop Spelling Regressions

Usage with npm

Add to your package.json and then run in report mode. If new spelling errors occur that are not ignored in the .spelling file, a error exit code will be set.

For instance, if your package.json has:

  "scripts": {
    "test": "gulp test"
  },

Change it to...

  "scripts": {
    "test": "mdspell -r **/*.md && gulp test"
  },

Usage in grunt

See grunt-mdspell.

Usage in gulp

Dictionaries being used

English-GB

See https://github.com/marcoagpinto/aoo-mozilla-en-dict.

Missing word? Raise it at https://github.com/marcoagpinto/aoo-mozilla-en-dict/issues.

English-US and English-AU

See http://wordlist.aspell.net/dicts/.

Missing word? Raise it at https://github.com/kevina/wordlist/issues.




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
上一篇:
timqian/resumd: Write resume with markdown发布时间:2022-08-18
下一篇:
Versal/word2markdown: Convert Word to Markdown, with images and math发布时间:2022-08-18
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap