User‐Guide

User Guide

GUI Application

Starting the Application

python3 localization_app.py

Step-by-Step Usage

1. Select Workspace Folder

Click the "Browse..." button and select the folder containing your .xcloc subdirectories.

2. Auto-Detect Languages

The app will automatically:

• Scan for all .xcloc folders
• Extract language codes
• Display them in the interface

3. Choose Default Language

Select your source language from the dropdown (typically English).

4. Select Target Languages

• Click on languages to translate
• Use Cmd/Ctrl + Click for multiple selections
• Or select all and deselect unwanted ones

5. Start Translation

Click "🚀 Start Translation" to begin.

6. Monitor Progress

Watch the log window for:

• Translation progress
• File status updates
• Any errors or warnings

7. Stop if Needed

Click "⏹️ Stop Translation" to cancel the process at any time.

Command Line Interface

Basic Usage

python3 translate_xliff.py

This will:

• Use the current directory as workspace
• Auto-detect all languages
• Skip English (en) and Arabic (ar) by default
• Translate all other languages

Advanced Options

Specify Workspace

python3 translate_xliff.py --workspace /path/to/localization

Translate Specific Languages Only

python3 translate_xliff.py --only de fr ja ko

Skip Specific Languages

python3 translate_xliff.py --skip en es ar

Dry Run (Preview Mode)

python3 translate_xliff.py --dry-run

Shows what would be translated without making changes.

Complete CLI Reference

See CLI Reference for all options and examples.

Tips for Best Results

1. Always start with a backup of your localization files
2. Use dry-run first to preview changes
3. Review translations before using in production
4. Start with a few languages to test the workflow
5. Check the log for any warnings or errors

Understanding the Log Output

The log shows:

• ✅ Success: Translation completed
• ⚠️ Warning: Already translated or skipped
• ❌ Error: Failed translation
• 📊 Summary: Total translations performed