ແປ PPTX ພາສາອັງກິດ ເປັນ ພາສາອາຣັບ API: ຄູ່ມືທີ່ວ່ອງໄວ ແລະ ຖືກຕ້ອງ

ນັກພັດທະນາມັກຈະປະເຊີນກັບອຸປະສັກທີ່ສຳຄັນເມື່ອພະຍາຍາມແປ PPTX ຈາກພາສາອັງກິດ ເປັນ ພາສາອາຣັບ ໂດຍໃຊ້ API.
ວຽກງານນີ້ແມ່ນສັບສົນຫຼາຍກ່ວາການປ່ຽນແທນຂໍ້ຄວາມແບບງ່າຍດາຍ, ໂດຍກ່ຽວຂ້ອງກັບການປັບຮູບແບບທີ່ຊັບຊ້ອນ ແລະ ການຮອງຮັບຂໍ້ຄວາມແບບສອງທິດທາງ.
ຄູ່ມືຂອງພວກເຮົາສະຫນອງວິທີແກ້ໄຂທີ່ມີປະສິດທິພາບ, ຊ່ວຍໃຫ້ທ່ານສາມາດເຮັດຂະບວນການນີ້ໃຫ້ເປັນອັດຕະໂນມັດດ້ວຍຄວາມຖືກຕ້ອງ ແລະ ປະສິດທິພາບ.

ສິ່ງທ້າທາຍທາງດ້ານເຕັກນິກຂອງການແປ PPTX ເປັນ ພາສາອາຣັບ

ການເຮັດໃຫ້ການແປໄຟລ໌ PowerPoint (PPTX) ເປັນອັດຕະໂນມັດ, ໂດຍສະເພາະເຂົ້າໃນພາສາຂຽນຈາກຂວາຫາຊ້າຍ (RTL) ເຊັ່ນ: ພາສາອາຣັບ, ສະແດງໃຫ້ເຫັນເຖິງຊຸດອຸປະສັກທາງດ້ານເຕັກນິກທີ່ເປັນເອກະລັກ.
ສິ່ງທ້າທາຍເຫຼົ່ານີ້ແມ່ນເກີນກວ່າການປ່ຽນແປງທາງດ້ານພາສາຢ່າງດຽວ, ແຕ່ກ່ຽວຂ້ອງກັບໂຄງສ້າງຫຼັກ ແລະ ຄວາມສົມບູນທາງສາຍຕາຂອງການນຳສະເໜີ.
ການບໍ່ແກ້ໄຂບັນຫາເຫຼົ່ານີ້ສາມາດສົ່ງຜົນໃຫ້ຮູບແບບເສຍຫາຍ, ຂໍ້ຄວາມອ່ານບໍ່ໄດ້, ແລະ ປະສົບການຂອງຜູ້ໃຊ້ທີ່ບໍ່ດີ.

ການຮັກສາຮູບແບບສະໄລ້ທີ່ສັບສົນ

ການນຳສະເໜີ PowerPoint ມີຄວາມເປັນພາບສູງ, ໂດຍອີງໃສ່ການຈັດລຽງທີ່ຊັດເຈນຂອງກ່ອງຂໍ້ຄວາມ, ຮູບພາບ, ຕາຕະລາງ, ແລະ ອົງປະກອບກຣາຟິກອື່ນໆ.
ເມື່ອແປຈາກພາສາຂຽນຈາກຊ້າຍຫາຂວາ (LTR) ເຊັ່ນ: ພາສາອັງກິດ ໄປເປັນພາສາ RTL ເຊັ່ນ: ພາສາອາຣັບ, ການໄຫຼເຂົ້າຂອງສະໄລ້ທັງໝົດຕ້ອງຖືກສະທ້ອນ.
API ທີ່ລຽບງ່າຍເຊິ່ງພຽງແຕ່ປ່ຽນຂໍ້ຄວາມຈະທຳລາຍການອອກແບບເດີມຢ່າງສິ້ນເຊີງ, ເຮັດໃຫ້ການນຳສະເໜີໃຊ້ງານບໍ່ໄດ້ ແລະ ບໍ່ເປັນມືອາຊີບ.

ຂະບວນການແປພາສາຕ້ອງຈັດຕໍາແໜ່ງອົງປະກອບຄືນໃໝ່ຢ່າງສະຫຼາດເພື່ອເຄົາລົບທິດທາງການອ່ານໃໝ່.
ນີ້ປະກອບມີການປັບການຈັດວາງຂໍ້ຄວາມ, ການສະທ້ອນຕຳແໜ່ງຂອງກຣາຟິກທີ່ກ່ຽວຂ້ອງກັບຂໍ້ຄວາມ, ແລະ ການຈັດລໍາດັບຈຸດຫົວຂໍ້ ຫຼື ລາຍການທີ່ມີໝາຍເລກຄືນໃໝ່.
ຖ້າບໍ່ມີຄວາມເຂົ້າໃຈຢ່າງລະອຽດກ່ຽວກັບໂຄງສ້າງ Open XML ຂອງຮູບແບບໄຟລ໌ PPTX, ການປ່ຽນຮູບແບບເຫຼົ່ານີ້ແມ່ນເກືອບເປັນໄປບໍ່ໄດ້ທີ່ຈະເຮັດໃຫ້ເປັນອັດຕະໂນມັດຢ່າງຖືກຕ້ອງ.

ການຈັດການການໄຫຼຂອງຂໍ້ຄວາມແບບຂວາຫາຊ້າຍ (RTL)

