หน้า

ข้อความ

ทุกคำบนเว็บไซต์นี้ทำเครื่องหมายไว้ในโค้ดด้วย fbtee และแต่ละภาษามีไฟล์แค็ตตาล็อกที่เก็บคำแปล นี่คือสิ่งที่ต้องทำ พร้อมบรรทัดโค้ดที่ทำงานนั้น

ประโยคเดียว ทุกจำนวน

ประโยคเดียวกันสำหรับหกจำนวน ในภาษาของหน้านี้ คอลัมน์ที่สองคือรูปพหูพจน์ที่ภาษาจัดแต่ละจำนวนไว้ ตามชื่อที่ Intl.PluralRules เรียก

0otherคุณจองไว้ 0 คืน
1otherคุณจองไว้ 1 คืน
2otherคุณจองไว้ 2 คืน
3otherคุณจองไว้ 3 คืน
11otherคุณจองไว้ 11 คืน
100otherคุณจองไว้ 100 คืน

ทุกส่วนของ fbtee

แต่ละวิธีของ fbtee ในการเขียนประโยค ในภาษาของหน้านี้ พร้อมบรรทัดที่ทำหน้าที่นั้น ภาษาอาหรับเปลี่ยนคำตามบุคคลที่กล่าวถึง ส่วนภาษาไทยและภาษาอังกฤษส่วนใหญ่ไม่เปลี่ยน

รายการในประโยค

เมนูมี หน้าแรก กิจกรรม และเอกสาร

<fbt:list conjunction="or" items={items} name="pages" />

ตัวเลือกจากชุดที่กำหนด

Laila เข้าร่วมด้วยตัวเอง

<fbt:enum enum-range={{ there: "in person", online: "online" }} value={way} />

ชื่อและเพศ

Laila จองที่นั่งแล้ว

<fbt:name name="name" gender={gender}>{name}</fbt:name>

จำนวน

Laila จองที่นั่งแล้ว 3 ที่

<fbt:plural count={count} many="seats" showCount="ifMany">a seat</fbt:plural>

สรรพนาม

Laila ตรวจตั๋วของเธอแล้ว

<fbt:pronoun type="possessive" gender={gender} human={true} />

ค่าเดียวกันสองครั้ง

Laila จองแล้ว และ Laila ได้รับตั๋วทางอีเมล

<fbt:same-param name="name" />

สำหรับผู้อ่าน ตามเพศของผู้อ่าน

คุณจองแล้ว

<fbt desc="…" subject={gender}>You're booked.</fbt>

ส่วนหนึ่งของหน้าในอีกภาษา

You're booked.

أنتِ مسجَّلة.

<InLanguage locale={other.locale} gender={gender}>…</InLanguage>

ใช้ในหน้านี้ และอธิบายไว้ในหน้าคอมโพเนนต์: InLanguage และFormatted

สิ่งที่ต้องทำ

ทำเครื่องหมายในโค้ด

ข้อความในคอมโพเนนต์เขียนไว้ในอิลิเมนต์ fbt พร้อมคำอธิบายที่บอกผู้แปลว่าเกิดอะไรขึ้น ตัวยึดตำแหน่งแต่ละตัวเก็บค่าอะไร และข้อความแสดงที่ใด ซึ่งเป็นบริบททั้งหมดที่ผู้แปลได้รับ ขณะที่คุณบันทึก vp dev จะรวบรวมทุกข้อความลงในแค็ตตาล็อกของแต่ละภาษา i18n/translations ซึ่งเป็นไฟล์ในที่เก็บโค้ดของแอป

src/home/HomeSections.tsx
<fbt desc="Home feature title: translated strings">Strings, by fbtee</fbt>

ข้อความธรรมดา

ที่ไหนต้องใช้ข้อความธรรมดา เช่น ในแอตทริบิวต์ ชื่อหน้า หรืออีเมล fbs จะให้ข้อความนั้น แปลแบบเดียวกัน

src/events/EventsCrumbs.tsx
aria-label={fbs("Where you are", "Label of the row showing where you are on the site")}

รูปพหูพจน์ ตามแต่ละภาษา

ประโยคที่มีจำนวนจะมีคำแปลหนึ่งแบบต่อรูปพหูพจน์แต่ละรูปที่ภาษานั้นมี: ภาษาไทยมีหนึ่งรูป ภาษาอังกฤษมีสองรูป ภาษาอาหรับมีหกรูป vp dev เพิ่มบรรทัดที่แต่ละภาษาต้องใช้ และจำนวนของผู้อ่านจะเลือกบรรทัดที่ถูกต้อง ดังในตารางด้านบน

pages/[lang]/index.tsx
<fbt:plural count={count} many="nights" showCount="yes">

คำที่ใช้ร่วมกัน ครั้งเดียว

คำที่ใช้ในหลายหน้า เช่นคำในเมนู ให้ไว้ครั้งเดียวกับ voidFbtee ใน vite.config.ts พร้อมคำอธิบาย และแปลครั้งเดียว

vite.config.ts
common,
src/shell/SiteHeader.tsx
return <fbt common>Events</fbt>;

ไม่มีอะไรตกหล่น

vp build จะล้มเหลวหากมีข้อความใดยังไม่ได้แปลในภาษาใดก็ตาม และกฎ lint ของ fbtee (vp check) จะแจ้งข้อความที่เขียนในคอมโพเนนต์โดยไม่มี fbt

.github/workflows/ci.yml
- run: vp run -r build

รายละเอียดทั้งหมดอยู่ในสกิลของ void-fbtee