Gvidlinioj por Defaŭltaj Antaŭagordoj

Ĉi tiu paĝo enhavas malprecizajn gvidliniojn por la defaŭltaj antaŭagordoj​ kaj novaj ikonoj.

Novaj Etikedoj kaj Valoroj

Bonvolu unue kontroli, ke ne ekzistas jam bileto por ĉi tiu etikedo, ekz. per uzi la serĉan funkcion ĉe la supra dekstra parto de ĉi tiu paĝo.

Baze ni devas certigi, ke la antaŭagorda menuo ne estas tro ŝtopita, ĉar estus malfacile trovi la utilajn ĉiutagajn aferojn se ni havus tro multajn ekzotajn enirojn. Novaj etikedoj kaj valoroj devas havi:

• taŭgan dokumentadon en la ​OSM-vikio,
• decajn uzonombrojn (absolutajn kaj laŭ nombro de mapistoj),
• tutmondan uzon,
• kontestatajn kazojn (kiel contact:phone=* kontraŭ phone=*) devas esti deciditaj kaze post kaze,
• se trajto estas nur mapita de kelkaj specialistoj, ĝi estas pli taŭga por ekstera antaŭagordo. Kutime ĉi tio inkluzivas etikedajn skemojn limigitajn al unu specifa lando, ŝatokupo, sporto aŭ profesio. Anstataŭ krei propran eksteran antaŭagordon vi ankaŭ povas etendi Presets/NewTags (en).

Noto:

• La celo de la interna antaŭagordo estas subteni la etikedojn kaj etikedajn skemojn kiuj estas vaste akceptitaj kaj uzataj de la komunumo. Ĝi ne estas la celo inventi novajn etikedojn aŭ etikedajn skemojn.
• Kiam esplorante ​taginfo, ankaŭ kontrolu kie nekutimaj valoroj estas uzataj.
• Vi povas uzi Overpass API por ŝargi ĉi tiujn objektojn en JOSM kaj kontroli en la historio kiu kreis ilin.
• Vidu ankaŭ ​ĉi tiun ekzemplon por serĉi la lastan redaktanton de specifa etikedo.
• Utila ilo por kontroli etikedojn estas ankaŭ ​taghistory. Se etikedo estas mapita ekz. 50 fojojn jare tutmonde, tiam ni kutime ne bezonas antaŭagordon por ĉi tiu etikedo. Vi ĉiam povas aldoni etikedojn mane per la Aldoni etikedon dialogo.
• Kiam modifante la defaŭltajn antaŭagordojn ankaŭ la ĉefa mapstilo​ kaj eble ankaŭ validigaj reguloj devus esti ŝanĝitaj por konsistenco.

Novaj Ikonoj

• La dosierformato devas esti svg por senperda skalado. (Teknike png estas subtenata sed ĉiuj antaŭagordaj ikonoj estas svg ekde Aŭgusto 2016.)
• La ikono devas esti identigebla ĉe grandeco de 16 rastrumeroj. Ĉi tio estas la defaŭlta grandeco laŭ kiu la ikonoj estas montritaj en la Mapo-Vido sur standardaj dpi (ne hidpi) ekranoj.
• La permesilo devas esti kongrua kun GPL3 (kiel PD aŭ CC0). Bona fonto por ikonoj estas ​openclipart.org (ĉiuj ikonoj estas PD), ​publicdomainvectors.org (ĉiuj ikonoj CC0), ​freesvg.org (ĉiuj ikonoj CC0) aŭ ​osm-icons.org (multaj estas CC0). Vi ankaŭ povas kontroli ĉu JOSM jam havas taŭgan neuzatan ikonon en unu el ĝiaj ikonaj dosierujoj: uzataj ikonoj kaj neuzataj ikonoj.
• Se la etikedo aplikiĝas al nodoj, la ikono en la Mapo-Vido kaj la ikono de la antaŭagordo devus esti la sama se eble. (Ĝi ne eblas kiam malsamaj trajtoj uzas la saman antaŭagordon, ekz. crossing=island kaj crossing=traffic_signals havas malsamajn ikonojn, sed estas traktitaj en nur unu antaŭagordo "Piediranta Transiro".)
• Ikonoj kun travidebla fono devas ne esti nur nigraj aŭ nur blankaj. Alie se oni uzas nigran aŭ blankan fonon (neniu aerfoto kiel fono) en la Mapo-Vido, nigraj aŭ blankaj ikonoj estus nevideblaj. Solvo: se vi volas uzi nigran ikonon, aldonu kvadratan blankan fonon al la ikono anstataŭ travidebla fono aŭ prefere uzu blankan halon.
  Ekzemplo: Tamen koloraj ikonoj estas preferataj.