ຕົວອັກສອນພາສາອາຣັບແມ່ນຂຽນຈາກຂວາໄປຊ້າຍ, ເຊິ່ງເປັນຄວາມແຕກຕ່າງພື້ນຖານຈາກພາສາອັງກິດ.
API ການແປພາສາທີ່ມີປະສິດທິພາບຕ້ອງບໍ່ພຽງແຕ່ໃສ່ຕົວອັກສອນອາຣັບເທົ່ານັ້ນ ແຕ່ຍັງຕ້ອງກຳນົດຄ່າການໄຫຼຂອງຂໍ້ຄວາມ ແລະ ຄຸນສົມບັດການຈັດວາງໃຫ້ຖືກຕ້ອງສຳລັບທຸກໆອົງປະກອບທີ່ມີຂໍ້ຄວາມ.
ນີ້ປະກອບມີວັກ, ກ່ອງຂໍ້ຄວາມ, ຕາຕະລາງ, ແລະ ແມ່ນແຕ່ຂໍ້ຄວາມພາຍໃນຮູບຮ່າງ, ເພື່ອຮັບປະກັນວ່າເນື້ອໃນສາມາດອ່ານໄດ້ຕາມທຳມະຊາດສຳລັບຜູ້ເວົ້າພື້ນເມືອງ.

ຍິ່ງໄປກວ່ານັ້ນ, ການນຳສະເໜີມັກຈະມີຂໍ້ຄວາມສອງທິດທາງແບບປະສົມ, ເຊັ່ນ: ຊື່ຍີ່ຫໍ້, ຕົວເລກ, ຫຼື ຂໍ້ຄວາມລະຫັດເປັນພາສາອັງກິດ.
API ຕ້ອງຈັດການຂໍ້ຄວາມສອງທິດທາງນີ້ຢ່າງຖືກຕ້ອງພາຍໃນບລັອກຂໍ້ຄວາມດຽວກັນ, ເຊິ່ງເປັນມາດຕະຖານທີ່ເອີ້ນວ່າການຮອງຮັບ ‘BiDi’.
ການຈັດການ BiDi ທີ່ເໝາະສົມຈະປ້ອງກັນບໍ່ໃຫ້ເຄື່ອງໝາຍວັກຕອນປາກົດຢູ່ໃນຕອນທ້າຍຂອງປະໂຫຍກທີ່ບໍ່ຖືກຕ້ອງ ແລະ ຮັບປະກັນວ່າຕົວເລກບໍ່ຖືກສັບສົນພາຍໃນການໄຫຼຂອງ RTL.

ການຈັດການວັດຖຸ ແລະ ສື່ທີ່ຝັງໄວ້

ໄຟລ໌ PPTX ທີ່ທັນສະໄໝບໍ່ແມ່ນພຽງແຕ່ຂໍ້ຄວາມ ແລະ ຮູບຮ່າງເທົ່ານັ້ນ; ພວກມັນມັກຈະມີວັດຖຸທີ່ຝັງໄວ້ເຊັ່ນ: ຕາຕະລາງ, ກຣາຟ, ແລະ SmartArt.
ຂໍ້ຄວາມພາຍໃນວັດຖຸເຫຼົ່ານີ້—ເຊັ່ນ: ປ້າຍຊື່ແກນ, ຈຸດຂໍ້ມູນ, ແລະ ຂໍ້ຄວາມແຜນວາດ—ກໍ່ຕ້ອງຖືກແປ ແລະ ຈັດລຽງຄືນໃໝ່ເຊັ່ນກັນ.
ນີ້ຮຽກຮ້ອງໃຫ້ API ວິເຄາະໂຄງສ້າງທີ່ຝັງໄວ້ທີ່ສັບສົນເຫຼົ່ານີ້, ແປເນື້ອໃນຂອງພວກມັນ, ແລະ ຈາກນັ້ນສ້າງຄືນໃໝ່ໃນຂະນະທີ່ຮັກສາຮູບແບບສາຍຕາ ແລະ ຄວາມສົມບູນຂອງຂໍ້ມູນຂອງພວກມັນ.

ຮູບພາບທີ່ມີຂໍ້ຄວາມຖືກຝັງໄວ້ເປັນອຸປະສັກທີ່ສໍາຄັນອີກອັນຫນຶ່ງສໍາລັບການແປແບບອັດຕະໂນມັດ.
API ແບບງ່າຍໆບໍ່ສາມາດປຸງແຕ່ງຂໍ້ຄວາມນີ້ໄດ້, ເຮັດໃຫ້ບາງສ່ວນຂອງການນຳສະເໜີຍັງບໍ່ໄດ້ແປ.
ວິທີແກ້ໄຂແບບພິເສດແມ່ນຈໍາເປັນເພື່ອທີ່ຈະລະເລີຍຮູບພາບເຫຼົ່ານີ້ ຫຼື ໝາຍໄວ້ເພື່ອທົບທວນດ້ວຍຕົນເອງ, ເພື່ອຮັບປະກັນຜະລິດຕະພັນສຸດທ້າຍທີ່ຖືກຈັດຕໍາແໜ່ງຢ່າງສົມບູນ.

ການເຂົ້າລະຫັດຕົວອັກສອນ ແລະ ຄວາມເຂົ້າກັນໄດ້ຂອງຟອນ

ການຮັບປະກັນການສະແດງຕົວອັກສອນທີ່ຖືກຕ້ອງແມ່ນສໍາຄັນສໍາລັບພາສາອາຣັບ, ເຊິ່ງມີຕົວອັກສອນທີ່ແຕກຕ່າງກັນຢ່າງສິ້ນເຊີງຈາກຕົວອັກສອນລາຕິນ.
API ການແປພາສາຕ້ອງຈັດການການເຂົ້າລະຫັດ UTF-8 ຢ່າງຖືກຕ້ອງຕະຫຼອດຂະບວນການທັງໝົດເພື່ອປ້ອງກັນ mojibake, ເຊິ່ງຕົວອັກສອນຖືກສະແດງເປັນສັນຍາລັກທີ່ບໍ່ມີຄວາມໝາຍ.
ນີ້ໃຊ້ໄດ້ກັບການຮັບໄຟລ໌ຕົ້ນສະບັບ, ການປະມວນຜົນຂໍ້ຄວາມ, ແລະ ການສ້າງໄຟລ໌ PPTX ທີ່ຖືກແປສຸດທ້າຍ.

