VS Code i18n Assistant

A Visual Studio Code extension that helps you manage internationalization (i18n) in your projects. This extension simplifies the process of creating and maintaining internationalized text by providing easy conversion of selected text into i18n formats and syncing with remote i18n resources.

Features

• Convert selected text to i18n plain text format with a keyboard shortcut (Cmd+Alt+I / Ctrl+Alt+I)
• Convert selected text to i18n plural format with a keyboard shortcut (Cmd+Alt+P / Ctrl+Alt+P)
• Sync your i18n resources with remote translation services
• Context menu integration for quick access to i18n conversion tools
• Command palette support for all operations

Installation

1. Install from the Visual Studio Code Marketplace
2. Restart VS Code

Usage

Converting Text to i18n Format

1. Select the text you want to convert in your editor
2. Use one of these methods to convert:
   • Press Cmd+Alt+I (Mac) or Ctrl+Alt+I (Windows/Linux) for plain text
   • Press Cmd+Alt+P (Mac) or Ctrl+Alt+P (Windows/Linux) for plural format
   • Right-click and select "Convert text to hub i18n" from the context menu
   • Use the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "i18n as plain text" or "i18n as plural"

Syncing i18n Resources

1. Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
2. Search for "Sync i18n resources with remote"
3. Execute the command

Configuration

This extension provides the following settings:

• myVscodeExtension.apiKey: API Key for external service integration
• myVscodeExtension.preferredLanguage: Preferred language for i18n records (default: "en")

To configure these settings:

1. Open VS Code settings (Cmd+, / Ctrl+,)
2. Search for "My VSCode Extension"
3. Update the settings as needed

Development

1. Clone this repository
2. Run yarn install to install dependencies
3. Press F5 to open a new window with your extension loaded
4. Run your commands from the command palette or use the configured keyboard shortcuts
5. Set breakpoints in your code inside src/extension.ts to debug your extension

Building the Extension

• Run yarn package to create a .vsix file that can be installed in VS Code

Deployment

This extension can be automatically deployed to the VS Code Marketplace using GitHub Actions:

1. Create a Personal Access Token (PAT) in the Visual Studio Marketplace
2. Add this token as a repository secret in GitHub with the name VSCODE_MARKETPLACE_TOKEN
3. Create a new tag with git tag v0.0.1 (match your version in package.json)
4. Push the tag with git push --tags
5. The GitHub Action will automatically deploy the extension to the marketplace

Release Notes

0.0.1

Initial release with core functionality:

• Convert text to i18n plain text format
• Convert text to i18n plural format
• Sync i18n resources with remote
• Context menu and command palette integration