# Buku Petunjuk &lokalize;

## Pengenalan

Biasanya messages dan documentation program ditulis dalam bahasa Inggris. Menggunakan sebuah kerangka yang dibuat dari seperangkat alat dan perpustakaan, yang memungkinkan untuk memiliki aplikasi favorit yang bertutur non-Inggris seperti bahasa yang kamu ucapkan. Proses ini mengadaptasi aplikasi ke bahasa tertentu yang dikenal sebagai localization. Proses pelokalisan termasuk menerjemahkan antarmuka program dan dokumentasi untuk berbagai bahasa yang dibutuhkan pengguna dan di beberapa negara atau wilayah, membuat input dan output sesuai konvensi tertentu. &lokalize; adalah alat yang akan membantu kamu dalam proses pelokalisan untuk membuat sebuah antarmuka aplikasi bertutur dalam banyak bahasa.

Setiap program penyadaran internasionalisasi tersedia untuk terjemahan atau lebih banyak file-file katalog message. Ekstensi dari file-file ini adalah `.pot`. POT adalah akronim dari Portable Object Template. &lokalize; adalah sebuah pengedit tingkat-lanjut dan mudah untuk menggunakan file PO (&GNU; gettext message catalogs). Ini adalah sebuah sistem computer-aided translation (CAT), penerjemahan yang berbantuan komputer untuk para penerjemah, ditulis dari nol menggunakan framework &kde; Platform 4. Selain pengeditan dasar file PO dengan perincian tambahan yang bagus, ini mengintegrasikan dukungan untuk glosarium, memori terjemahan, diff-mode untuk QA, pengelolaan projek, &etc;. Ini memiliki banyak fitur seperti kemampuan navigasi penuh, fungsi pengeditan yang luas, fungsi pencarian, fungsi pemeriksaan sintaks dan statistik.

File-file Portable Object (.po): Setiap penerjemah mengambil salinan dari salah satu file templates POT tersebut dan mulai mengisi yang kosong: setiap pesan diterjemahkan ke dalam bahasa yang diinginkan. File yang berisi teks terjemahan disebut sebagai file PO (Portable Object).

## Pengedit

### Window Utama

Secara baku, window utama berisi enam bagian. Kotak kanan-atas adalah hanya-baca dan berisi bidang msgid (sumber teks) dari file PO yang dibuka. Kotak edit di bawah hanya berisi bidang msgtr (sasaran teks) yang terkait dengan msgid yang ditampilkan dan di sini kamu bisa menginput atau mengedit teks yang diterjemahkan.

Jendela &lokalize; baku utama Ini menampilkan window utama ketika file dibuka.

Bagian kiri atas window utama menampilkan Unit Terjemahan. Di bawah ini, ada bagian Unit Metadata dan berisi komentar yang relevan dengan teks sumber yang saat ini ditampilkan. Di sebelah kiri bawah, ada Bagian Memori Terjemahan yang menampilkan terjemahan yang disarankan dari database memori terjemahan untuk entri teks sumber saat ini. Bagian glosarium ditampilkan di pojok kanan bawah window.

File terjemahan dibuka di tab terpisah, dengan dua editan multi-baris besar serta sekumpulan tool views. Tampilan ini bisa jadi ditumpuk (mirip dengan tab), ditampilkan secara terpisah, atau disembunyikan. File terjemahan terdiri dari banyak kecocokan sasaran bahasa Inggris yang disebut unit. Sebuah unit biasanya sesuai dengan string tunggal dalam antarmuka pengguna, atau satu paragraf dalam dokumentasi. Tujuan dari edit multi-baris pertama adalah untuk menampilkan bagian asli dari kecocokan. Tujuan dari edit multi-baris kedua adalah untuk menampilkan terjemahan. Kamu bisa menavigasi melalui unit via tampilan Unit Terjemahan atau dengan menggunakan Page Down dan Page Up.

Sebuah unit mungkin translated atau untranslated. Sebuah terjemahan dari unit yang diterjemahkan mungkin ready atau not ready (juga kadang-kadang disebut fuzzy). Jika unit belum siap, terjemahannya akan diberikan dalam huruf miring. &lokalize; memungkinkan kamu dengan mudah menavigasi file sesuai dengan keadaan terjemahannya. Lihat menu Ke untuk pintasan. Bilah status di bagian bawah window menampilkan nomor string saat ini, jumlah total string, total string yang belum diterjemahkan, total string belum siap (fuzzy) dan status string saat ini masing-masing. Ketika menavigasi, unit yang belum diterjemahkan dianggap sebagai belum siap. Juga, kamu dapat menggunakan fitur filter tampilan alat Unit Terjemahan. Menekan Page Down sesungguhnya membawa kamu ke unit selanjutnya dalam daftar terfilter/tersortir dari tampilan alat itu.

