Helpo:Ŝablonoj/Punktaj ŝablonoj

Tiu ĉi artikolo enhavas detalan helpon pri punktaj ŝablonoj. Se vi serĉas la liston, legu Helpo:Ŝablonoj/Punktoj.
Geografia lokigo
vdr

Ĉi tiu helpopaĝo rilatas al la projekto pri ŝablonoj kaj geografiaj koordinatoj.

Ĝi celas kunordigi la kreadon kaj evoluon de ŝablonoj por mapaj punktoj. Tiaj ŝablonoj estas ĉefe uzataj de {{punkto sur mapo}}, sed ankaŭ de aliaj ŝablonoj.

Ŝablono de punkto poziciigas bildon unu sur alian, punkton (<varianto>), kun piktogramo kaj/aŭ loknomo. La punkto estas ĉiam centrigata sur la donita pozicio. La komuna sintakso por tajpi de ŝablonoj estas: « {{<nomo de ŝablono>|1=<y>|2=<x>|3=<loknomo>|<arg1>|<arg2>}} ».

Ili estas uzataj ĉefe de {{punkto sur mapo}}, {{geolokigo de mapo}}, alternative de {{Informkesto/Geografia lokigo multobla}}.

Ŝablonoj por mapaj punktoj redakti

Tio estas specifa grupo de ŝablonoj kun la sekvaj trajtoj:

  • Ili difinas certa(j)n speco(j)n de bildetoj.
  • Ili aranĝas pozicion de la bildeto sur alia bildo, ĉefe mapo.
  • Multaj el ili poziciigas eĉ loknomon apud la bildeto. Sed ankaŭ ekzistas multaj ŝablonoj sen loknomoj.

Detala priskribo redakti

Ŝablonoj uzeblaj en parametroj kaj generaj ŝablonoj redakti

 
Ekzistas kategorio dediĉita al ĉi tiu subjekto: Ŝablono:Punkto sur mapo.

La ŝablonoj de punkto uzeblaj en parametroj por lokigi <varianto> estas tipikaj

  1. « Ŝablono:Punkto/<varianto> sen loknomo » en informkesto.
  2. « Ŝablono:Punkto/<varianto> » por kompleta mapo.
  Pli detalaj informoj troveblas en artikolo La nomskemo de ŝablonoj de geografia lokigo.
 
Ekzistas kategorio dediĉita al ĉi tiu subjekto: Ŝablono:Punkto sur mapo/baza.

La koncepto de ŝablono de punkto baziĝas sur la uzado de genera ŝablono (aŭ meta-ŝablono) de punkto. La plej simpla maniero krei novan ŝablonon de punkto (por lokigi novan varianton) estas uzi generan ŝablonon (aŭ meta-ŝablonon). Oni uzas la plej oftajn:

  1. {{Piktogramo}} por « Ŝablono:Punkto/|varianto= sen loknomo »
  2. {{Piktogramo kun loknomo}} por « Ŝablono:Punkto/<varianto> »

Aŭ ankoraŭ, aŭ {{Loknomo}}, aŭ {{Loknomo kun streko}} se la lokigo estas pli flua ({{Punkto/regiono}}, {{Punkto/insulo}} ekzemple).

Sintakso redakti

La komuna sintakso de ĉi tiuj ŝablonoj estas:

{{<ŝablono de punkto>|1=<y>|2=<x>|3=<loknomo>|4=<arg1>|5=<arg2>|...}}
  • <y> kaj <x> estas la koordinatoj de punkto rilate al supra maldekstra angulo de la bildo sur kiuj la punkto aperos. Atentu la inversion (y, x)[1].
  • <loknomo> estas …
    • Por la nomitaj punktoj « <varianto> sen loknomo », la loknomo devas esti pura teksto. Ĝi nur aperas en tujhelpilo de piktogramo.
    • Por la nomitaj punktoj « <varianto> », la loknomo estas ligilo al artikolo. Oni povas uzi la sintakson « <titolo de paĝo>{{!}}<reala nomo> ».

La uzado de la sekvaj parametroj <arg1>, <arg2> dependas de la ŝablono. Vidu la listo de la ŝablonoj de punkto.