ຄວາມເຂົ້າກັນໄດ້ຂອງຟອນເປັນຂໍ້ພິຈາລະນາຫຼັກອີກອັນໜຶ່ງທີ່ນັກພັດທະນາຕ້ອງແກ້ໄຂ.
ຟອນພາສາອັງກິດຕົ້ນສະບັບອາດຈະບໍ່ຮອງຮັບຕົວອັກສອນອາຣັບ, ເຊິ່ງນໍາໄປສູ່ຟອນສຳຮອງທີ່ສາມາດລົບກວນການພິມ ແລະ ການສ້າງຍີ່ຫໍ້ຂອງການນຳສະເໜີ.
ວິທີແກ້ໄຂການແປພາສາທີ່ເຂັ້ມແຂງຄວນຈະອະນຸຍາດໃຫ້ມີການທົດແທນຟອນ ຫຼື ໃຊ້ຟອນທີ່ຮອງຮັບຕົວອັກສອນອາຣັບເພື່ອຮັກສາຄວາມສອດຄ່ອງທາງສາຍຕາ.

ຂໍແນະນຳ Doctranslate API ສຳລັບການແປ PPTX

Doctranslate API ຖືກອອກແບບມາໂດຍສະເພາະເພື່ອເອົາຊະນະສິ່ງທ້າທາຍທີ່ສັບສົນຂອງການແປເອກະສານ, ລວມທັງໄຟລ໌ PPTX.
ມັນສະຫນອງການໂຕ້ຕອບທີ່ມີປະສິດທິພາບ, ເປັນມິດກັບນັກພັດທະນາເພື່ອ ແປ PPTX ຈາກພາສາອັງກິດ ເປັນ ພາສາອາຣັບ ດ້ວຍຄວາມຖືກຕ້ອງ ແລະ ການຮັກສາຮູບແບບທີ່ໂດດເດັ່ນ.
ລະບົບຂອງພວກເຮົາຖືກອອກແບບມາເພື່ອຈັດການລາຍລະອຽດທີ່ສັບສົນ, ຕັ້ງແຕ່ການໄຫຼຂອງຂໍ້ຄວາມ RTL ໄປຈົນເຖິງການຈັດຕຳແໜ່ງວັດຖຸທີ່ຝັງໄວ້ຄືນໃໝ່, ດັ່ງນັ້ນທ່ານຈຶ່ງບໍ່ຕ້ອງເຮັດ.

ຄຸນສົມບັດຫຼັກສຳລັບນັກພັດທະນາ

API ຂອງພວກເຮົາຖືກສ້າງຂຶ້ນໂດຍເນັ້ນໃສ່ຄວາມຫນ້າເຊື່ອຖື, ຄວາມສາມາດປັບຂະໜາດໄດ້, ແລະ ຄວາມງ່າຍໃນການເຊື່ອມໂຍງສໍາລັບນັກພັດທະນາ.
ພວກເຮົາສະຫນອງ ການປະມວນຜົນແບບ asynchronous, ເຊິ່ງເໝາະສຳລັບການຈັດການໄຟລ໌ PPTX ຂະໜາດໃຫຍ່ ແລະ ສັບສົນໂດຍບໍ່ມີການບລັອກ main thread ຂອງແອັບພລິເຄຊັນຂອງທ່ານ.
ທ່ານສາມາດສົ່ງວຽກ ແລະ ໃຊ້ webhooks ຫຼື polling ເພື່ອຮັບການແຈ້ງເຕືອນເມື່ອສຳເລັດ, ສ້າງການເຮັດວຽກທີ່ບໍ່ບລັອກ ແລະ ມີປະສິດທິພາບ.

ຍິ່ງໄປກວ່ານັ້ນ, API ໃຫ້ການຮອງຮັບພາສາທີ່ກວ້າງຂວາງ, ລວມທັງຫຼາຍສໍານຽງໃນບ່ອນທີ່ເຫມາະສົມ, ຮັບປະກັນວ່າການແປຂອງທ່ານຖືກຕ້ອງຕາມບໍລິບົດ.
ຄວາມປອດໄພແມ່ນສໍາຄັນທີ່ສຸດເຊັ່ນກັນ, ໂດຍມີການໂອນຂໍ້ມູນທັງໝົດໄດ້ຮັບການປົກປ້ອງໂດຍໂປໂຕຄອນການເຂົ້າລະຫັດມາດຕະຖານອຸດສາຫະກໍາ.
ນີ້ເຮັດໃຫ້ທ່ານມີຄວາມໝັ້ນໃຈໃນການປະມວນຜົນການນຳສະເໜີທາງທຸລະກິດທີ່ລະອຽດອ່ອນ ແລະ ເອກະສານຂອງບໍລິສັດຢ່າງປອດໄພຜ່ານແພລະຟອມຂອງພວກເຮົາ.

ສະຖາປັດຕະຍະກຳ RESTful ທີ່ງ່າຍດາຍ

ພວກເຮົາໄດ້ອອກແບບ Doctranslate API ໂດຍອີງໃສ່ຫຼັກການ REST ມາດຕະຖານ, ເຮັດໃຫ້ມັນເຂົ້າໃຈງ່າຍສໍາລັບນັກພັດທະນາຄົນໃດກໍ່ຕາມທີ່ຄຸ້ນເຄີຍກັບ web services.
ການໂຕ້ຕອບແມ່ນຖືກປະຕິບັດໂດຍໃຊ້ວິທີ HTTP ມາດຕະຖານເຊັ່ນ POST ແລະ GET, ແລະ ຜົນຕອບຮັບແມ່ນຖືກຈັດຮູບແບບໃນ JSON ທີ່ຄາດເດົາໄດ້.
ຄວາມງ່າຍດາຍນີ້ຊ່ວຍຫຼຸດຜ່ອນ learning curve ຢ່າງຫຼວງຫຼາຍ ແລະ ອະນຸຍາດໃຫ້ມີການເຊື່ອມໂຍງເຂົ້າໃນ technology stack ທີ່ທັນສະໄໝໃດໆ, ຈາກ backend services ໄປຫາ web applications ຢ່າງວ່ອງໄວ.

