Skip to content

troubleshooting.md

Latest commit

 

History

History
240 lines (180 loc) · 17.6 KB

troubleshooting.md

File metadata and controls

240 lines (180 loc) · 17.6 KB

Microsoft Co-op Translator ပြန်ဆိုရေးကိရိယာ ပြဿနာဖြေရှင်းနည်းလမ်းညွှန်

အကျဉ်းချုပ်

Microsoft Co-Op Translator က Markdown စာရွက်စာတမ်းတွေကို အလွယ်တကူ ပြန်ဆိုနိုင်တဲ့ အင်္ဂါရပ်ရှိတဲ့ ကိရိယာတစ်ခုပါ။ ဒီလမ်းညွှန်မှာ သုံးစွဲသူတွေ မကြုံတွေ့နိုင်တဲ့ ပြဿနာတွေကို ဘယ်လို ဖြေရှင်းရမလဲ ဆိုတာကို ရှင်းပြပေးထားပါတယ်။

မကြုံတွေ့နိုင်တဲ့ ပြဿနာများနှင့် ဖြေရှင်းနည်းများ

1. Markdown Tag ပြဿနာ

ပြဿနာ: ပြန်ဆိုပြီးတဲ့ Markdown စာရွက်မှာ markdown tag အပေါ်ဆုံးမှာ ပါလာတာကြောင့် ဖော်ပြမှုမှာ ပြဿနာဖြစ်တတ်ပါတယ်။

ဖြေရှင်းနည်း: ဒီပြဿနာကို ဖြေရှင်းဖို့ markdown tag ကို ဖိုင်အပေါ်ဆုံးကနေ ဖျက်လိုက်ပါ။ ဒါဆို Markdown ဖိုင်က မှန်ကန်စွာ ဖော်ပြနိုင်ပါလိမ့်မယ်။

လုပ်ဆောင်ရန်အဆင့်များ:

  1. ပြန်ဆိုပြီးတဲ့ Markdown (.md) ဖိုင်ကို ဖွင့်ပါ။
  2. စာရွက်အပေါ်ဆုံးမှာ markdown tag ကို ရှာပါ။
  3. markdown tag ကို ဖျက်ပါ။
  4. ဖိုင်ကို သိမ်းပါ။
  5. ပြန်ဖွင့်ပြီး မှန်ကန်စွာ ဖော်ပြနိုင်သလား စစ်ပါ။

2. ပုံ URL မကိုက်ညီမှု ပြဿနာ

ပြဿနာ: ထည့်သွင်းထားတဲ့ ပုံတွေ URL များက ဘာသာစကား locale နဲ့ မကိုက်ညီလို့ ပုံတွေ မှားနေတတ်ပါတယ်၊ ပျောက်နေတတ်ပါတယ်။

ဖြေရှင်းနည်း: ပုံ URL တွေကို စစ်ကြည့်ပြီး ဘာသာစကား locale ကို ကိုက်ညီအောင် ပြင်ပါ။ ပုံအားလုံးကို translated_images folder ထဲမှာ သိမ်းထားပြီး ပုံနာမည်မှာ ဘာသာစကား locale tag ပါပါတယ်။

လုပ်ဆောင်ရန်အဆင့်များ:

  1. ပြန်ဆိုပြီးတဲ့ Markdown စာရွက်ကို ဖွင့်ပါ။
  2. ထည့်ထားတဲ့ ပုံတွေ URL ကို ရှာပါ။
  3. ပုံနာမည်ထဲက ဘာသာစကား locale ကို စာရွက်ဘာသာစကားနဲ့ ကိုက်ညီစေပါ။
  4. လိုအပ်ရင် URL ကို ပြင်ပါ။
  5. သိမ်းပြီး ပြန်ဖွင့်ကြည့်ပါ။

3. ပြန်ဆိုမှုတိကျမှု

ပြဿနာ: ပြန်ဆိုထားတဲ့ အကြောင်းအရာက တိကျမှုမရှိဘူး၊ ပြင်ဆင်ဖို့ လိုအပ်တယ်။

ဖြေရှင်းနည်း: ပြန်ဆိုထားတဲ့ စာရွက်ကို ပြန်ကြည့်ပြီး တိကျမှု၊ ဖတ်ရလွယ်အောင် ပြင်ဆင်ပါ။

