Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cca-io/quick-translate
Translate multiple languages at once in a spreadsheet. Supports JSON and CSV.
https://github.com/cca-io/quick-translate
rescript translate
Last synced: about 2 months ago
JSON representation
Translate multiple languages at once in a spreadsheet. Supports JSON and CSV.
- Host: GitHub
- URL: https://github.com/cca-io/quick-translate
- Owner: cca-io
- License: mit
- Created: 2021-03-03T14:10:10.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-06-18T10:35:33.000Z (7 months ago)
- Last Synced: 2024-11-30T18:12:04.265Z (about 2 months ago)
- Topics: rescript, translate
- Language: ReScript
- Homepage: https://cca-io.github.io/quick-translate/
- Size: 2.06 MB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Translate multiple languages at once in a spreadsheet.
### Demo
[https://cca-io.github.io/quick-translate/](https://cca-io.github.io/quick-translate/)
## Documentation
This web application is specifically tailored to translate a list of language strings to multiple target languages at once.
### Formats
It supports the follwing input file formats
#### Properties
```
Message.hello=Hello
Message.world=World
Some.Message.id=Some message
```
#### Strings
```
"message_hello" = "Hello"
"message_world" = "World"
"some_message_id" = "Some message"
```
#### XML (Android resources strings)
```xml
Hello
World!
Some message
```
#### JSON
```json
[
{
"id": "message.hello",
"defaultMessage": "Hello"
},
{
"id": "message.world",
"defaultMessage": "World"
},
{
"id": "some.message.id",
"defaultMessage": "Some message",
"description": "View some message"
}
]
```
which is exactly what [rescript-react-intl-extractor](https://github.com/cca-io/rescript-react-intl-extractor) yields, for instance.
#### CSV
The app is able to detect CSVs not generated by it. The delimiter is detected automatically, but if you have a description or comments column, it should either say `comments`, `comment` or `description` (case insensitive) to correctly detect it as a description. Also, the first column needs to be the `id` column, does not matter how it is called.
If you happen to import a custom CSV, the same delimiter gets used for subsequent exports. Otherwise it defaults to `;`.
### Workflow
The app has a notion of sources and targets. Basically, the first file you drag and drop into the web app is the source file.
The app takes the `id`s or keys of all entries and puts it into the first column of the spreadsheet (read-only).
In the second column, the values or `defaultMessage`s will appear. If you use a JSON as source, you can show/hide a description column between the first and second columns. Descriptions are hints for the translator about what to keep in mind when translating the corresponding source texts.
Then you can either add a new target column with the button on the right, or drag another (partially) translated file into the app,
which will also appear as another column.
Translation itself must be done manually, but copy & paste (of multiple cells) works pretty well from and to all kinds of spreadsheet applications.
Some of them even provide built-in translation functions.
The app allows to
- export single target languages with the export buttons above every target language column
- export both the source and all target languages at once
- export the whole sheet as-is to CSV
- import the aforementioned CSV again
> **NOTE**: Currently the app state is not stored anywhere, which means a refresh deletes all your data.
> To save your data, use the export/import CSV functionality for now.
## Development
Setup:
```sh
npm install
```
Run ReScript build and vitejs dev server:
```sh
npm run dev
```
Production build:
```sh
npm run build
```