ຂັ້ນຕອນການເຮັດວຽກແມ່ນກົງໄປກົງມາ ແລະ ມີເຫດຜົນ, ໂດຍກ່ຽວຂ້ອງກັບການອັບໂຫຼດໄຟລ໌, ການສ້າງວຽກ, ການກວດສອບສະຖານະ, ແລະ ສຸດທ້າຍ, ການດາວໂຫຼດຜົນການແປ.
ຂະບວນການທີ່ຄາດເດົາໄດ້, ເປັນຂັ້ນຕອນນີ້ແມ່ນງ່າຍທີ່ຈະສ້າງແບບຈໍາລອງໃນລະຫັດ ແລະ ໃຫ້ຄໍາຄຶດຄໍາເຫັນທີ່ຊັດເຈນໃນທຸກໆຂັ້ນຕອນ. ສໍາລັບນັກພັດທະນາທີ່ກໍາລັງຊອກຫາວິທີແກ້ໄຂທີ່ມີປະສິດທິພາບແຕ່ງ່າຍດາຍ, API ຂອງພວກເຮົາເຮັດໃຫ້ມັນງ່າຍທີ່ຈະ ແປເອກະສານ PPTX ດ້ວຍຄຸນນະພາບ ແລະ ຄວາມໄວທີ່ບໍ່ມີໃຜທຽບເທົ່າ.

ຄວາມເຂົ້າໃຈກ່ຽວກັບຜົນຕອບຮັບ JSON

ທຸກໆຜົນຕອບຮັບຈາກ Doctranslate API ແມ່ນວັດຖຸ JSON ທີ່ມີໂຄງສ້າງທີ່ດີ, ໃຫ້ຂໍ້ມູນທີ່ຊັດເຈນ ແລະ ສາມາດດໍາເນີນການໄດ້.
ເມື່ອທ່ານສ້າງວຽກແປພາສາ, API ຈະສົ່ງຄືນ job_id ທີ່ເປັນເອກະລັກ ແລະ status ປັດຈຸບັນ.
ຈາກນັ້ນທ່ານສາມາດໃຊ້ job_id ນີ້ເພື່ອ poll ເພື່ອອັບເດດ, ໄດ້ຮັບການປ່ຽນແປງສະຖານະເຊັ່ນ: processing, completed, ຫຼື failed ໃນເວລາຈິງ.

ເມື່ອວຽກຖືກ completed ແລ້ວ, ຜົນຕອບຮັບຈະປະກອບມີ file_id ສໍາລັບເອກະສານທີ່ຖືກແປທີ່ສ້າງຂຶ້ນໃໝ່.
ID ນີ້ສາມາດຖືກໃຊ້ເພື່ອເອົາໄຟລ໌ສຸດທ້າຍຜ່ານ endpoint ການດາວໂຫຼດທີ່ແຍກຕ່າງຫາກ.
ການອອກແບບທີ່ decoupled ນີ້ຮັບປະກັນການແຍກຄວາມກັງວົນທີ່ສະອາດ ແລະ ຂະບວນການເຊື່ອມໂຍງທີ່ມີປະສິດທິພາບ, ທົນທານຕໍ່ຄວາມຜິດພາດສຳລັບແອັບພລິເຄຊັນຂອງທ່ານ.

ຄູ່ມືເທື່ອລະຂັ້ນຕອນ: ການເຊື່ອມໂຍງ API ເພື່ອແປ PPTX ຈາກພາສາອັງກິດ ເປັນ ພາສາອາຣັບ

ຄູ່ມືນີ້ຈະນໍາພາທ່ານຜ່ານຂະບວນການທັງໝົດຂອງການເຊື່ອມໂຍງ API ຂອງພວກເຮົາເພື່ອແປໄຟລ໌ PPTX ຈາກພາສາອັງກິດ ເປັນ ພາສາອາຣັບ.
ພວກເຮົາຈະກວມເອົາທຸກຢ່າງຕັ້ງແຕ່ການໄດ້ຮັບ API key ຂອງທ່ານໄປຈົນເຖິງການອັບໂຫຼດໄຟລ໌ຕົ້ນສະບັບ ແລະ ການດາວໂຫຼດການນໍາສະເໜີທີ່ຖືກແປສຸດທ້າຍ.
ການປະຕິບັດຕາມຂັ້ນຕອນເຫຼົ່ານີ້ຈະຊ່ວຍໃຫ້ທ່ານສ້າງການເຮັດວຽກການແປແບບອັດຕະໂນມັດຢ່າງເຕັມທີ່ພາຍໃນແອັບພລິເຄຊັນຂອງທ່ານເອງ.

ເງື່ອນໄຂເບື້ອງຕົ້ນ: ການໄດ້ຮັບ API Key ຂອງທ່ານ

ກ່ອນທີ່ຈະເຮັດການຮຽກໃຊ້ API ໃດໆ, ທ່ານຈໍາເປັນຕ້ອງໄດ້ຮັບ API key ຈາກ dashboard ຂອງ Doctranslate ຂອງທ່ານ.
key ນີ້ຢືນຢັນຄໍາຮ້ອງຂໍຂອງທ່ານ ແລະ ຕ້ອງຖືກລວມເຂົ້າໃນ header ຂອງທຸກໆການຮຽກໃຊ້ທີ່ທ່ານເຮັດ.
ພຽງແຕ່ລົງທະບຽນ, ໄປທີ່ສ່ວນ API, ແລະ ສ້າງ key ໃໝ່ເພື່ອເລີ່ມຕົ້ນການເຊື່ອມໂຍງຂອງທ່ານ.

