แปลข้อความที่สมบูรณ์
ด้วย t-string ของ Python¶

import gettext

from gettext_tstrings import Translator

_ = Translator(gettext.translation("messages", localedir="locales"))
name = "Ada"
print(_(t"Hello {name}"))  # with a Japanese catalog: こんにちは Ada

นี่เหมาะกับคุณหรือไม่¶

เหมาะแล้วในวันนี้ ถ้า แอปพลิเคชันของคุณรันบน Python 3.14 ขึ้นไป คุณใช้ gettext และ Babel อยู่แล้วหรืออยากรับเวิร์กโฟลว์ PO/MO ของมันมาใช้ และคุณต้องการไวยากรณ์ t-string ที่มีตัวยึดตำแหน่งแบบมีชื่อซึ่งถูกตรวจสอบก่อนเรนเดอร์

ยังไม่เหมาะ ถ้า คุณต้องใช้ Python 3.13 หรือเก่ากว่า คุณต้องการ Python API ที่เสถียร — นี่ยังเป็นรุ่นอัลฟา และข้อกำหนดคือส่วนของมันที่นิ่งแล้ว — หรือข้อความที่ต้องแปลของคุณเกือบทั้งหมดอยู่ในภาษาเทมเพลตมากกว่าในซอร์ส Python

มีแคตตาล็อกอยู่แล้วใช่ไหม มันยังใช้งานได้ต่อไป _("Hello {name}").format(name=name) กับ tr(t"Hello {name}") ผลิต msgid เดียวกัน คำแปลที่มีอยู่จึงรอดผ่านการเปลี่ยนมาได้ — การย้ายระบบ พาเดินตลอดการย้าย

แคตตาล็อกพูดอะไรได้บ้าง¶

คำแปลเปลี่ยนโครงสร้างของประโยคที่มันแปลไม่ได้ นั่นคือทั้งหมดของคำสัญญา และทุกอย่างที่เหลือในเว็บไซต์นี้ล้วนสืบเนื่องมาจากมัน คำแปลอาจสลับลำดับหรือใช้ {name} ซ้ำได้ และเขียนคำอื่น ๆ รอบมันใหม่ทั้งหมดก็ได้ แต่จะตัดตัวยึดตำแหน่งทิ้ง เสกอันใหม่ขึ้นมา เอื้อมผ่านมันเข้าไปในอ็อบเจกต์ของคุณ หรือแนบการจัดรูปแบบของตัวเองไม่ได้

ไลบรารีตรวจสอบสิ่งนั้นตั้งแต่ขาเข้า — ตอนคอมไพล์แคตตาล็อก — และตรวจอีกครั้งตอนเรนเดอร์ ซึ่งนั่นคือความต่างระหว่างข้อผิดพลาด ที่ถูกพบตอนรีวิว กับข้อผิดพลาดที่ถูกพบโดยผู้ใช้

ปัญหาที่มันแก้¶

f-string ถูกแทนค่าเสร็จเรียบร้อยก่อนที่ไลบรารีใดจะทันได้เห็นมัน — f"Hello {name}" กลายเป็น "Hello Ada" ไปแล้ว และการแปลเศษข้อความรอบ ๆ ค่าหนึ่ง ๆ จะทำลายไวยากรณ์ของภาษาส่วนใหญ่ ส่วน t-string (PEP 750) เก็บข้อความคงที่ ค่าที่ประเมินแล้ว นิพจน์ต้นทาง การแปลงค่า และตัวระบุรูปแบบแยกจากกัน — ซึ่งเป็นการแยกส่วนแบบที่แคตตาล็อกข้อความต้องการพอดี สิ่งที่เปลี่ยนไปจากเดิม เมื่อเทียบกับ %(name)s, .format() และ $-strings

อย่างไรก็ตาม ไม่มีส่วนใดใน gettext หรือ Babel ที่กำหนดว่า t-string จะกลายเป็นข้อความได้อย่างไร ไลบรารีนี้เป็นผู้ตัดสินใจเลือกแนวทางนั้น เขียนมันไว้เป็นข้อกำหนดที่มีการกำกับเวอร์ชัน และมาพร้อมชุดทดสอบความสอดคล้องสำหรับตรวจสอบ

