Bạn có thể sử dụng tham số trong bảng địa phương hóa khi chỉ một phần của chuỗi hiển thị cần dịch, chẳng hạn như địa phương hóa một đơn vị đo lường sau một giá trị số, tham chiếu một tên người dùng, hoặc hiển thị thời gian và ngày tháng.
Các tham số bao gồm một giá trị tham số và một chỉ thị định dạng tùy chọn được đặt trong dấu ngoặc nhọn.
Trong ví dụ sau, một trò chơi có các mục sau trong bảng địa phương hóa của nó:
| Source | es |
|---|---|
| Hello {Player_Name}! | Hola {Player_Name}! |
| My name is {NPC_Name} | Me llamo {NPC_Name} |
Nếu một người dùng có ngôn ngữ cài đặt là es, đầu ra dịch sẽ như sau:
| Original in-game text | Spanish translation |
|---|---|
| Hello new_storm! | Hola new_storm! |
| My name is Diva Dragonslayer | Me llamo Diva Dragonslayer |
Trong một số trường hợp, bạn có thể muốn sử dụng các chỉ thị định dạng để kiểm soát cách giá trị tham số được định dạng trong chuỗi được địa phương hóa.
Các chỉ thị định dạng có sẵn bao gồm:
| Specifier | Type | Description | Example output |
|---|---|---|---|
| int | number | Số nguyên có dấu âm tùy chọn; không có dấu phân cách nghìn. | 1234 |
| fixed | number | Hai chữ số thập phân với dấu phân cách thập phân, dấu âm tùy chọn, và không có dấu phân cách nghìn. | 1234.50 1234,50 |
| num | number | Hai chữ số thập phân với dấu phân cách thập phân, dấu âm tùy chọn, và dấu phân cách nghìn. | 1,234.50 1234,50 |
| HEX | number | Số nguyên được chuyển đổi sang hệ hex; số âm được chuyển đổi sang bù 2 64-bit. | 3FF |
| hex | number | Tương tự như HEX, nhưng là chữ thường. | 3ff |
| datetime | number | Thời gian UTC dưới dạng số đến định dạng người dùng có thể đọc chung. | 2017-10-10 13:38:10 |
| iso8601 | number | Thời gian UTC dưới dạng số đến định dạng thời gian UTC ISO-8601. | 2017-10-12T22:02:38Z |
| shorttime | number | Thời gian UTC đến định dạng "giờ:phút" địa phương. | 1:45 PM 13:45 |
| shortdatetime | number | Thời gian UTC đến mẫu ngày+thời gian chung với thời gian ngắn. | 10/10/2017 1:45 PM |
| shortdate | number | Thời gian UTC đến mẫu ngày ngắn. | 10/10/2017 2017-10-10 |
| translate | string | Tìm kiếm một chuỗi Source khớp chính xác trong bảng địa phương hóa và sử dụng bản dịch có sẵn cho ngôn ngữ đó. |
Dịch các chuỗi con
Sử dụng chỉ thị translate khi cần một bản dịch trực tiếp từ bảng địa phương hóa của bạn. Quá trình địa phương hóa sẽ tìm kiếm một khớp chính xác của tham số trong cột Source của bảng địa phương hóa của bạn.
Trong ví dụ sau, một trò chơi có các hàng sau trong bảng địa phương hóa của nó:
| Source | es |
|---|---|
| I am from {Place_Name:translate}. | Soy de {Place_Name:translate}. |
| Brazil | Brasil |
| London | Londres |
| Germany | Alemania |
Nếu một người dùng có ngôn ngữ cài đặt là 'es', đầu ra dịch sẽ hiển thị như sau:
| Original in-game text | Spanish translation |
|---|---|
| I am from Brazil. | Soy de Brasil. |
| I am from London. | Soy de Londres. |
| I am from Germany. | Soy de Alemania. |
Dịch với các số
Bạn có thể sử dụng một chỉ thị để định dạng các giá trị số của bạn cho phù hợp với ngữ cảnh trong trò chơi của bạn.
Trong ví dụ sau, một trò chơi có các mục liên quan đến số sau trong bảng địa phương hóa của nó:
| Source | es |
|---|---|
| {race_time:fixed} seconds | {race_time:fixed} segundos |
| ${1:num} cash and {2:int} jewels | ${1:num} dinero y {2:int} joyas |
Nếu một người dùng có ngôn ngữ cài đặt là es, đầu ra dịch sẽ hiển thị như sau:
| Original in-game text | Spanish translation |
|---|---|
| 75.202844 seconds | 75,20 segundos |
| $2500.5 cash and 99.8 jewels | $2.500,50 dinero y 100 joyas |
Khi sử dụng nhiều tham số trên một mục, bạn phải sử dụng hoặc tất cả là chuỗi hoặc tất cả là số cho các chỉ thị tham số.