# Buku Panduan &khangman;

## Pengantar

&khangman; adalah permainan yang didasarkan pada permainan hangman (algojo/tiang gantung) yang terkenal. Ini ditujukan untuk anak-anak berusia enam tahun ke atas. Permainan ini memiliki beberapa kategori kata untuk dimainkan, misalnya: Hewan (nama-nama binatang), Pakaian, Komputer, Mata Uang, Mudah dan Buah-buahan. Sebuah kata dipilih secara acak, huruf-hurufnya disembunyikan, dan kamu harus menebak kata itu dengan mencoba huruf satu demi satu. Setiap kali kamu menebak huruf yang salah, bagian dari gambar algojo digambari. Kamu harus menebak kata sebelum digantung! Kamu memiliki 10 percobaan.

## Menggunakan &khangman;

Ini adalah cuplikan layar dari &khangman; ketika Anda menggunakannya untuk pertama kali Cuplikan layar &khangman;

Gambar di atas adalah &khangman; saat Anda menjalankannya pertama kali. Kategorinya Nama Hewan, bahasa baku bawaan (dalam hal ini Bahasa Inggris, standarnya adalah bahasa sesuai pengaturan &kde; anda jika ada datanya), tema adalah Catatan. Segala perubahan dalam kategori, bahasa atau tema (latar belakang) ditulis dalam berkas konfigurasi dan ditampilkan kembali dalam permainan Anda berikutnya.

Catatlah bahwa sangat mudah untuk mengganti tema, hanya dengan menekan tombol pada bilah alat bawah. Mendapatkan kata baru dan mengakhiri permainan juga sangat mudah dengan menekan tombol terkait pada bilah alat.

### Penggunaan Umum

Sebuah kata dipilih dan huruf-hurufnya ditampilkan sebagai simbol garisbawah (_). Anda mengetahui berapa banyak huruf yanga ada dalam sebuah kata. Anda harus menebak kata dengan mencoba huruf satu persatu. Anda ketikkan huruf pada papan tik atau memilihnya menggunakan &LMB;. Jika huruf tersebut merupakan bagian dari kata maka warna latar belakang dari huruf akan berubah menjadi hijau, jika tidak maka berwarna merah.

Huruf pada layar permainan memungkinkan Anda untuk memainkan &khangman; dalam bahasa asing tanpa mengganti pengaturan tata letak papan tik.

Kata dipilih secara acak dan tidak sama dengan kata sebelumnya.

Semua kata adalah kata benda (tidak ada kata kerja atau kata sifat, &etc;).

Jika Anda membutuhkan bantuan untuk menebak kata, Anda dapat mengklik ikon pada bilah alat dan sebuah petunjuk akan ditampilkan untuk memberi Anda beberapa petunjuk tentang kata. Mengklik aikonnya lagi akan menyembunyikan petunjuk.

Secara baku petunjuk tidak ditampilkan.

Biasanya, tidaklah penting apakah Anda mengetik dalam huruf kecila atau huruf besar. Perangkat lunak mengubah semua masukan kedalam huruf besar. Perangkat lunak melakukannya secara otomatis.

Kategori saat ini, menang dan kalah ditampilkan pada layar.

Setiap kali Anda menebak sebuah huruf yang tidak ada dalam kata, sebuah bagian dari tiang gantung akan digambar. Anda memiliki 10 kesempatan untuk menebak kata. Setelah itu, jawaban yang benar akan dimunculkan.

Ada beberapa kategori kata yang tersedia, tergantung bahasa yang dipilih. Perangkat lunak memindai seluruh berkas data untuk semua bahasa dan juga menggunakan berkas kata-kata &kanagram;.

Setelah sebuah kata ditebak (atau permainan diselesaikan), Anda diberi selamat dan kata berikutnya ditampilkan. Untuk keluar dari permainan klik ikon pada bilah alat atas.

