wiki:El:TaggingPresets

Αν θέλετε να μάθετε τα βήματα εγκατάστασης για προεπιλογές, δείτε την καταχώρηση source:trunk/resources/images/dialogs/propertiesdialog.svg Προεπιλογές Ετικετών στις source:trunk/resources/images/preference.svg Προτιμήσεις
Αν θέλετε να χρησιμοποιήσετε προεπιλογές ή χρειάζεστε πλήρη αναφορά των προεπιλογών, δείτε τις Προεπιλογές


Προεπιλογές Ετικετών

Το JOSM υποστηρίζει κατανεμημένες προεπιλογές ετικετών. Αυτό είναι ένα αρχείο ρυθμίσεων XML που περιγράφει ένα γραφικό περιβάλλον χρήστη (GUI) για την εισαγωγή ετικετών (ή ιδιοτήτων, σχολιασμών, που μερικές φορές ονομάζονται χαρακτηριστικά χάρτη).

Οι προεπιλογές μπορούν να τοποθετηθούν οπουδήποτε στον ιστό ή στο τοπικό σύστημα αρχείων του χρήστη. Το JOSM μπορεί να ρυθμιστεί ώστε να χρησιμοποιεί προσαρμοσμένες τοπικές ή απομακρυσμένες Προεπιλογές.

Ανάπτυξη μιας νέας προεπιλογής

Η περιγραφή της προεπιλογής ετικετών είναι σε πολύ απλή μορφή XML. Δείτε λεπτομέρειες παρακάτω.

Δείτε το defaultpresets.xml για ένα παράδειγμα που καλύπτει τις περισσότερες από τις δυνατότητες που αναφέρονται παρακάτω.

Παράδειγμα:

<?xml version="1.0" encoding="UTF-8"?>
<presets xmlns="http://josm.openstreetmap.de/tagging-preset-1.0">
  <item name="Oneway highway" type="way">
    <label text="Inserting a unidirectional highway" />

    <combo key="highway" text="Type" values="trunk,motorway" />
    <text key="name" text="Name (e.g. Angel Road)" />
    <text key="ref" text="Ref (e.g. A406)" />

    <!-- Αυτή είναι μια προεπιλογή μονής κατεύθυνσης, επομένως ορίστε τη μονή κατεύθυνση ως προεπιλογή -->
    <check key="oneway" text="Oneway" default="on" />

    <!-- Πάντα να ορίζετε την επιφάνεια ως άσφαλτο -->
    <key key="surface" value="asphalt" />
  </item>
</presets>

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


Περιγραφή μορφής XML

