[[TranslatedPages(revision=198)]]
[[PageOutline(2-10,Enhavtabelo)]]
''Se vi volas lerni instalajn paŝojn por antaŭagordoj, vidu [[JOSMImage(dialogs/propertiesdialog)]] [wikitr:/Help/Preferences/TaggingPresetPreference Etikedaj Antaŭagordoj] registri en [[JOSMImage(preference)]] [wikitr:/Help/Action/Preferences Preferoj]'' \\
''Se vi volas uzi antaŭagordojn aŭ bezonas kompletan referencon de antaŭagordoj, vidu [wikitr:/Presets Antaŭagordoj]''
----
= Etikedaj Antaŭagordoj =
JOSM subtenas distribuitajn etikedajn antaŭagordojn. Ĉi tio estas XML-agorda dosiero, kiu priskribas grafikan uzantinterfacon por enigi etikedojn (aŭ propraĵojn, anotaciojn, foje nomatajn mapaj trajtoj).
La antaŭagordoj povas esti metitaj ie ajn en la reto aŭ en la loka dosiersistemo de la uzanto. JOSM povas esti agordita por uzi proprajn lokajn aŭ forajn antaŭagordojn.
== Disvolvi novan antaŭagordon ==
La priskribo de la etikeda antaŭagordo estas en tre simpla XML-formato. Detaloj vidu [#XML sube].
Vidu la **[source:/trunk/resources/data/defaultpresets.xml defaultpresets.xml]** por ekzemplo kiu kovras la plejmultajn el la eblecoj listigitaj sube.
Ekzemplo:
[[Image(Change 1 object.png,right,link=,margin-left=15)]]
{{{
#!preset
}}}
\\
== XML-formata priskribo ==#XML
La plena XSD-skemo estas havebla ĉe la nomspaca URI (https://josm.openstreetmap.de/tagging-preset-1.0) same kiel [source:/trunk/resources/data/tagging-preset.xsd la fonta deponejo].
=== Etikedoj ===
==== La dokumenta prologo ====
::
Devas esti la ĉefa etikedo de la dosiero. Subtenas jenajn atributojn
* **xmlns="http://josm.openstreetmap.de/tagging-preset-1.0"**
* **author** - la nomo de la aŭtoro de la antaŭagordo
* **version** - la versia numero de la dosiero. Por aŭtomata versia ĝustigo de antaŭagordoj administritaj en ĉi tiu vikio, vi devas uzi du internajn variablojn: `[[revision]]` (la plej lasta versia numero de la vikia paĝo) kaj `[[date]]` (la dato de la lasta redakto), ekz. `version="1.[[revision]]_[[date]]"`.
* **description** (i18n) - priskribo pri kio enhavas la dosiero
* **shortdescription** (i18n) - tre mallonga superrigarda priskribo, ekz. la "nomo" de la antaŭagordo
* **link** (i18n) - retligilo al pliaj detaloj (laŭvola)
* **icon** - ikono por la tuta antaŭagordo
* **baselanguage** - kiam la baza lingvo ne estas la angla, specifu ĝin ĉi tie (uzante ne-anglajn antaŭagordajn tekstojn malhelpos aŭtomatan tradukon, kiam ĝi estos implementita (#11392))
(i18n) signifas ke la valoroj ankaŭ povas esti lokaligitaj (ekz. `de.description`).
\\
==== Komentoj ====
::
La dokumento povas enhavi enkorpigitajn komentojn.
\\
==== Kreo de antaŭagorda grupo ====
::
Uzata por grupigi erojn en submenioj. `name=""` estas postulata, `icon=""` estas laŭvola atributo.
::
Ĉiu ero estas unu anotacia aro por elekti. `name=""` estas postulata, `type=""` kaj `preset_name_label=""` estas rekomendataj, `icon=""`, `name_template=""` kaj `match_expression=""` estas laŭvolaj atributoj.
::
Enmetu linian apartigilon en la menuon.
\\
==== Antaŭagorda fenestra aranĝo ====
::
Etikedoj estas statikaj tekstoj por montri. `text=""` estas postulata atributo, `icon=""` kaj `icon_size=""` estas laŭvolaj.
::
Aldonu iom da spaco (ekz. novan linion).
::
Uzata por grupigi iujn laŭvolajn elementojn de ero. La `text=""` atributo estas laŭvola. Se uzata sen `text=""`, tiam ĉi tio estas ekvivalenta al ``
::
Aldonu horizontalan apartigilon inter eroj.
::
Specifu retligilon por ĉi tiu trajto aŭ al io alia utila. Aŭ la `wiki=""` (referencante al OSM-vikia paĝo, ekz. `"Tag:leisure=park"`) aŭ la `href=""` (plena URL) atributo estas postulata. Kiam la `wiki=""` atributo estas uzata, la ligilo indikas al la vikia paĝo de la lingvo, kiun JOSM estas agordita. Se ĝi ne ekzistas, la angla paĝo estas montrita. Se uzas `wiki=""`, la OSM-vikia paĝo ne devas esti URL-kodita, ekz., ĝi ne devas esti `"Tag:leisure%3Dpark"` kaj devas esti `"Tag:leisure=park"`.
::
Por grupigi kontrolojn. La `columns=""` atributo estas postulata.
::
Ĉi tio estas postulata ĉirkaŭ `` kaj aldonas la ĉapon ("Haveblaj roloj rolo nombro elementoj") al la tabelo, kiu estas generita de pluraj ``.
::
Por specifi eblajn rolojn de membroj en rilatoj. La `key=""` atributo estas postulata, `text=""`, `requisite=""`, `count=""`, `type=""`, `member_expression=""` kaj `regexp=""` estas laŭvolaj.
::
Aldonas ligilon al alia antaŭagordo kun etikedo supre. La `preset_name=""` atributo estas postulata, `text=""` por anstataŭigi la etikedon (defaŭlte estas `"Redaktu ankaŭ …"`) kaj `text_context=""` estas laŭvolaj. Vico de `` sen `text=""` aŭ identa `text=""` valoro estas grupigita sub unu etikedo. \\
**Atentu** pri antaŭagordoj kun identaj **`name=""`** ĉar ne estas antaŭvideble al kiu antaŭagordo la ligilo kondukos, vidu #12716. \\
Havante la saman etikedon en ambaŭ antaŭagordoj ne funkcias, vidu #18992. \\
Uzante `` en antaŭagordoj malfermitaj de [wikitr:/Help/Dialog/RelationEditor rilata redaktilo] produktas esceptojn, vidu #20044.
\\
==== Agordi fiksan ŝlosil-valoran paron ====
::
Ĉi tiu etikedo ĉiam agordos ŝlosilon al specifa valoro. `key=""` estas postulata kaj se `value=""` estas ĉeesta, la ŝlosilo estos agordita. Se `value=""` atributo estas preterlasita, la ŝlosilo estas forigita. La `match=""` atributo estas laŭvola.
\\
==== Enira kaj elekta dialogujoj por atributoj ====#EntrySelectionBoxes
::
Teksta redakta kampo por eniri iun ajn arbitran ĉenon de la uzanto. `key=""` estas deviga, `text=""`, `default=""`, `use_last_as_default=""`, `auto_increment=""`, `length=""`, `alternative_autocomplete_keys=""`, `match=""`, `icon=""` kaj `icon_size=""` (ambaŭ ekde r17605) estas laŭvolaj.
::
Montras plur-elektan kombobokson. `key=""` kaj `values=""` estas devigaj, `text=""`, `default=""`, `editable=""`, `delimiter=""`, `values_from=""`, `display_values=""`, `short_descriptions=""`, `use_last_as_default=""`, `values_searchable=""`, `length=""`, `values_no_i18n=""`, `values_sort=""`, `match=""`, `icon=""` kaj `icon_size=""` (ambaŭ ekde r17605) estas laŭvolaj.\\
Se `editable=""` estas `true` (defaŭlte), komboboksoj povas esti redaktitaj kvazaŭ ili estus tekstaj kampoj (aldone al la falmenuo). Ne-redakteblaj komboboksoj povas nur enhavi unu el la specifitaj valoroj.\\
Se la ŝlosilo estas `colour` aŭ `colour:*` aŭ `*:colour`, koloran antaŭrigardon kaj koloran elektilon estas aldonita dekstre (vidu #8352).
[=#multiselect]
::
Montras liston el kiu nul aŭ pli eroj povas esti elektitaj. `key=""` kaj `values=""` estas devigaj, kaj `text=""`, `default=""`, `delimiter=""`, `values_from=""`, `rows=""`, `display_values=""`, `short_descriptions=""`, `use_last_as_default=""`, `values_searchable=""`, `values_no_i18n=""`, `values_sort=""`, `match=""`, `icon=""` kaj `icon_size=""` (ambaŭ ekde r17605) estas laŭvolaj. La elektitaj valoroj estos kunligitaj kun la specifita apartigilo (defaŭlte: punktokomo, `;`) kaj skribitaj al la etikeda valoro. Se etikeda valoro jam estas agordita kiam la antaŭagorda dialogo estas malfermita, la `` provos marki la taŭgajn erojn en la listo kiel elektitaj. Se la etikeda valoro ne povas esti reprezentita de kombinaĵo de elektoj en la listo, tiam la listo estos malaktivigita por ke la uzanto ne povu hazarde anstataŭigi propran valoron. Kontraste al la `` elemento, la `` atendas ke la listo de valoroj, priskriboj ktp. uzu la specifitan apartigilon, t.e. defaŭlte vi devos uzi punktokomon. Vi povas specifi `delimiter=","` sed tiam ankaŭ komo estos uzata en la etikeda valoro.
::
Uzata en `` kaj ``. Plia informo vidu `short_descriptions=""`, [#short_description sube]. La atributoj estas `value=""`, `display_value=""`, `short_description=""`, `icon=""` kaj `icon_size=""`.
::
Markobutono, kiun la uzanto povas elekti, malelekti aŭ agordi kiel neagordita. La `key=""` atributo estas deviga. `text=""`, `default=""`, `match=""`, `value_on=""` , `value_off=""`, `disable_off=""`, `icon=""` kaj `icon_size=""` (ambaŭ ekde r15437) estas laŭvolaj.
\\
==== Ŝablonoj ====
::
Por difini ŝablonon de elementoj por posta (ripeta) uzo. La `id=""` atributo estas deviga.
::
Por inkluzivi antaŭe difinitan ŝablonon. La `ref=""` atributo estas deviga.
\\
=== Atributoj ===
La atributoj de la etikedoj havas la jenan signifon:
name="a_name"::
Specifi nomon por ero. Ĉi tiu nomo estos uzata en la grafika uzantinterfaco por montri la etikedan antaŭagordon.
name_context="context"::
Traduka kunteksto por name atributo por apartigi egalajn vortojn kun malsama signifo (ne postulata por en-dosieraj tradukoj).
type="data_type"::
Kiam specifita, nur objektoj de la donita tipo funkcios kun ĉi tiu etikeda antaŭagordo. Povas esti `"node"`, `"way"`, `"closedway"`, `"multipolygon"`, `"relation"` aŭ iu ajn komo-apartigita kombinaĵo de ili. Notu ke `"multipolygon"` ne estas inkluzivita en `"relation"`, do se la antaŭagordo devas apliki por multpoligonoj kaj aliaj rilataj tipoj, vi devas specifi ambaŭ: `"multipolygon,relation"`. Ankaŭ uzata en la `` etikedo por specifi kiuj objektaj tipoj estas permesitaj por specifa rilata membro.
icon="iconname"::
Nomo aŭ ligilo al ikono. La bildo estos uzata kiel ikono por montri en la elekta listo kaj kiam aldonante la antaŭagordon al la ilobreto. Ikono ankaŭ povas esti uzata en ``, ``, plus ĉiuj [#EntrySelectionBoxes atributaj eniraj kaj elektaj dialogujoj] (ekde r17605, antaŭe ĝi estis nur `` kaj ``). Ĝi estas metita antaŭ `` La ikono devas esti kvadrata laŭ grandeco. Vidu [wikitr:/Styles#Iconhandling Ikonmaneĝon] kiel ikonoj povas esti specifitaj.
icon_size="a number"::
La maksimuma grandeco de ikono en px. Se neniu valoro estas donita, defaŭlte estas 16 por `` kaj la defaŭlta ikona grandeco por `` (en `` kaj ``).
key="some_key"::
Ĉi tio specifas la propraĵan ŝlosilon, kiu estos modifita de la ero. En kazo de `` ĝi estas la rola nomo uzata en rilato.
text="Any text"::
La priskribo, kiu estos montrita antaŭ la grafika uzantinterfaca elemento, (en kazo de `` post la grafika uzantinterfaca elemento kaj la laŭvola ikono). Ankaŭ uzata por `