vscode-fluent

💬 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
  • 🇺🇸 In English
  • 🇧🇷 In Portuguese

Features

• Syntax highlight
• Show syntax errors
• Code Action to extract a string to Fluent files
• List file symbol (⇧⌘O on Mac, Ctrl+Shift+O on Linux and Windows)
• Hover support on messages
• Breadcrumbs support
• Go to message definition from a reference
• Generate documentation comments for messages

Code Action

Extract string to FTL

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.

How to develop vscode-fluent

Syntax

The syntax is written on a YML file. You can compile it running:

> npm run build:syntaxes

Extension

You can run the extension using the Run Extension task on VS Code.

Tests

You can run the automated tests using the Test Extension - No Workspace and Test Extension - With Workspace tasks on VS Code.