The Co-op Translator CLI offers several options to customize the translation process:
| Command | Description |
|---|---|
| translate -l “language_codes” | Translates your project into specified languages. Example: translate -l “es fr de” translates into Spanish, French, and German. Use translate -l “all” to translate into all supported languages. |
| translate -l “language_codes” -u | Updates translations by deleting existing ones and re-creating them. Warning: This will delete all current translations for specified languages. |
| translate -l “language_codes” -img | Translates only image files. |
| translate -l “language_codes” -md | Translates only Markdown files. |
| translate -l “language_codes” -nb | Translates only Jupyter notebook files (.ipynb). |
| translate -l “language_codes” –fix | Retranslates files with low confidence scores based on previous evaluation results. |
| translate -l “language_codes” -d | Enables debug mode for detailed logging. |
| translate -l “language_codes” -r “root_dir” | Specifies the root directory of the project |
| translate -l “language_codes” -f | Uses fast mode for image translation (up to 3x faster plotting at a slight cost to quality and alignment). |
| translate -l “language_codes” -y | Automatically confirm all prompts (useful for CI/CD pipelines) |
| translate -l “language_codes” –help | help details within the CLI showing available commands |
| evaluate -l “language_code” | Evaluates translation quality for a specific language and provides confidence scores |
| evaluate -l “language_code” -c 0.8 | Evaluates translations with custom confidence threshold |
| evaluate -l “language_code” -f | Fast evaluation mode (rule-based only, no LLM) |
| evaluate -l “language_code” -D | Deep evaluation mode (LLM-based only, more thorough but slower) |
| migrate-links -l “language_codes” | Reprocess translated Markdown files to update links to notebooks (.ipynb). Prefers translated notebooks when available; otherwise can fall back to original notebooks. |
| migrate-links -l “language_codes” -r | Specify the project root directory (default: current directory). |
| migrate-links -l “language_codes” –dry-run | Show which files would change without writing changes. |
| migrate-links -l “language_codes” –no-fallback-to-original | Do not rewrite links to original notebooks when translated counterparts are missing (only update when translated exists). |
| migrate-links -l “language_codes” -d | Enable debug mode for detailed logging. |
| migrate-links -l “all” -y | Process all languages and auto-confirm the warning prompt. |
Default behavior (add new translations without deleting existing ones): translate -l “ko” translate -l “es fr de” -r “./my_project”
Add only new Korean image translations (no existing translations are deleted): translate -l “ko” -img
Update all Korean translations (Warning: This deletes all existing Korean translations before re-translating): translate -l “ko” -u
Update only Korean images (Warning: This deletes all existing Korean images before re-translating): translate -l “ko” -img -u
Add new markdown translations for Korean without affecting other translations: translate -l “ko” -md
Fix low confidence translations based on previous evaluation results: translate -l “ko” –fix
Fix low confidence translations for specific files only (markdown): translate -l “ko” –fix -md
Fix low confidence translations for specific files only (images): translate -l “ko” –fix -img
Use fast mode for image translation: translate -l “ko” -img -f
Fix low confidence translations with custom threshold: translate -l “ko” –fix -c 0.8
Debug mode example: - translate -l “ko” -d: Enable debug logging.
Migrate notebook links for Korean translations (update links to translated notebooks when available): migrate-links -l “ko”
Migrate links with dry-run (no file writes): migrate-links -l “ko” –dry-run
Only update links when translated notebooks exist (do not fallback to originals): migrate-links -l “ko” –no-fallback-to-original
Process all languages with confirmation prompt: migrate-links -l “all”
Process all languages and auto-confirm: migrate-links -l “all” -y
[!WARNING]
Beta Feature: The evaluation functionality is currently in beta. This feature was released to evaluate translated documents, and the evaluation methods and detailed implementation are still under development and subject to change.
Evaluate Korean translations: evaluate -l “ko”
Evaluate with custom confidence threshold: evaluate -l “ko” -c 0.8
Fast evaluation (rule-based only): evaluate -l “ko” -f
Deep evaluation (LLM-based only): evaluate -l “ko” -D