Hvis du vil lære installasjonssteg for forhåndsinnstillinger, se Tagging Forhåndsinnstillinger registrer i Innstillinger
Hvis du vil bruke forhåndsinnstillinger eller trenger fullstendig referanse av forhåndsinnstillinger, se Forhåndsinnstillinger

---

Tagging Forhåndsinnstillinger

JOSM støtter distribuerte tagging forhåndsinnstillinger. Dette er en XML-konfigurasjonsfil som beskriver et GUI for å legge inn tags (eller egenskaper, annotasjoner, noen ganger kalt kartfunksjoner).

Forhåndsinnstillingene kan plasseres hvor som helst på nettet eller på brukerens lokale filsystem. JOSM kan konfigureres til å bruke egendefinerte lokale eller eksterne forhåndsinnstillinger.

Utvikle en ny forhåndsinnstilling

Beskrivelsen av tagging forhåndsinnstillingen er i et veldig enkelt XML-format. Detaljer se nedenfor.

Se defaultpresets.xml​ for et eksempel som dekker de fleste av mulighetene listet nedenfor.

Eksempel:

<?xml version="1.0" encoding="UTF-8"?>
<presets xmlns="http://josm.openstreetmap.de/tagging-preset-1.0">
  <item name="Enveiskjøring" type="way">
    <label text="Setter inn en enveiskjøring" />

    <combo key="highway" text="Type" values="motorvei,riksvei" />
    <text key="name" text="Navn (f.eks. Angel Road)" />
    <text key="ref" text="Ref (f.eks. A406)" />

    <!-- Dette er en enveiskjørings forhåndsinnstilling, så gjør enveiskjøring standard -->
    <check key="oneway" text="Enveiskjøring" default="on" />

    <!-- Alltid sett asfalt overflate -->
    <key key="surface" value="asphalt" />
  </item>
</presets>

Nb:TaggingPresets-preset.xml, Nb:TaggingPresets.zip

XML-format beskrivelse