Untuk memudahkan terjemahan pada aplikasi console di mana jarak sepasi dalam perpesanan yang penting, kamu bisa mencentang item Visualkan pemisah sepertihalnya sepasi, tab, dan baris baru di dalam pengedit pada halaman Pengeditan pada window konfigurasi yang bisa dibuka dengan memilih item menu utama Pengaturan Konfigurasikan &lokalize;....

Jika kamu belum memiliki akses ke file template terjemahan asli (ini adalah cukup sederhana pada beberapa projek komersial) kemudian kamu bisa menggunakan sebuah file terjemahan dari bahasa yang berhubungan. Hanya dengan memilih item menu File Bersihkan semua entri yang diterjemahkan atau gunakan pintasan &Ctrl;&Alt;D untuk membersihkan semua unit terjemahan.

Untuk window utama salahsatunya dapat menambahkan lebih banyak bagian seperti Terjemahan Alternatif, Sinkron Primer, Sinkron Sekunder, Unit Biner dengan menggunakan Pengaturan Tampilan Alat dari menu utama.

### Bilah Alat

Kamu bisa menambah atau menghapus aksi dalam bilah alat menggunakan Pengaturan Konfigurasikan Bilah Alat... dari menu utama.

Konfigurasikan Bilah Alat Di sini kamu bisa mengkonfigurasi bilah alat.

Untuk informasi selebihnya baca bagian tentang Bilah Alat dari &kde; Fundamentals.

### Tuts pintas

kamu bisa menghemat waktu dengan menggunakan tuts pintas selagi menerjemahkan. Untuk mengkonfigurasi tuts pintas, gunakan Pengaturan Konfigurasikan Pintasan... dari menu utama.

Konfigurasikan Pintasan Di sini kamu bisa mengkonfigurasi pintasan tuts.

Untuk informasi selebihnya baca bagian tentang Pintasan dari &kde; Fundamentals.

### Tips Umum

Jika kamu sedang melakukan terjemahan untuk &kde;, kemudian kamu sudah memiliki file projek &lokalize; di folder bahasamu (biasanya bernama `index.lokalize`), atau kamu bisa memilih Projek Ciptakan projek baru dan asisten akan mengunduh file terjemahan untuk bahasamu dan akan menciptakan projek untuk kamu.

Dianjurkan agar kamu terbiasa dengan menggunakan pintasan keyboard sebagai gantinya menu dan bilah alat untuk meningkatkan produktivitas. Misalnya, gunakan &Ctrl;L untuk fokus Cari cepat baris input untuk filter daftar unit di tampilan Unit Terjemahan. Setelah kamu kelar, tekan Page Down untuk mulai pindah sepanjang daftar terfilter.

Jika kamu bekerja dengan file terjemahan dalam format XLIFF (pastinya ketika. Kamu menerjemahkan OpenDocument), kemudian keadaan luas tersedia (baru, perlu tinjauan, disetujui, &etc;.). Kamu mungkin dapat memilihnya di menu bentangturun tombol Diperkenankan di bilah alat. Klasifikasi wilayah sebagai siap atau belum siap tergantung pada tahap alurkerja (terjemahan, tinjauan, persetujuan) saat ini. Tahap baku bagi kamu tergantung pada peraturanmu dalam projek (diset dalam pengaturan projek). Setiap unit biasanya berisi informasi tentang tahap yang diubah terakhir kali, dan untuk setiap tahapnya pemilik telah ter-log ke file.

## Projek

### Catatan Umum

Proyek adalah salah satu konsep utama dalam &lokalize;. Sebuah projek adalah diwakili oleh sebuah file yang berisi alur, folder dengan terjemahan, template, dan file lainnya: file glosarium, skrip otomasi, memori terjemahan. Kapanpun &lokalize; membuka file tanpa projek yang dimuat, hal itu akan mencari file projek di folder induk (sampai empat tingkat). Sebagai alternatif, kamu bisa menentukan file projek via bendera `--projek` saat memulai &lokalize; dari baris perintah.

Untuk setiap projek, peran kamu yang kamu pilih di dalamnya (penerjemah, peninjau, penyetuju), yang pada gilirannya memengaruhi tahap alur kerja &lokalize; secara otomatis mengambil file yang kamu edit.

