Teks dan terjemahan¶

MRBS memisahkan kosakata aplikasi, kata-kata khusus situs, halaman Bantuan, dan manual MkDocs ini. Pilih lapisan yang benar agar peningkatan tetap dapat dikelola.

Tugas	Lokasi yang benar
Ganti nama label untuk satu instalasi	`$vocab_override` di `config.inc.php`
Tambahkan atau tingkatkan bahasa UI MRBS	`web/lang/lang.<language>`
Terjemahkan atau sesuaikan halaman Bantuan dalam aplikasi	`web/site_faq/site_faq_<language>.html`
Terjemahkan manual ini	File dengan akhiran bahasa di bawah `docs/`

Ganti kata-kata untuk satu situs¶

Jangan mengedit file bahasa yang dikirimkan hanya untuk mengganti nama “Ruangan” atau mengubah judul situs. Temukan token di web/lang/lang.en, lalu ganti:

$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';

Urutan indeks selalu bahasa, lalu token: $vocab_override[LANG][TOKEN].

Token yang ditentukan situs yang berguna meliputi:

$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 bidang khusus dijelaskan di Bidang khusus. Deskripsi jenis pemesanan menggunakan type.X, dengan X adalah kode jenis yang dikonfigurasi.

Penggantian dapat bertahan dalam pemutakhiran karena berada dalam konfigurasi situs. Periksa kembali maknanya jika rilis mengubah token asli atau konteksnya.

Pertahankan penanda format¶

String bahasa dapat berisi penanda printf seperti %s, %d, atau bentuk posisi seperti %1$d. Pertahankan setiap penanda dan jenisnya. Terjemahan hanya boleh menyusun ulang argumen dengan bentuk posisional.

Pertahankan juga fragmen HTML yang disengaja, semantik tanda baca, dan spasi di sekitarnya. Uji string dengan jumlah nol, satu, dan banyak jika memungkinkan.

Pilih bahasa antarmuka¶

Secara default, MRBS memilih bahasa dari browser:

$disable_automatic_language_changing = false;

Untuk memaksa satu bahasa:

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

Token harus cocok dengan file web/lang/lang.* yang tersedia. Pemilihan lokal untuk tanggal dan waktu dapat diganti secara terpisah:

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

$override_locale juga harus didukung oleh sistem operasi server. $cli_language mengontrol perintah yang dijalankan di luar browser. Untuk diagnosis, $language_debug = true menulis informasi bahasa dan lokal ke log kesalahan; nonaktifkan lagi setelah pemecahan masalah.

Tambahkan atau pertahankan bahasa aplikasi¶

File bahasa Inggris adalah referensi dan cadangan. Untuk membuat bahasa yang tokennya terdeteksi adalah xx:

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

Kemudian:

Pertahankan baris pembuka PHP dan setiap kunci $vocab.
Terjemahkan nilai string, bukan nama token.
Simpan file sebagai UTF-8.
Jangan gunakan entitas HTML kecuali  ; menulis karakter UTF-8 secara langsung.
Pertahankan penanda substitusi dan penandaan yang disengaja.
Validasi sintaks PHP.

php -l web/lang/lang.xx

MRBS pertama-tama memuat referensi bahasa Inggris dan kemudian bahasa yang dipilih, sehingga token yang hilang akan dikembalikan ke bahasa Inggris.

Periksa kelengkapan¶

checklang.php membandingkan file bahasa dengan lang.en. Untuk contoh pengembangan, letakkan atau simpan di direktori web MRBS dan buka:

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

Tanpa pilihan bahasa, ia menawarkan semua file bahasa yang diinstal. Fungsi pembaruan opsional menulis file dan karenanya memerlukan akses tulis; hindari hal itu pada produksi dan tinjau perubahan yang dihasilkan. Batasi atau hapus utilitas pengembangan ini dari penerapan publik ketika pemeriksaan selesai.

Pemeriksaan sintaksis dan checklang.php menangkap masalah yang berbeda: gunakan keduanya.

Terjemahkan halaman Bantuan dalam aplikasi¶

Teks bantuan tidak berasal dari $vocab. Itu disimpan secara terpisah:

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 kompatibilitas tetapi tidak digunakan lagi. Pengaturannya tidak bergantung pada bahasa browser, jadi ujilah apakah FAQ yang dipilih cocok dengan audiens yang dituju. Pengeditan lokal pada file FAQ yang dikirimkan harus dicatat dan diterapkan kembali atau digabungkan selama peningkatan.

Terjemahkan manual ini¶

Situs web dokumentasi menggunakan file sufiks:

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 Inggris menjadi bahasa cadangan dokumentasi. File-file ini tidak memengaruhi antarmuka aplikasi MRBS maupun halaman Bantuan di dalam aplikasi.

Alur kerja yang aman untuk ditingkatkan¶

Masukkan kata-kata khusus situs di $vocab_override.
Simpan daftar file bahasa dan FAQ yang dikelola secara lokal.
Bandingkan lang.en baru dengan versi sebelumnya untuk token yang ditambahkan atau diubah.
Jalankan php -l pada setiap file bahasa yang diubah.
Jalankan checklang.php pada instance pengembangan terbatas.
Tinjau perubahan FAQ secara terpisah.
Uji semua bahasa aktif sebelum penerapan.

Daftar periksa verifikasi¶

Deteksi browser dan default paksa memilih bahasa yang diharapkan.
Token yang hilang dikembalikan ke bahasa Inggris yang dapat dimengerti.
Halaman navigasi, formulir, kesalahan, persetujuan, dan administrasi ditampilkan dengan benar.
%s, %d, dan penanda posisi menerima nilai yang tepat.
Tanggal, waktu, hari kerja, dan zona waktu menggunakan lokal yang dimaksud.
Subjek dan isi email, laporan, ekspor, dan pekerjaan baris perintah menggunakan bahasa yang dimaksudkan.
Bidang khusus, jenis pemesanan, placeholder, dan pesan validasi diterjemahkan.
Halaman Bantuan menggunakan file site_faq yang diharapkan.
Log tidak berisi proses debug bahasa yang persisten atau nilai formulir yang sensitif.