57 lines
2.9 KiB
Markdown
57 lines
2.9 KiB
Markdown
# easy-i18n
|
|
|
|
|
|
[](https://plugins.jetbrains.com/plugin/16316)
|
|
[](https://plugins.jetbrains.com/plugin/16316)
|
|
|
|
<!-- Plugin description -->
|
|
This is an easy plugin to manage internationalization for JSON or Resource-Bundle(Properties) based locale files.
|
|
Most common use case is for translating Webapps or simple Java Applications. Translating large scale projects was never that easy with your favourite IDE!
|
|
|
|
## Use Cases
|
|
- Webapps: For example [Vue](https://vuejs.org/) with [vue-i18n](https://kazupon.github.io/vue-i18n/) or any other JSON translation file based technology
|
|
- Java based Resource-Bundle
|
|
|
|
## Features
|
|
- UI Tool Window with Table- and Tree-View representation
|
|
- Easily Add / Edit / Delete translations
|
|
- Filter / Search function to hide irrelevant keys
|
|
- Key completion and annotation inside editor
|
|
- Configurable locales directory & preferred locale for ui presentation
|
|
- Supports modularized (splitted) json files
|
|
- Translation keys with missing definition for any locale will be displayed red
|
|
- Quick edit any translation by right-click (IntelliJ Popup Action)
|
|
- Quick delete any translation via <kbd>DEL</kbd>-Key
|
|
<!-- Plugin description end -->
|
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
- Using IDE built-in plugin system:
|
|
|
|
<kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>Marketplace</kbd> > <kbd>Search for "easy-i18n"</kbd> >
|
|
<kbd>Install Plugin</kbd>
|
|
|
|
- Manually:
|
|
|
|
Download the [latest release](https://github.com/marhali/easy-i18n/releases/latest) and install it manually using
|
|
<kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>⚙️</kbd> > <kbd>Install plugin from disk...</kbd>
|
|
|
|
## Configuration
|
|
- Install plugin. See **Installation** section
|
|
- Create a directory which will hold the locale files
|
|
- Create a file for each required locale (e.g de.json, en.json) Note: Each json file must at least define an empty section (e.g. **{}**)
|
|
- Click on the **Settings** Action inside the Easy I18n Tool Window
|
|
- Select the created directory (optional: define the preferred locale to view) and press Ok
|
|
- Translations can now be created / edited or deleted
|
|
|
|
Examples for the configuration can be found in the [/example](https://github.com/marhali/easy-i18n/tree/main/example) folder.
|
|
|
|
---
|
|
Plugin based on the [IntelliJ Platform Plugin Template][template].
|
|
|
|
[template]: https://github.com/JetBrains/intellij-platform-plugin-template
|