languagetool README

The project's README from github.com/languagetool-org/languagetool. As one markdown file: README.md.

LanguageTool

LanguageTool is open-source proofreading software for English, Spanish, French, German, Portuguese, Polish, Dutch, and more than 20 other languages. It finds many errors that a simple spell checker cannot detect.

For more information, please see our homepage, at languagetool.org, this README, and CHANGES.

The LanguageTool core (this repo) is freely available under the LGPL 2.1 or later.

Docker

Try one of the following projects for a community-contributed Docker file:

github.com hub.docker.com/r
meyayl/docker-languagetool meyay/languagetool
Erikvl87/docker-languagetool erikvl87/languagetool
silvio/docker-languagetool silviof/docker-languagetool

Contributions

The development overview describes how you can contribute error detection rules.

For more technical details, see our dev pages.

Scripted installation and building

To install or build using a script, simply type:

#!/usr/bin/env sh
curl -L https://raw.githubusercontent.com/languagetool-org/languagetool/master/install.sh | sudo bash $options

If you wish to have more options, download the install.sh script. Usage options follow:

sudo bash install.sh <options>

Usage: install.sh <option> <package>
Options:
   -h --help                   Show help
   -b --build                  Builds packages from the bleeding edge development copy of LanguageTool
   -c --command <command>      Specifies post-installation command to run (default gui when screen is detected)
   -q --quiet                  Shut up LanguageTool installer! Only tell me important stuff!
   -t --text <file>            Specifies what text to be spellchecked by LanguageTool command line (default spellcheck.txt)
   -d --depth <value>          Specifies the depth to clone when building LanguageTool yourself (default 1).
   -p --package <package>      Specifies package to install when building (default all)
   -o --override <OS>          Override automatic OS detection with <OS>
   -a --accept                 Accept the oracle license at http://java.com/license. Only run this if you have seen the license and agree to its terms!
   -r --remove <all/partial>   Removes LanguageTool install. <all> uninstalls the dependencies that were auto-installed. (default partial)

Packages(only if -b is specified):
   standalone                  Installs standalone package
   wikipedia                   Installs Wikipedia package
   office-extension            Installs the LibreOffice/OpenOffice extension package

Commands:
   GUI                         Runs GUI version of LanguageTool
   commandline                 Runs command line version of LanguageTool
   server                      Runs server version of LanguageTool

Alternate way to build from source

Before start: you will need to clone from GitHub and install Java 17 and Apache Maven.

Warning: a complete clone requires downloading more than 500 MiB and needs more than 1 500 MiB on disk. This can be reduced, if you only need the last few revisions of the master branch by creating a shallow clone:

#!/usr/bin/env sh
git clone --depth 5 https://github.com/languagetool-org/languagetool.git

A shallow clone downloads less than 60 MiB, and needs less than 200 MiB on disk.

In the root project folder, run:

#!/usr/bin/env sh
mvn clean test

(Sometimes, you can skip Maven step for repeated builds.)

#!/usr/bin/env sh
./build.sh languagetool-standalone package -DskipTests

Test the result in languagetool-standalone/target/.

#!/usr/bin/env sh
./build.sh languagetool-wikipedia package -DskipTests

Test the result in languagetool-wikipedia/target.

Now, you can use the bleeding edge development copy of LanguageTool *.jar files, be aware that it might contain regressions.

How to run under Mac M1 or M2

  1. Install Brew for Rosetta:

    #!/usr/bin/env sh
    arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
    
  2. Install OpenJDK for Rosetta:

    #!/usr/bin/env sh
    arch -x86_64 brew install openjdk
    
  3. Install Maven for Rosetta:

    #!/usr/bin/env sh
    arch -x86_64 brew install maven
    
  4. Now, run the build scripts.

License

Unless otherwise noted, this software – the LanguageTool core – is distributed under the LGPL; see COPYING.txt.

languagetool (languagetool-org/languagetool)

Searching Database…

这是什么?一款开源校对软件,可以检查英语、德语、法语、西班牙语、波兰语、荷兰语等 25 种以上语言的语法和文风问题,能发现普通拼写检查器查不出的许多错误。
那它是需要安装的应用、Java 库,还是在线服务?三种都是:可以作为 Java 库使用,可以调用公共服务器上的 HTTP API,也可以搭建自己的服务器——从源码构建还会生成独立的 jar 文件。
我怎么把它跑起来?脚本安装器(install.sh)会负责安装或构建,你也可以选用社区提供的 Docker 镜像;从源码构建的方法也有文档说明。
从源码构建之前我需要准备什么?需要 Java 17 和 Apache Maven,再克隆一份代码仓库。
从源码构建会不会很占下载流量和磁盘空间?有一点:完整克隆要下载超过 500 MiB,磁盘上需要超过 1,500 MiB 的空间;不过只浅克隆最近的版本,就能降到 60 MiB 和 200 MiB 以内。
在 Apple Silicon 的 Mac 上能用吗?可以,通过 Rosetta 运行:README 里介绍了如何为 Rosetta 安装 Brew、OpenJDK 和 Maven,然后执行常用的构建脚本即可。
它只能查拼写错误吗?不是——这正是它的核心价值:它能查出普通拼写检查器发现不了的很多错误,覆盖 25 种以上语言。
我能试用刚构建出来的开发版吗?可以——从源码构建会在 languagetool-standalone/target/ 里生成最新的 jar 文件,但 README 提醒这些版本可能带有回归问题,想要稳定还是建议用正式发布版。
Size
6 GB
Stars
15.2K
Updated
CommitOct 18
Age
13y
Commits · 90 Days