ຮັກສາ API key ຂອງທ່ານໃຫ້ປອດໄພ, ເນື່ອງຈາກວ່າມັນຖືກຜູກມັດກັບບັນຊີ ແລະ ການນໍາໃຊ້ຂອງທ່ານ.
ມັນຄວນຈະຖືກປະຕິບັດຄືກັບລະຫັດຜ່ານ ແລະ ເກັບໄວ້ໃນບ່ອນທີ່ປອດໄພ, ເຊັ່ນ: environment variable ຫຼື ລະບົບການຈັດການຄວາມລັບ.
ຢ່າເປີດເຜີຍ API key ຂອງທ່ານໃນ client-side code ຫຼື commit ມັນໃສ່ public version control repository.

ຂັ້ນຕອນທີ 1: ການອັບໂຫຼດໄຟລ໌ PPTX ຂອງທ່ານ

ຂັ້ນຕອນທໍາອິດໃນຂະບວນການແປພາສາແມ່ນການອັບໂຫຼດໄຟລ໌ PPTX ພາສາອັງກິດຕົ້ນສະບັບຂອງທ່ານໄປຫາເຊີບເວີ Doctranslate.
ນີ້ແມ່ນເຮັດໄດ້ໂດຍການສົ່ງຄໍາຮ້ອງຂໍ POST ໄປຫາ endpoint /v2/files.
ຄໍາຮ້ອງຂໍຕ້ອງເປັນຄໍາຮ້ອງຂໍ multipart/form-data ທີ່ມີໄຟລ໌ເອງ.

ເມື່ອການອັບໂຫຼດສໍາເລັດ, API ຈະຕອບສະໜອງດ້ວຍວັດຖຸ JSON ທີ່ມີ file_id ທີ່ເປັນເອກະລັກ.
ID ນີ້ເຮັດໜ້າທີ່ເປັນການອ້າງອີງເຖິງໄຟລ໌ທີ່ເກັບໄວ້ຂອງທ່ານໃນເຊີບເວີທີ່ປອດໄພຂອງພວກເຮົາ.
ທ່ານຈະຕ້ອງການ file_id ນີ້ໃນຂັ້ນຕອນຕໍ່ໄປເພື່ອສ້າງວຽກແປພາສາຕົວຈິງ.

ຂັ້ນຕອນທີ 2: ການລິເລີ່ມວຽກແປພາສາ

ດ້ວຍ file_id ຈາກຂັ້ນຕອນການອັບໂຫຼດ, ທ່ານສາມາດສ້າງວຽກແປພາສາໄດ້ແລ້ວ.
ທ່ານຈະສົ່ງຄໍາຮ້ອງຂໍ POST ໄປຫາ endpoint /v2/jobs.
ັດຖຸໃນ request body ຕ້ອງເປັນ JSON object ທີ່ລະບຸ file_id, source_lang (en), ແລະ target_lang (ar).

ການຮຽກໃຊ້ API ນີ້ບອກລະບົບວ່າໄຟລ໌ໃດທີ່ຈະປຸງແຕ່ງ ແລະ ໃຊ້ຄູ່ພາສາໃດ.
API ຈະຕອບສະໜອງທັນທີດ້ວຍ job_id ແລະ status ເບື້ອງຕົ້ນຂອງວຽກ, ເຊິ່ງມັກຈະເປັນ queued.
job_id ນີ້ແມ່ນຕົວລະບຸຫຼັກທີ່ທ່ານຈະໃຊ້ເພື່ອຕິດຕາມຄວາມຄືບໜ້າຂອງການແປຂອງທ່ານ.

ຕົວຢ່າງລະຫັດ Python

ນີ້ແມ່ນຕົວຢ່າງ Python ທີ່ສົມບູນເຊິ່ງສະແດງໃຫ້ເຫັນເຖິງການເຮັດວຽກເຕັມຮູບແບບ: ການອັບໂຫຼດໄຟລ໌, ການເລີ່ມຕົ້ນການແປພາສາ, ການ polling ເພື່ອຄວາມສໍາເລັດ, ແລະ ການດາວໂຫຼດຜົນໄດ້ຮັບ.
script ນີ້ໃຊ້ library requests ທີ່ນິຍົມເພື່ອຈັດການການສື່ສານ HTTP.
ໃຫ້ແນ່ໃຈວ່າໄດ້ປ່ຽນແທນ 'YOUR_API_KEY' ແລະ 'path/to/your/file.pptx' ດ້ວຍຂໍ້ມູນປະຈໍາຕົວ ແລະ ເສັ້ນທາງໄຟລ໌ຕົວຈິງຂອງທ່ານ.

import requests
import time

# Replace with your actual API key and file path
API_KEY = 'YOUR_API_KEY'
FILE_PATH = 'path/to/your/file.pptx'
BASE_URL = 'https://developer.doctranslate.io/api'

headers = {
    'Authorization': f'Bearer {API_KEY}'
}

# Step 1: Upload the PPTX file
print("Uploading file...")
with open(FILE_PATH, 'rb') as f:
    files = {'file': (FILE_PATH, f, 'application/vnd.openxmlformats-officedocument.presentationml.presentation')}
    response = requests.post(f'{BASE_URL}/v2/files', headers=headers, files=files)

if response.status_code != 201:
    raise Exception(f"File upload failed: {response.text}")

file_id = response.json().get('id')
print(f"File uploaded successfully. File ID: {file_id}")

# Step 2: Create the translation job
print("Creating translation job...")
job_data = {
    'file_id': file_id,
    'source_lang': 'en',
    'target_lang': 'ar'
}
response = requests.post(f'{BASE_URL}/v2/jobs', headers=headers, json=job_data)

if response.status_code != 201:
    raise Exception(f"Job creation failed: {response.text}")

job_id = response.json().get('id')
print(f"Job created successfully. Job ID: {job_id}")

