Fabric icon indicating copy to clipboard operation
Fabric copied to clipboard

[Feature request]: [i18n] Add multilingual support for CLI tool

Open fatinghenji opened this issue 9 months ago • 0 comments

What do you need?

Problem Statement
Non-English users face friction due to:

  • Inability to understand command help/errors without translation tools
  • Misaligned text rendering in CJK terminals
  • No adherence to LC_ALL environment variables

Proposed Solution

  1. Core Features

    • --lang flag with auto-detection (fallback to English)
    • Translated content for:
      • Command help texts
      • Interactive prompts
      • Error messages with solution links
  2. Priority Languages

    Phase 1: Simplified Chinese (zh_CN)  
    Phase 2: Spanish (es_ES), Japanese (ja_JP)  
    Phase 3: Community-driven translations
    
  3. Requirements

    • [ ] All terminal output goes through i18n layer
    • [ ] Support width-aware text formatting for CJK
    • [ ] Add locale configuration to user profiles
    • [ ] Document translation contribution process

Acceptance Criteria

Scenario: Non-English command execution  
  Given the system language is zh_CN  
  When user runs `mycli deploy --help`  
  Then output shows Chinese help text  
  And text columns maintain terminal alignment  

Measurement

  • 90% reduction in --help > translate searches (via user analytics)
  • 40% decrease in misconfigured command errors

fatinghenji avatar Mar 17 '25 00:03 fatinghenji