Memungkinkan untuk menemukan sebuah posisi pengemasan kata pada tingkat projek. Hanya menggunakan item menu Projek Konfigurasikan projek... kemudian menuju ke halaman Tingkat-lanjut.

Memori terjemahan (tidak seperti file projek, glosarium dan skrip) tidak dibagikan kepada anggota tim penerjemahan, karena mereka diciptakan dan disimpan di bawah folder beranda pengguna, yang berarti bahwa memori terjemahan untuk semua dari projek adalah disimpan dalam folder yang sama dan dengan demikian bisa digunakan ketika projek lainnya dibuka.

### Tab Ikhtisar Projek

Ketika kamu memulai &lokalize; pertama kali, kamu akan melihat tab Ikhtisar Projek kosong. Ikhtisar Projek adalah tampilan pengelola file , yang mana membantu kamu menjaga ikhtisar dari file -file PO kamu. &lokalize; suite akan membantu kamu untuk menerjemahkan dengan cepat dan juga menjaga terjemahan tetap konsisten. Alurkerja &lokalize; menyiratkan bahwa kamu memulai dengan menciptakan/membuka sebuah projek. Tab Ikhtisar Projek menampilkan hierarki file dengan statistik dengan projek saat ini, seperti persentase dari rampungnya unit yang diterjemahkan dan penerjemah yang terakhir. Ini memungkinkan kamu untuk membuka file yang dipilih dalam tab window &lokalize; saat ini.

Untuk menciptakan sebuah projek baru, gunakan Projek Ciptakan projek baru. Ini akan memandu melalui langkah untuk menciptakan sebuah projek baru. Dalam menu Projek kamu juga bisa menemukan pilihan seperti Ikhtisar projek, Konfigurasikan projek, Buka projek, dan Buka projek baru-baru ini.

Tab Ikhtisar Projek Di sini kamu bisa mengkonfigurasi projek.

Tab Ikhtisar Projek menampilkan hierarki file dengan statistik untuk projek saat ini, seperti persentase lengkap unit diterjemahkan dan penerjemah terakhir. Ini memungkinkan kamu membuka file yang dipilih dalam tab baru pada window &lokalize; saat ini.

Kamu bisa mematikan secara lengkap file-file yang diterjemahkan dari Ikhtisar Projek menggunakan tombol Sembunyikan item yang dirampungkan pada bilah alat utama atau pintasan baku &Ctrl;T.

Ketika kamu menjalankan &lokalize; di lain waktu, secara baku ia akan menampilkan file yang dibuka terakhir kali. Kamu bisa mematikan perilaku ini dengan item Kembalikan file yang dibuka sebelumnya ketika membuka &lokalize; pada halaman Umum pada window konfigurasi yang bisa dibuka dengan memilih item menu utama Pengaturan Konfigurasikan &lokalize;.... Halaman yang sama bisa digunakan untuk mengkonfigurasi perilaku &lokalize; ketika kamu beralih ke tab sebelumnya/selanjutnya di dalamnya. Ini memungkinkan untuk menuju melalui sesuai daftar tab ke posisi tab atau sesuai dengan urutan aktivasi mereka.

## Glosarium

Pernahkah kamu bosan mengetik urutan teks panjang yang sama setiap kali oleh karenanya akan membutuhkan waktu lebih lama untuk menemukan terjemahannya bagi salin dan tempel? Sekarang kamu hanya mencari urutan kata (yang sering) di Tampilan Glosarium, lalu sisipkan dengan menekan sebuah pintasan.

Tentu glosarium harus diisi dengan urutan kata terlebih dahulu. &lokalize; memiliki pengedit glosarium praktis yang memungkinkan pencarian eksplisit melalui entri glosarium.

Tampilan glosarium di pojok kanan bawah menampilkan entri-entri glosarium yang sesuai untuk unit saat ini Tampilan glosarium di pojok kanan bawah menampilkan entri-entri glosarium yang sesuai untuk unit saat ini

## Memori Terjemahan

Tampilan Memori Terjemahan memungkinkan kamu untuk seret dan jatuh sebuah folder dengan file terjemahan dari katakanlah &dolphin; ke dalam tampilan, dan kemudian, dalam beberapa menit, saran terjemahan akan ditampilkan secara otomatis pada peralihan unit. Untuk menyisipkan saran terjemahan ke dalam file, gunakan &Ctrl; 1, &Ctrl;2 dan seterusnya, tergantung dari jumlah sarannya.