# Step 3: Poll for job completion
print("Polling for job status...")
while True:
    response = requests.get(f'{BASE_URL}/v2/jobs/{job_id}', headers=headers)
    job_status = response.json().get('status')
    print(f"Current job status: {job_status}")

    if job_status == 'completed':
        translated_file_id = response.json().get('translated_file_id')
        print("Translation completed!")
        break
    elif job_status == 'failed':
        raise Exception("Translation job failed.")
    
    time.sleep(5) # Wait for 5 seconds before polling again

# Step 4: Download the translated file
print(f"Downloading translated file with ID: {translated_file_id}")
response = requests.get(f'{BASE_URL}/v2/files/{translated_file_id}/content', headers=headers)

if response.status_code == 200:
    with open('translated_presentation.pptx', 'wb') as f:
        f.write(response.content)
    print("Translated file downloaded as translated_presentation.pptx")
else:
    raise Exception(f"Failed to download file: {response.text}")

ຂັ້ນຕອນທີ 3: ການກວດສອບສະຖານະການແປພາສາ
ເນື່ອງຈາກການແປພາສາສາມາດໃຊ້ເວລາ, ໂດຍສະເພາະສໍາລັບໄຟລ໌ຂະຫນາດໃຫຍ່, ຂະບວນການແມ່ນ asynchronous.
 ທ່ານຈໍາເປັນຕ້ອງກວດສອບສະຖານະຂອງວຽກເປັນໄລຍະໂດຍການສົ່ງຄໍາຮ້ອງຂໍ GET ໄປຫາ endpoint /v2/jobs/{job_id}, ໂດຍໃຊ້ job_id ທີ່ທ່ານໄດ້ຮັບກ່ອນໜ້ານີ້.
 ນີ້ອະນຸຍາດໃຫ້ແອັບພລິເຄຊັນຂອງທ່ານລໍຖ້າຢ່າງສະຫຼາດໂດຍບໍ່ມີການຖືກບລັອກ.
ຜົນຕອບຮັບຈະປະກອບດ້ວຍສະຖານະປັດຈຸບັນ, ເຊັ່ນ: processing ຫຼື completed.
 ພວກເຮົາແນະນຳໃຫ້ປະຕິບັດກົນໄກ polling ດ້ວຍຄວາມລ່າຊ້າທີ່ເໝາະສົມ (ເຊັ່ນ: 5-10 ວິນາທີ) ເພື່ອຫຼີກເວັ້ນການຮ້ອງຂໍຫຼາຍເກີນໄປ.
 ອີກທາງເລືອກ, ທ່ານສາມາດຕັ້ງຄ່າ webhooks ໃນ dashboard ຂອງທ່ານເພື່ອໃຫ້ເຊີບເວີຂອງພວກເຮົາແຈ້ງເຕືອນແອັບພລິເຄຊັນຂອງທ່ານໂດຍກົງເມື່ອວຽກສຳເລັດ.
ຂັ້ນຕອນທີ 4: ການດາວໂຫຼດ PPTX ພາສາອາຣັບ ທີ່ຖືກແປ
ເມື່ອສະຖານະວຽກປ່ຽນເປັນ completed, ຜົນຕອບຮັບ JSON ຈາກ endpoint ກວດສອບສະຖານະຈະປະກອບມີ translated_file_id.
 ນີ້ແມ່ນຕົວລະບຸສໍາລັບໄຟລ໌ PPTX ພາສາອາຣັບທີ່ສ້າງຂຶ້ນໃໝ່ຂອງທ່ານ.
 ໃຊ້ ID ນີ້ເພື່ອດາວໂຫຼດເອກະສານສຸດທ້າຍໄປຍັງລະບົບຂອງທ່ານ.
ເພື່ອດາວໂຫຼດໄຟລ໌, ໃຫ້ສົ່ງຄໍາຮ້ອງຂໍ GET ໄປຫາ endpoint /v2/files/{translated_file_id}/content.
 ຜົນຕອບຮັບຈະບໍ່ແມ່ນ JSON; ແທນທີ່ຈະ, ມັນຈະເປັນ raw file stream ຂອງ PPTX ທີ່ຖືກແປ.
 ທ່ານຄວນບັນທຶກເນື້ອໃນຜົນຕອບຮັບນີ້ໃສ່ໄຟລ໌ .pptx ໃໝ່ໃນເຄື່ອງຂອງທ່ານ.
ຂໍ້ພິຈາລະນາທີ່ສໍາຄັນສໍາລັບການແປພາສາອາຣັບ
ການແປ PPTX ເປັນພາສາອາຣັບ ໃຫ້ສໍາເລັດຮຽບຮ້ອຍຮຽກຮ້ອງໃຫ້ມີຫຼາຍກ່ວາພຽງແຕ່ API ທີ່ໃຊ້ງານໄດ້; ມັນຮຽກຮ້ອງໃຫ້ມີຄວາມສົນໃຈຕໍ່ລັກສະນະທາງດ້ານພາສາ ແລະ ການພິມທີ່ສະເພາະຂອງພາສານັ້ນ.
 ຂໍ້ພິຈາລະນາເຫຼົ່ານີ້ຮັບປະກັນວ່າຜົນຜະລິດສຸດທ້າຍບໍ່ພຽງແຕ່ຖືກຕ້ອງທາງດ້ານເຕັກນິກເທົ່ານັ້ນ ແຕ່ຍັງເໝາະສົມທາງດ້ານວັດທະນະທໍາ ແລະ ອ່ານງ່າຍສໍາລັບຜູ້ຊົມເປົ້າໝາຍ.
 ການລະເລີຍລາຍລະອຽດເຫຼົ່ານີ້ສາມາດທຳລາຍຄຸນນະພາບຂອງການແປພາສາໄດ້, ເຖິງແມ່ນວ່າຄໍາສັບຕ່າງໆຈະຖືກຕ້ອງກໍ່ຕາມ.