Anda ketikkan huruf yang ingin Anda coba pada papan tik atau pilihlah dengan &LMB;. Jika huruf yang dipilih merupakan bagian dari kata maka hurufnya akan menjadi berwarna hijau dan diletakkan pada posisinya dalam kata, sebanyak jumlahnya dalam kata. Apabila huruf bukan bagian dari kata. huruf akan ditampilkan berwarna merah. Anda memiliki 10 kesempatan dan setelah itu Anda dinyatakan kalah dan kata yang benar akan ditampilkan.

Selama permainan, Anda dapat memilih untuk memulai permainan baru dengan mengklik pada bilah alat di bagian bawah. Anda juga dapat mengganti kategori kata dengan mengklik kategori yang saat ini ditampilkan.

Tampilan dapat dengan mudah diganti dengan tombol pilihan tema pada bilah alat di bagian bawah.

### Memainkan dengan bahasa yang berbeda

Anda dapat memainkan &khangman; dalam banyak bahasa termasuk di dalamnya: Bahasa Portugis Brasil, Bulgaria, Catalan, Ceko, Denmark, Inggris (Amerika dan Britania Raya), Filandia, Perancis, Jerman, Hungaria, Irlandia (Gaelic), Italia, Norwegia (Bokmål), Norwegia (Nynorsk), Polandia, Portugis, Romania, Spanyol, Serbia (Latin dan Cyrilic), Slovenia, Tajik, Swedia; Rusia dan Turki. Anda bahkan dapat mencoba bahasa China jika Anda memasang berkasnya melalui &kanagram;.

Secara baku, setelah instalasi pemasangan &khangman;, hanya Bahasa Inggris dan bahasa sesuai pengaturan &kde; jika itu termasuk dalam salah satu bahasa di atas dan apabila Anda memasang paket kde-i18n yang sesuai, yang akan dipasang. Sebagai contoh jika Anda seorang pengguna dari Denmark dan apabila Anda menggunakan &kde; dalam bahasa Denmark, dalam pihan Bahasa Anda akan melihat dua pilihan: Bahasa Inggris dan Bahasa Denmark, dengan Bahasa Denmark sebagai pilihan utama.

Anda tetap dapat memainkan &khangman; dalam bahasa lain. Adalah sangat mudahuntuk menambahkan data baru ke dalam &khangman;. Yang Anda butuhkan hanyalah koneksi Internet. Klik pada dan sebuah jendela dialog akan muncul, sama seperti yang satu ini:

Dialog Mendapatkan Kata-Kata Baru untuk &khangman; Dialog Mendapatkan Kata-Kata Baru untuk &khangman;

Klik pada nama bahasa yang ingin Anda pasang dan selanjutnya pada tombol Install. Jika bahasa berhasil dipasang, tanda hijau ditampilkan di depan nama bahasa dan Install berubah menjadi Uninstall. Data akan segera dipasang dan tersedia pada &khangman;. Anda klik pada tombol Close untuk menutup jendela dialog Mendapatkan Kata-Kata Baru (jika Anda menginginkan berkas data yang lain, Anda dapat mengulang langkah-langkah di atas).

Anda dapat dengan mudah mengganti bahasa dengan mengklik tombol bahasa dan memilih bahasa yang baru.

Mohon dicatat bahwa karakter spesial dalam sebuah bahasa akan ditampilkanpada papan tik. Dalam hal ini Anda akan melihat tombol dengan sebuah ikon untuk setiap karkater spesial dalam setiap bahasa seperti é dalam bahasa Perancis sebagai contoh. Mengklik pada tombol tersebut akan memilih huruf yang sesuai. Tentu saja Anda dapat menggunakan papan tik yang sesuai dengan pilihan bahasa.

### Beberapa tip/petunjuk

Dalam Bahasa Inggris, pertama-tama cobalah untuk menduga huruf vokal. Kemudian cobalah konsonan umum: l, t, r, n, s.

Apabila anda melihat io, cobalah n setelahnya, dalam bahasa Perancis dan Inggris.

Anda harus mengetik huruf beraksen atau mengkliknya. Ketika anda mengetik a, hanya a yang ditampilkan dan Anda harus mengetik ã sebagai contoh sehingga huruf tersebut akan ditampilkan.

