Teks dan terjemahan¶

MRBS memisahkan perbendaharaan kata aplikasi, perkataan khusus tapak, halaman Bantuan dan manual MkDocs ini. Pilih lapisan yang betul supaya peningkatan kekal terurus.

Tugasan	Lokasi yang betul
Namakan semula label untuk satu pemasangan	`$vocab_override` dalam `config.inc.php`
Tambah atau tingkatkan bahasa UI MRBS	`web/lang/lang.<language>`
Terjemah atau sesuaikan halaman Bantuan dalam aplikasi	`web/site_faq/site_faq_<language>.html`
Terjemah manual ini	Fail akhiran bahasa di bawah `docs/`

Gantikan perkataan untuk satu tapak¶

Jangan edit fail bahasa yang dihantar semata-mata untuk menamakan semula "Bilik" atau menukar tajuk tapak. Cari token dalam web/lang/lang.en, kemudian gantikannya:

$vocab_override['en']['mrbs'] = 'Resource Booking';
$vocab_override['de']['mrbs'] = 'Ressourcenbuchung';
$vocab_override['fr']['mrbs'] = 'Réservation de ressources';
$vocab_override['es']['mrbs'] = 'Reserva de recursos';

Susunan indeks sentiasa bahasa, kemudian token: $vocab_override[LANG][TOKEN].

Token yang ditakrifkan tapak berguna termasuk:

$vocab_override['en']['room.coffee_machine'] = 'Coffee machine';
$vocab_override['en']['entry.catering'] = 'Catering';
$vocab_override['en']['entry.description.placeholder'] =
    'Add information for the room team';
$vocab_override['en']['users.zip_code.oninvalid'] =
    'Enter a valid ZIP code';
$vocab_override['en']['type.C'] = 'Customer booking';

Token medan tersuai diterangkan dalam Medan tersuai. Penerangan jenis tempahan menggunakan type.X, dengan X ialah kod jenis yang ditetapkan.

Gantikan bertahan dalam peningkatan kerana ia hidup dalam konfigurasi tapak. Semak semula maknanya jika keluaran mengubah token asal atau konteksnya.

Kekalkan penanda penggantian¶

Rentetan bahasa boleh mengandungi printf penanda seperti %s, %d atau bentuk kedudukan seperti %1$d. Kekalkan setiap penanda dan jenisnya. Terjemahan boleh menyusun semula hujah hanya dengan bentuk kedudukan.

Juga simpan serpihan HTML yang disengajakan, semantik tanda baca dan ruang sekeliling. Uji rentetan dengan kiraan sifar, satu dan banyak jika berkenaan.

Pilih bahasa antara muka¶

Secara lalai, MRBS memilih bahasa daripada penyemak imbas:

$disable_automatic_language_changing = false;

Untuk memaksa satu bahasa:

$disable_automatic_language_changing = true;
$default_language_tokens = 'de';

Token mesti sepadan dengan fail web/lang/lang.* yang tersedia. Pemilihan tempat untuk tarikh dan masa boleh ditindih secara berasingan:

$override_locale = 'de-DE';
$cli_language = 'de';

$override_locale juga mesti disokong oleh sistem pengendalian pelayan. $cli_language mengawal arahan yang dijalankan di luar pelayar. Untuk diagnosis, $language_debug = true menulis maklumat bahasa dan tempat ke log ralat; nyahdayakannya semula selepas menyelesaikan masalah.

Tambah atau kekalkan bahasa aplikasi¶

Fail bahasa Inggeris adalah rujukan dan sandaran. Untuk mencipta bahasa yang tokennya dikesan ialah xx:

cp web/lang/lang.en web/lang/lang.xx

Kemudian:

Simpan PHP baris pembukaan dan setiap kekunci $vocab.
Terjemahkan nilai rentetan, bukan nama token.
Simpan fail sebagai UTF-8.
Jangan gunakan entiti HTML kecuali  ; tulis aksara UTF-8 secara langsung.
Kekalkan penanda penggantian dan penanda yang disengajakan.
Sahkan sintaks PHP.

php -l web/lang/lang.xx

MRBS mula-mula memuatkan rujukan bahasa Inggeris dan kemudian bahasa yang dipilih, jadi token yang hilang akan kembali kepada bahasa Inggeris.

Semak kesempurnaan¶

checklang.php membandingkan fail bahasa dengan lang.en. Untuk contoh pembangunan, letakkan atau simpannya dalam direktori web MRBS dan buka:

https://example.invalid/mrbs/checklang.php?lang[]=xx

Tanpa pemilihan bahasa ia menawarkan semua fail bahasa yang dipasang. Fungsi kemas kini pilihan menulis fail dan oleh itu memerlukan akses tulis; elakkan itu pada pengeluaran dan semak semula perubahan yang dihasilkan. Hadkan atau alih keluar utiliti pembangunan ini daripada penggunaan awam apabila semakan selesai.

Semakan sintaks dan checklang.php menangkap masalah yang berbeza: gunakan kedua-duanya.

Terjemah halaman Bantuan dalam aplikasi¶

Teks bantuan tidak datang dari $vocab. Ia disimpan secara berasingan:

web/site_faq/site_faq.html
web/site_faq/site_faq_de.html
web/site_faq/site_faq_fr.html
web/site_faq/site_faq_es.html

Pilih akhiran tanpa garis bawah:

$faqfilelang = 'de';

Nilai lama seperti '_de' diterima untuk keserasian tetapi tidak digunakan lagi. Tetapan adalah bebas daripada bahasa penyemak imbas, jadi uji bahawa FAQ yang dipilih sepadan dengan khalayak yang dimaksudkan. Suntingan setempat pada fail Soalan Lazim yang dihantar mesti direkodkan dan digunakan semula atau digabungkan semasa naik taraf.

Terjemah manual ini¶

Tapak web dokumentasi menggunakan fail akhiran:

docs/admin-guide/custom-fields.md
docs/admin-guide/custom-fields.de.md
docs/admin-guide/custom-fields.fr.md
docs/admin-guide/custom-fields.es.md

Bahasa Inggeris adalah sandaran dokumentasi. Fail ini tidak menjejaskan UI aplikasi MRBS atau halaman Bantuannya.

Aliran kerja selamat naik taraf¶

Letakkan perkataan tapak sahaja dalam $vocab_override.
Simpan senarai bahasa yang diselenggara secara tempatan dan fail FAQ.
Bandingkan lang.en baharu dengan versi sebelumnya untuk token yang ditambah atau ditukar.
Jalankan php -l pada setiap fail bahasa yang ditukar.
Jalankan checklang.php pada contoh pembangunan terhad.
Semak perubahan FAQ secara berasingan.
Uji semua bahasa aktif sebelum penggunaan.

Senarai semak pengesahan¶

Pengesanan penyemak imbas dan lalai terpaksa memilih bahasa yang diharapkan.
Token yang hilang kembali kepada bahasa Inggeris yang boleh difahami.
Halaman navigasi, borang, ralat, kelulusan dan pentadbiran dipaparkan dengan betul.
%s, %d, dan penanda kedudukan menerima nilai yang betul.
Tarikh, masa, hari bekerja dan zon waktu menggunakan tempat yang dimaksudkan.
Subjek dan badan e-mel, laporan, eksport dan kerja baris arahan menggunakan bahasa yang dimaksudkan.
Medan tersuai, jenis tempahan, ruang letak dan mesej pengesahan diterjemahkan.
Halaman Bantuan menggunakan fail site_faq yang dijangkakan.
Log tidak mengandungi penyahpepijatan bahasa yang berterusan atau nilai bentuk sensitif.