translate

Translate the content of a file to a target language and save it with the locale in the filename.

Arguments

$ARGUMENTS must contain two values separated by |:

<filename> | <target language>

Example:

README.md | Spanish

Steps

1. Parse $ARGUMENTS by splitting on | to extract:

   • filename — first segment (trimmed)
   • targetLanguage — second segment (trimmed)

2. If either value is missing or empty, stop and ask the user to provide both before proceeding.

3. Resolve the locale code for targetLanguage (e.g. Spanish → es, French → fr, Portuguese → pt, German → de, Italian → it, Japanese → ja, Chinese → zh, etc.).

4. Derive the output filename by inserting .<locale> before the last extension:

   • README.md → README.es.md
   • docs/guide.txt → docs/guide.es.txt
   • index.html → index.es.html

5. Read the content of filename.

6. Translate the full content to targetLanguage. Preserve all formatting, markup, code blocks, and structure — only translate human-readable text.

7. Write the translated content to the output filename.

8. Confirm by reporting the output filename.

Rules

• Never modify the source file.
• Preserve all code blocks, commands, URLs, and technical identifiers untranslated.
• If the source file does not exist, report the error and stop.