Uzado kaj mekanismo redakti

Ĉi tiu speco de ŝablonoj povas esti uzata rekte inter la etikedoj {{Komenco de mapo}} kaj {{Fino de mapo}}[2].

Tamen, ĉi tiu speco de ŝablono estas antaŭ ĉio uzata nerekte per la ŝablono {{Punkto sur mapo}}, {{Punkto sur mapo/gms}}. La uzado de

{{Punkto sur mapo|<mapo>|<latitudo>|<longitudo>|<loknomo>|<nomo de punkto>|6=<arg1>|7=<arg2>}}[3]

kaŭzas elvokon de ŝablono de punkto « Ŝablono:Punkto/<nomo de punkto> » tiel:

{{Punkto/<nomo de punkto>|<y>|<x>|<loknomo>|4=<arg1>|5=<arg2>}}[4]

Oni notas unue ke la geografiaj koordinatoj (<latitudo>, <longitudo>) estas konvertataj en du procentaĵojn (<y>, <x>) de la dimensioj de la bildo[5], danke al ŝablono de parametrigo de mapo « Ŝablono:Situo sur mapo/<mapo> ».

Oni vidas egale ke la parametroj <loknomo>, <arg1> kaj <arg2> estas rekte transmetataj al la ŝablono de punkto. La uzado de la parametro <loknomo> estas komuna al ĉiuj ŝablonoj de punkto. Kontraŭe, la parametroj <arg1> kaj <arg2> estas nedevigaj. Ilia uzado (aŭ neuzado) dependas de la ŝablono de elektita punkto.

  Pli detalaj informoj troveblas en artikolo Listo de la ŝablonoj de punkto, kiuj estas uzeblaj en parametroj.

Kodo redakti

