nexoniarz/Finch
Watch
1
0
Fork
You've already forked Finch
 0
mirror of https://github.com/Nexoniarz/Finch.git synced 2026-11-03 16:54:25 +00:00
Code Issues Projects Releases Packages Wiki Activity
Finch/editors/kate
History
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Nexoniarz bb9702aeba Finch 2.5.0: docs (EN, PL), Kate and VS Code for the new features 
- cheat sheets, technicians' and engineers' guides: "\(x)", test blocks, finch fmt, finch.toml,
  the build cache, the chain of calls, threads and atomics, C++/Rust/Android, struct #defines,
  passing structs, why there is no warning for big copies
- Kate (version 4) and VS Code: code inside text, test, min/max/abs/clamp/assert/atomic_...
- finch.toml's name is used only for its entry; other files of the project keep their own name

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016GzNP6r8dg6WDxUVZy8wjL
2026-10-29 11:34:41 +01:00
..
finch.xml Finch 2.5.0: docs (EN, PL), Kate and VS Code for the new features 2026-10-29 11:34:41 +01:00
install.sh CMake: enable C (Homebrew LLVM's config needs it); Kate: highlighting, language server setup, install script 2026-10-09 00:36:44 +02:00
lspclient.json CMake: enable C (Homebrew LLVM's config needs it); Kate: highlighting, language server setup, install script 2026-10-09 00:36:44 +02:00
README.md CMake: enable C (Homebrew LLVM's config needs it); Kate: highlighting, language server setup, install script 2026-10-09 00:36:44 +02:00

README.md

Finch in Kate

Syntax highlighting and the Finch language server for Kate (and KWrite / KDevelop, which share Kate's highlighting engine).

Install

editors/kate/install.sh

It copies finch.xml to ~/.local/share/org.kde.syntax-highlighting/syntax/ and adds a finch entry to ~/.config/kate/lspclient/settings.json (your other servers are kept). Then:

  1. Restart Kate.
  2. Settings → Configure Kate → Plugins: enable LSP Client (and Build & Run for the next part).
  3. Make sure finch is on your PATH (finch version in a terminal).

Open a .fch file: errors appear as you type, hovering shows types and docs, Ctrl+Space completes (fields and methods after .), Go to Definition and the Symbols outline work, and parameter hints pop up inside (…).

Running and building

Build & Run plugin → Add target set, then add targets with these commands (the working folder can be %d, the folder of the current file):

Target Command
Run finch run %f
Build finch build %f

Give one of them a shortcut in Settings → Configure Keyboard Shortcuts (search for "Build"). Finch's errors have the file:line:column: error: form, so Kate lists them and jumps to the line on click.

By hand

  • Highlighting: copy finch.xml into ~/.local/share/org.kde.syntax-highlighting/syntax/ (Windows: %LOCALAPPDATA%\org.kde.syntax-highlighting\syntax\).
  • Language server: Settings → Configure Kate → LSP Client → User Server Settings, and add the finch entry from lspclient.json inside "servers".