Apakah Anda tahu? Dalam Bahasa Inggris, huruf yang paling umum adalah e (12.7%), diikuti t (9.1%) kemudian a (8.2%), i (7.0%) dan n (6.7%).

## Bilah menu dan Bilah alat

### Jendela utama &khangman;

&khangman; Tema Gurun &khangman; Tema Gurun

Di sini Anda memiliki &khangman; dengan Tema Gurun, Bahasa Perancis dan kategori Binatang. Karakter khusus Bahasa Perancis diperlihatkan di sini.

Permainan memiliki bilah alat utama pada bagian atas dari jendela:

- atau Memulai atau mengakhiri permainan
- Buka dialog pengaturan
- Tentang &khangman;
- Tentang &kde;
- Lihat buku panduan &khangman;
- Unduh berkas bahasa baru dari Internet
- Keluar &khangman;

Bilah alat bawah ditampilkan hanya jika memainkan permainan, jika anda menyetop sementara permainan bilah alat ini akan disembunyikan:

- - Tampilkan petunjuk tentang kata yang harus ditebak
- Tombol untuk mengganti kategori
- Pilihan bahasa
- Pilihan tema
- Perlihatkan kata untuk ditebak
- Panggil kata berikutnya dan mulai permainan baru

Semua kata adalah kata benda. Tidak ada kata kerja, juga tidak ada kata sifat. Kategori yang dipilih ditampilkan pada bilah status.

Hanya huruf yang diizinkan untuk diketik dalan kotak teks

### Pengaturan

&khangman; pengaturan &khangman; pengaturan

Waktu menebak kata dalam detik menetapkan waktu maksimum yang diizinkan untuk untuk memecahkan kata dalam &khangman;. Standarnya adalah 120 detik. Anak-anak membutuhkan waktu yang lebih lama untuk mengerti permainan, untuk orang dewasa kurangi waktunya untuk membuat permainan tetap menarik.

Fator Pengali Nilai adalah faktor yang menentukan berapa nilai akan dilipatgandakan.

Jika Anda memeriksa Suara maka suara akan dimainkan untuk permainan baru dan suara lainnya akan dimainkan ketika Anda memenangkan permainan.

## Petunjuk Pengembang untuk &khangman;

### Bagaimana menerjemahkan kata-kata dalam bahasa baru untuk permainan

Silakan ikuti prosedur dan kirim berkas tar dan gzip ke kde-edu mailinglist.

Silakan periksa &khangman; pada bilah alat di bagian atas untuk melihat jika bahasa Anda telah tersedia. Jika iya, selanjutnya periksa apakah mengandung petunjuk.

Daftar kata-kata baku disimpan dalam 4 berkas terpisah, untuk membuat kategori yang berbeda. Berkas terdapata dalam `/khangman/data/`. Berkas `easy.kvtml` adalah untuk kategori mudah, berkas `medium.kvtml` adalah untuk kategori menengah, berkas `animals.kvtml` adalah untuk kategori hewan dan berkas `hard.kvtml` adalah untuk kategori sulit.

Bahasa Inggris adalah bawaan standar dan satu-satunya bahas yang dipaketkan dengan &khangman;. Semua data bahasa lainnya terdapat pada modul kde-l10n yang sesuai.

