typst-languagetool

Spellcheck typst files with LanguageTool.

Overview

1. compile the document
2. extract text content
3. check text with languagetool
4. map results back to the source

Use special styling for spellchecking

// use styling for spellcheck only in the spellchecker
// keep the correct styling in pdf or preview
// should be called after the template
#show: lt()

// use styling for spellcheck in pdf or preview
// should be called after the template
#show: lt(overwrite: true) 

#let lt(overwrite: false) = {
	if not sys.inputs.at("spellcheck", default: overwrite) {
		return (doc) => doc
	}
	return (doc) => {
		show math.equation.where(block: false): it => [0]
		show math.equation.where(block: true): it => []
		show bibliography: it => []
		show par: set par(justify: false, leading: 0.65em)
		set page(height: auto)
		show block: it => it.body
		show page: set page(numbering: none)
		show heading: it => if it.level <= 3 {
			pagebreak() + it
		} else {
			it
		}
		doc
	}
}

LanguageTool Backend

• different LanguageTool backends can be used to check the text

Bundled

• requires maven
• add feature bundle-jar
• specify --bundled

External JAR

• requires JAR with languagetool
• add feature external-jar
• specify jar_location=...

Remote Server

• add feature remote-server
• specify host=... and port=...

Usage

• terminal
  • install command line interface (CLI)
    • cargo install --git=https://github.com/antonWetzel/typst-languagetool cli --features=...
  • Check on time or watch for changes
    • typst-languagetool check ...
    • typst-languagetool watch ...
  • Path to check
    • typst-languagetool watch --path=<directory or file>
    • typst-languagetool cehck --path=<file>
  • Different main file can be used
    • defaults to path
    • --main=<file>
  • Project root can be changed
    • defaults to main parent folder
    • --root=<path>
• vs-codium/vs-code
  • install language server protocal (LSP)
    • cargo install --git=https://github.com/antonWetzel/typst-languagetool lsp --features=...
  • install generic lsp (editors/vscodium/generic-lsp/generic-lsp-0.0.1.vsix)
  • configure options (see below)
  • hints should appear
    • first check takes longer

LSP Options

/// Additional allowed words for language codes
dictionary: HashMap<String, Vec<String>>,
/// Languagetool rules to ignore (WHITESPACE_RULE, ...) for language codes
disabled_checks: HashMap<String, Vec<String>>,

/// preferred language codes
languages: Vec<String>,

/// use bundled languagetool
bundled: bool,
/// use external JAR for languagetool
jar_location: Option<String>,
/// host for remote languagetool
host: Option<String>,
/// port for remote languagetool
port: Option<String>,

/// Size for chunk send to LanguageTool
chunk_size: usize,
/// Duration to wait for additional changes before checking the file
/// Leave empty to only check on open and save
on_change: Option<std::time::Duration>,

/// Project Root
root: Option<PathBuf>,
/// Project Main File
main: Option<PathBuf>,