Το πλήρες σχήμα XSD είναι διαθέσιμο στο URI του χώρου ονομάτων (https://josm.openstreetmap.de/tagging-preset-1.0) καθώς και στο the αποθετήριο πηγαίου κώδικα.

Ετικέτες

Ο πρόλογος του εγγράφου

<presets>
Πρέπει να είναι η κύρια ετικέτα του αρχείου. Υποστηρίζει τα ακόλουθα χαρακτηριστικά
  • xmlns="http://josm.openstreetmap.de/tagging-preset-1.0"
  • author - το όνομα του δημιουργού της προεπιλογής
  • version - ο αριθμός έκδοσης του αρχείου. Για αυτόματη προσαρμογή της έκδοσης προεπιλογών που διαχειρίζονται σε αυτό το wiki, πρέπει να χρησιμοποιήσετε δύο εσωτερικές μεταβλητές: [[revision]] (ο πιο πρόσφατος αριθμός έκδοσης της σελίδας wiki) και [[date]] (η ημερομηνία της τελευταίας επεξεργασίας), π.χ. version="1.[[revision]]_[[date]]".
  • description (i18n) - περιγραφή του τι περιέχει το αρχείο
  • shortdescription (i18n) - πολύ σύντομη περιγραφή, δηλαδή το "name" της προεπιλογής
  • link (i18n) - σύνδεσμος ιστού για περισσότερες λεπτομέρειες (προαιρετικό)
  • icon - εικονίδιο για ολόκληρη την προεπιλογή
  • baselanguage - όταν η βασική γλώσσα δεν είναι τα Αγγλικά, καθορίστε την εδώ (η χρήση μη αγγλικών κειμένων προεπιλογής θα αποτρέψει την αυτόματη μετάφραση, όταν υλοποιηθεί (#11392))

(i18n) σημαίνει ότι οι τιμές ενδέχεται επίσης να είναι μεταφρασμένες (π.χ. de.description).


Σχόλια

<!-- αυτό είναι ένα παράδειγμα σχολίου -->
Το έγγραφο μπορεί να περιέχει ενσωματωμένα σχόλια.


Δημιουργία ομάδας προεπιλογών

<group>
Χρησιμοποιείται για την ομαδοποίηση στοιχείων σε υπομενού. Το name="" είναι υποχρεωτικό, το icon="" είναι προαιρετικό γνώρισμα.
<item>
Κάθε στοιχείο είναι ένα σύνολο σχολίων για επιλογή. Το name="" είναι υποχρεωτικό, τα type="" και preset_name_label="" είναι προτεινόμενα, ενώ τα icon="", name_template="" και match_expression="" είναι προαιρετικά γνωρίσματα.
<separator />
Εισαγωγή γραμμής διαχωρισμού στο μενού.


Διάταξη παραθύρου προεπιλογών

<label />
Οι ετικέτες είναι στατικά κείμενα για εμφάνιση. Το text="" είναι υποχρεωτικό χαρακτηριστικό, ενώ τα icon="" και icon_size="" είναι προαιρετικά.
<space />
Προσθήκη κενού χώρου (π.χ. νέα γραμμή).
<optional>
Χρησιμοποιείται για την ομαδοποίηση ορισμένων προαιρετικών στοιχείων ενός αντικειμένου. Το χαρακτηριστικό text="" είναι προαιρετικό. Αν χρησιμοποιηθεί χωρίς το text="" τότε αυτό ισοδυναμεί με: <space /><label text="Optional Attributes:" /><space />
<item_separator />
Προσθήκη οριζόντιας γραμμής διαχωρισμού μεταξύ αντικειμένων.
<link />
Καθορίστε έναν σύνδεσμο ιστού για αυτό το χαρακτηριστικό ή για οτιδήποτε άλλο χρήσιμο. Απαιτείται είτε το χαρακτηριστικό wiki="" (που αναφέρεται σε σελίδα του OSM wiki, π.χ. "Tag:leisure=park") είτε το χαρακτηριστικό href="" (πλήρες URL). Όταν χρησιμοποιείται το χαρακτηριστικό wiki="" ο σύνδεσμος οδηγεί στη σελίδα του wiki στη γλώσσα στην οποία έχει ρυθμιστεί το JOSM. Αν δεν υπάρχει, εμφανίζεται η αγγλική σελίδα. Εάν χρησιμοποιείτε wiki="", η σελίδα wiki OSM δεν πρέπει να έχει κωδικοποίηση URL, π.χ., δεν πρέπει να είναι "Tag:leisure%3Dpark" και πρέπει αντ' αυτού να είναι "Tag:leisure=park".
<checkgroup>
Για την ομαδοποίηση ελέγχων. Το χαρακτηριστικό columns="" είναι υποχρεωτικό.
<roles>
Αυτό απαιτείται γύρω από το <role /> και προσθέτει την επικεφαλίδα ("Διαθέσιμοι ρόλοι στοιχεία αριθμού ρόλων") στον πίνακα που δημιουργείται από πολλά <role />.
<role />
Για τον καθορισμό των πιθανών ρόλων των μελών σε σχέσεις. Το χαρακτηριστικό key="" είναι υποχρεωτικό, ενώ τα text="", requisite="", count="", type="", member_expression="" και regexp="" είναι προαιρετικά.
<preset_link />
Προσθέτει έναν σύνδεσμο σε άλλη προεπιλογή με μια ετικέτα στην κορυφή. Το χαρακτηριστικό preset_name="" είναι υποχρεωτικό. Το χαρακτηριστικό text="" για την επικάλυψη της ετικέτας (η προεπιλογή είναι "Edit also …") και το text_context="" είναι προαιρετικό. Μια ακολουθία από <preset_link /> χωρίς text="" ή με ίδια τιμή στο text="" ομαδοποιείται κάτω από μία ετικέτα.
Προσοχή Για προεπιλογές με ίδιο name="" δεν είναι προβλέψιμο σε ποια προεπιλογή θα οδηγήσει ο σύνδεσμος, δείτε το #12716.
Η ύπαρξη της ίδιας ετικέτας και στις δύο προεπιλογές δεν λειτουργεί, δείτε το #18992.
Η χρήση του <preset_link /> σε προεπιλογές που ανοίγονται από τον επεξεργαστή σχέσεων προκαλεί εξαιρέσεις, δείτε το #20044.


Ορισμός σταθερού ζεύγους κλειδιού τιμής

<key />
Αυτή η ετικέτα θα ορίζει πάντα ένα κλειδί σε μια συγκεκριμένη τιμή. Το χαρακτηριστικό key="" είναι υποχρεωτικό και, αν υπάρχει το value="" το κλειδί θα λάβει την αντίστοιχη τιμή. Αν το χαρακτηριστικό value="" παραλειφθεί, το κλειδί αφαιρείται. Το χαρακτηριστικό match="" είναι προαιρετικό.


Παράθυρα διαλόγου εισαγωγής και επιλογής χαρακτηριστικών

<text />
Ένα πεδίο επεξεργασίας κειμένου για την εισαγωγή οποιασδήποτε αυθαίρετης συμβολοσειράς από τον χρήστη. Το key="" είναι υποχρεωτικό, ενώ τα text="", default="", use_last_as_default="", auto_increment="", length="", alternative_autocomplete_keys="", match="", icon="" και icon_size="" (και τα δύο από την έκδοση r17605) είναι προαιρετικά.
<combo />
Εμφανίζει ένα σύνθετο πλαίσιο πολλαπλής επιλογής. Τα key="" και values="" είναι υποχρεωτικά, ενώ τα text="", default="", editable="", delimiter="", values_from="", display_values="", short_descriptions="", use_last_as_default="", values_searchable="", length="", values_no_i18n="", values_sort="", match="", icon="" και icon_size="" (και τα δύο από την έκδοση r17605) είναι προαιρετικά.
Αν το editable="" είναι true (προεπιλογή), τα πλαίσια επιλογής μπορούν να επεξεργαστούν σαν να ήταν πεδία κειμένου (εκτός από το αναδυόμενο μενού). Μη επεξεργάσιμα πλαίσια επιλογής μπορούν να περιέχουν μόνο μία από τις καθορισμένες τιμές.
Αν το κλειδί είναι colour ή colour:* ή *:colour, προστίθεται προεπισκόπηση χρώματος και επιλογέας χρώματος στα δεξιά (δείτε το #8352).
<multiselect />
Εμφανίζει μια λίστα από την οποία μπορούν να επιλεγούν μηδέν ή περισσότερα στοιχεία. Τα key="" και values="" είναι υποχρεωτικά, ενώ τα text="", default="", delimiter="", values_from="", rows="", display_values="", short_descriptions="", use_last_as_default="", values_searchable="", values_no_i18n="", values_sort="", match="", icon="" και icon_size="" (και τα δύο από την έκδοση r17605) είναι προαιρετικά. Οι επιλεγμένες τιμές θα συνενωθούν με τον καθορισμένο διαχωριστή (προεπιλογή: ερωτηματικό, ;) και θα γραφτούν στην τιμή της ετικέτας.

Αν μια τιμή ετικέτας έχει ήδη οριστεί όταν ανοίξει το παράθυρο προεπιλογής, το <multiselect /> θα προσπαθήσει να επισημάνει τα κατάλληλα στοιχεία στη λίστα ως επιλεγμένα. Αν η τιμή της ετικέτας δεν μπορεί να αναπαρασταθεί από συνδυασμό επιλογών στη λίστα, η λίστα θα απενεργοποιηθεί ώστε ο χρήστης να μην μπορεί να αντικαταστήσει κατά λάθος μια προσαρμοσμένη τιμή. Σε αντίθεση με το στοιχείο <combo />, το <multiselect /> αναμένει ότι η λίστα τιμών, περιγραφών κ.λπ. θα χρησιμοποιεί τον καθορισμένο διαχωριστή, δηλαδή από προεπιλογή θα πρέπει να χρησιμοποιήσετε ερωτηματικό. Μπορείτε να ορίσετε delimiter="," αλλά τότε το κόμμα θα χρησιμοποιηθεί επίσης και στην τιμή της ετικέτας.

<list_entry />
Χρησιμοποιείται στα <combo> και <multiselect>. Για περισσότερες πληροφορίες δείτε το short_descriptions="", παρακάτω. Τα χαρακτηριστικά είναι: value="", display_value="", short_description="", icon="" και icon_size="".
<check />
Ένα πλαίσιο επιλογής που οι χρήστες μπορούν να επιλέξουν, να αποεπιλέξουν ή να αφήσουν σε μη ορισμένη κατάσταση. Το key="" είναι υποχρεωτικό. Τα text="", default="", match="", value_on="" , value_off="", disable_off="", icon="" και icon_size="" (και τα δύο από την έκδοση r15437) είναι προαιρετικά.


Πρότυπα

<chunk>
Για τον ορισμό ενός προτύπου στοιχείων για μελλοντική (επαναλαμβανόμενη) χρήση. Το γνώρισμα id="" είναι υποχρεωτικό.
<reference>
Για να συμπεριληφθεί ένα προγενέστερα ορισμένο πρότυπο. Το χαρακτηριστικό ref="" είναι υποχρεωτικό.


Χαρακτηριστικά

Τα χαρακτηριστικά των ετικετών έχουν την ακόλουθη σημασία:

name="a_name"
Καθορίζει ένα όνομα για ένα στοιχείο. Αυτό το όνομα θα χρησιμοποιηθεί στο γραφικό περιβάλλον για την εμφάνιση της προεπιλογής ετικετών.
name_context="context"
Πλαίσιο μετάφρασης για το χαρακτηριστικό name ώστε να διαχωρίζονται ίδιες λέξεις με διαφορετική σημασία (δεν απαιτείται για μεταφράσεις εντός του αρχείου).
type="data_type"
Όταν οριστεί, μόνο αντικείμενα του συγκεκριμένου τύπου θα λειτουργούν με αυτή την προεπιλογή ετικετών. Μπορεί να είναι "node", "way", "closedway", "multipolygon", "relation" ή οποιοσδήποτε συνδυασμός τους χωρισμένος με κόμμα. Σημειώστε ότι το "multipolygon" δεν περιλαμβάνεται στο "relation", επομένως εάν η προεπιλογή πρέπει να ισχύει για πολυπολύγωνα και άλλους τύπους σχέσεων, πρέπει να καθορίσετε και τα δύο: "multipolygon,relation". Χρησιμοποιείται επίσης στην ετικέτα <role> για να ορίσει ποιους τύπους αντικειμένων επιτρέπεται να έχει ένα συγκεκριμένο μέλος σχέσης.
icon="iconname"
Ένα όνομα ή σύνδεσμος προς ένα εικονίδιο. Η εικόνα θα χρησιμοποιηθεί ως εικονίδιο για εμφάνιση στη λίστα επιλογής και κατά την προσθήκη της προεπιλογής στη γραμμή εργαλείων. Τα εικονίδια μπορούν επίσης να χρησιμοποιηθούν σε <item>, <label />, καθώς και σε όλα τα πλαίσια εισαγωγής και επιλογής γνωρισμάτων (από την έκδοση r17605· πριν ήταν μόνο σε <list_entry /> και <check />). Τοποθετούνται μπροστά από το <text />. Το εικονίδιο πρέπει να είναι τετράγωνο σε διαστάσεις. Δείτε την Διαχείριση εικονιδίων για το πώς μπορούν να οριστούν τα εικονίδια.
icon_size="a number"
Το μέγιστο μέγεθος ενός εικονιδίου σε pixel. Αν δεν δοθεί τιμή, η προεπιλογή είναι 16 για το <label /> και το προεπιλεγμένο μέγεθος εικονιδίου για το <list_entry /> (σε <combo> και <multiselect>).
key="some_key"
Καθορίζει το κλειδί ιδιότητας που θα τροποποιηθεί από το στοιχείο. Στην περίπτωση του <role> είναι το όνομα του ρόλου που χρησιμοποιείται σε μια σχέση.
text="Any text"
Η περιγραφή που θα εμφανίζεται πριν από το στοιχείο του γραφικού περιβάλλοντος (στην περίπτωση του <check /> μετά το στοιχείο του γραφικού περιβάλλοντος και το προαιρετικό εικονίδιο). Χρησιμοποιείται επίσης για το <label> και το <optional>.
text_context="context"
Πλαίσιο μετάφρασης για το γνώρισμα text ώστε να διαχωρίζονται ίδιες λέξεις με διαφορετική σημασία (δεν απαιτείται για μεταφράσεις εντός του αρχείου).
default="default_value"
Μια ρητά δηλωμένη προεπιλεγμένη τιμή για το στοιχείο. Αυτή η τιμή εφαρμόζεται μόνο μέσω μιας προεπιλογής όταν το αντικείμενο στο οποίο εφαρμόζεται η προεπιλογή έχει μηδενικά κλειδιά. Εάν δεν καθοριστεί τιμή για την προεπιλογή, δεν ορίζεται τιμή στο κλειδί. Χρησιμοποιείται στα <check />, <text />, <combo /> και <multiselect />. Για το <check /> μόνο οι τιμές "on" και "off" είναι έγκυρες.
values="entry1,entry2,entry3"
Μια λίστα καταχωρήσεων (για το πλαίσιο <combo /> και <multiselect />). Η λίστα πρέπει να χωρίζεται με κόμματα (για το πλαίσιο combo) ή με τον καθορισμένο διαχωριστή (για το multiselect). Αν μια τιμή περιέχει τον διαχωριστή, μπορεί να προηγείται ανάποδη κάθετος για διαφυγή. Αν μια τιμή περιέχει ανάποδη κάθετο, πρέπει επίσης να διαφύγει με ανάποδη κάθετο.
values_from="JAVA code"
Για χρήση αντί για values="" εάν η λίστα τιμών πρέπει να ληφθεί με μια μέθοδο Java αυτής της μορφής: public static String[] getValues(); Η τιμή πρέπει να είναι: "full.package.name.ClassName#methodName".
values_no_i18n="true|false"
Απενεργοποιεί τη διεθνοποίηση των τιμών ώστε να αποφευχθούν λάθη (δείτε το #11696. Η προεπιλογή είναι "false". Χρησιμοποιείται σε <combo /> και <multiselect />. (Χρήσιμο π.χ. για κλειδιά όπως opening hours ή brand.) Δεν χρειάζεται για κλειδιά που έχουν μόνο αριθμητικές τιμές, όπως layer ή level τα οποία ήδη εξαιρούνται από τη μετάφραση.
values_sort="true|false"
Οι τιμές των <combo /> και <multiselect /> ταξινομούνται αλφαβητικά σε κάθε γλώσσα. Με αυτό το χαρακτηριστικό μπορείτε να απενεργοποιήσετε την αλφαβητική ταξινόμηση, αν οι τιμές πρέπει να διατηρούν τη δοσμένη σειρά (δείτε το #5509 και το #11926. (Στην εσωτερική προεπιλογή του JOSM αυτό χρησιμοποιείται π.χ. για τα κλειδιά tracktype, direction, network, smoothness, visibility ή trail_visibility.) Η προεπιλογή είναι "true".
Οι χρήστες μπορούν να απενεργοποιήσουν καθολικά την ταξινόμηση με το κλειδί προτιμήσεων taggingpreset.sortvalues.
values_context="context"
Το περιβάλλον μετάφρασης για το χαρακτηριστικό values ώστε να διαχωρίζονται ίδιες λέξεις με διαφορετική σημασία (δεν απαιτείται για μεταφράσεις εντός του αρχείου).
display_values="Entry1,Entry2,Entry3"
Μια λίστα καταχωρήσεων που εμφανίζεται στους χρήστες. Πρέπει να έχει τον ίδιο αριθμό και την ίδια σειρά καταχωρήσεων με το values="" και το editable="" πρέπει να είναι "false" ή να μην έχει οριστεί. Για τον χαρακτήρα οριοθέτησης και το escaping, δείτε τις παρατηρήσεις στο values="". Χρησιμοποιείται σε <combo /> και <multiselect />.
value="foobar"
Καθορίζει μια τιμή που θα εισαχθεί στην ετικέτα <key>.
value_on="foobar"
Καθορίζει την τιμή true που θα εισαχθεί στην ετικέτα <key> όταν είναι επιλεγμένο ένα <check /> (η προεπιλογή είναι "yes").
value_off="foobar"
Καθορίζει την τιμή false που θα εισαχθεί στην ετικέτα <key> όταν είναι αποεπιλεγμένο ένα <check /> (η προεπιλογή είναι "no").
disable_off="true"
Καθορίζει εάν η τιμή off ενός <check /> είναι απενεργοποιημένη στον διάλογο, δηλαδή μόνο οι επιλογές unset ή "yes" παρέχονται.
editable="false"
Το πλαίσιο επιλογής είναι μόνο για ανάγνωση, πράγμα που σημαίνει ότι οι χρήστες μπορούν να επιλέξουν μόνο ένα στοιχείο από τη λίστα. Η προεπιλογή είναι "true", που σημαίνει ότι οι χρήστες μπορούν να προσθέσουν και άλλες τιμές ως κείμενο. (Η λειτουργία δεν δούλευε σωστά για μεγάλο χρονικό διάστημα αλλά θα πρέπει να λειτουργεί ξανά από την έκδοση r18221, δείτε το #6157.)
use_last_as_default="true|false|force"
Για πεδία <combo />, <multiselect /> ή <text /> χρησιμοποιείται ως προεπιλογή η τελευταία χρησιμοποιημένη τιμή. Η χρήση της επιλογής "force" επιβάλλει αυτήν τη συμπεριφορά ακόμη και για ήδη χαρακτηρισμένα αντικείμενα. Η προεπιλογή είναι "false".
rows="count"
Καθορίζει τον αριθμό σειρών που θα εμφανιστούν σε μια καταχώρηση <multiselect /> (αν δεν οριστεί, καθορίζεται αυτόματα από την Java ή ην εμφάνιση και την αίσθηση και έχει ως αποτέλεσμα π.χ. 8).
name_template="template", name_template_filter="search expression"
Προσαρμοσμένη μορφοποίηση ονομάτων για στοιχεία OSM που ταιριάζουν με αυτήν την προεπιλογή. Δείτε τις λεπτομέρειες μορφοποίησης ονομάτων παρακάτω.
match="none|key|key!|keyvalue|keyvalue!"
Επιτρέπει την αλλαγή της διαδικασίας αντιστοίχισης, δηλαδή τον προσδιορισμό του εάν οι ετικέτες ενός αντικειμένου OSM ταιριάζουν σε αυτήν την προεπιλογή. Εάν μια προεπιλογή ταιριάζει, τότε συνδέεται στο Πίνακα Ετικετών/Μελών.
  • none: ουδέτερη, δηλαδή, δεν λαμβάνεται υπόψη αυτό το στοιχείο για αντιστοίχιση
  • key: θετική αν το κλειδί ταιριάζει, διαφορετικά ουδέτερη
  • key!: θετική αν το κλειδί ταιριάζει, διαφορετικά αρνητική
  • keyvalue: θετική αν ταιριάζουν και το κλειδί και η τιμή, διαφορετικά ουδέτερη
  • keyvalue!: θετική αν ταιριάζουν και το κλειδί και η τιμή, διαφορετικά αρνητική
Σημείωση: Για να υπάρχει αντιστοίχιση, απαιτείται τουλάχιστον μία θετική και καμία αρνητική αντιστοίχιση. Η προεπιλογή είναι "keyvalue!" για το <key> και "none" για τα <text />, <combo />, <multiselect /> και <check />.
match_expression="search expression"
Πρόσθετα κριτήρια για την αντιστοίχιση αντικειμένων, καθορισμένα στη σύνταξη αναζήτησης του JOSM. (από την έκδοση r17662)
Τα εισαγωγικά (") πρέπει να γράφονται ως &quot;.
Για παράδειγμα, μια προεπιλογή με match_expression="foo=bar" απαιτεί τα αντικείμενα OSM να έχουν την ετικέτα foo=bar. Μπορεί να θέλετε να χρησιμοποιήσετε το match_expression="" για να εξαιρέσετε ορισμένα αντικείμενα OSM, π.χ. όταν υπάρχει μια πιο συγκεκριμένη προεπιλογή.
id="unique_identifier"
το μοναδικό αναγνωριστικό για αυτό το <chunk>
ref="unique_identifier"
το μοναδικό αναγνωριστικό του (ήδη ορισμένου) προτύπου που θα περιλαμβάνει
columns="a number"
τον αριθμό των στηλών των ομαδοποιημένων <check />
requisite="optional|required"
Εάν ένα μέλος σχέσης είναι προαιρετικό ή απαιτείται. Η προεπιλογή είναι "optional".
count="a number"
Πόσο συχνά μπορεί να εμφανίζεται ένας ρόλος (αν δεν δοθεί, θεωρείται απεριόριστος αριθμός)
member_expression="search expression"
μια έκφραση, στη σύνταξη αναζήτησης JOSM, για αντικείμενα αυτού του ρόλου
Τα εισαγωγικά (") πρέπει να γράφονται ως &quot;.
regexp="true"
Ορισμός σε "true" εάν το κλειδί ενός ρόλου είναι κανονική έκφραση.
Αυτό επιτρέπει μεταβλητούς ρόλους, π.χ.: <role key="level_-?\d+" text="Building level" regexp="true" requisite="optional" type="relation" /> επιτρέπει ρόλους όπως level_0, level_1,...
preset_name="exact_name"
Το ακριβές όνομα της προκαθορισμένης ρύθμισης στην οποία θα γίνει σύνδεση.
preset_name_label="false|true"
Εάν θα εισαχθεί η ετικέτα "[preset name]" στο παράθυρο διαλόγου (προεπιλογή σε "false" για συμβατότητα με παλαιότερες ρυθμίσεις σε εξωτερικές προεπιλογές).
length="a number"
Το μήκος ενός πλαισίου <text /> ή <combo /> (αριθμός χαρακτήρων που επιτρέπονται).
alternative_autocomplete_keys="some_key(s)"
Μια λίστα εναλλακτικών κλειδιών, διαχωρισμένων με κόμμα, για χρήση για την αυτόματη συμπλήρωση του <text>.
auto_increment="-2,-1,+1,+2"
Μπορεί να περιέχει λίστα ακέραιων βημάτων αύξησης ή μείωσης, χωρισμένων με κόμμα, π.χ. "-2,-1,+1,+2". Εμφανίζεται κουμπί δίπλα στο πεδίο <text /> για κάθε τιμή, ώστε να επιλέγετε αυτόματη αύξηση με το συγκεκριμένο βήμα. Η αυτόματη αύξηση γίνεται μόνο αν την επιλέξετε. Υπάρχει επίσης κουμπί για απενεργοποίηση της αυτόματης αύξησης. Η προεπιλογή είναι χωρίς αυτόματη αύξηση. Δεν μπορεί να χρησιμοποιηθεί ταυτόχρονα με το use_last_as_default="".
delimiter="special character"
Ο χαρακτήρας που χωρίζει τις τιμές. Στην περίπτωση του <combo /> η προεπιλογή είναι comma (,). Στην περίπτωση του <multiselect /> η προεπιλογή είναι semicolon (;) και αυτό θα χρησιμοποιηθεί επίσης για να χωρίζει τις επιλεγμένες τιμές στην ετικέτα. Για περισσότερες πληροφορίες δείτε το <multiselect />, παραπάνω.
short_descriptions="Entry1,Entry2,Entry3"
Λίστα κειμένων, χωρισμένων με τον χαρακτήρα οριοθέτησης, που εμφανίζονται κάτω από κάθε display_value="". (Μόνο αν δεν είναι δυνατό να περιγράψετε την καταχώριση σε 2–3 λέξεις.) Αντί για λίστα χωρισμένη με κόμμα, χρησιμοποιώντας values="", display_values="" και short_descriptions="", υποστηρίζεται και η παρακάτω μορφή:
<list_entry value="" display_value="" short_description="" icon="" icon_size="" />
values_searchable="true|false"
Αν θα γίνεται αναζήτηση στις τιμές values="" και display_values="", αντίστοιχα, value="" και display_value="" του <combo /> ή <multiselect /> κατά την αναζήτηση προεπιλογών.
value_template="template"
Ένα πρότυπο για την αυτόματη δημιουργία της τιμής με βάση άλλες τιμές ετικέτας του αντικειμένου. Χρησιμοποιείται η ίδια σύνταξη όπως στο name_template="", δείτε παρακάτω. (από το r17639)
Για παράδειγμα, το "Bus {ref}: {from} → {to}" μπορεί να χρησιμοποιηθεί για τη δημιουργία του ονόματος μιας σχέσης διαδρομής λεωφορείου.
Σημείωση: Υπάρχουν ορισμένα μικρά προβλήματα με αυτό το χαρακτηριστικό, δείτε το #20851 και το #20861.


Λεπτομέρειες name_template και value_template

Name templates can be used to define custom formatting for OSM primitives or GPX waypoints (for example in the Relations or Selection panels).

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

Δείγματα

Πρότυπο Ετικέτες Αποτέλεσμα
House number {addr:housenumber} addr:housenumber=10 Αριθμός σπιτιού 10
?{ 'House number {addr:housenumber} at {addr:street}' | 'House number {addr:housenumber}' } addr:housenumber=10 Αριθμός σπιτιού 10
addr:housenumber=10 addr:street=Abbey road Αριθμός σπιτιού 10 στην Abbey road
?{ admin_level = 2 'NUTS 1' | admin_level = 4 'NUTS 2' | admin_level = 6 'NUTS 3' | 'Admin level {admin_level}'} admin_level=4 NUTS 2
admin_level=5 Admin level 5
{admin_level} - {name} !{parent() type=boundary '?{'(part of {admin_level} - {name})' | ''}'} admin_level=6 name=Vysocina, μέλος σχέσης admin_level=4 name=Jihovychod 6 - Vysocina (μέρος του 4 - Jihovychod)
admin_level=2 name=Czech republic (χωρίς γονικό) 2 - Czech republic


Σύνταξη
  • {tag} - εισάγετε την τιμή της ετικέτας.
  • ?{condition1 'value1' | condition2 'value2' | 'value3'} - χρησιμοποιήστε το value1 εάν το condition1 ικανοποιείται, διαφορετικά χρησιμοποιήστε το value2 εάν το condition2 ικανοποιείται, και τέλος χρησιμοποιήστε το value3 εάν δεν ικανοποιείται καμία συνθήκη. Η συνθήκη μπορεί να είναι είτε ρητή - στη σύνταξη αναζήτησης JOSM είτε έμμεση: Η τιμή χρησιμοποιείται όταν όλες οι ετικέτες που αναφέρονται μέσα υπάρχουν.
  • !{search_expression 'template'} - η έκφραση αναζήτησης αξιολογείται και το πρώτο αντικείμενο που ταιριάζει χρησιμοποιείται ως πλαίσιο για το πρότυπο. Χρήσιμο, π.χ., για την ανάκτηση ετικετών γονικής σχέσης.
  • \ - χρησιμοποιήστε μια ανάστροφη κάθετο για να διαφύγετε από τους ειδικούς χαρακτήρες '{', '}', '?', '!'. Π.χ. What is this\? It is a {type}\!.


Διαθέσιμες τιμές

Για τη μορφοποίηση αντικειμένων OSM, μπορεί να χρησιμοποιηθεί η τιμή οποιασδήποτε ετικέτας. Χρησιμοποιήστε την ετικέτα {special:everything} για να εμφανίσετε όλες τις διαθέσιμες ετικέτες, π.χ. στα σημεία πορείας gpx.

Μπορείτε επίσης να χρησιμοποιήσετε τις εξής εικονικές ετικέτες:

  • {special:everything} εκτυπώνει όλες τις διαθέσιμες τιμές, διαθέσιμες για μορφοποίηση τόσο των αντικειμένων όσο και σημείων.
  • {special:id} εκτυπώνει το ID του αντικειμένου osm.
  • {special:localName} εκτυπώνει το μεταφρασμένο όνομα, δηλαδή την τιμή του name:lang for your language για τη γλώσσα σας αν υπάρχει, αλλιώς την τιμή του name εάν δεν υπάρχει.


Καταργημένα χαρακτηριστικά

Τα ακόλουθα χαρακτηριστικά έχουν καταργηθεί και δεν υποστηρίζονται πλέον από το JOSM:

delete_if_empty="true"
αφαιρέθηκε στο r5155. Μπορείτε απλώς να αφαιρέσετε αυτό το χαρακτηριστικό εάν εξακολουθεί να χρησιμοποιείται στις προεπιλογές σας.
required="true"
αντικαταστάθηκε από το match="" από το r5155


Μετάφραση

Για την υποστήριξη μεταφράσεων, όλα τα στοιχεία κειμένου (name="", text="", display_values="") μπορούν να μεταφραστούν τοπικά. Π.χ., το de.name="" θα αντιπροσωπεύει το όνομα όταν φορτώνεται η υποστήριξη γερμανικής γλώσσας. Στον προκαθορισμένο κώδικα XML, ο αγγλικός όρος πρέπει να είναι ο πρώτος, πριν προστεθούν πιθανές μεταφράσεις.

Εσωτερική προεπιλογή

Η μετάφραση για την εσωτερική προεπιλογή γίνεται στο Launchpad.

Στην εσωτερική προεπιλογή, όλα τα name="", text="" και display_values="" μεταφράζονται μέσω της παραπάνω υπηρεσίας, εφόσον δεν έχει δοθεί συγκεκριμένη μετάφραση μέσα στο αρχείο XML. Όταν δεν παρέχονται display_values="" τότε τα values="" θα αντιμετωπίζονται ως display_values="" και θα μεταφράζονται αντ' αυτού.

Όταν η ίδια αγγλική λέξη έχει διαφορετικές μεταφράσεις σε διαφορετικά περιβάλλοντα, πρέπει να καθοριστεί το συγκεκριμένο περιβάλλον μετάφρασης. Χρησιμοποιήστε name_context="", text_context="" ή values_context="" για αυτόν τον σκοπό. Το περιβάλλον θα πρέπει να είναι μια σύντομη περιγραφή με νόημα για να βοηθήσει τους μεταφραστές.

Εξωτερικές Προεπιλογές

Η μετάφραση των εξωτερικών προεπιλογών σε αυτόν τον ιστότοπο είναι, μέχρι στιγμής, δυνατή μόνο εντός του πηγαίου κώδικα XML της προεπιλογής, δείτε το #11392.

Οι προεπιλογές που φιλοξενούνται αλλού μπορούν επίσης να προσθέσουν έναν κατάλογο data με τα αρχεία .lang τύπου JOSM για μετάφραση (όπως στο ίδιο το JOSM ή σε πρόσθετα).

Ωστόσο, όταν χρησιμοποιούνται λέξεις στην εξωτερική προεπιλογή που υπάρχουν ήδη στην εσωτερική προεπιλογή, η μετάφραση από την εσωτερική προεπιλογή ισχύει και για την εξωτερική. Αυτό είναι χρήσιμο εφόσον το περιβάλλον είναι το ίδιο. Όταν το περιβάλλον στην εξωτερική προεπιλογή είναι διαφορετική, πρέπει να γίνεται διάκριση με την προσθήκη name_context="", text_context="" ή values_context="".

Χειρισμός εικονιδίων

Δείτε Τεχνοτροπίες.

Δείτε επίσης

Last modified 3 months ago Last modified on 2025-08-12T19:28:26+02:00
Note: See TracWiki for help on using the wiki.