• La ikono devus kaŝi kiel malpli eble en la mapvido, do koloraj ikonoj kun travidebla fono estas preferataj super nigraj/blankaj ikonoj kun kvadrata fono.
• La ikono devas esti komprenebla en ĉiuj landoj.
• Ĉiu antaŭagordo devus havi sian propran ikonon kaj ne prunti ekzistantan ikonon de alia antaŭagordo por ke vi povu scii la etikedon nur vidante la ikonon en la mapvido.
• Por testi vian ikonon kontraŭ ĉi tiuj postuloj ene de JOSM, la mapstilo Ikon-testilo helpas vin.

Eblaj problemoj kun svg en JOSM

Bonvolu kontroli ĉu la svg-dosiero ĝuste funkcias ene de JOSM.

• La baza grandeco de svg devus esti 16px aŭ pli granda ol 64px. Bildoj kun baza grandeco inter 16 kaj 64 px ne estos skalitaj malsupren al 16px.
• Estas kelkaj svg-bibliotekoj kiuj ne funkcias kun JOSM (la bildoj deformiĝas). Se vi havas tian dosieron, provu la sekvan solvon: kreu novan svg-dokumenton kun Inkscape, kopiu la svg-datumojn al ĉi tiu nova dosiero, regrandigu la paĝon al la datumoj kaj konservu.
• Regrandigu vian ikonon al 16px aŭ entjera oblo de ĝi (ne io kiel 458.1534) por eviti montrajn neprecizecojn pro rondigaj eraroj ene de java.
• Kontrolu la kodon de la dosiero en tekstredaktilo. Serĉu viewBox valoron en la komenco de la dosiero. Se la ikono estas, ekzemple, en 16x16 rastrumeroj, kaj se vi faris ĝin en Inkscape (almenaŭ ĉi tio okazas en versio 0.91) kaj difinis en Dokumentaj Propraĵoj 16,00000 per 16,00000 rastrumeroj, verŝajne en la dosierkodo vi havas ĉi tiujn valorojn viewBox="0 0 16.000002 16.000001". Ŝanĝu ĝin al viewBox="0 0 16 16" aŭ vi havos problemojn (vidu #12201)
• svg-ikonoj estas aŭtomate purigitaj por redukti dosiergrandon en la JOSM-konstruo. Do ne necesas fari ĉi tiun paŝon mane antaŭ ol alŝuti svg-dosierojn al svn. Vidu komenton:35:bileto:10479, komenton:10:bileto:10877 kaj bileton:12201#comment:21 Nepurigitaj svg-oj estas pli bonaj por plua redaktado.
• Pro cimo en svgcleaner tamen, la svg-kodo ne devus enhavi argumentojn komenciĝantajn per specialaj karakteroj en stilaj kodoj ekz. -inkscape-font-specification:Sans;. Ĉi tio povas kaŭzi kolorŝanĝojn (vidu #13158).
• Se la ikono inkluzivas gradientojn, la deklivo devas pliiĝi ĉe ĉiu halto, t.e. du haltoj kun la sama deklivo ne estas permesitaj, vidu ​svg salamandro.
• CSS-stiloj (<style type="text/css">) ankoraŭ ne estas subtenataj de svgSalamander.
• Se eble, tute ne uzu tekstajn elementojn ĉar ĉi tio povas konduki al malsamaj montraj rezultoj bazitaj sur ekz. operaciumo aŭ instalitaj tiparoj. Por eviti ĉi tion vi povas transformi tekston en vojojn en la svg.
• Kelkaj el la nomitaj problemoj povas esti detektitaj per ekzekuti ĉi tiun skripton​.

Vidu ankaŭ

• Startpunkto por ĉi tiuj reguloj estis bileto:10246#comment:14.

---

Reen al Disvolvantaj Gvidiloj (en)
Reen al Ĉefa Helpo