Skip to content

troubleshooting.md

Latest commit

 

History

History
243 lines (182 loc) · 20 KB

troubleshooting.md

File metadata and controls

243 lines (182 loc) · 20 KB

មីគ្រូសុភ្ឋ Co-op Translator មគ្គុទេសក៍ដោះស្រាយបញ្ហា

ទិដ្ឋភាពទូទៅ

Microsoft Co-Op Translator គឺជាឧបករណ៍ដែលមានសមត្ថភាពខ្លាំងសម្រាប់បកប្រែឯកសារ Markdown ឲ្យកើតមានដោយរលូន។ មគ្គុទេសក៍នេះនឹងជួយអ្នកដោះស្រាយបញ្ហាទូទៅដែលជួបប្រទៈនៅពេលប្រើបច្ចេកវិទ្យានេះ។

បញ្ហាទូទៅ និងដំណោះស្រាយ

1. បញ្ហាតេក Markdown

បញ្ហា: ឯកសារ Markdown ដែលបានបកប្រែមានតេក markdown នៅផ្នែកលើកំពូល ដែលបណ្តាលឲ្យមានបញ្ហាក្នុងការបង្ហាញ។

ដំណោះស្រាយ: ដើម្បីដោះស្រាយបញ្ហានេះ គ្រាន់តែលុបតេក markdown នៅកំពូលឯកសារ។ វានឹងអនុញ្ញាតឲ្យឯកសារ Markdown បង្ហាញបានត្រឹមត្រូវ។

ជំហាន:

  1. បើកឯកសារ Markdown ដែលបានបកប្រែ (.md)។
  2. ស្វែងរកតេក markdown នៅផ្នែកលើកំពូលឯកសារ។
  3. លុបតេក markdown។
  4. រក្សាទុកការផ្លាស់ប្តូរនៅក្នុងឯកសារ។
  5. បើកឯកសារឡើងវិញដើម្បីធ្វើការត្រួតពិនិត្យថាកម្មវិធីបានបង្ហាញត្រឹមត្រូវ។

2. បញ្ហា URL រូបភាពបញ្ចូល

បញ្ហា: URL របស់រូបភាពបញ្ចូលមិនត្រូវគ្នានឹងភាសាទីតាំងដែលបានបកប្រែ ដោយនាំឲ្យរូបភាពមិនត្រឹមត្រូវ ឬសន្ធឹង។

ដំណោះស្រាយ: ពិនិត្យ URL របស់រូបភាពបញ្ចូល ហើយធ្វើឲ្យប្រាកដថាវាសមរម្យនឹងភាសាទីតាំង។ រូបភាពទាំងអស់ត្រូវបានរក្សាទុកក្នុងថត translated_images ហើយរាល់រូបភាពមានតេកភាសាទីតាំងនៅក្នុងឈ្មោះឯកសាររូបភាព។

ជំហាន:

  1. បើកឯកសារ Markdown ដែលបានបកប្រែ។
  2. កំណត់រូបភាពបញ្ចូល និង URL របស់ពួកវា។
  3. ផ្ទៀងផ្ទាត់ថាភាសាទីតាំងក្នុងឈ្មោះឯកសាររូបភាពត្រូវគ្នានឹងភាសាឯកសារ។
  4. បន្ទាន់បំរើ URL ប្រសិនបើចាំបាច់។
  5. រក្សាទុកការផ្លាស់ប្តូរ ហើយបើកឯកសារឡើងវិញដើម្បីបញ្ជាក់ថារូបភាពបានបង្ហាញត្រឹមត្រូវ។

3. តុល្យភាពនៃការបកប្រែ

បញ្ហា: មាតិកាដែលបានបកប្រែមិនត្រឹមត្រូវ ឬតម្រូវឲ្យមានការកែសម្រួលបន្ថែម។

ដំណោះស្រាយ: ពិនិត្យឯកសារដែលបានបកប្រែ និងធ្វើការកែសម្រួលតាមតម្រូវការដើម្បីពង្រឹងតុល្យភាព និងភាពងាយស្រួលក្នុងការអាន។

ជំហាន:

  1. បើកឯកសារដែលបានបកប្រែ។
  2. ពិនិត្យមាតិកាឲ្យម៉ត់ចត់។
  3. ធ្វើការកែសម្រួលតាមតម្រូវការ ដើម្បីពង្រឹងតុល្យភាពនៃការបកប្រែ។
  4. រក្សាទុកការផ្លាស់ប្តូរ។

4. កំហុសសិទ្ធិបានលុប ឬ 404

