Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/baotlake/i18ncsv
i18nCSV is a streamlined tool for effective internationalization, offering seamless integration with Google Docs, Google Translate, and ChatGPT for enhanced translation capabilities. Easily extract and import i18n data using CSV files, simplifying the localization workflow.
https://github.com/baotlake/i18ncsv
chatgpt cli csv google-docs i18n internationalization l10n localization python tools translate
Last synced: 1 day ago
JSON representation
i18nCSV is a streamlined tool for effective internationalization, offering seamless integration with Google Docs, Google Translate, and ChatGPT for enhanced translation capabilities. Easily extract and import i18n data using CSV files, simplifying the localization workflow.
- Host: GitHub
- URL: https://github.com/baotlake/i18ncsv
- Owner: baotlake
- Created: 2024-01-14T16:25:11.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-10T15:58:20.000Z (8 months ago)
- Last Synced: 2024-10-12T07:11:06.115Z (4 months ago)
- Topics: chatgpt, cli, csv, google-docs, i18n, internationalization, l10n, localization, python, tools, translate
- Language: Python
- Homepage:
- Size: 12.7 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
i18nCSV
A super easy-to-use cross-platform i18n tool for efficiently managing your i18n files in a table UI. Provides i18n machine translation, ChatGPT translation, and team collaboration solutions.
## i18nCSV + CSV:
- Table UI interface
- Single text file, supports Git version control
## i18nCSV + [Google Sheets](https://www.google.com/sheets/about/):
- Supports [Google Translate translation](https://support.google.com/docs/answer/3093331)
- Supports ChatGPT GPT-3.5, GPT-4 translation (requires installation of [Google Workspace App](https://workspace.google.com/marketplace/search/gpt))
- Supports manual translation, team collaboration translation
## Why choose i18nCSV
| Manual Management | i18nCSV |
| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| ❌ Edit JSON code without UI | ✅ Supports table UI |
| ❌ Manually manage JSON files for dozens of languages | ✅ Manage a single table document (CSV or Google Sheets) |
| ❌ Adding/deleting messages requires editing JSON files for each language | ✅ Adding or deleting messages only requires adding or deleting a row in the table |
| ❌ No batch operations, no automatic translation | ✅ Supports selecting rows or columns, supports automatic translation with formulas |
| ❌ No real-time collaboration | ✅ With Google Sheets, supports real-time team collaboration |
## Usage
```txt
Usage: i18ncsv.py [OPTIONS] I18N_DIR CSV_PATH
Options:
-e, --extract extract csv from i18n directory
-n, --msg-name TEXT i18n message filename
-p, --prioritize TEXT Languages to prioritize at the beginning of CSV
columns, e.g., 'en,zh'.
-o, --overwrite overwrites existing i18n messages, default is False
-w, --watch FLOAT Enable watch mode to automatically update i18n when
the CSV file changes.
--sheet-name TEXT The name of the sheet
--range TEXT Any valid range specifier, e.g. A1:C99 or B2:F
--help Show this message and exit.
```
### Export CSV
Export CSV from existing i18n messages.
```shell
python ./i18ncsv.py -e ./i18n i18n.csv
```
### Update i18n
```shell
# Update i18n from a local csv file
python ./i18ncsv.py ./i18n ./i18n.csv
# Watch mode
python ./i18ncsv.py ./i18n ./i18n.csv -w
# Overwrite existing i18n file content
python ./i18ncsv.py ./i18n ./i18n.csv -w -o
```
```shell
# Update i18n from a Google Sheets document
# Make sure to set Google Sheets to be viewable by anyone with the link
python ./i18ncsv.py ./i18n https://docs.google.com/spreadsheets/d/xxxxxxxxxxx/ -w -o
```
When updating i18n, you can automatically create corresponding files by specifying the directory structure through `--msg-name`, where `` represents the code for the respective language.
```shell
python ./i18ncsv.py ./i18n ./i18n.csv --msg-name '.json'
├── en.json
├── zh.json
├── ja.json
```
```shell
python ./i18ncsv.py ./i18n ./i18n.csv --msg-name '/messages.json'
├── en
│ └── messages.json
├── zh
│ └── messages.json
├── ja
│ └── messages.json
```