Gunakan Peralatan Kelola memori terjemahan untuk menambah/mengelola projek ke projek Memori Terjemahan kamu. Di sini kamu juga bisa mengimpor atau mengekspor data dari format file `tmx`.

Menekan F7 akan membuka tab Memori Terjemahan, yang memungkinkan kamu untuk men-query MT secara bebas. Mengeklik sebuah hasil pencarian akan membuka file dan unit yang sesuai. Jika kamu ingin cepat membuka beberapa file dalam projek (dan itu ditambahkan ke MT), sebagai gantinya merambah Ikhtisar Projek kamu bisa mengetikan namanya saja ke bidang File mask, disertai dengan '*'.

Mesin MT mengindeks semua entri, termasuk yang belum siap dan belum diterjemahkan. Hal ini memungkinkannya untuk secara lengkap mengganti fitur Pencarian-dalam-File yang mana diperlukan pemindaian setiap file dalam projek setiap kali pencarian dilakukan.

Entri-entri MT yang kedaluwarsa akan dihapus dari memori terjemahan &lokalize; saat pindai-ulang atau mengeklik pada entri yang hilang jika kamu mencentang item Hapus file yang hilang dari memori terjemahan saat Pindai-ulang atau ketika mengeklik sebuah entri yang hilang di halaman Memori Terjemahan dari window konfigurasi yang bisa dibuka dengan memilih item menu utama Pengaturan Konfigurasikan &lokalize;....

&lokalize; dengan hasil pencarian memori terjemahan untuk unit saat ini &lokalize; dengan hasil pencarian memori terjemahan untuk unit saat ini

Setumpuk Terjemahan:

- Untuk memasukkan saran pencocokan yang pas secara otomatis dari database memori terjemahan, gunakan Peralatan Isikan semua saran yang pas ATAU Isikan semua saran yang pas dan tandai sebagai fuzzy. Fitur ini adalah fitur terjemahan kasar yang serupa di &kbabel;.

## Kemampuan Sinkronisasi Terjemahan

Mode Sinkron (sebelumnya dikenal sebagai Mode Gabung) menghemat banyak waktu untuk pengeditan, dan dalam kasus ketika dua atau lebih penerjemah bekerja secara bersamaan pada file yang sama, atau ketika kita harus mempertahankan terjemahan beberapa cabang perangkat lunak.

&lokalize; memungkinkan navigasi cepat melalui unit yang berbeda, dan menampilkan perbedaan kata demi kata. Juga, &lokalize; memiliki dua tampilan Sinkron - Sinkron Primer dan Sinkron Sekunder. Mereka identik, tapi yang pertama biasanya digunakan untuk menggabungkan terjemahan dan kedua untuk terus melakukan sinkronisasi terjemahan untuk dua cabang perangkat lunak.

Setelah kamu menyalin terjemahan dari file penolong (tersinkronisasi), segala perubahan selanjutnya yang dibuat pada unit ini akan direplikasi kembali ke file penolong.

### Penggabungan

Salah satu penggunaan Mode Sinkron adalah meninjau perubahan yang dilakukan oleh kontributor (baru), bila kamu tidak bisa memastikan kualitas pekerjaan yang dilakukan.

Buka file base, lalu turunkan versi yang diubah ke dalam tampilan Sinkron Primer, berikut ini dengan &Alt;Down atau &Alt; Up (ingat pintasan tersebut mungkin dimodif dalam cara mudah untuk semua aplikasi &kde;) untuk menavigasi melalui entri-entri yang berbeda.

&lokalize; digunakan untuk menggabungkan perubahan dalam terjemahan &lokalize; digunakan untuk menggabungkan perubahan dalam terjemahan

### Replikasi

Mode Sinkron juga dapat digunakan untuk melakukan perubahan untuk terjemahan bagi dua cabang secara bersamaan. Set alur folder Branch pada pilihan projek kamu ke alur yang sesuai dengan basis folder cabang, dan tampilan Sinkron Sekunder secara otomatis membuka file dari cabang. Kemudian, setiap kali kamu melakukan perubahan file dari cabang utama kamu, mereka secara otomatis akan direplikasi ke cabang (tentu saja, jika itu berisi string bahasa Inggris yang sama).

Umpamanya, jika kamu bekerja pada terjemahan &kde;, kamu bisa checkout trunk ke `/home/xx/hacking/kde/trunk/l10n-kf5/BAHASAMU` dan branch ke `/home/xx/hacking/kde/branches/stable/l10n-kf5/BAHASAMU`. Ciptakan projek &lokalize;: `/home/xx/hacking/kde/trunk/l10n-kf5/BAHASAMU/project.lokalize` dan set `BranchDir=../../../branches/stable/l10n-kf5/BAHASAMU`, kemudian bekerja melalui projek ini, dan commit perubahan di kedua folder trunk dan branch.

