รูปแบบข้อความการแปล

{   "name": {     "message": "Message text, with optional placeholders.",     "description": "Translator-aimed description of the message.",     "placeholders": {       "placeholder_name": {         "content": "A string to be placed within the message.",         "example": "Translator-aimed example of the placeholder string."       },       ...     }   },   ... } 

{   "prompt_for_name": {     "message": "What's your name?",     "description": "Ask for the user's name"   },   "hello": {     "message": "Hello, $USER$",     "description": "Greet the user",     "placeholders": {       "user": {         "content": "$1",         "example": "Cira"       }     }   },   "bye": {     "message": "Goodbye, $USER$. Come back to $OUR_SITE$ soon!",     "description": "Say goodbye to the user",     "placeholders": {       "our_site": {         "content": "Example.com",       },       "user": {         "content": "$1",         "example": "Cira"       }     }   } } 

"prompt_for_name": {   ... }, "hello": {   ... }, "bye": {   ... } 

"message": "What's your name?" ... "message": "Hello, $USER$" ... "message": "Goodbye, $USER$. Come back to $OUR_SITE$ soon!" 

"message": "Amount (in $$)"  
แม้ว่าตัวยึดตําแหน่ง เช่น $USER$ เป็นวิธีที่แนะนำในการอ้างอิงสตริงการแทนที่ (สตริงที่ระบุโดยใช้พารามิเตอร์ substitutions ของ i18n.getMessage) แต่คุณยังอ้างอิงสตริงการแทนที่ภายในข้อความได้โดยตรง ตัวอย่างเช่น ข้อความต่อไปนี้หมายถึงสตริงการแทนที่ 3 รายการแรกซึ่งส่งไปยัง getMessage()
  
messages.json:
 
"message": "Params: $1, $2, $3"  
อย่างไรก็ตาม เราขอแนะนำให้คุณใช้ตัวยึดตําแหน่งแทนสตริง $_n_ ในข้อความ ให้คิดว่าตัวยึดตำแหน่งเป็นชื่อตัวแปรที่ดี หลังจากเขียนโค้ดได้ 1 สัปดาห์ คุณอาจลืมความหมายของ $1 แต่คุณจะรู้ว่าตัวยึดตําแหน่งหมายถึงอะไร ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวยึดตําแหน่งและสตริงการแทนที่ได้ที่ส่วนตัวยึดตําแหน่ง
  
คำอธิบาย
  
ไม่บังคับ คำอธิบายข้อความโดยมีจุดประสงค์เพื่อให้บริบทหรือรายละเอียดเพื่อช่วยนักแปล ทำการแปลที่ดีที่สุดเท่าที่จะเป็นไปได้
  
ต่อไปนี้เป็นตัวอย่างคำอธิบาย 3 รายการที่นำมาจากส่วนตัวอย่าง
  
messages.json:
 
"description": "Ask for the user's name" ... "description": "Greet the user" ... "description": "Say goodbye to the user"  
ตัวยึดตำแหน่ง
  
ไม่บังคับ กําหนดสตริงย่อยอย่างน้อย 1 รายการที่จะใช้ในข้อความ นี่เป็นเหตุผล 2 ประการที่คุณ อาจต้องการใช้ตัวยึดตำแหน่งดังนี้
  

• เพื่อกำหนดข้อความสำหรับส่วนของข้อความที่ไม่ควรได้รับการแปล เช่น โค้ด HTML ชื่อที่จดทะเบียนเครื่องหมายการค้า ตัวระบุการจัดรูปแบบ
• หากต้องการอ้างอิงสตริงการแทนที่ที่ส่งผ่านไปยัง getMessage() ตัวอย่าง: $1

ตัวยึดตําแหน่งแต่ละรายการมีชื่อ รายการ "เนื้อหา" และรายการ "ตัวอย่าง" (ไม่บังคับ) ชื่อตัวยึดตําแหน่งจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ รวมถึงมีอักขระเดียวกับชื่อข้อความได้

"เนื้อหา" ค่าของรายการคือสตริงที่สามารถอ้างถึงสตริงการแทนที่ ซึ่งระบุ โดยใช้พารามิเตอร์การแทนที่เมธอด i18n.getMessage ค่าของรายการ "content" มักจะเป็น "Example.com" หรือ "$1" หากคุณอ้างอิงสตริงการแทนที่ที่ไม่มีอยู่ คุณจะได้รับสตริงว่าง ตารางต่อไปนี้แสดงความสอดคล้องของสตริง $_n_ กับสตริง ที่ระบุโดยพารามิเตอร์ substitutions

รายการ "ตัวอย่าง" (ไม่บังคับ แต่แนะนำอย่างยิ่ง) จะช่วยนักแปลโดยแสดงลักษณะที่เนื้อหาปรากฏต่อผู้ใช้ ตัวอย่างเช่น ตัวยึดตำแหน่งสำหรับจำนวนเงินดอลลาร์ควรมีตัวอย่างดังนี้ "$23.45"

ข้อมูลโค้ดต่อไปนี้ซึ่งนำมาจากส่วนตัวอย่างแสดง "ตัวยึดตำแหน่ง" รายการที่ มีตัวยึดตำแหน่ง 2 รายการชื่อ "our_site" และ "ผู้ใช้" ตัวยึดตําแหน่ง "our_site" ไม่มีรายการ "example" เนื่องจากค่าของรายการนั้นเห็นได้ชัดจากช่อง "content"

messages.json:

"placeholders": {   "our_site": {     "content": "Example.com",   },   "user": {     "content": "$1",     "example": "Cira"   } }