La grandeco
La ŝablono de punkto estas centrigata se la koordinatoj <y>, <x> korespondas al la centro de punkto kaj ne al ĝia supra maldekstra angulo. Por centrigi piktogramon de donita <grando>, la ŝablono devas uzi la kodon
<div style="position:absolute;border:none;
top:{{{1}}}%;left:{{{2}}}%;<!-- … -->
"><div style="position:absolute;border:none;
top:{{#expr:-(<grando>)/2}}px; 
left:{{#expr:-(<grando>)/2}}px;<!-- … -->
"><!- 
…
 --></div></div>
Vidu {{Piktogramo}}. Kun rando, ĝi devas egale forigi la dikecon de ĉi tiu rando.
Ĝi devas egale preferi la parojn de <grando>, ĉar ili estas pli bone centrigitaj, se la koordinatoj estas kompletaj.
La parametroj <arg1> kaj <arg2>
La traktado de ĉi tiuj parametroj estas delikata. Oni devas atenti, ke la parametro povas ne nur foresti, sed ankaŭ esti virgulo. Se la defaŭlta valoro estas virgulo, oni povas uzi {{{4|}}}{{{5|}}} sen danĝero. En kontraŭa kazo, la uzado simple de {{{4|<defaŭlta valoro>}}} ne estas ebla[6]. La bona sintakso estas
{{#if:{{{4|}}}|{{{4}}}|<defaŭlta valoro>}}
Vidu ankaŭ

Kiel krei novan punktan ŝablonon? redakti

Antaŭ ol vi kreas novan ŝablonon, bonvolu sekvi la jenajn punktojn:

  • Kontrolu, ĉu ankoraŭ ne ekzistas konvena ŝablono.
  • Respektu la semantikon! Ne kreu alternativajn punktojn nur pro estetikaj kialoj.
  • Estas eble preferinda parametrigi punkton ekzistantan (kiel tio estas farata por {{Punkto/urbo}}) por aranĝi variantojn.
  • La uzado de genera ŝablono estas tre rekomendata.

Jen kelkaj kodaj variantoj:

{{Punkto/flughaveno sen loknomo}} uzas {{Piktogramo}} :

<includeonly>{{Piktogramo|{{{1}}}|{{{2}}}|3={{{3|}}}|4=Airplane silhouette.svg|5={{{4|12}}}}}</includeonly><noinclude>
{{Punkto/dokumentado}}
</noinclude>

{{Punkto/flughaveno}} uzas {{Piktogramo kun loknomo}} :

<includeonly>{{Piktogramo kun loknomo|{{{1}}}|{{{2}}}|3=<small>[[{{{3|loknomo mankas!}}}]]</small>|4=Airplane silhouette.svg|5={{{4|ne}}}|6=6|7=12}}</includeonly><noinclude>
{{Punkto/dokumentado}}
</noinclude>

{{Punkto/regiono}} uzas {{Loknomo}} :

<includeonly>{{Loknomo|{{{1}}}|{{{2}}}|3=<span style="font-weight:bold;color:slategray">[[{{{3}}}]]</span>}}</includeonly><noinclude>
{{Punkto/dokumentado}}
</noinclude>

{{Punkto/rivero sen loknomo}} uzas {{Loknomo kun streko}} :

Ĉi tie oni povas malfacile uzi piktogramon, oni estas devigata surekranigi la loknomon kaj oni aranĝas ĝin tiel ke ĝi ne eliĝas el la kadro.

<includeonly>{{Loknomo kun streko|{{{1}}}|{{{2}}}|3=<span style="color:#0978AB;">{{{3|lokigo de akvaj vojo}}}</span>|4=20|5={{#ifexpr: {{{1}}}<50|s|n}}{{#ifexpr: {{{2}}}<70|{{#ifexpr: {{{1}}}<30|e|}}|o}}}}</includeonly><noinclude>
{{Punkto/dokumentado}}
</noinclude>
Serĉu piktogramon por krei la novan punkton

Dokumentado redakti

Por la dokumentado de tiaj ŝablonoj estas uzata la sekva kodo:

{{Punkto/dokumentado}}

Tio ĉiam devas stari inter <noinclude> kaj </noinclude>, prefere antaŭ la tiea(j) kategorio(j) kaj intervikiaj ligiloj.

Subpaĝo de informoj redakti

La subpaĝo de informoj enhavas kodon laŭ la jena skemo, kiel videblas en {{punkto/urbo/informoj}}:

{{#switch: {{{1|}}}
|varianto=urbo
|ŝablono=Piktogramo kun loknomo
|arg1=[[Helpo:Ŝablonoj/Parametro statuso|statuso de la urbo]]
|arg2=[[Helpo:Ŝablonoj/Parametro de pozicio|pozicio de la loknomo]]
|noto=En realeco, {{Ŝ|Piktogramo kun loknomo}} ne estas uzata.
}}

La paĝo povas esti kreata aŭtomate, se oni aldonis al la koncerna punkta ŝablono la kodon por la dokumentado. Se la subpaĝo ankoraŭ ne ekzistas, tiam aperas la ligilo "Kreas la subpaĝon de informoj" en informa ŝabloneto meze en la dokumentado. Se tie jam legeblas "subpaĝo de informoj" en la sama informa ŝabloneto, tia subpaĝo jam ekzistas.

Evoluigo redakti

Parametrigi la punktojn redakti

Parametro de speco povas esti aldonata al certaj punktoj (laŭ simila maniero al statuso de la urbo por {{Punkto/urbo}}). Ekzemple:

  1. La kialo de la inversion (y, x) kuŝas en la korespondo kun (latitudo, longitudo).
  2. Teknike dirite, ĉi tiuj ŝablonoj lokiĝas en la interno de HTML-a etikedo al kiu oni aldonas position:relative; al ĝia atributo style. Sed pli resonema uzado konsistas en la sistema uzado de {{Komenco de mapo}} kaj {{Fino de mapo}}.
  3. Numeri la parametrojn ne estas necese; sed tio estas pli fidinda.
  4. Notu ke ĝi havas duoblan ŝoviĝon en la numerado de la argumentoj, ĉar ne plu estas parametroj <mapo> nek <nomo de punkto> en la ŝablono de punkto.
  5. … Aŭ, pli ĝenerale, de la dimensioj de la enhava kesto.
  6. Vidu la bogue 1.

Aldonoj redakti

Vidu ankaŭ redakti