>Voxel at 20:09, 8 April 2021

2021-04-08T20:09:58Z

← Older revision	Revision as of 13:09, 8 April 2021
(No difference)

>Voxel at 20:09, 8 April 2021

2021-04-08T20:09:58Z

← Older revision

Revision as of 13:09, 8 April 2021

>Voxel at 20:09, 8 April 2021

2021-04-08T20:09:58Z

← Older revision	Revision as of 13:09, 8 April 2021
(No difference)

>Voxel at 20:09, 8 April 2021

2021-04-08T20:09:58Z

New page

{{Languages}}
{{Mod Data/ms
| name=Internationalization Lib for Minetest
| luaname=intllib
| type= [[:Category:Misc mods|Pelbagai]]
| author=Diego Martínez (kaeza)
| version=
| forum=[https://forum.minetest.net/viewtopic.php?id=4929 4929]
| source=[https://github.com/minetest-mods/intllib GitHub]
}}
__NOTOC__
'''Pustaka Pengantarabangsaan untuk Minetest''' ([[Help:Original names/ms|BI]]: '''''Internationalization Lib for Minetest''''') atau juga dikenali sebagai '''Internationalization Library''' ialah sebuah [[Mods/ms|mods]] yang dicipta oleh Diego Martínez (kaeza) dan diterbitkan di bawah [http://unlicense.org Unlicense] (bahasa Inggeris). Mods ini ialah suatu usaha untuk menyediakan sokongan pengantarabangsaan kepada mods. Sebarang komen atau cadangan dialu-alukan dekat [https://forum.minetest.net/viewtopic.php?id=4929 topik forum] dalam bahasa Inggeris. Pepijat boleh dilaporkan menggunakan [https://github.com/minetest-mods/intllib/issues penjejak pepijat] Github.

== Menggunakan pustaka sebagai pemain biasa ==

Jika anda pemain biasa yang mencari teks terjemahan, hanya pasangkan mods ini seperti mods lain, kemudian bolehkannya melalui GUI.

Mods ini cuba untuk mengesan bahasa anda, tetapi oleh kerana tiada cara mudah alih untuk melakukannya, ia cuba beberapa cara yang lain:
* Tetapan <code>language</code> di dalam fail [[minetest.conf/ms|minetest.conf]].
* Pembolehubah sekitaran <code>LANGUAGE</code>.
* Pembolehubah sekitaran <code>LANG</code>.
* Jika semua di atas gagal, ia gunakan <code>en</code>.

Dalam apa jua keadaan, hasil akhirnya sepatutnya menjadi [https://ms.wikipedia.org/wiki/Senarai_kod_ISO_639-1 Kod Bahasa ISO 639-1] untuk bahasa yang dikehendaki.

== Menggunakan pustaka sebagai penterjemah ==

Jika anda seorang penterjemah, anda perlu menentukan jenis antaramuka mods yang menyokong intllib tersebut, dan ikut langkah untuk antaramuka yang berkenaan.

Untuk menentukan antaramuka yang manakah mods tersebut gunakan, carilah subdirektori <code>locale</code> mods tersebut. Jika anda jumpa fail berbentuk fail teks kosong dalam format <code>.txt</code>, maka ianya menggunakan antaramuka yang lama. Kalau tidak, kemungkinan besar ianya menggunakan antaramuka baru, terutamanya jika failnya berupa fail gettext dalam format <code>.po</code>.

=== Antaramuka baru ===

Antaramuka baru menggunakan fail <code>.po</code> dari [https://www.gnu.org/software/gettext gettext] (bahasa Inggeris). Lihat [https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html Format Fail PO] (bahasa Inggeris) untuk maklumat lanjut.

Oleh itu, jika anda menterjemah mods yang menggunakan antaramuka baru ke dalam bahasa anda, gunakan alatan kegemaran anda untuk menyunting fail <code>.po</code> tersebut. Fail tersebut juga boleh disunting dengan penyunting teks kosong.

=== Antaramuka lama ===

Untuk menterjemah mods ke dalam bahasa anda, salin fail <code>locale/template.txt</code> kepada <code>locale/BAHASA.txt</code> (di mana <code>BAHASA</code> ialah [https://ms.wikipedia.org/wiki/Senarai_kod_ISO_639-1 Kod Bahasa ISO 639-1] untuk bahasa anda).

Buka fail baru tersebut dalam penyunting kegemaran anda, dan terjemahkan setiap barus dengan meletakkan teks terjemahan selepas tanda sama dengan.

Di sini contoh untuk fail terjemahan bahasa Melayu (<code>ms.txt</code>):

# A comment.
# Another comment.
This line is ignored since it has no equals sign.
Hello, World! = Hello, Dunia!
String with\nnewlines = Rentetan dengan\nbaris baru
String with an \= equals sign = Rentetan dengan \= tanda sama dengan

Fail terjemahan (atau penempatan) ialah fail teks biasa yang mempunyai baris-baris dalam bentuk <code>teks asal = teks terjemahan</code>. Fail tersebut mestilah berada di dalam subdirektori <code>locale</code> di dalam direktori mods, dan mesti dinamakan sebagai [https://ms.wikipedia.org/wiki/Senarai_kod_ISO_639-1 Kod Bahasa ISO 639-1] dua huruf untuk bahasa yang anda ingin terjemahkan.

Fail terjemahan mestilah menggunakan pengekodan UTF-8.

Baris yang bermula dengan tanda nombor/tanda pagar (#) ialah komen dan diabaikan oleh pemprosesan pembaca terjemahan. Ambil perhatian bahawa komen hanyalah sah sehingga penghujung baris; tidak ada sokongan untuk komen pelbagai baris. Baris-baris tanpa tanda sama dengan juga akan diabaikan.

Aksara yang dianggap "istimewa" boleh "dilepaskan" supaya ianya diambil bulat-bulat. Terdapat beberapa jujukan lepasan (''escape sequence'') yang boleh digunakan:
* Mana-mana tanda nombor/tanda pagar (<code>#</code>), tanda sama dengan (<code>=</code>) boleh dilepaskan untuk diambil bulat-bulat. Jujukan <code>\#</code> sangat berguna sekiranya teks asal bermula dengan tanda nombor/tanda pagar (<code>#</code>).
* Jujukan lepasan biasa <code>\n</code> dan <code>\t</code> setiap satunya membawa maksud baris baru dan tab mendatar.
* Jujukan lepasan istimewa <code>\s</code> melambangkan aksara ruang (selang). Ianya berguna untuk memasukkan ruang hadapan atau ruang belakang ke dalam teks sumber atau terjemahan, kerana ruang-ruang ini akan dibuang jika tidak berbuat sedemikian. Contohnya, jika teks tersebut ialah perenggan dan perlu bermula dengan beberapa ruang, perlulah menggunakan jujukan lepasan ini.

== Menggunakan pustaka sebagai pembangun ==

Sekiranya anda pembangun mods yang ingin menambah sokongan pengantarabangsaan kepada mods anda, anda perlu melalukan perkara berikut.

=== Membolehkan pengantarabangsaan ===

Untuk membolehkan pengantarabangsaan untuk mods anda, anda perlu salin fail <code>lib/intllib.lua</code> ke dalam direktori akar mods anda, kemudian masukkan kod plat dandang (boilerplate) ini ke dalam fail yang memerlukan pengantarabangsaan:

-- Load support for intllib.
local MP = minetest.get_modpath(minetest.get_current_modname())
local S, NS = dofile(MP.."/intllib.lua")

Anda juga perlu bergantung secara pilihan kepada intllib, untuk menambah kebergantungan pilihan, masukkan <code>intllib?</code> ke dalam baris kosong di dalam fail <code>depends.txt</code> mods anda. Ambil perhatian bahawa jika intllib tidak dipasang, fungsi pengambil telah ditakrifkan untuk memulangkan rentetan tanpa perubahan. Perkara ini dibuat supaya anda tidak perlu merenjiskan beratus-ratus penyemak <code>if</code> (atau pembina lain yang serupa) untuk memeriksa sama ada pustaka tersebut memang telah dipasang.

Apabila kod tersebut telah dimasukkan, anda perlu menanda rentetan yang memerlukan terjemahan. Untuk setiap rentetan boleh terjemah dalam teks sumber anda, gunakan fungsi <code>S</code> (lihat atas) untuk memulangkan rentetan yang telah diterjemah. Contohnya:

minetest.register_node("mymod:mynode", {
-- Rentetan biasa:
description = S("My Fabulous Node"),
-- Rentetan dengan penyisipan:
description = S("@1 Car", "Blue"),
-- ...
})

Fungsi <code>NS</code> pula serupa dengan <code>ngettext</code>. Ia patut digunakan apabila rentetan untuk diterjemah mempunyai bentuk mufrad dan bentuk jamak. Contohnya:

-- `count` pertama untuk `ngettext` menentukan bentuk mana untuk digunakan.
-- `count` kedua pula penggantian sebenar.
print(NS("You have one item.", "You have @1 items.", count, count))

=== Menjana dan mengemaskini katalog ===

Ini alir kerja asas untuk bekerja dengan [https://www.gnu.org/software/gettext/ gettext]

Setiap kali anda mempunyai rentetan baru untuk diterjemah, anda patut buat seperti berikut:

cd /laluan/kepada/mods
/laluan/kepada/mods/intllib/tools/xgettext.sh file1.lua file2.lua ...

Skrip tersebut akan mencipta direktori bernama <code>locale</code> jika ia belum wujud, dan ia akan menjana fail <code>template.pot</code> (sebuah templat dengan semua rentetan boleh terjemah). Jika anda sudah ada terjemahan, skrip tersebut akan mengemaskini kesemuanya dengan rentetan yang baru.

Skrip tersebut menghantar beberapa pilihan kepada <code>xgettext</code> sebenar yang sepatutnya cukup untuk kebanyakan waktunya. Anda boleh meletakkan pilihan lain jika mahu:

xgettext.sh -o file.pot --keyword=blargh:4,5 a.lua b.lua ...

Ambil perhatian bahawa terdapat juga fail kelompok Windows <code>xgettext.bat</code> untuk pengguna Windows, tetapi anda perlu memasang alatan baris perintah secara berasingan. Lihat pengepala fail untuk konfigurasi.

[[Category:Malay]]

Mods/Internationalization Lib for Minetest/ms - Revision history

>Voxel at 20:09, 8 April 2021

>Voxel at 20:09, 8 April 2021

>Voxel at 20:09, 8 April 2021

>Voxel at 20:09, 8 April 2021