# Buku Petunjuk &lokalize;

## Pengantar

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

Setiap program penyadaran internasionalisasi tersedia untuk terjemahan atau lebih banyak file katalog-message. Ekstensi dari file -file ini adalah `.pot`. POT adalah akronim untuk Template Objek Portable. &lokalize; adalah lanjutan dan mudah untuk menggunakan pengedit file PO (&GNU; gettext message catalogs). Ini adalah sebuah sistem penerjemahan dibantu komputer untuk 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 proyek, &etc; Ini memiliki banyak fitur seperti kemampuan navigasi penuh, fungsi pengeditan yang luas, fungsi pencarian, fungsi pemeriksaan sintaks dan statistik.

File-file Objek Portabel (.po): Setiap penerjemah mengambil salinan dari salah satu dari 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

### Jendela Utama

Secara baku, jendela 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 msgfmt (sasaran teks) yang terkait dengan msgid yang ditampilkan dan di sini Anda bisa menginput atau mengedit teks yang diterjemahkan.

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

Bagian kiri atas jendela 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. Di pojok kanan bawah jendela, bagian glosarium ditampilkan.

File terjemahan dibuka di tab terpisah, dengan dua editan multi-baris besar serta sekumpulan tampilan alat. 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. Anda bisa menavigasi melalui unit via tampilan Unit Terjemahan atau dengan menggunakan Page Down dan Page Up.

Sebuah unit mungkin diterjemahkan atau belum diterjemahkan. Sebuah terjemahan dari unit yang diterjemahkan mungkin siap atau belum siap (juga kadang-kadang disebut fuzzy). Jika unit belum siap, terjemahannya akan diberikan dalam huruf miring. &lokalize; memungkinkan Anda dengan mudah menavigasi file sesuai dengan keadaan terjemahannya. Lihat menu Ke untuk pintasan. Bilah status di bagian bawah jendela 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, Anda dapat menggunakan fitur filter tampilan alat Unit Terjemahan. Menekan Page Down sesungguhnya membawa Anda ke unit selanjutnya dalam daftar terfilter/tersortir dari tampilan alat itu.

Untuk jendela utama satu dapat menambahkan lebih banyak bagian seperti Terjemahan Alternatif, Sinkron Primer, Sinkron Sekunder, Unit Biner dengan menggunakan Setelan Tampilan-alat dari menu utama.

### Bilah Alat

Anda bisa bertindak menambah atau menghapus dalam bilah-alat menggunakan Setelan Konfigurasi Bilah Alat... dari menu utama.

Konfigurasi Bilah Alat Di sini Anda bisa mengkonfigurasi bilah-alat.

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

### Tombol pintas

Anda bisa menghemat waktu dengan menggunakan tombol pintas selagi menerjemahkan. Untuk mengkonfigurasi tombol pintas, gunakan Setelan Konfigurasi Pintasan... dari menu utama.

Konfigurasi Pintasan Di sini Anda bisa mengkonfigurasi tombol pintas.

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

### Tips Umum

Jika Anda sedang melakukan terjemahan untuk &kde;, kemudian Anda sudah memiliki file proyek &lokalize; di folder bahasa Anda (biasanya bernama `index.lokalize`), atau Anda bisa memilih Proyek Ciptakan proyek baru dan asisten akan mendownload file terjemahan untuk bahasa Anda dan akan menciptakan proyek untuk Anda.

Dianjurkan agar Anda 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 Anda kelar, tekan Page Down untuk mulai pindah sepanjang daftar terfilter.

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

## Proyek

### Catatan Umum

Proyek adalah salah satu konsep utama dalam &lokalize;. Sebuah proyek 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 proyek yang dimuat, hal itu akan mencari file proyek di folder induk (sampai empat tingkat). Sebagai alternatif, Anda bisa menentukan file proyek via bendera `--proyek` saat memulai &lokalize; dari baris perintah.

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

Memori terjemahan (tidak seperti file proyek, 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 proyek adalah disimpan dalam folder yang sama dan dengan demikian bisa digunakan ketika proyek lainnya dibuka.

### Tab Ikhtisar Proyek

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

Untuk menciptakan sebuah proyek baru, gunakan Proyek Ciptakan proyek baru. Ini akan memandu melalui langkah untuk menciptakan sebuah proyek baru. Dalam menu Proyek Anda juga bisa menemukan pilihan seperti Ikhtisar proyek, Konfigurasi proyek, Buka proyek, dan Buka proyek baru-baru ini.

Tab Ikhtisar Proyek Di sini Anda bisa mengkonfigurasi proyek.

Tab Ikhtisar Proyek menampilkan pohon file dengan statistik untuk proyek saat ini, seperti persentase lengkap unit diterjemahkan dan penerjemah terakhir. Ini memungkinkan Anda membuka file yang dipilih dalam tab baru pada jendela &lokalize; saat ini.

## Glosarium

Pernahkah Anda bosan mengetik urutan teks panjang yang sama setiap kali oleh karenanya akan membutuhkan waktu lebih lama untuk menemukan terjemahannya bagi salin dan tempel? Sekarang Anda 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 Anda 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 Alat Kelola memori terjemahan untuk menambah/mengelola proyek ke proyek Memori Terjemahan Anda. Di sini Anda juga bisa mengimpor atau mengekspor data dari format file `tmx`.

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

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

&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 Alat 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 Anda 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 Anda 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. Setel alur folder Branch pada pilihan proyek Anda ke alur yang sesuai dengan basis folder cabang, dan tampilan Sinkron Sekunder secara otomatis membuka file dari cabang. Kemudian, setiap kali Anda melakukan perubahan file dari cabang utama Anda, mereka secara otomatis akan direplikasi ke cabang (tentu saja, jika itu berisi string bahasa Inggris yang sama).

Contohnya, jika Anda bekerja pada terjemahan &kde;, Anda bisa checkout trunk ke `/home/xx/hacking/kde/trunk/l10n-kde4/YOUR_LANG` dan cabang ke `/home/xx/hacking/kde/branches/stable/l10n-kde4/YOUR_LANG`. Ciptakan proyek &lokalize;: `/home/xx/hacking/kde/trunk/l10n-kde4/YOUR_LANG/project.lokalize` dan setel `BranchDir=../../../branches/stable/l10n-kde4/YOUR_LANG`, kemudian bekerja via proyek ni, 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 mempembarui file terjemahan dan entri-entri tanda dengan mengubah teks asli sebagai fuzzy (atau nonsiap dalam terminologi lain). Mereka menyimpan teks asli sebelumnya sehingga penerjemah bisa melihat perubahan tepatnya apa yang dibuat. &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 tindakan menu (yang mana Anda dapat menetapkan pintasan keyboard). Lokasi dan nama pada entri menu untuk skrip diterangjelaskan di dalam file .rc yang menyertainya. Pada setiap proyek 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 Anda seharusnya tidak usah menambahkan sistem kendali versi proyek). 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 Anda ingin membaginya kepada orang lain dalam proyek Anda). Misalnya, Anda bisa menentukan `../../scripts/localize/opensrc.py` untuk memuat skrip dari folder skrip kde4-l10n global (&ie; tidak spesifik untuk bahasa Anda).

Contohnya file .rc yang ditemukan di folder pasangan &lokalize; (biasanya `/usr/share/lokalize/scripts/`) dan di &kde; repositori. Di sini Anda bisa menemukan contoh-contoh skrip lebih, 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 Proyek

## Kredit dan Lisensi

&lokalize;

Program Copyright © 2007-2009, 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 lebih.

Wantoyowantoyek@gmail.com

&underFDL; &underGPL;
&documentation.index;