Den fulle XSD-skjemaet er tilgjengelig på navneområde-URI-en (https://josm.openstreetmap.de/tagging-preset-1.0) samt kilde-depotet​.

Tagger

Dokumentprologen

<presets>

Må være hovedtaggen i filen. Støtter følgende attributter

• xmlns="​http://josm.openstreetmap.de/tagging-preset-1.0"
• author - navnet på forfatteren av forhåndsinnstillingen
• version - versjonsnummeret til filen. For automatisk versjonsjustering av forhåndsinnstillinger som administreres i denne wikien, må du bruke to interne variabler: [[revision]] (den siste versjonsnummeret av wikisiden) og [[date]] (datoen for siste redigering), f.eks. version="1.[[revision]]_[[date]]".
• description (i18n) - beskrivelse av hva filen inneholder
• shortdescription (i18n) - veldig kort oversiktsbeskrivelse, f.eks. "navnet" på forhåndsinnstillingen
• link (i18n) - nettlenke til flere detaljer (valgfri)
• icon - ikon for hele forhåndsinnstillingen
• baselanguage - når grunnspråket ikke er engelsk, spesifiser det her (bruk av ikke-engelske forhåndsinnstillingstekster vil forhindre automatisk oversettelse når det implementeres (#11392))

(i18n) betyr at verdiene også kan være lokalisert (f.eks. de.description).

Kommentarer

<!-- dette er en eksempelkommentar -->

Dokumentet kan inneholde innebygde kommentarer.

Opprettelse av forhåndsinnstillingsgruppe

<group>

Brukes til å gruppere elementer i undermenyer. name="" er påkrevd, icon="" er valgfri attributt.

<item>

Hvert element er ett annotasjonssett å velge fra. name="" er påkrevd, type="" og preset_name_label="" er anbefalt, icon="", name_template="" og match_expression="" er valgfrie attributter.

<separator />

Sett inn en linjeseparator i menyen.

Oppsett av forhåndsinnstillingsvindu

<label />

Etiketter er statiske tekster for visning. text="" er en påkrevd attributt, icon="" og icon_size="" er valgfrie.

<space />

Legg til litt plass (f.eks. en ny linje).

<optional>

Brukes til å gruppere noen valgfrie elementer av et element. text="" attributtet er valgfri. Hvis brukt uten text="" er dette ekvivalent med <space /><label text="Valgfrie Attributter:" /><space />

<item_separator />

Legg til en horisontal separatorlinje mellom elementer.

<link />

Spesifiser en nettlenke for denne funksjonen eller til noe annet nyttig. Enten wiki="" (refererer til en OSM-wiki-side, f.eks. "Tag:leisure=park") eller href="" (full URL) attributt er påkrevd. Når wiki="" attributtet brukes, peker lenken til wikisiden for språket JOSM er satt til. Hvis den ikke eksisterer, vises den engelske siden. Hvis du bruker wiki="", må OSM-wiki-siden ikke være URL-kodet, f.eks., den må ikke være "Tag:leisure%3Dpark" og må i stedet være "Tag:leisure=park".

<checkgroup>

For å gruppere avkrysninger. columns="" attributtet er påkrevd.

<roles>

Dette er påkrevd rundt <role /> og legger til overskriften ("Tilgjengelige roller rolleantall elementer") til tabellen som genereres av flere <role />.

<role />

For å spesifisere mulige roller for medlemmer i relasjoner. key="" attributtet er påkrevd, text="", requisite="", count="", type="", member_expression="" og regexp="" er valgfrie.

<preset_link />

Legger til en lenke til en annen forhåndsinnstilling med en etikette på toppen. preset_name="" attributtet er påkrevd, text="" for å overstyre etiketten (standard er "Rediger også …") og text_context="" er valgfrie. En sekvens av <preset_link /> uten text="" eller en identisk text="" verdi grupperes under en etikette.
Vær oppmerksom på forhåndsinnstillinger med identiske name="" da det ikke er forutsigbart hvilken forhåndsinnstilling lenken vil lede til, se #12716.
Å ha samme tagg i begge forhåndsinnstillinger fungerer ikke, se #18992.
Bruk av <preset_link /> i forhåndsinnstillinger åpnet fra relasjonsredigering gir unntak, se #20044.

Sett et fast nøkkel-verdi-par

<key />

Denne taggen vil alltid sette en nøkkel til en spesifikk verdi. key="" er påkrevd og hvis value="" er til stede, vil nøkkelen bli satt. Hvis value="" attributtet utelates, fjernes nøkkelen. match="" attributtet er valgfri.

Attributtinngangs- og valgdialogbokser

<text />

Et tekstredigeringsfelt for å legge inn en vilkårlig streng fra brukeren. key="" er obligatorisk, text="", default="", use_last_as_default="", auto_increment="", length="", alternative_autocomplete_keys="", match="", icon="" og icon_size="" (begge siden r17605) er valgfrie.

<combo />

Viser en flervalgskomboboks. key="" og values="" er obligatoriske, text="", default="", editable="", delimiter="", values_from="", display_values="", short_descriptions="", use_last_as_default="", values_searchable="", length="", values_no_i18n="", values_sort="", match="", icon="" og icon_size="" (begge siden r17605) er valgfrie.
Hvis editable="" er true (standard), kan kombobokser redigeres som om de var tekstfelt (i tillegg til rullegardinmenyen). Ikke-redigerbare kombobokser kan bare inneholde en av de spesifiserte verdiene.
Hvis nøkkelen er colour eller colour:* eller *:colour, legges en fargeforhåndsvisning og fargevelger til på høyre side (se #8352).

<multiselect />

Viser en liste der null eller flere elementer kan velges. key="" og values="" er obligatoriske, og text="", default="", delimiter="", values_from="", rows="", display_values="", short_descriptions="", use_last_as_default="", values_searchable="", values_no_i18n="", values_sort="", match="", icon="" og icon_size="" (begge siden r17605) er valgfrie. De valgte verdiene vil bli sammenkoblet med den spesifiserte separator (standard: semikolon, ;) og skrevet til taggverdien. Hvis en taggverdi allerede er satt når forhåndsinnstillingsdialogen åpnes, vil <multiselect /> forsøke å markere de aktuelle elementene i listen som valgt. Hvis taggverdien ikke kan representeres av en kombinasjon av valg i listen, vil listen deaktiveres slik at brukeren ikke ved et uhell kan overskrive en egendefinert verdi. I motsetning til <combo />-elementet, forventer <multiselect /> at verdilisten, beskrivelser osv. bruker den spesifiserte separator, dvs. standard må du bruke semikolon. Du kan spesifisere delimiter="," men da vil komma også bli brukt i taggverdien.

<list_entry />

Brukes i <combo> og <multiselect>. Mer informasjon se short_descriptions="", nedenfor. Attributtene er value="", display_value="", short_description="", icon="" og icon_size="".

<check />

En avkrysningsboks som brukeren kan velge, fjerne eller sette som uavklart. key="" attributtet er obligatorisk. text="", default="", match="", value_on="" , value_off="", disable_off="", icon="" og icon_size="" (begge siden r15437) er valgfrie.

Maler

<chunk>

For å definere en mal av elementer for senere (gjentatt) bruk. id="" attributtet er obligatorisk.

<reference>

For å inkludere en tidligere definert mal. ref="" attributtet er obligatorisk.

Attributter

Attributtene til taggene har følgende betydning:

name="a_name"

Spesifiser et navn for et element. Dette navnet vil bli brukt i GUI-et for å vise tagging forhåndsinnstillingen.

name_context="context"

Oversettelseskontekst for name-attributt for å skille like ord med forskjellig betydning (ikke påkrevd for in-file oversettelser).

type="data_type"

Når spesifisert, vil bare objekter av den gitte typen fungere med denne tagging forhåndsinnstillingen. Kan være "node", "way", "closedway", "multipolygon", "relation" eller enhver kommaseparert kombinasjon av dem. Merk at "multipolygon" ikke er inkludert i "relation", så hvis forhåndsinnstillingen skal gjelde for multipolygoner og andre relasjonstyper, må du spesifisere begge: "multipolygon,relation". Også brukt i <role>-taggen for å spesifisere hvilke objekttyper som er tillatt for et spesifikt relasjonsmedlem.

icon="iconname"

Et navn eller en lenke til et ikon. Bildet vil bli brukt som ikon for å vise i valglisten og når forhåndsinnstillingen legges til i verktøylinjen. Ikoner kan også brukes i <item>, <label />, pluss alle attributtinngangs- og valgdialogbokser (siden r17605, før var det bare <list_entry /> og <check />). Det plasseres foran <text /> Ikonet bør være kvadratisk i størrelse. Se Ikonhåndtering hvordan ikoner kan spesifiseres.

icon_size="a number"

Den maksimale størrelsen på et ikon i px. Hvis ingen verdi er gitt, er standard 16 for <label /> og standard ikonstørrelse for <list_entry /> (i <combo> og <multiselect>).

key="some_key"

Dette spesifiserer egenskapsnøkkelen som vil bli endret av elementet. I tilfelle <role> er det rollenavnet som brukes i en relasjon.

text="Any text"

Beskrivelsen som vil vises før GUI-elementet, (i tilfelle <check /> etter GUI-elementet og det valgfrie ikonet). Også brukt for <label> og <optional>.

text_context="context"

Oversettelseskontekst for text-attributt for å skille like ord med forskjellig betydning (ikke påkrevd for in-file oversettelser).

default="default_value"

En eksplisitt deklarert standardverdi for elementet. Denne verdien er bare brukt gjennom en forhåndsinnstilling når objektet forhåndsinnstillingen brukes på har null nøkler. Hvis ingen verdi for standard er spesifisert, blir ingen verdi satt til nøkkelen. Brukes i <check />, <text />, <combo /> og <multiselect />. For <check /> er bare verdiene "on" og "off" gyldige.

values="entry1,entry2,entry3"

En liste over oppføringer (for <combo />-boksen og <multiselect />). Listen må være separert med komma (for komboboksen) eller med den spesifiserte separator (for multiselect). Hvis en verdi inneholder separator, kan separator unnslippes med en omvendt skråstrek. Hvis en verdi inneholder en omvendt skråstrek, må den også unnslippes med en omvendt skråstrek.

values_from="JAVA code"

Brukes i stedet for values="" hvis verdilisten må hentes med en Java-metode av denne formen: public static String[] getValues(); Verdien må være: "full.pakke.navn.KlasseNavn#metodeNavn".

values_no_i18n="true|false"

Deaktiverer internasjonalisering for verdier for å unngå feil, se #11696. Standard er "false". Brukes i <combo /> og <multiselect />. (Nyttig f.eks. for nøkler opening hours eller brand.) Ikke nødvendig med nøkler med bare tall som verdier som layer eller level som allerede er ekskludert fra oversettelse.

values_sort="true|false"

Verdier av <combo /> og <multiselect /> er sortert alfabetisk på alle språk. Med dette attributtet kan du deaktivere den alfabetiske sorteringen hvis verdiene skal beholde den gitte rekkefølgen, se #5509 og #11926. (I den interne JOSM-forhåndsinnstillingen brukes dette f.eks. for nøklene tracktype, direction, network, smoothness, visibility eller trail_visibility.) Standard er "true".
Brukere kan globalt deaktivere sortering med preferansenøkkelen taggingpreset.sortvalues.

values_context="context"

Oversettelseskontekst for values-attributt for å skille like ord med forskjellig betydning (ikke påkrevd for in-file oversettelser).

display_values="Entry1,Entry2,Entry3"

En liste over oppføringer som vises til brukeren. Må ha samme antall og rekkefølge av oppføringer som values="" og editable="" må være "false" eller ikke spesifisert. For separator-tegnet og unnslipping, se merknadene ved values="". Brukes i <combo /> og <multiselect />.

value="foobar"

Spesifiser en verdi som skal legges inn i <key>-taggen.

value_on="foobar"

Spesifiser den sanne verdien som skal legges inn i <key>-taggen til en avkrysset <check /> (standard er "yes").

value_off="foobar"

Spesifiser den falske verdien som skal legges inn i <key>-taggen til en uavkrysset <check /> (standard er "no").

disable_off="true"

Om av-verdien til en <check /> er deaktivert i dialogen, dvs. bare uavklart eller "yes" er tilgjengelig.

editable="false"

Komboboksen er skrivebeskyttet, noe som betyr at brukeren bare kan velge et element i listen. Standard er "true", noe som betyr at brukeren kan legge til andre verdier som tekst. (Funksjonen fungerte ikke riktig i lang tid, men skal fungere igjen siden r18221, se #6157.)

use_last_as_default="true|false|force"

For <combo />, <multiselect /> eller <text />-felt brukes den sist brukte verdien som standard. Ved å bruke "force" tvinges denne oppførselen også for allerede taggete objekter. Standard er "false".

rows="count"

Spesifiser antall rader som skal vises i <multiselect />-oppføringen (hvis ikke satt, bestemmes det automatisk av java eller utseendet og følelsen og resulterer f.eks. i 8).

name_template="template", name_template_filter="search expression"

Egendefinert navnformatering for OSM-primitiver som matcher denne forhåndsinnstillingen. Se navnmal detaljer nedenfor.

match="none|key|key!|keyvalue|keyvalue!"

Lar deg endre matcheprosessen, dvs. bestemme om taggene til et OSM-objekt passer til denne forhåndsinnstillingen. Hvis en forhåndsinnstilling passer, kobles den i Tags/Medlemskap-dialogen.

• none: nøytral, dvs. ikke vurdere dette elementet for matching
• key: positiv hvis nøkkel matcher, nøytral ellers
• key!: positiv hvis nøkkel matcher, negativ ellers
• keyvalue: positiv hvis nøkkel og verdi matcher, nøytral ellers
• keyvalue!: positiv hvis nøkkel og verdi matcher, negativ ellers
  

Merk: For en match kreves minst én positiv og ingen negative. Standard er "keyvalue!" for <key> og "none" for <text />, <combo />, <multiselect /> og <check />.

match_expression="search expression"

ytterligere kriterier for å matche primitiver, spesifisert i JOSM-søk syntaks. (siden r17662)
Anførselstegn (") må skrives som ".
For eksempel, en forhåndsinnstilling med match_expression="foo=bar" krever at OSM-objekter har taggen foo=bar. Du kan ønske å bruke match_expression="" for å ekskludere visse OSM-objekter, f.eks. når en mer spesifikk forhåndsinnstilling er til stede.

id="unique_identifier"

den unike identifikatoren for denne <chunk>

ref="unique_identifier"

den unike identifikatoren til den (allerede definerte) malen som skal inkluderes

columns="a number"

antall kolonner av grupperte <check />

requisite="optional|required"

Om et relasjonsmedlem er valgfritt eller påkrevd. Standard er "optional".

count="a number"

Hvor ofte kan en rolle forekomme (hvis ikke gitt, antas ubegrenset antall)

member_expression="search expression"

et uttrykk, i JOSM-søk syntaks, for objekter av denne rollen
Anførselstegn (") må skrives som ".

regexp="true"

satt til "true" hvis nøkkelen til en rolle er et regulært uttrykk.
Dette tillater variable roller f.eks. <role key="level_-?\d+" text="Bygningsnivå" regexp="true" requisite="optional" type="relation" /> tillater rollene level_0, level_1,...

preset_name="exact_name"

Det eksakte navnet på forhåndsinnstillingen som skal lenkes til.

preset_name_label="false|true"

Om du skal sette inn "[forhåndsinnstillingsnavn]" etikett i dialog (standard er "false" for bakoverkompatibilitet på eksterne forhåndsinnstillinger).

length="a number"

Lengden på et <text /> eller <combo />-boks (antall tillatte tegn).

alternative_autocomplete_keys="some_key(s)"

En kommaseparert liste over alternative nøkler for automatisk komplettering av <text>.

auto_increment="-2,-1,+1,+2"

Kan inneholde en kommaseparert liste over heltallsøkninger eller -reduksjoner, f.eks. "-2,-1,+1,+2". En knapp vil vises ved siden av <text />-feltet for hver verdi, slik at brukeren kan velge automatisk økning med det gitte trinnet. Automatisk økning skjer bare hvis brukeren velger det. Det er også en knapp for å fjerne automatisk økning. Standard er ingen automatisk økning. Gjensidig utelukkende med use_last_as_default="".

delimiter="special character"

Tegnet som skiller verdier. I tilfelle <combo /> er standard komma (,). I tilfelle <multiselect /> er standard semikolon (;) og dette vil også brukes til å skille valgte verdier i taggen. Mer informasjon se <multiselect />, ovenfor.

short_descriptions="Entry1,Entry2,Entry3"

En separator-separert liste over tekster som skal vises under hver display_value="". (Bare hvis det ikke er mulig å beskrive oppføringen i 2-3 ord.) I stedet for en kommaseparert liste ved bruk av values="", display_values="" og short_descriptions="", støttes også følgende form:
<list_entry value="" display_value="" short_description="" icon="" icon_size="" />

values_searchable="true|false"

Om du skal søke i values="" og display_values="", henholdsvis value="" og display_value="" av <combo /> eller <multiselect /> for å søke etter forhåndsinnstillinger.

value_template="template"

En mal for å generere verdien automatisk basert på andre taggverdier av objektet. Samme syntaks som i name_template="" brukes, se nedenfor. (siden r17639)
For eksempel, "Buss {ref}: {from} → {to}" kan brukes til å generere navnet på en bussruterelasjon.
Merk: Det er noen mindre problemer med dette attributtet, se #20851 og #20861.

name_template og value_template detaljer

Navnmaler kan brukes til å definere egendefinert formatering for OSM-primitiver eller GPX-veipunkter (for eksempel i Relasjoner eller Valg-panelet).

<?xml version="1.0" encoding="UTF-8"?>
<presets>
        <item name="Offentlig transport" type="relation"
                name_template="Buss({operator} {ref} ?{'{from} - {via} - {to}' | '{from} - {to}' | '{from}' | '{to}'})"
                name_template_filter="type=route route=bus">
        </item>
</presets>

Eksempler

Mal	Tagger	Resultat
Husnummer {addr:housenumber}	addr:housenumber=10	Husnummer 10
?{ 'Husnummer {addr:housenumber} på {addr:street}' | 'Husnummer {addr:housenumber}' }	addr:housenumber=10	Husnummer 10
	addr:housenumber=10 addr:street=Abbey road	Husnummer 10 på Abbey road
?{ admin_level = 2 'NUTS 1' | admin_level = 4 'NUTS 2' | admin_level = 6 'NUTS 3' | 'Adminnivå {admin_level}'}	admin_level=4	NUTS 2
	admin_level=5	Adminnivå 5
{admin_level} - {name} !{parent() type=boundary '?{'(del av {admin_level} - {name})' | ''}'}	admin_level=6 name=Vysocina, medlem av relasjon admin_level=4 name=Jihovychod	6 - Vysocina (del av 4 - Jihovychod)
	admin_level=2 name=Czech republic (ingen foreldre)	2 - Czech republic

Syntaks

• {tag} - sett inn verdien av taggen.
• ?{condition1 'value1' | condition2 'value2' | 'value3'} - bruk value1 hvis condition1 er oppfylt, ellers bruk value2 hvis condition2 er oppfylt, til slutt bruk value3 hvis ingen betingelse er oppfylt. Betingelse kan være enten eksplisitt - i JOSM-søk syntaks - eller implisitt: Verdien brukes når alle tagger referert til inne eksisterer.
• !{search_expression 'template'} - search_expression evalueres og første matchende primitiv brukes som kontekst for mal. Nyttig for eksempel for å få tagger av overordnet relasjon.
• \ - bruk en omvendt skråstrek for å unnslippe spesialtegn '{', '}', '?', '!'. F.eks. Hva er dette\? Det er en {type}\!.

Tilgjengelige verdier

For formatering av OSM-primitiver kan verdien av hvilken som helst tagg brukes. Bruk taggen {special:everything} for å vise alle tilgjengelige tagger, f.eks. på dine GPX-veipunkter.

Du kan også bruke disse virtuelle taggene:

• {special:everything} skriver ut alle tilgjengelige verdier, tilgjengelig for formatering av både primitiver og veipunkter.
• {special:id} skriver ut ID-en til OSM-primitivet.
• {special:localName} skriver ut det lokaliserte navnet, det vil si verdien av name:lang for ditt språk hvis det er tilgjengelig, eller verdien av name hvis det ikke er det.

Foreldede Attributter

Følgende attributter er foreldet og støttes ikke lenger av JOSM:

delete_if_empty="true"

ble fjernet i r5155. Du kan ganske enkelt fjerne dette attributtet hvis det fortsatt brukes i din forhåndsinnstilling.

required="true"

erstattet av match="" siden r5155

Oversettelse

For å støtte oversettelser, kan alle tekstlige elementer (name="", text="", display_values="") lokaliseres. F.eks. de.name="" vil representere navnet når tysk språkstøtte er lastet. I forhåndsinnstillings-XML-koden må det engelske begrepet være det første, før mulige oversettelser kan legges til.

Intern Forhåndsinnstilling

Oversettelsen for den interne forhåndsinnstillingen gjøres på ​Launchpad.

I den interne forhåndsinnstillingen​, er alle name="", text="" og display_values="" oversatt via tjenesten ovenfor, så lenge ingen spesifikk oversettelse er gitt i XML-filen. Når ingen display_values="" er levert, vil values="" bli behandlet som display_values="" og oversatt i stedet.

Når det samme engelske ordet har forskjellige oversettelser i forskjellige kontekster, må den spesifikke oversettelseskonteksten spesifiseres. Bruk name_context="", text_context="" eller values_context="" for dette formålet. Konteksten bør være en meningsfull kort beskrivelse for å hjelpe oversettere.

Eksterne Forhåndsinnstillinger

Oversettelsen av eksterne forhåndsinnstillinger på dette nettstedet er, så langt, bare mulig inline i forhåndsinnstillings-XML-kildekoden, se #11392.

Forhåndsinnstillinger som ligger andre steder kan også legge til en data-katalog med JOSM-stil .lang-filer for oversettelse (som i JOSM selv eller plugins).

Men når ord brukes i den eksterne forhåndsinnstillingen som allerede finnes i den interne forhåndsinnstillingen, gjelder oversettelsen fra den interne forhåndsinnstillingen også for den eksterne. Dette er nyttig så lenge konteksten er den samme. Når konteksten i den eksterne forhåndsinnstillingen er forskjellig, må den skilles ved å legge til name_context="", text_context="" eller values_context="".

Ikonhåndtering

Se Stiler.

Se også

• Forhåndsinnstillinger meny