ລາຍລະອຽດຂອງຮູບແບບຂວາຫາຊ້າຍ (RTL)
ດັ່ງທີ່ໄດ້ກ່າວມາ, ການຈັດການຮູບແບບ RTL ແມ່ນສໍາຄັນທີ່ສຸດ.
 API ຂອງພວກເຮົາຖືກອອກແບບມາໂດຍສະເພາະເພື່ອ ສະທ້ອນຮູບແບບສະໄລ້ໂດຍອັດຕະໂນມັດ, ຈັດຕຳແໜ່ງອົງປະກອບສາຍຕາຄືນໃໝ່ເຊັ່ນ: ຮູບພາບ ແລະ ຕາຕະລາງ ໄປທາງຊ້າຍເພື່ອຮອງຮັບຂໍ້ຄວາມທີ່ຈັດວາງທາງຂວາ.
 ນີ້ຮັບປະກັນການເລົ່າເລື່ອງດ້ວຍສາຍຕາຂອງການນຳສະເໜີໄຫຼຢ່າງມີເຫດຜົນໃນພາສາອາຣັບ, ຄືກັນກັບທີ່ມັນຢູ່ໃນພາສາອັງກິດ.
ນັກພັດທະນາຄວນຈະຮູ້ເຖິງ edge cases ທີ່ອາດຈະເກີດຂຶ້ນ.
 ຕົວຢ່າງ, ໂລໂກ້ ຫຼື ແຜນວາດບາງຢ່າງອາດຈະບໍ່ເໝາະສົມສຳລັບການສະທ້ອນ.
 ໃນຂະນະທີ່ API ຂອງພວກເຮົາຈັດການກໍລະນີສ່ວນໃຫຍ່, ມັນເປັນການປະຕິບັດທີ່ດີສະເໝີທີ່ຈະປະຕິບັດການທົບທວນສາຍຕາຄັ້ງສຸດທ້າຍສໍາລັບການນໍາສະເໜີທີ່ສໍາຄັນຕໍ່ພາລະກິດເພື່ອຮັບປະກັນວ່າແນວທາງຍີ່ຫໍ້ຖືກປະຕິບັດຕາມ.
ການເລືອກຟອນ ແລະ ການສະແດງໃນພາສາອາຣັບ
ການເລືອກຟອນແມ່ນມີຄວາມສໍາຄັນຢ່າງບໍ່ໜ້າເຊື່ອສໍາລັບການອ່ານ ແລະ ຄວາມດຶງດູດທາງດ້ານຄວາມງາມໃນພາສາອາຣັບ.
 ຖ້າການນຳສະເໜີຕົ້ນສະບັບໃຊ້ຟອນທີ່ບໍ່ມີການຮອງຮັບຕົວອັກສອນອາຣັບ, ເອກະສານທີ່ຖືກແປອາດຈະສະແດງດ້ວຍຟອນເລີ່ມຕົ້ນຂອງລະບົບທີ່ຂັດແຍ້ງກັບການອອກແບບໂດຍລວມ.
 ຂະບວນການແປພາສາທີ່ມີຄຸນນະພາບສູງຄວນໃຊ້ web-safe ຫຼື ຟອນອາຣັບທີ່ລະບຸໄວ້ເພື່ອຮັກສາຮູບລັກສະນະທີ່ເປັນມືອາຊີບ.
Doctranslate API ຈັດການການທົດແທນຟອນຢ່າງສະຫຼາດເພື່ອຮັບປະກັນວ່າຂໍ້ຄວາມອາຣັບຖືກສະແດງຢ່າງຊັດເຈນ ແລະ ຖືກຕ້ອງ.
 ມັນເລືອກຟອນທີ່ເໝາະສົມທີ່ຮອງຮັບຕົວອັກສອນອາຣັບຄົບຊຸດ, ລວມທັງ ligatures ແລະ diacritics ທີ່ຈຳເປັນທັງໝົດ.
 ນີ້ປ້ອງກັນບັນຫາການສະແດງຜົນ ແລະ ຮັບປະກັນວ່າເອກະສານສຸດທ້າຍມີຄວາມສວຍງາມທາງສາຍຕາ ແລະ ອ່ານງ່າຍ.
ການຈັດການຕົວເລກ ແລະ ຕົວອັກສອນພິເສດ
ພາສາອາຣັບໃຊ້ລະບົບຕົວເລກຂອງຕົນເອງ (١, ٢, ٣) ໃນບາງບໍລິບົດ, ແຕ່ຕົວເລກຕາເວັນຕົກ (1, 2, 3) ກໍ່ຖືກໃຊ້ຢ່າງກວ້າງຂວາງເຊັ່ນກັນ, ໂດຍສະເພາະໃນເອກະສານດ້ານວິຊາການ ຫຼື ທຸລະກິດ.
 ການແປພາສາຕ້ອງມີຄວາມສອດຄ່ອງໃນການຈັດການຕົວເລກ.
 API ຂອງພວກເຮົາຖືກຕັ້ງຄ່າເພື່ອຮັກສາຕົວເລກຕາເວັນຕົກໂດຍຄ່າເລີ່ມຕົ້ນ, ເນື່ອງຈາກວ່ານີ້ແມ່ນທໍານຽມທົ່ວໄປທີ່ສຸດສໍາລັບການນໍາສະເໜີທາງທຸລະກິດ, ເຊິ່ງປ້ອງກັນຄວາມສັບສົນ.
ເຄື່ອງໝາຍວັກຕອນຍັງປະຕິບັດຕ່າງກັນໃນບໍລິບົດ RTL.
 ຕົວຢ່າງ, ເຄື່ອງໝາຍຄໍາຖາມ (?) ໃນພາສາອາຣັບຫັນໜ້າໄປໃນທິດທາງກົງກັນຂ້າມ (؟), ແລະ ຈຸດວັກກໍ່ຖືກປີ້ນກັບກັນເຊັ່ນກັນ.
 ລະບົບຂອງພວກເຮົາຈັດການການຈັດຕຳແໜ່ງຂອງຕົວອັກສອນພິເສດເຫຼົ່ານີ້ຢ່າງຖືກຕ້ອງ, ຮັບປະກັນວ່າປະໂຫຍກຖືກວັກຕອນຢ່າງຖືກຕ້ອງຕາມກົດໄວຍາກອນພາສາອາຣັບ.