လုပ်ဆောင်ရန်အဆင့်များ:

  1. ပြန်ဆိုထားတဲ့ စာရွက်ကို ဖွင့်ပါ။
  2. အကြောင်းအရာကို ဂရုစိုက်စွာ ပြန်ကြည့်ပါ။
  3. တိကျမှုအတွက် လိုအပ်တဲ့ ပြင်ဆင်မှုတွေ လုပ်ပါ။
  4. သိမ်းပါ။

4. ခွင့်ပြုချက် Error Redacted သို့မဟုတ် 404

ပုံတွေ သို့မဟုတ် စာသားတွေကို မှန်ကန်တဲ့ ဘာသာစကားနဲ့ မပြန်ဆိုနိုင်ဘူး၊ -d debug mode နဲ့ run လုပ်တဲ့အခါ 401 error တွေ့ရင် authentication fail ဖြစ်တာပါ။ သော့ချက်က မမှန်ဘူး၊ သက်တမ်းကုန်သွားပြီ သို့မဟုတ် endpoint region နဲ့ မချိတ်ထားဘူး ဖြစ်နိုင်ပါတယ်။

-d debug switch နဲ့ co-op translator ကို run လုပ်ပြီး root cause ကို နားလည်နိုင်ပါတယ်။

  • Error Message: Access denied due to invalid subscription key or wrong API endpoint.
  • ဖြစ်နိုင်တဲ့ အကြောင်းရင်းများ:
    • Subscription key ကို request မှာ မှားရေးထားတယ်၊ redact လုပ်ထားတယ်။
    • AI Services Key သို့မဟုတ် Subscription Key က Azure AI Vision resource မဟုတ်ဘဲ Translator သို့မဟုတ် OpenAI resource ဖြစ်နိုင်တယ်။

Resource Type

  • Azure Portal သို့မဟုတ် Azure AI Foundry ကို သွားပြီး resource type ကို Azure AI services → Vision ဖြစ်ကြောင်း စစ်ပါ။
  • သော့ချက်တွေ မှန်ကန်စွာ သုံးထားကြောင်း အတည်ပြုပါ။

5. Configuration Errors (Error Handling အသစ်)

Selective translation system အသစ်မှာ Co-op Translator က လိုအပ်တဲ့ service မရှိရင် error message တွေကို တိကျစွာ ပြပေးပါတယ်။

5.1. Azure AI Service မရှိသေးလို့ Image Translation မလုပ်နိုင်

ပြဿနာ: Image translation (-img flag) တောင်းဆိုထားပေမယ့် Azure AI Service ကို configure မလုပ်ထားပါ။

Error Message:

Error: Image translation requested but Azure AI Service is not configured.
Please add AZURE_AI_SERVICE_API_KEY and AZURE_AI_SERVICE_ENDPOINT to your .env file.
Check Azure AI Service availability and configuration.

ဖြေရှင်းနည်း:

  1. Option 1: Azure AI Service ကို configure လုပ်ပါ

    • .env ဖိုင်ထဲ AZURE_AI_SERVICE_API_KEY ထည့်ပါ
    • .env ဖိုင်ထဲ AZURE_AI_SERVICE_ENDPOINT ထည့်ပါ
    • Service ကို အသုံးပြုနိုင်ကြောင်း စစ်ပါ

  2. Option 2: Image translation request ကို ဖယ်ရှားပါ

    # Instead of: translate -l "ko" -img
# Use: translate -l "ko" -md

5.2. လိုအပ်တဲ့ Configuration မရှိ

ပြဿနာ: LLM configuration အရေးကြီးတာ မရှိပါ။

Error Message:

Error: No language model configuration found.
Please configure either Azure OpenAI or OpenAI in your .env file.

ဖြေရှင်းနည်း:

  1. .env ဖိုင်ထဲမှာ အနည်းဆုံး LLM configuration တစ်ခုတော့ ပါစေကြောင်း စစ်ပါ:

    • Azure OpenAI: AZURE_OPENAI_API_KEY နဲ့ AZURE_OPENAI_ENDPOINT
    • OpenAI: OPENAI_API_KEY

    Azure OpenAI သို့မဟုတ် OpenAI တစ်ခုခု configure လုပ်ထားရပါမယ်၊ နှစ်ခုလုံး မလိုအပ်ပါ။

5.3. Selective Translation မှားယွင်းမှု

