💬 VS Code extension to work with Fluent, the correct-by-design l10n programming language
Fluent is a Mozilla's programming language for natural-sounding translations. And vscode-fluent is a Visual Studio Code extension to improve developer experience while working with this language.
- 🌎 Official Fluent's website
- 📓 Fluent Syntax Guide
- 🎢 Fluent's Playground
- 🎥 Talk about localization and Fluent
- Syntax highlight
- Show syntax errors
- Code Action to extract a string to Fluent files
- List file symbol (
⇧⌘Oon Mac,Ctrl+Shift+Oon Linux and Windows) - Hover support on messages
- Breadcrumbs support
- Go to message definition from a reference
- Generate documentation comments for messages
Using the code action "Extract to Fluent files" you can easily extract a string to from source code to all FTL files on your project.
To open the code action menu, you should select a string (including its quotes) and then type ⌘ + . (or Ctrl + .).
You can change the replacement template using the configuration vscodeFluent.replacementTemplate.
By default, the message will be added to all Fluent files on the workspace. But if you are working on a workspace with multiple projects, and each project has its Fluent files, you won't want mix messages between the projects. To avoid that, you should use the configuration vscodeFluent.projects, and add on it each projects' root path. See the below image for an instance.
The syntax is written on a YML file. You can compile it running:
> npm run build:syntaxes
You can run the extension using the Run Extension task on VS Code.
You can run the automated tests using the Test Extension - No Workspace and Test Extension - With Workspace tasks on VS Code.