co-op-translator

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

This site is open source. Improve this page.