ပြဿနာ: Command အောင်မြင်သွားပေမယ့် ဖိုင်မပြန်ဆိုဘူး။

ဖြစ်နိုင်တဲ့ အကြောင်းရင်းများ:

  • File type flags (-md, -img, -nb) မှားသုံးထားတယ်
  • Project ထဲမှာ ကိုက်ညီတဲ့ ဖိုင်မရှိဘူး
  • Directory structure မှားနေတယ်

ဖြေရှင်းနည်း:

  1. Debug mode သုံးပါ:

    translate -l "ko" -md -d

  2. Project ထဲက file types ကို စစ်ပါ:

    # For markdown files
find . -name "*.md" -not -path "./translations/*"

# For notebooks
find . -name "*.ipynb" -not -path "./translations/*"

# For images
find . -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" -not -path "./translations/*"

  3. Flag တွေကို ကိုက်ညီစေပါ:

    # Translate everything (default)
translate -l "ko"

# Translate specific types
translate -l "ko" -md -img

6. System အဟောင်းကနေ ပြောင်းရွှေ့ခြင်း

6.1. Markdown-Only Mode ပယ်ဖျက်သွားပြီ

ပြဿနာ: Markdown-only fallback ကို အလိုအလျောက် သုံးတဲ့ command တွေ အလုပ်မလုပ်တော့ဘူး။

အဟောင်းမှာ:

# This used to automatically switch to markdown-only mode
translate -l "ko"  # (when Azure AI Vision was not configured)

အသစ်မှာ:

# This now produces an error if image translation is requested but not configured
translate -l "ko" -img

ဖြေရှင်းနည်း:

  • တိကျစွာ သတ်မှတ်ပါ: ဘာကို ပြန်ဆိုချင်သလဲ ရှင်းရှင်းလင်းလင်း သတ်မှတ်ပါ 
    translate -l "ko" -md        # Only markdown
translate -l "ko" -md -img   # Markdown and images
translate -l "ko"            # Everything (if all services configured)

6.2. Link များ မမျှော်လင့်တဲ့နေရာကို ဦးတည်ခြင်း

ပြဿနာ: ပြန်ဆိုထားတဲ့ ဖိုင်ထဲက link တွေ မမျှော်လင့်တဲ့နေရာကို ဦးတည်နေတတ်တယ်။

အကြောင်းရင်း: File type ရွေးချယ်မှုအပေါ် မူတည်ပြီး link တွေ dynamic ပြောင်းလဲတတ်တယ်။

ဖြေရှင်းနည်း:

  1. Link အသစ်အနေနဲ့ ဘယ်လို အလုပ်လုပ်သလဲ နားလည်ပါ:

    • -nb ပါဝင်ရင်: Notebook link တွေ ပြန်ဆိုထားတဲ့ version ကို ဦးတည်တယ်
    • -nb မပါဝင်ရင်: Notebook link တွေ မူရင်းဖိုင်ကို ဦးတည်တယ်
    • -img ပါဝင်ရင်: Image link တွေ ပြန်ဆိုထားတဲ့ version ကို ဦးတည်တယ်
    • -img မပါဝင်ရင်: Image link တွေ မူရင်းဖိုင်ကို ဦးတည်တယ်

  2. သင့်လိုအပ်ချက်အတွက် combination မှန်ကန်စွာ ရွေးပါ:

    # All internal links point to translated versions
translate -l "ko" -md -img -nb

# Only markdown translated, other links point to originals
translate -l "ko" -md

7. GitHub Action run ပြီး PR မဖန်တီးဘူး

လက္ခဏာ: peter-evans/create-pull-request workflow logs မှာ:

Branch 'update-translations' is not ahead of base 'main' and will not be created

ဖြစ်နိုင်တဲ့ အကြောင်းရင်းများ:

  • မပြောင်းလဲမှုရှိ: Translation လုပ်ပြီး repo မှာ diff မရှိတော့ (repo up to date ဖြစ်နေတယ်)
  • Ignored outputs: .gitignore မှာ commit လုပ်ချင်တဲ့ ဖိုင်တွေ (ဥပမာ *.ipynb, translations/, translated_images/) ကို exclude လုပ်ထားတယ်
  • add-paths မကိုက်ညီမှု: Action ကို paths ပေးတဲ့အခါ output location နဲ့ မကိုက်ညီဘူး
  • Workflow logic/conditions: Translation step က စောစောထွက်သွားတယ် သို့မဟုတ် မမျှော်လင့်တဲ့ directory မှာ ဖိုင်ရေးထားတယ်

ဘယ်လို ပြင်/စစ်ရမလဲ:

  1. Output ရှိ/မရှိ စစ်ပါ: Translation ပြီးရင် workspace ထဲမှာ translations/ နဲ့/သို့မဟုတ် translated_images/ ထဲမှာ ဖိုင်အသစ်/ပြောင်းလဲမှု ရှိ/မရှိ စစ်ပါ။
    • Notebook ပြန်ဆိုရင် .ipynb ဖိုင်တွေ translations/<lang>/... ထဲမှာ ရေးထားကြောင်း စစ်ပါ။
  2. .gitignore ကို ပြန်ကြည့်ပါ: Generated outputs တွေကို ignore မလုပ်ပါနဲ့။ အောက်ပါအရာတွေကို မထည့်ပါနဲ့:
    • translations/
    • translated_images/
    • *.ipynb (Notebook ပြန်ဆိုရင်)
  3. add-paths ကို output နဲ့ ကိုက်ညီစေပါ: Multiline value သုံးပြီး folder နှစ်ခုလုံး ထည့်ပါ: 
    with:
  add-paths: |
    translations/
    translated_images/
  4. Debug အတွက် PR ကို အတင်းလုပ်ပါ: Empty commit ကို ခွင့်ပြုထားပြီး wiring မှန်မမှန် စစ်ပါ: 
    with:
  commit-empty: true
  5. Debug mode နဲ့ run လုပ်ပါ: translate command မှာ -d ထည့်ပြီး ဘယ်ဖိုင်တွေ ရှာတွေ့/ရေးထားသလဲ print ထုတ်ပါ။
  6. Permissions (GITHUB_TOKEN): Workflow မှာ commit/PR ဖန်တီးခွင့်ရှိကြောင်း စစ်ပါ: 
    permissions:
  contents: write
  pull-requests: write

Quick Debugging Checklist

ပြန်ဆိုရေး ပြဿနာဖြေရှင်းတဲ့အခါ:

  1. Debug mode သုံးပါ: -d flag ထည့်ပြီး log အသေးစိတ်ကြည့်ပါ
  2. Flag တွေကို စစ်ပါ: -md, -img, -nb သုံးမှု သင့်ရည်ရွယ်ချက်နဲ့ ကိုက်ညီစေပါ
  3. Configuration ကို စစ်ပါ: .env ဖိုင်ထဲမှာ လိုအပ်တဲ့ key တွေ ပါ/မပါ စစ်ပါ
  4. တဖြည်းဖြည်း စမ်းပါ: -md တစ်ခုတည်းနဲ့ စပြီး နောက်ထပ် type တွေ ထပ်ထည့်ပါ
  5. File structure ကို စစ်ပါ: Source ဖိုင်တွေ ရှိ/မရှိ၊ အသုံးပြုနိုင်/မနိုင် စစ်ပါ

Command တွေ၊ flag တွေ အသေးစိတ်ကို Command Reference မှာ ကြည့်နိုင်ပါတယ်။

သတိပေးချက်: ဤစာရွက်စာတမ်းကို AI ဘာသာပြန်ဝန်ဆောင်မှု Co-op Translator ကို အသုံးပြု၍ ဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့သည် တိကျမှုအတွက် ကြိုးစားနေသော်လည်း၊ အလိုအလျောက်ဘာသာပြန်မှုများတွင် အမှားများ သို့မဟုတ် မတိကျမှုများ ပါဝင်နိုင်သည်ကို သတိပြုပါ။ မူလစာရွက်စာတမ်း၏ မူရင်းဘာသာစကားကို အာဏာပိုင်အဖြစ် ယူဆသင့်ပါသည်။ အရေးကြီးသောအချက်အလက်များအတွက် လူ့ဘာသာပြန်ပညာရှင်များကို အသုံးပြုရန် အကြံပြုပါသည်။ ဤဘာသာပြန်မှုကို အသုံးပြုခြင်းကြောင့် ဖြစ်ပေါ်လာသော နားလည်မှုမှားခြင်း သို့မဟုတ် အနားလည်မှုမှားခြင်းများအတွက် ကျွန်ုပ်တို့သည် တာဝန်ယူမည်မဟုတ်ပါ။
⚡