### Terjemahan Alternatif

Setiap unit mungkin memiliki beberapa terjemahan alternatif yang terkait dengannya. Terjemahan semacam itu mungkin muncul selagi pembaruan file , ketika string sumber ada sedikit perubahan. Dalam kasus ini terjemahan lawas dengan sumber (lawas) telah dipindahkan ke daftar terjemahan alternatif, sehingga dengan begitu tidak hilang.

Saat menerjemahkan perangkat lunak, biasanya alat gettext digunakan untuk mempersiapkan file terjemahan. Saat perubahan teks asli, alat gettext memperbarui file terjemahan dan entri-entri tanda dengan mengubah teks asli sebagai fuzzy (atau belum siap dalam terminologi lain). Mereka menyimpan teks asli sebelumnya sehingga penerjemah bisa melihat perubahan apa yang diubah. &lokalize; menyederhanakan kehidupan penerjemah dan menyoroti bagian dari teks asli yang diubah di tampilan Terjemahan Alternatif.

&lokalize; menyoroti bagian teks asli yang diubah sejak terjemahan terakhir ditinjau &lokalize; menyoroti bagian teks asli yang diubah sejak terjemahan terakhir ditinjau

## Skrip &lokalize;

&lokalize; dapat diekstensi menggunakan skrip dalam beberapa bahasa yang diinterpretasikan, termasuk Python dan &javascript;. Skrip biasanya diintegrasikan ke dalam antarmuka UI &lokalize; sebagai aksi menu (yang mana kamu bisa menetapkan pintasan keyboard). Lokasi dan nama pada entri menu untuk skrip diterangjelaskan di dalam file .rc yang menyertainya. Pada setiap projek yang dibuka, &lokalize; memindai folder `DIREKTORIPROYEK/lokalize-scripts` bagi file-file .rc dan menambahkannya ke file cache yang disebut `DIREKTORIPROYEK/lokalize-scripts/scripts.rc` (jadi kamu seharusnya tidak usah menambahkan sistem kendali versi projek). File RC juga berisi alur skrip, yang mungkin relatif terhadap folder file .rc, atau untuk folder skrip sistem - keduanya dicoba (meskipun harus tetap berada di lokasi yang relatif jika kamu ingin membaginya kepada orang lain dalam projek kamu). Misalnya, kamu bisa menentukan `../../scripts/localize/opensrc.py` untuk memuat skrip dari folder skrip kf5-l10n global (&ie; tidak spesifik untuk bahasamu).

Contohnya file .rc yang ditemukan di folder instalan &lokalize; (biasanya `/usr/share/lokalize/scripts/`) dan di &kde; repositori. Di sini kamu bisa menemukan contoh-contoh skrip selebihnya, termasuk JavaScript-based `check-gui.js` yang berjalan secara otomatis saat setiap file disimpan (ini adalah arsip via pilihan khusus di file .rc). Jika kalian terbiasa dengan Python atau &javascript;, kode seharusnya sudah cukup jelas.

Berikut adalah tautan ke referensi API. Semuanya ditandai sebagai Q_SCRIPTABLE mungkin digunakan dari skrip.

- Referensi API objek Editor

- Referensi API objek &lokalize;

- Referensi API objek Projek

### Pology

Salah satu aplikasi kemampuan penskripan yang baik adalah menggunakan Pology di dalam &lokalize;.

Interaksi dengan Pology bisa dikonfigurasi menggunakan halaman Pology pada window konfigurasi yang mana bisa dibuka dengan memilih item menu utama Pengaturan Konfigurasikan &lokalize;....

Untuk informasi selebihnya, silakan mengarah ke Pology homepage.

## Penghargaan dan Lisensi

&lokalize;

Hak Cipta Program © 2007-2015, Nick Shaforostoff shaforostoff@kde.ru

Beberapa kode diambil dari &kbabel;, leluhur &lokalize;.

Dokumentasi Copyright © 2007-2009 Nick Shaforostoff shaforostoff@kde.ru

Penulis:

- Nick Shaforostoff shaforostoff AT kde.ru; Shankar Prasad svenkate AT redhat.com; Sweta Kothari swkothar AT redhat.com

Lihat laman &lokalize; untuk perincian selebihnya.

Wantoyowantoyek@gmail.com

&underFDL; &underGPL;
&documentation.index;