กฎการออกแบบ¶

• แปลข้อความทั้งประโยคเสมอ ไม่แปลเศษเสี้ยวของประโยค
• รับเฉพาะชื่อตัวแปรอย่างง่ายเช่น {name}
• เก็บ !r และ :.2f ไว้ใต้การควบคุมของแอปพลิเคชัน นอกแคตตาล็อก
• ให้นักแปลสลับลำดับและใช้ตัวยึดตำแหน่งที่รู้จักซ้ำได้ — แต่เรียกแอตทริบิวต์ไม่ได้ และเพิ่มพฤติกรรมการจัดรูปแบบเองไม่ได้
• ใช้ไฟล์ POT, PO และ MO แบบธรรมดา รวมถึงเครื่องมือที่อ่านไฟล์เหล่านี้ได้อยู่แล้ว

และนี่คือรายการคู่กันของสิ่งที่มันจงใจไม่ไปยุ่งด้วย: มันไม่แปลงตัวเลข สกุลเงิน หรือวันที่ให้เข้ากับท้องถิ่น — จงจัดรูปแบบสิ่งเหล่านั้นก่อน ด้วย Babel; มันไม่ escape ผลลัพธ์ที่เรนเดอร์แล้วสำหรับ HTML เชลล์ หรือเทอร์มินัล และมันตัดสินไม่ได้ว่าคำแปล ถูกต้อง หรือไม่ ตัดสินได้เพียงว่าตัวยึดตำแหน่งของมันยังครบถ้วน

การติดตั้ง¶

python -m pip install gettext-tstrings

ต้องใช้ Python 3.14 ขึ้นไป การเรนเดอร์ไม่มี dependency ใด ๆ — ใช้เพียง gettext จากไลบรารีมาตรฐานเท่านั้น ไม่มีอย่างอื่นอีก

การสกัดข้อความและการตรวจสอบแคตตาล็อกทำงานผ่าน Babel จึงควรติดตั้ง extra นี้ในที่ที่ pybabel ทำงาน ซึ่งมักเป็นสภาพแวดล้อมการพัฒนาหรือ CI มากกว่าอิมเมจสำหรับการใช้งานจริง:

python -m pip install "gettext-tstrings[babel]"

ขั้นตอนถัดไป¶

เริ่มต้นที่นี่ — ไม่ต้องมีประสบการณ์ gettext มาก่อน:

การใช้งาน — เอกสารอ้างอิงสำหรับการทำงาน:

ทำความเข้าใจ — จากประวัติศาสตร์ไปจนถึงการทำงานภายใน:

เอกสารอ้างอิง — ตัวสัญญา:

สถานะ¶

ยังเป็นรุ่นอัลฟา สัญญาถูกออกแบบให้เล็กโดยตั้งใจ และข้อกำหนดคือส่วนที่เสถียรของมัน ส่วน Python API อาจยังเปลี่ยนแปลงได้ ก่อนออกรุ่นเสถียร โปรเจกต์นี้ยังต้องการ fixture ภาษาที่หลากหลายขึ้น การติดตามประสิทธิภาพอย่างต่อเนื่อง การรีวิว API จากผู้ที่ใช้ gettext และ Babel อย่างจริงจัง และการทดสอบความเข้ากันได้กับ Python และ Babel ทุกรุ่นที่รองรับ

Issue และ pull request ยินดีต้อนรับเสมอ — ช่วงอัลฟาคือช่วงเวลาที่อินเทอร์เฟซยังคุ้มค่าแก่การถกเถียงที่สุด

เข้าร่วมชุมชน¶

• เลือก good first issue สำหรับการมีส่วนร่วมที่มีขอบเขตชัดเจน
• ถามคำถามเรื่องการใช้งานได้ใน Q&A Discussions
• นำเวิร์กโฟลว์ gettext จากงานจริงและไอเดียเกี่ยวกับ API มาแลกเปลี่ยนใน Ideas Discussions
• อ่าน คู่มือการมีส่วนร่วม ก่อนเปิด pull request