1. Berkas menggunakan format kvhtml. Tag `text` adalah untuk kata dan tag `comment` adalah untuk petunjuk, semuanya di dalam tag `entry`. Silakan coba untuk mencocokkan petunjuk dengan kategori kesulitan. Kategori Easy akan membutuhkan petunjuk yang mudah tetapi kategori Hard akan membutuhkan definisi di dalam kamus. Usahakan untuk tidak menggunakan kata-kata dari keluarga yang sama di dalam petunjuk, hal tersebut akan menghasilkan kata yang sangat mudah!

   Catat bahwa Anda harus menggunakan UTF-8 encoding ketika menyunting berkas. Jika editor anda tidak dapat melakukannya, coba menggunakan &kwrite; atau &kate;. Ketika membuka sebuah berkas melalui &kwrite; or &kate; Anda dapat memilih encoding utf8 dengan boks combo pada bagian atas dialog buka berkas.

   Sebuah contoh dari berkas kvtml adalah sebagai berikut:

       <?xml version="1.0"?>
       <DOCTYPE kvtml PUBLIC "kvtml2.dtd"
       "https://edu.kde.org/kvtml/kvtml2.dtd">
       <kvtml version="2.0">
       <information>
           <generator>converter</generator>
           <title>Animals</title><!--Translate tag content-->
           <comment>Animals from across the
       planet</comment><!--Translate tag content-->
         </information>
         <identifiers>
           <identifier id="0" >
             <locale>en</locale>
           </identifier>
         </identifiers>
       ...
       <entry id="0" >
             <inactive>false</inactive>
             <inquery>false</inquery>
             <translation id="0" >
               <text>bear</text><!--Translate all text tags
       content-->
               <comment>Large heavy animal with thick
       fur</comment><!--Translate all comment tags content-->
             </translation>
           </entry>
       ...
       </kvtml>

2. Di awal berkas, Anda harus menterjemahkan isi dari `title` dan tag `comment` yang terdapat di antara tag `information`. Judul adalah sesuatu yang akan muncul pada menu Kategori dari permainan (dimana pengguna memilih berkas untuk bermain)

3. Kemudian antara tag `identifier`, silakan tempatkan kode bahasa Anda selain en di `locale`.

   Mohon jangan menerjemahkan nama berkas karena nama berkas harus tidak memuat karakter khusus. Selanjutnya simpan berkas anda dengan nama berkas versi Bahasa Inggris yang sama.

4. Sunting berkas kvhtml dengan ditor teks (akan lebih mudah jika Anda menggunakan penyorotan sintaksis &XML;) dan ganti setiap kata di dalam tag `text` dengan kata terjemahan dan setiap petunjuk di dalam `comment` dengan terjemahannya. Tidak terlalu penting untuk mempertahankan makna yang tepat, tetapi cobalah untuk mempertahankan panjang dan kategori kesulitannya kira-kira sama.

   Anda dapat mengikutkan kata dengan spasi jarak atau - di dalamnya, jika demikian halnya spasi jarak atau - akan ditampilkan bukannya malah _. Silakan mengontak kde-edu mailinglist jika ada sesuatu yang khusus terkait bahasa Anda sehingga Saya dapat mengadopsi nya di dalam kode (khususnya karakter spesial dan aksen).

5. Anda dapat menerjemahkan hanya kata tetapi Anda juga dapat menyesuaikan dengan kategori dan menambah kata bru jika Anda mau. Sebagai contoh, table ada di dalam kategori mudah dalam Bahasa Inggris tetapi dalam bahasa Anda, bisa saja masuk kategori medium. Anda bebas untuk menyesuaikan berkas sesuai kebutuhan bahasa Anda. Jumlah kata dalam sebuah berkas tidaklah penting, Anda dapat menambahnya jika Anda mau.

   Ingatlah bahwa semua kata adalah kata benda.

6. Selanjutnya Anda dapat menyerahkan berkas anda di dalam l10n-kf5/<lang_code>/data/kdeedu/kdeedu-data/. Jangan lupa untuk memutakhirkan berkas CMakeLists.txt juga. Silakan menghubungi kde-edu mailinglist jika anda membutuhkan informasi lebih jauh. Jika Anda mengirimkan berkas, mohon jangan lupa untuk menyebutkan setiap karakter khusus yang digunakan dalam bahasa Anda (letakkan di dalam berkas txt, satu per baris dan tambahkan berkas ini dalam tarball) dan mohon sebutkan setiap kekhususannya.

   Mohon jangan pernah mengirim berkas dalam sebuah BRANCH karena dapat merusak permainan.

Terima kasih untuk kontribusi Anda!

### Apa yang disimpan oleh &khangman; dan dimana

