Gringow for VS Code
Navigate and preview Gringow translations without leaving your editor.
Works with both VS Code and VS Code Insiders version 1.96 or newer.
Features
- Go to Definition and Cmd/Ctrl+Click navigation from
g, gid, and gs tagged templates to their entries in the configured translation cache.
- HTML navigation from the cache ID in
<g-gringow data-cache-id="gid_..."> elements.
- A Navigate to translation document link on every supported expression.
- Translation hovers with the original text and up to three translations, ordered by your configured locales and kept compact for editor readability.
- Live cache refresh when the configured cache file is created, changed, deleted, or repaired after invalid JSON.
- Support for files selected by the
globby pattern in your Gringow configuration, including TypeScript, JavaScript, React, JSX, and HTML projects.
Supported tagged templates:
g`Hello world`
gid`gid_a78a4d60de586f5309350dd01f7b2f47`
gs`Welcome, ${name}`
Usage
- Open a workspace containing a
gringow.config.* file and its configured translation cache.
- Open a source file matched by the configuration's
globby pattern.
- Hover a supported expression to preview its cached translations.
- Use Go to Definition, Cmd/Ctrl+Click, or the Navigate to translation link to open the matching cache entry.
For plain HTML, navigation is available on valid cache IDs:
<g-gringow data-cache-id="gid_a78a4d60de586f5309350dd01f7b2f47"></g-gringow>
Requirements
- VS Code or VS Code Insiders 1.96.0 or newer.
- A valid
gringow.config.* file in the workspace.
- A translation cache at the location configured by
cache.dir and cache.file.
Extension Settings
The extension does not add VS Code settings. It reads globby, languages, and the cache location from your existing Gringow configuration.
License
MIT
| |