ប្រសិនបើរូបភាព ឬអត្ថបទមិនត្រូវបានបកប្រែក្នុងភាសាត្រឹមត្រូវ និងពេលដំណើរការជាមួយម៉ូដ -d debug អ្នកបានជួបកំហុស 401។ នេះគឺជាការបរាជ័យផ្នែកផ្ទៀងផ្ទាត់សម្គាល់ចាស់—កូនសោអាចមិនមានសុពលភាព កំណត់ពេលផុតកំណត់ ឬមិនភ្ជាប់នឹងតំបន់ endpoint។

រត់ co-op translator ជាមួយ -d debug switch ដើម្បីយល់ដឹងបន្ថែមអំពីមូលហេតុ។

  • សារ​កំហុសៈ Access denied due to invalid subscription key or wrong API endpoint.
  • មូលហេតុអាចមាន:
    • កូនសោសេវាកម្មត្រូវបានលុបឬមិនត្រឹមត្រូវក្នុងសំណើ។
    • កូនសោ AI Services ឬ Subscription Key អាចជារបស់កន្លែង Azure ផ្សេង (ដូចជា Translator ឬ OpenAI) មិនមែនខណៈ Azure AI Vision ទេ។

ប្រភេទធនធាន

  • ចូលទៅកាន់ Azure Portal ឬ Azure AI Foundry ហើយពិនិត្យថាធនធានគឺជាប្រភេទ Azure AI services → Vision។
  • ផ្ទៀងផ្ទាត់កូនសោ និងធានាថាកូនសោត្រឹមត្រូវត្រូវបានប្រើ។

5. កំហុសការកំណត់តម្លៃ (ដំណោះស្រាយកំហុសថ្មី)

ចាប់ពីប្រព័ន្ធបកប្រែជ្រើសរើសថ្មី​ Co-op Translator បានផ្តល់សារកំហុសច្បាស់លាស់ពេលសេវាកម្មត្រូវការ មិនត្រូវបានកំណត់តម្លៃ។

5.1. សេវា Azure AI មិនត្រូវបានកំណត់តម្លៃសម្រាប់ការបកប្រែរូបភាព

បញ្ហា: អ្នកបានស្នើរសុំបកប្រែរូបភាព (-img flag) ប៉ុន្តែសេវា Azure AI មិនត្រូវបានកំណត់តម្លៃបានត្រឹមត្រូវ។

សារ​កំហុស:

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. ជម្រើស 1: កំណត់តម្លៃសេវា Azure AI

    • បន្ថែម AZURE_AI_SERVICE_API_KEY ទៅក្នុងឯកសារ .env
    • បន្ថែម AZURE_AI_SERVICE_ENDPOINT ទៅក្នុងឯកសារ .env
    • ផ្ទៀងផ្ទាត់ថាសេវាកម្មអាចចូលដំណើរការ

  2. ជម្រើស 2: ដកចេញសំណើរបកប្រែរូបភាព

    # ជំនួសវិញ: translate -l "ko" -img
# ប្រើ: translate -l "ko" -md

5.2. ការខ្វះកំណត់តម្លៃចាំបាច់

បញ្ហា: ការកំណត់តម្លៃ LLM ដែលចាំបាច់ ខ្វះខាត។

សារ​កំហុស:

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

ដំណោះស្រាយ:

  1. ផ្ទៀងផ្ទាត់ថាឯកសារ .env របស់អ្នក មានការកំណត់តម្លៃ LLM កែប្រែមួយយ៉ាងហោចណាស់៖

    • Azure OpenAI: AZURE_OPENAI_API_KEY និង AZURE_OPENAI_ENDPOINT
    • OpenAI: OPENAI_API_KEY

    អ្នកត្រូវការតែ Azure OpenAI ឬ OpenAI តែម្ដង មិនត្រូវមានទាំងពីរទេ។

5.3. ការភាន់ច្រឡំក្នុងការបកប្រែជ្រើសរើស

បញ្ហា: គ្មានឯកសារណាត្រូវបានបកប្រែទោះបីបញ្ជារបំពេញក៏ដោយ។

មូលហេតុអាចមាន:

  • តេកប្រភេទឯកសារក្លាតៗ ( -md, -img, -nb)
  • គ្មានឯកសារអត្រាក្នុងគម្រោង
  • រចនាសម្ព័ន្ធថតមិនត្រឹមត្រូវ

ដំណោះស្រាយ:

  1. ប្រើម៉ូដ debug ដើម្បីមើលវាអ្វីកំពុងឡើង:

    translate -l "ko" -md -d

  2. ពិនិត្យប្រភេទឯកសារ ក្នុងគម្រោងរបស់អ្នក:

    # សម្រាប់ឯកសារ markdown
find . -name "*.md" -not -path "./translations/*"

# សម្រាប់សៀវភៅចំណាំ
find . -name "*.ipynb" -not -path "./translations/*"