ຄວາມຖືກຕ້ອງດ້ານວັດທະນະທໍາ ແລະ ບໍລິບົດ
ນອກເໜືອໄປຈາກລັກສະນະທາງດ້ານເຕັກນິກ, ການປັບຕົວທາງດ້ານວັດທະນະທໍາແມ່ນສໍາຄັນຕໍ່ການແປພາສາທີ່ປະສົບຜົນສໍາເລັດ.
 ພາສາສໍານວນ, ການປຽບທຽບ, ແລະ ການອ້າງອີງທາງດ້ານວັດທະນະທໍາຈາກພາສາອັງກິດມັກຈະບໍ່ແປໂດຍກົງເປັນພາສາອາຣັບ.
 ການແປແບບກົງໄປກົງມາ, ຕາມຕົວອັກສອນສາມາດຟັງເບິ່ງບໍ່ເປັນທຳມະຊາດ ຫຼື ເຖິງແມ່ນວ່າຈະຖືກເຂົ້າໃຈຜິດໂດຍຜູ້ຊົມເປົ້າໝາຍ.
ໃນຂະນະທີ່ API ຂອງພວກເຮົາໃຊ້ຮູບແບບການແປເຄື່ອງຈັກແບບພິເສດເພື່ອໃຫ້ຜົນຜະລິດທາງດ້ານພາສາທີ່ມີຄຸນນະພາບສູງ, ການທົບທວນຂອງມະນຸດແມ່ນມີຄ່າຢ່າງຍິ່ງສໍາລັບການນໍາສະເໜີທາງດ້ານການຕະຫຼາດ ແລະ ການຂາຍ.
 ເປົ້າໝາຍບໍ່ແມ່ນພຽງແຕ່ການແປພາສາເທົ່ານັ້ນ ແຕ່ແມ່ນການຈັດຕຳແໜ່ງ, ຊຶ່ງໝາຍເຖິງການປັບເນື້ອໃນໃຫ້ເຫມາະສົມກັບບໍລິບົດວັດທະນະທໍາຂອງໂລກທີ່ເວົ້າພາສາອາຣັບ.
 ການລວມເອົາປະສິດທິພາບຂອງ API ຂອງພວກເຮົາກັບການກວດສອບຄຸນນະພາບຂອງມະນຸດຄັ້ງສຸດທ້າຍຮັບປະກັນຜົນໄດ້ຮັບທີ່ດີທີ່ສຸດສໍາລັບເນື້ອໃນຂອງທ່ານ.
ສະຫຼຸບ: ປັບປຸງຂັ້ນຕອນການເຮັດວຽກການແປ PPTX ຂອງທ່ານ
ການເຊື່ອມໂຍງ API ເພື່ອແປ PPTX ຈາກພາສາອັງກິດ ເປັນ ພາສາອາຣັບ ແມ່ນເປັນວິທີທີ່ມີປະສິດທິພາບໃນການເຮັດໃຫ້ຄວາມພະຍາຍາມໃນການຈັດຕຳແໜ່ງຂອງທ່ານເປັນອັດຕະໂນມັດ ແລະ ຂະຫຍາຍຂະໜາດ.
 Doctranslate API ຖືກສ້າງຂຶ້ນໂດຍສະເພາະເພື່ອຈັດການກັບສິ່ງທ້າທາຍດ້ານເຕັກນິກທີ່ສໍາຄັນ, ຕັ້ງແຕ່ການຮັກສາຮູບແບບສະໄລ້ທີ່ສັບສົນໄປຈົນເຖິງການຈັດການການໄຫຼຂອງຂໍ້ຄວາມ RTL ແລະ ຄວາມເຂົ້າກັນໄດ້ຂອງຟອນ.
 ໂດຍການປະຕິບັດຕາມຄູ່ມືນີ້, ທ່ານສາມາດສ້າງ translation pipeline ທີ່ເຂັ້ມແຂງ, ມີປະສິດທິພາບ, ແລະ ເຊື່ອຖືໄດ້.
ສະຖາປັດຕະຍະກໍາ RESTful, ການປະມວນຜົນແບບ asynchronous, ແລະ ຜົນຕອບຮັບ JSON ທີ່ຊັດເຈນຂອງພວກເຮົາສະຫນອງປະສົບການຂອງນັກພັດທະນາທີ່ດີກວ່າ.
 ນີ້ອະນຸຍາດໃຫ້ທ່ານສຸມໃສ່ເຫດຜົນຫຼັກຂອງແອັບພລິເຄຊັນຂອງທ່ານ ແທນທີ່ຈະເປັນຄວາມສັບສົນຂອງການວິເຄາະໄຟລ໌ ແລະ ການສ້າງເອກະສານຄືນໃໝ່.
 ພວກເຮົາສ້າງຄວາມເຂັ້ມແຂງໃຫ້ທ່ານເພື່ອສົ່ງມອບການນຳສະເໜີທີ່ຖືກແປທີ່ມີຄຸນນະພາບສູງ, ຖືກຕ້ອງ ໂດຍມີຄວາມພະຍາຍາມໃນການພັດທະນາໜ້ອຍທີ່ສຸດ. ສໍາລັບຂໍ້ມູນລາຍລະອຽດເພີ່ມເຕີມກ່ຽວກັບພາລາມິເຕີ ແລະ endpoints ທີ່ມີຢູ່ທັງໝົດ, ກະລຸນາປຶກສາຫາລືກັບ ເອກະສານ Doctranslate API ຢ່າງເປັນທາງການ.