[[TranslatedPages(revision=47)]] 
= Tagging (Label) Preset =
JOSM mendukung didistribusikannya pelabelan preset. Ini adalah file konfigurasi XML yang menggambarkan GUI untuk memasukkan label (atau properti, anotasi, biasanya disebut fitur peta). File-file XML dapat ditempatkan dimana saja di website atau di pengguna sistem file lokal. Preset dapat ditambahkan oleh pengguna di halaman utama.[wiki:Presets].


== Instal Preset ==
Buka [Help/Action/Preferences preferences window], klik [[JOSMImage(preferences/map,20)]] pengaturan peta dan pilih tab ketiga [Help/Preferences/Map#TaggingPresets "Tagging Presets"].

----

== Mengembangkan preset baru - Contoh ==

[[Image(tagging_screenshot.png,align=right)]]

{{{
#!xml 
<presets xmlns="http://josm.openstreetmap.de/tagging-preset-1.0">
  <item name="Highway">
    <label text="Inserting a highway in UK" />

    <text key="name" text="Highway (e.g. M3)" />
    <combo key="highway" text="Type" values="major,minor" />

    <!-- Highways are usually oneway -->
    <check key="oneway" text="Oneway" default="on" />

    <!-- Always setting class=highway -->
    <key key="class" value="highway" />
  </item>
</presets>
}}}


== Mengembangkan preset baru - Menambah daftar preset yang tersedia ==

Lihat [[Presets]].


== Menambah preset baru - Deskripsi format XML ==

Deskripsi pelabelan preset adalah dalam format XML yang sangat sederhana. 

Lihat bagian komentar di **[source:trunk/resources/data/defaultpresets.xml defaultpresets.xml]** untuk **format deskripsi yang berlaku**.

----

== Mengembangkan preset baru - Deskripsi format XML (Model lama!) ==

=== Tag (Label) ===
Dokumen prolog (pembuka) :
 '''<presets>'''::
   Harus menjadi tag utama dari file tersebut. Mendukung atribut berikut
   * '''xmlns="http://josm.openstreetmap.de/tagging-preset-1.0"'''
   * '''author''' - nama pencipta
   * '''version''' - versi file
   * '''description''' (i18n) - deskripsi isi file tersebut
   * '''shortdescription''' (i18n) - deskripsi gambaran singkat
   * '''link''' (i18n) - web link to further details
komentar:
 '''<!-- this is an example comment -->'''::
  Dokumen tersebut dapat berisi komentar yang dibuat.
Menu creation:
 '''<group>'''::
   Digunakan untuk kelompok item dalam sub menu. ''name'' yang dibutuhkan, ''icon'' adalah atribut pilihan.
 '''<item>'''::
   Setiap item adalah salah satu penjelasan set untuk memilih dari. ''name'' yang dibutuhkan, ''icon'' merupakan atribut pilihan.
 '''<separator/>'''::
   Masukan garis pemisah kedalam menu.
Buat intruksi untuk pengguna:
 '''<label>'''::
   Label merupakan teks statis untuk ditampilk. ''text'' merupakan atribut yang dibutuhkan.
 '''<optional>'''::
   Digunakan untuk mengelompokan beberapa elemen pilihan. Mungkin setara dengan <label text="Optional Attributes:"/>
 '''<space/>'''::
   Menambah beberapa ruang (di garis baru) dalam tampilan preset. Mungkin setara dengan <label text=" "/>
 '''<link>'''::
   Menentukan link web untuk fitur ini atau sesuatu yang lain dari penggunaan. Atribut ''href'' yang diperlukan.
Atribut masuk dan kotak dialog seleksi:
 '''<text>'''::
   Menegedit teks field untuk dimasukan ke setiap string secara bebas dari pengguna. ''key'' adalah wajib, ''text'', ''default'' dan ''required'' adalah opsional
 '''<combo>'''::
   Menampilkan beberapa pilihan combo box. ''key'' dan ''values'' adalah wajib dan ''text'', ''default'', ''editable'' dan ''required'' adalah opsional. JIka diedit benar (default), combo box juga dapat diedit seolah-olah mereka teks field (tambahan menu drop - down).  Non editable combo box hanya dapat berisi salah satu nilai-nilai yang ditentukan.

 '''<multiselect>'''::
   Menampilkan daftar dari nol atau lebih item yang dapat dipilih. ''key'' dan ''values'' adalah wajib, dan ''text'', ''default'', ''delimiter'', dan ''required'' adalah opsional. Nilai-nilai yang dipilih akan dipotong dengan pembatas yang ditentukan (default: semicolon) dan ditulis dengan nilai label. Jika nilai tag/label sudah  diatur ketika kotak dialog preset terbuka, multiselect mencoba menandai item yang sesuai dalam daftar pilih. Jika nilai tag/label tidak dapat diwakili oleh kombinasi pilhan dalam daftar, maka daftar akan dinonaktifkan sehingga pengguna tidak dapat mengubah nilai kustom dengan sengaja. Berbeda dengan elemen "combo", "multiselect" menunggu daftar nilai, deksripsi, dll dengan menggunakan pembatas yang sudah ditentukan, yaitu secara default Anda harus menggunakan tanda titik koma. Anda dapat menentukan pembatas delimiter="," kemudian koma juga akan digunakan dalam nilai tag/label.
 '''<check>'''::
   Sebuah kotak centang yang pengguna hanya dapat memilih atau membatalkan pilian. Atribut ''key'' dalah wajib. ''text'', ''default'' dan ''required'' adalah opsional.
Mengatur sepasang value key:
 '''<key>'''::
   Tag/label ini akan selalu menetapkan kunci untuk nilai tertentu. ''key'' akan diperlukan jika ''value'' ada, key akan  diatur. Jika atribut ''value'' dihapus, maka key akan terhapus.

=== Atribut ===
Atribut tag/label memiliki arti sebagai berikut:
 '''name="a_name"'''::
   Menentukan nama untuk suatu item. Nama ini akan digunakan dalam GUI untuk menampilkan pelabelan preset.
 '''name_context="context"'''::
   Konteks terjemahan untuk atribut nama untuk memisahkan kata-kata yang mirip dengan arti yang berbeda (tidak diperlukan untuk terjemahan dalam file).
 '''type="data_type"'''::
   Ketika ditetapkan, hanya objek dari jenis yang diberikan akan berubah sama sekali oleh pelabelan preset ini. Bisa berupa "node", "relation", "way", "closedway" atau setiap koma kombinasinya terpisahkan dari mereka.
 '''icon="iconname"'''::
   Sebuah nama ikon yang ada di dalam setiap ''classpath'' dalam subdirektori dari gambar / simbol. Anda dapat memasukkan ''plugin-jar'' yang juga menyediakan gambar-gambar. Gambar akan digunakan sebagai ikon untuk menampilkan dalam daftar pilihan dan ketika menambahkan preset ke toolbar. Ikon tersebut harus dalam ukuran kuadrat.
 '''key="some_key"'''::
   Ini menetapkan kunci properti yang akan dimodifikasi oleh item.
 '''text="Any text"'''::
   Sebuah deskripsi, yang akan ditampilkan sebelum (setelah dalam kasus <check>) elemen gui.
 '''text_context="context"'''::
   Konteks terjemahan untuk atribut nama untuk memisahkan kata-kata yang mirip dengan arti yang berbeda (tidak diperlukan untuk terjemahan dalam file).
 '''default="default_value"'''::
   Nilai default untuk item. Jika tidak ditentukan, nilai saat ini dari kunci dipilih sebagai default (bila ada).
 '''values="entry1,entry2,entry3"'''::
   Sebuah daftar entri (untuk kotak combo dan multiselect).Daftar ini harus dipisahkan oleh koma (untuk combo box) atau dengan pembatas yang ditentukan (untuk multiselect).Jika nilai berisi pembatas, pembatas tersebut dapat dikeluarkan dengan garis miring terbalik. Jika nilai berisi garis miring terbalik, itu juga harus dilepas dengan garis miring terbalik.
 '''values_context="context"'''::
   Konteks terjemahan untuk atribut nama untuk memisahkan kata-kata yang mirip dengan arti yang berbeda (tidak diperlukan untuk terjemahan dalam file).
 '''display_values="Entry1,Entry2,Entry3"'''::
   Sebuah daftar entri yang ditampilkan kepada pengguna, harus dengan jumlah yang sama, entri sebagai values dan '''editable''' harus salah atau belum ditentukan. Untuk karakter pembatas dan pelepas, lihat pernyataan di sini ''values''.
 '''value="foobar"'''::
   Menentukan nilai yang akan dimasukkan dalam <key> tag/label.
 '''value_on="foobar"'''::
   Menentukan nilai benar yang akan dimasukkan dalam <key> tag/label (standarnya adalah "yes").
 '''value_off="foobar"'''::
   Menentukan nilai salah yang akan dimasukkan dalam <key> tag/label (standarnya adalah "no").
 '''editable="false"'''::
   Kotak combo adalah ''read only'' (hanya dibaca), yang berarti bahwa pengguna hanya dapat memilih salah satu item dalam daftar. 
 '''use_last_as_default="true"'''::
   Untuk kotak combo atau kolom teks, nilai yang terakhir digunakan sebagai standar. Menggunakan "force" juga akan memberlakukan perilaku ini untuk objek yang sudah ditandai.
 '''rows="count"'''::
   Menentukan jumlah baris dalam entri multiselect.

Untuk mendukung terjemahan, semua elemen tekstual dapat digunakan dalam bentuk terjemahan. Contohnya "de.name" akan mewakili nama dukungan dalam bahasa Jerman yang termuat.

=== Penanganan Ikon ===
Terdapat 3 cara yang berbeda untuk to sumber ikon:

 * Ikon didistribusikan dengan JOSM dapat dimasukkan langsung dengan jalur (relatif terhadap direktori citra internal JOSM). Cari melalui [http://josm.openstreetmap.de/svn/trunk/data/defaultpresets.xml halaman ini] untuk nama ikon yang talah ada.
 * Ikon baru dapat langsung dirujuk menggunakan http-link. Ini download dan cache secara internal.
 * Sejak JOSM versi 2289 Zip-File telah didukung.
  * File zip harus mengandung setidaknya satu file dengan ekstensi xml.
  * Ikon nama dan jalur relatif untuk direktori zip teratas.
  * Jika ada multipel file XML, file dengan "preset" di dalam nama lebih diutamakan (untuk memungkinkan model kemasan dan preset dalam satu arsip).

== Lihat juga ==
* [/Presets]
* [wiki:Help/Preferences/Map#TaggingPresets Preferensi pelabelan preset]