Ketika Anda mendapatkan bahasa baru melalui Game Get Words in New Language..., data bahasa baru disimpan di dalam `$XDG_DATA_HOME/share/apps/kvtml/` pada folder kode bahasa. Nama direktori bahasa juga tersedia di dalam berkas pengaturan &khangman; pada `$XDG_DATA_HOME/share/config/khangmanrc`.

Nama penyedia (yaitu alamat situs web tempat mengunduh bahasa baru) disimpan di dalam `$XDG_DATA_DIRS/share/apps/khangman/khangmanrc`.

Bahasa Inggris (baku) dan bahasa pengguna dari paket i18n (jika tersedia) disimpan di dalam `$XDG_DATA_DIRS/share/apps/kvtml`.

Pada berkas konfigurasi, tempat penyimpanan untuk setiap pengguna dalam `$XDG_DATA_HOME/share/config/khangmanrc` menyimpan semua pengaturan permainan seperti latar belakang, kategori terakhir yang dimainkan, ... ditambah berkas yang diunduh dari dialog Dapatkan Hal Baru!.

## Pujian dan Lisensi

&khangman;

Hak cipta program 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

Kontributor:

- Grafik Hangman: Renaud Blanchard kisukuma@chez.com

- Suara: Ludovic Grossard ludovic.grossard@libertysurf.fr

- Mantan pemelihara: &Primoz.Anzur; &Primoz.Anzur.mail;

- Berkas data Bahasa Swedia, bantuan pemrograman, gambar transparan dan perbaikan i18n: Stefan Asserhäll stefan.asserhall@telia.com

- Berkas data Bahasa Spanyol: eXParTaKus expartakus@expartakus.com

- Data petunjuk Bahasa Spanyol: : Erik Kjaer Pedersen erik@mpim-bonn.mpg.de

- berkas data Bahasa Denmark: Erik Kjaer Pedersen erik@mpim-bonn.mpg.de

- Berkas data Bahasa Finlandia: Niko Lewman niko.lewman@edu.hel.fi

- Berkas data Bahasa Portugis Brasil: João Sebastião de Oliveira Bueno gwidion@mpc.com.br

- Berkas data Bahasa Katalan: Antoni Bella bella5@teleline.es

- Berkas data Bahasa Italia: Giovanni Venturi jumpyj@tiscali.it

- Berkas data Bahasa Belanda: Rinse rinse@kde.nl

- Berkas data Bahasa Portugis: Pedro Morais morais@kde.org

- Berkas data Bahasa Serbia (Cyrillic and Latin): Chusslove Illich chaslav@sezampro.yu

- Berkas data Bahasa Slovenia: Jure Repinc jlp@holodeck1.com

- Berkas data Bahasa Ceko: Lukáš Tinkl lukas@kde.org

- Berkas data Bahasa Tajik: Roger Kovacs rkovacs@khujand.org

- Berkas data Bahasa Norwegia (Bokmål): Torger Åge Sinnes torg-a-s@online.no

- Berkas data Bahasa Hungaria: Tamas Szanto tszanto@mol.hu

- Berkas data Bahasa Norwegia (Nynorsk): Gaute Hvoslef Kvalnes gaute@verdsveven.com

- Berkas data Bahasa Turki: Mehmet Özel mehmet_ozel2003@hotmail.com

- Berkas data Bahasa Bulgaria: Radostin Radnev radnev@yahoo.com

- Berkas data Bahasa Irlandia (Gaelic): Kevin Patrick Scannell scannell@slu.edu

- Bantuan pemrograman: &Robert.Gogolok; &Robert.Gogolok.mail;

- Bantuan pemrograman: Benjamin Meyer ben@meyerhome.net

- Perbaikan kode: Lubos Lunàk l.lunak@kde.org

- Perbaikan kode: Albert Astals Cid &Albert.Astals.Cid.mail;

- Studi usabilitas: Celeste Paul seele@obso1337.org

Hak cipta dokumentasi 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

Mohammad Edwinmedwinz@gmail.com

&underFDL; &underGPL;
&documentation.index;