https://github.com/fkirc/attranslate
A command line tool for translating JSON, YAML, CSV, ARB, XML (via a CLI)
https://github.com/fkirc/attranslate
internationalization localization semi-automated-translations translations
Last synced: 3 days ago
JSON representation
A command line tool for translating JSON, YAML, CSV, ARB, XML (via a CLI)
- Host: GitHub
- URL: https://github.com/fkirc/attranslate
- Owner: fkirc
- License: other
- Created: 2020-09-15T08:51:45.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-05-05T15:59:56.000Z (13 days ago)
- Last Synced: 2025-05-05T16:54:50.402Z (13 days ago)
- Topics: internationalization, localization, semi-automated-translations, translations
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/attranslate
- Size: 2.15 MB
- Stars: 345
- Watchers: 7
- Forks: 29
- Open Issues: 6
-
Metadata Files:
- Readme: README-es.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - attranslate - Semi-automatically translate or synchronize .strings files or crossplatform-files from different languages. (Localization / Other Hardware)
- awesome-flutter - attranslate - Semi-automated translation of ARB or JSON files by [fkirc](https://github.com/fkirc) (Components / Internationalization)
- awesome-javascript - attranslate - A JavaScript-tool for synchronizing translation-files, including JSON/YAML/XML and other formats. (I18n And L10n / Runner)
- awesome-translations - attranslate - A tool for semi-automated translations of cross-platform apps or websites. (Tools / Machine translation for developers)
- awesome-jekyll - attranslate - A tool for synchronizing translation-files. (Command Line Tools)
- awesome-flutter-cn - attranslate - 通过 [fkirc](https://github.com/fkirc) 制作的自动化翻译 ARB 或 JSON 文件工具。 (组件 / 国际化)
- awesome-ios-star - attranslate - Semi-automatically translate or synchronize .strings files or crossplatform-files from different languages. (Localization / Other Hardware)
- awesome-flutter-cn - attranslate - 基于 [fkirc](https://github.com/fkirc) 的 ARB 或 JSON 半自动翻译工具 (组件 / 国际化)
- awesome-flutter - attranslate - Semi-automated Text Translator for Websites and Apps ` 📝 23 days ago ` (Internationalization [🔝](#readme))
README
# attranslate: Traductor de texto semiautomático para sitios web y aplicaciones
macOS/Ubuntu/Windows: [](https://github.com/fkirc/attranslate/actions?query=branch%3Amaster)
`attranslate` es una herramienta para sincronizar archivos de traducción, incluyendo JSON/YAML/XML y otros formatos.
A diferencia de los servicios de pago, cualquier desarrollador puede integrar `attranslate` en cuestión de minutos.
`attranslate` dejará las traducciones existentes sin cambios y solo sincronizará las nuevas traducciones.
Opcionalmente `attranslate` trabaja con servicios de traducción automática.
Por ejemplo, supongamos que un servicio de traducción logra un 80% de traducciones correctas.
Con `attranslate`, una solución rápida del 20% restante puede ser más rápida que hacer todo a mano.
Aparte de eso, `attranslate` admite traducciones puramente manuales o incluso conversiones de formato de archivo sin cambiar el idioma.
# Funciones
## Conservar traducciones manuales
`attranslate` reconoce que las traducciones automáticas no son perfectas.
Por lo tanto, siempre que no esté satisfecho con los resultados producidos, `attranslate` le permite simplemente sobrescribir textos en sus archivos de destino.
`attranslate` nunca sobrescribirá una corrección manual en ejecuciones posteriores.
## Servicios disponibles
`attranslate` admite los siguientes servicios de traducción; Muchos de ellos son gratis:
- `openai`: Utiliza un modelo como ChatGPT; gratis hasta un límite
- [google-translate](https://cloud.google.com/translate): Necesita una cuenta de GCloud; gratis hasta un límite
- [azure](https://azure.microsoft.com/en-us/services/cognitive-services/translator-text-api/): Necesita una cuenta de Microsoft; cuesta dinero
- `sync-without-translate`: No cambia el idioma. Esto puede ser útil para convertir entre formatos de archivo o para mantener diferencias específicas de la región.
- `manual`: Traducir textos manualmente
# Ejemplos de uso
Traducir un solo archivo es tan simple como la siguiente línea:
attranslate --srcFile=json-simple/en.json --srcLng=English --srcFormat=nested-json --targetFile=json-simple/de.json --targetLng=German --targetFormat=nested-json --service=openai
Si tiene varios idiomas de destino, necesitará varias llamadas a `attranslate`.
Puede escribir algo como el siguiente script:
```bash
# Este ejemplo traduce un archivo JSON en inglés a español y alemán.
BASE_DIR="json-advanced"
SERVICE_ACCOUNT_KEY="gcloud/gcloud_service_account.json"
COMMON_ARGS=( "--srcLng=en" "--srcFormat=nested-json" "--targetFormat=nested-json" "--service=google-translate" "--serviceConfig=$SERVICE_ACCOUNT_KEY" )
# instalar attranslate si aún no está instalado
attranslate --version || npm install --global attranslate
attranslate --srcFile=$BASE_DIR/en/fruits.json --targetFile=$BASE_DIR/es/fruits.json --targetLng=es "${COMMON_ARGS[@]}"
attranslate --srcFile=$BASE_DIR/en/fruits.json --targetFile=$BASE_DIR/de/fruits.json --targetLng=de "${COMMON_ARGS[@]}"
```
Del mismo modo, puede utilizar `attranslate` para convertir entre formatos de archivo.
Ver [scripts de ejemplo](https://github.com/fkirc/attranslate/tree/master/sample-scripts) para más ejemplos.
# Guía de integración
En primer lugar, asegúrese de que [nodejs](https://nodejs.org/) está instalado en el equipo.
Una vez que tengas `nodejs`, puede instalar `attranslate` Vía:
`npm install --global attranslate`
Alternativamente, si usted es un desarrollador de JavaScript, entonces debe instalar `attranslate` Vía:
`npm install --save-dev attranslate`
A continuación, debe escribir un script específico del proyecto que invoque `attranslate` para sus archivos específicos.
Ver [scripts de ejemplo](https://github.com/fkirc/attranslate/tree/master/sample-scripts) para obtener orientación sobre cómo traducir los archivos específicos del proyecto.
# Opciones de uso
Correr `attranslate --help` para ver una lista de opciones disponibles:
```
Usage: attranslate [options]
Options:
--srcFile The source file to be translated
--srcLng A language code for the source language
--srcFormat One of "flat-json", "nested-json",
"yaml", "po", "xml", "ios-strings",
"arb", "csv"
--targetFile The target file for the translations
--targetLng A language code for the target language
--targetFormat One of "flat-json", "nested-json",
"yaml", "po", "xml", "ios-strings",
"arb", "csv"
--service One of "openai", "manual",
"sync-without-translate",
"google-translate", "azure"
--serviceConfig supply configuration for a translation
service (either a path to a key-file or
an API-key)
--matcher An optional feature for string replacements. One of "none", "icu", "i18next",
"sprintf" (default: "none")
--prompt Prompt opcional para guiar al servicio de traducción. Útil para especificar
términos técnicos que no deben traducirse u otras preferencias de traducción.
-v, --version output the version number
```
## Ejemplos de Prompt
Puedes usar el parámetro `--prompt` para proporcionar instrucciones específicas al servicio de traducción. Aquí tienes un ejemplo:
```bash
attranslate --srcFile=json-simple/en.json --srcLng=English --srcFormat=nested-json \
--targetFile=json-simple/es.json --targetLng=Spanish --targetFormat=nested-json \
--service=openai \
--prompt="Estoy desarrollando una aplicación de salud para profesionales médicos. Términos técnicos como 'EKG', 'MRI', 'CT scan', 'blood pressure', 'pulse oximeter' y 'vital signs' deben permanecer en inglés. Por favor, mantenga la terminología médica adecuada y un tono formal en las traducciones."
```
Este prompt asegurará que los términos técnicos permanezcan en inglés mientras se traduce el resto del contenido. Puedes personalizar el prompt según tus necesidades específicas, como:
- Especificar qué términos no deben traducirse
- Solicitar reglas específicas de capitalización
- Proporcionar contexto sobre el dominio de tu aplicación
- Establecer preferencias de tono o estilo para las traducciones
# Contribuidores
Nos gustaría agradecer a todos los contribuidores que han ayudado a mejorar attranslate:
- [@esuljic](https://github.com/esuljic): Agregó la característica de parámetro de prompt para servicios de IA (OpenAI y TypeChat).