# សម្រាប់រូបភាព
find . -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" -not -path "./translations/*"

  3. ផ្ទៀងផ្ទាត់ការរួមបញ្ចូលតេក:

    # ប្រែសម្រួលគ្រប់យ៉ាង (លំនាំដើម)
translate -l "ko"

# ប្រែសម្រួលប្រភេទជាក់លាក់
translate -l "ko" -md -img

6. ធ្វើបច្ចុប្បន្នភាពពីប្រព័ន្ធចាស់

6.1. របៀប Markdown-Only បានបោះបង់

បញ្ហា: ពាក្យបញ្ជាដែលអាស្រ័យលើ fallback markdown-only ទៅមិនដំណើរការដូចដែលបានរំពឹងទុក។

ឥរិយាបថចាស់:

# នេះធ្លាប់ត្រូវបានប្រើដើម្បីប្ដូរជាប្រភេទម៉ាទិកក្នុងម៉ាទិកបញ្ជាក់តែប៉ុណ្ណោះដោយស្វ័យប្រវត្តិ
translate -l "ko"  # (ពេល Azure AI Vision មិនបានកំណត់រចនា)

ឥរិយាបថថ្មី:

# ឥឡូវនេះវាបង្កើតកំហុស ប្រសិនបើសំណើសុំបំលែងរូបភាព តែ មិនបានកំណត់រចនាសម្ព័ន្ធឡើយ។
translate -l "ko" -img

ដំណោះស្រាយ:

  • ត្រូវច្បាស់លាស់ អំពីអ្វីដែលអ្នកចង់បកប្រែ: 
    translate -l "ko" -md        # ត្រឹមតែ markdown ប៉ុណ្ណោះ
translate -l "ko" -md -img   # Markdown និងរូបភាព
translate -l "ko"            # អ្វីគ្រប់យ៉ាង (បើសេវាកម្ម​ទាំងអស់បានកំណត់រចនា)

6.2. អ្នកប្រើបានសម្រួលតំណភ្ជាប់មិនរំពឹងទុក

បញ្ហា: តំណភ្ជាប់នៅក្នុងឯកសារដែលបានបកប្រែបង្ហាញទៅកាន់ទីតាំងមិនរំពឹងទុក។

មូលហេតុ: ការដំណើរការតំណភ្ជាប់ឌីណាមិចផ្លាស់ប្តូរតាមប្រភេទឯកសារជ្រើសរើស។

ដំណោះស្រាយ:

  1. យល់ពីឥរិយាបថតំណភ្ជាប់ថ្មី:

    • បញ្ចូល -nb: តំណទិន្នន័យនិពន្ធបង្ហាញទៅកាន់កំណែបកប្រែ
    • មិនបញ្ចូល -nb: តំណទិន្នន័យនិពន្ធបង្ហាញទៅកាន់ឯកសារដើម
    • បញ្ចូល -img: តំណរូបភាពបង្ហាញទៅកាន់កំណែបកប្រែ
    • មិនបញ្ចូល -img: តំណរូបភាពបង្ហាញទៅកាន់ឯកសារដើម

  2. ជ្រើសរើសការរួមបញ្ចូលត្រឹមត្រូវ សម្រាប់ករណីរបស់អ្នក:

    # តំណខាងក្នុងទាំងអស់បង្ហាញទៅកាន់កំណែបកប្រែ
translate -l "ko" -md -img -nb

# មានតែ markdown បកប្រែ ប៉ុន្តែតំណផ្សេងទៀតបង្ហាញទៅកាន់លំដាប់ដើម
translate -l "ko" -md

7. ការប្រតិបត្ដិ GitHub បានដំណើរការទៅ តែមិនបានបង្កើត Pull Request( PR )

រោលរាលៈ: កំណត់ហេតុនៃសកម្មភាព peter-evans/create-pull-request បង្ហាញថា:

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

មូលហេតុអាចមាន:

  • គ្មានការផ្លាស់ប្តូរត្រូវបានរកឃើញ: ជំហានបកប្រែមិនបង្កើតភាពខុសគ្នាទេ (repo រួចហើយបានធ្វើបច្ចុប្បន្នភាព)
  • លទ្ធផលដែលត្រូវបានរំលង: .gitignore មិនចូលរួមឯកសារដែលអ្នករំពឹងចង់ផ្តល់បន្ត (ឧ. *.ipynb, translations/, translated_images/)
  • add-paths មិនត្រូវគ្នា: ផ្លូវដែលផ្តល់ទៅសកម្មភាពមិនត្រូវគ្នានឹងទីតាំងលទ្ធផលពិតប្រាកដ។
  • ដំណើរការសកម្មភាព/លក្ខខណ្ឌ: ជំហានបកប្រែបានបញ្ចប់មុនពេល ឬបានសរសេរទៅថតដែលមិនរំពឹងទុក។

វិធីដោះស្រាយ / ផ្ទៀងផ្ទាត់:

  1. ប្រាកដថាលទ្ធផលមាននៅ: បន្ទាប់ពីបកប្រែ ពិនិត្យថាកន្លែងធ្វើការមានឯកសារថ្មី/ផ្លាស់ប្តូរនៅក្នុង translations/ ឬ/និង translated_images/។
    • ប្រសិនបើបកប្រែសៀវភៅកំណត់ចំណាំ (notebooks) ត្រូវប្រាកដថាឯកសារ .ipynb ត្រូវបានសរសេរពិតប្រាកដនៅក្រោម translations/<lang>/...។
  2. ពិនិត្យ .gitignore: កុំរំលងលទ្ធផលដែលបានបង្កើត។ ធានាថាអ្នកមិនបានរំលង៖
    • translations/
    • translated_images/
    • *.ipynb (បើកំពុងបកប្រែសៀវភៅកំណត់ចំណាំ)
  3. ធានាថា add-paths ត្រូវគ្នានឹងលទ្ធផល: ប្រើតម្លៃច្រើនបន្ទាត់ និងរួមបញ្ចូលថតទាំងពីរបើអាចធ្វើបាន៖ 
    with:
  add-paths: |
    translations/
    translated_images/
  4. បង្ខម្រ PR សម្រាប់សាកល្បងវិភាគ៖ អនុញ្ញាតការបញ្ចូលទទេ ដើម្បីបញ្ជាក់ថាការតភ្ជាប់ត្រឹមត្រូវ៖ 
    with:
  commit-empty: true
  5. រត់ជាមួយ debug៖ បន្ថែម -d ទៅក្នុងការបកប្រែ ដើម្បីបង្ហាញថាតើឯកសារអ្វីបានរកឃើញ និងសរសេរ។
  6. សិទិ្ធ (GITHUB_TOKEN): ធានាថាសកម្មភាពមានសិទ្ធិសរសេរដើម្បីបង្កើតកំណែបន្ត និង PR: 
    permissions:
  contents: write
  pull-requests: write

បញ្ជីពិនិត្យលឿនសម្រាប់ដោះស្រាយបញ្ហា

ពេលដែលដោះស្រាយបញ្ហាក្នុងការបកប្រែ:

  1. ប្រើម៉ូដ debug: បន្ថែមតេក -d ដើម្បីមើលកំណត់ហេតុលម្អិត
  2. ពិនិត្យតេករបស់អ្នក: ធានាវ่า -md, -img, -nb ត្រូវគ្នានឹងគោលបំណងរបស់អ្នក
  3. ផ្ទៀងផ្ទាត់កំណត់តម្លៃ: ពិនិត្យឯកសារ .env របស់អ្នកមានកូនសោចាំបាច់
  4. សាកល្បងជាន់កម្រិត: ចាប់ផ្តើមជាមួយ -md តែម្ដង បន្ទាប់មកបន្ថែមប្រភេទផ្សេងៗ
  5. ពិនិត្យរចនាសម្ព័ន្ធឯកសារ: ធានាថាឯកសារដើមមាន និងអាចចូលដំណើរការ

សម្រាប់ព័ត៌មានលម្អិតបន្ថែមអំពីពាក្យបញ្ជា និងតេកដែលមាន សូមមើល Command Reference។

ការបដិសេធ៖
ឯកសារនេះត្រូវបានបកប្រែដោយប្រើសេវាកម្មបកប្រែ AI Co-op Translator។ ខណៈពេលដែលយើងខិតខំប្រឹងប្រែងដើម្បីភាពត្រឹមត្រូវ សូមយកចិត្តទុកដាក់ថាការបកប្រែដោយស្វ័យប្រវត្តិក្នុងនេះអាចមានកំហុស ឬការបញ្ចេញព័ត៌មានមិនត្រឹមត្រូវ។ ឯកសារដើមជាភាសាមាតិជាតិនោះគួរត្រូវបានស្គាល់ថាជាធនាគារដែលមានអំណាច។ សម្រាប់ព័ត៍មានសំខាន់ៗណា ការបកប្រែដោយមនុស្សដែលមានជំនាញគឺអាចជាជម្រើសល្អ។ យើងមិនបានទទួលខុសត្រូវចំពោះភាពយល់ច្រឡំ ឬការបកប្រែខុសឆ្គងណាមួយដែលកើតឡើងពីការប្រើប្រាស់ការបកប្រែនេះឡើយ។