TypoLima

What is TypoLima?

TypoLima is a command-line tool that automatically fixes common typographic issues in web content while being extremely careful not to break code. It only touches text content — never HTML tags, attributes, scripts, or template variables like {{ }} or <?php ?>.

The name comes from the Latin word lima (file/polish), representing the final meticulous polishing of a text — labor limae.

Features

Supported Languages

TypoLima supports 33+ languages with language-specific rules for quotes, spacing, and punctuation:

Installation

brew install heptau/tap/typolima

pipx install git+https://github.com/heptau/typolima.git

pip install git+https://github.com/heptau/typolima.git

git clone https://github.com/heptau/typolima.git
cd typolima
pip install .

Usage

Basic Commands

typolima --help

# Process a single file
typolima article.html --lang cs --in-place

# Dry run with diff
typolima *.html --lang en --dry-run --diff

# Recursive processing
typolima public/ --lang cs --recursive --in-place

Options

• --lang — Language code (cs, en, fr, de, etc.)
• --in-place — Modify files in place (default: output to stdout)
• --dry-run — Show what would be changed without modifying
• --diff — Show detailed diff (requires --dry-run)
• --recursive — Process directories recursively
• --aggressive — Convert (c) → ©, +- → ±, etc.
• --include PATTERN — Include files matching glob pattern (can be used multiple times)
• --exclude PATTERN — Exclude files matching glob pattern (can be used multiple times)
• --backup — Create .bak backup before modifying (requires --in-place)
• --auto-detect — Auto-detect language from HTML lang attribute, filename, or .typolimarc config
• --verbose — Show detailed statistics about changes (quotes, dashes, NBSP count)

Examples

Fix Czech HTML files

typolima content/*.html --lang cs --in-place

Before: "Ahoj" jdu k lesu
After: „Ahoj“ jdu k lesu

French with diff

typolima public/ --lang fr --recursive --dry-run --diff

Before: Salut?
After: Salut ?

Hugo post-build

typolima public/ --lang cs --recursive --in-place

Add to package.json: "postbuild": "typolima public/ --lang cs --recursive --in-place"

Aggressive mode

typolima text.md --lang en --aggressive

Converts: (c) → ©, (tm) → ™, -> → →, ==> → ⟹

File filtering with include/exclude

# Include only HTML files
typolima site/ --lang cs --recursive --include "*.html"

# Exclude partials (files starting with _)
typolima public/ --lang de --recursive --exclude "_*"

# Combined: include html but exclude minified
typolima site/ --lang fr --include "*.html" --exclude "*.min.html"

Backup before in-place changes

# Create .bak backup files before modifying
typolima site/ --lang cs --in-place --backup

Creates backup files (e.g., index.html.bak) before modifying original files.

Auto-detect language

# Auto-detect from HTML lang attribute, filename pattern, or .typolimarc
typolima site/ --recursive --auto-detect

Automatically detects language from: <html lang="fr">, filename like article.cs.html, or .typolimarc config file.

Verbose statistics

# Show detailed statistics about changes
typolima site/ --lang cs --verbose

Shows: Changed files count, quotes fixed, dashes converted, NBSP inserted.

Config File

# .typolimarc example
language: cs
recursive: true
exclude:
  - "_*"
  - "*.min.*"

Place .typolimarc in your project root to set default options.