View source for Template:Hu:Relation/doc

{{Documentation subpage}}
{{language|Template:Relation/doc}}
{{Heavily used template}}
{{ambox
|type=caution
|text=Ez most komoly! Nagyjából 6000&nbsp;oldalon vannak beágyazva ezek a sablonok. Mielőtt módosítást javasolsz, vess egy pillantást a [[#Design_Decisions|Tervezési döntések fejezetre]]. 
|stacked=yes}}
{{Translation not complete}}

Ez a lap dokumentálja az '''{{t|1=Area}}''', '''{{t|1=node}}''', '''{{t|1=relation}}''', és '''{{t|1=way}}''' sablonok működését. Ezek a sablonok használhatóak [[Hu:Node|pontokra]], [[Hu:Way|vonalakra]] és [[Hu:Relation|kapcsolatokra]] ([[closed way|zárt vonalra]] hivatkozó terület) hivatkozó '''linkek beillesztésére''' valamint '''eszköz linkekre'''. Az összes sablon [[Module:Element|'''közös kódbázison''']] osztozik. Ennek következtében a működésük majdnem mindenben megegyezik (az {{t|1=area}} és {{t|1=relation}} kicsit eltér a többitől).<br>
A sablon 2018 őszén újra lett írva kevesebb opcióval, Luában.
{{TOC_limit|2}}

== Használat ==
Az összes itt említett sablon használata hasonló, csak a nevét kell átírnod (pl. <tt><nowiki>{{Node|...}}</nowiki></tt> helyett <tt><nowiki>{{Area|...}}</nowiki></tt>). 
Az alábbi kód 
 <nowiki>{{node|12345}}</nowiki>
ezt eredményezi
 {{node|12345}}

Az összes paraméter áttekintése
{| class="wikitable"
|-
! Név/Sorszám !! Lehetséges értékek !! Leírás
|-
| <tt>1</tt> || Szám || egy OSM ID-re hivatkozik, '''kötelező paraméter'''
|-
| <tt>2</tt> || Szöveg || a link felirata, ''alapértelmezett: megegyezik az ID-vel''
|-
| <tt>tools</tt> || <tt>all</tt>, <tt>josm</tt>, <tt>mini</tt>, <tt>no</tt>, or <tt>short</tt> || megjelenítendő eszköz linkek ''alapértelmezett: no''
|-
| <tt>lang</tt> || egy MediaWiki nyelvkód vagy ezen wiki egy [[Module:OSM Constants|speciális kódja]] || biztosítja a linkek megfelelő nyelvű feliratozását (lásd [[#Translation|Fordítás fejezet alább]])
|}

== Képesség lista ==

{|class="wikitable"
|-
!scope="col"| Wikikód
!scope="col"| Eredmény
!scope="col"| Megjegyzés
|-
| {{T|Relation|2345}} || {{relation|2345}} || The icon links to the [[Relation|wiki article about relations]]. 
|-
| {{T|Relation|2345|Promenade}} || {{relation|2345|Promenade}} ||
|-
| {{T|Relation|2345|3=tools=all}} || {{relation|2345|tools=all}} ||
|-
| {{T|Relation|2345|3=tools=all|4=Promenade}} || {{relation|2345|tools=all|Promenade}} ||
|-
| {{T|1=Relation|2=2345|3=tools=all|4=lang=vi}} || {{relation|2345|tools=all|lang=vi}} || translation to Vietnamese
|-
| {{T|1=Relation|2=2345|3=Promenade|4=tools=all|5=lang=ar}} || {{relation|2345|Promenade|tools=all|lang=ar}} || translation falls back to English as Arabic translation is incomplete.
|-
| {{T|1=Way|2=12346|3=tools=all|5=lang=ar}} || {{way|12346|tools=all|lang=ar}} || links displayed depending on the element
|-
| {{T|Relation|2345|3=tools=josm}} || {{relation|2345|tools=josm}} ||
|-
| {{T|Relation|2345|3=tools=josm|4=Promenade}} || {{relation|2345|tools=josm|Promenade}} ||
|-
| {{T|Relation|2345|3=tools=mini}} || {{relation|2345|tools=mini}} ||
|-
| {{T|Relation|2345|3=tools=mini|4=Promenade}} || {{relation|2345|tools=mini|Promenade}} ||
|-
| {{T|Relation|2345|3=tools=no}} || {{relation|2345|tools=no}} ||
|-
| {{T|Relation|2345|3=tools=no|4=Promenade}} || {{relation|2345|Promenade|tools=no}} ||
|-
| {{T|Relation|2345|3=tools=short}} || {{relation|2345|tools=short}} ||
|-
| {{T|Relation|2345|3=tools=short|4=Promenade}} || {{relation|2345|tools=short|Promenade}} ||
|-
| {{T|Relation||Promenade}} || <strong class="error"><span class="scribunto-error" id="mw-scribunto-error-0">Lua error in Module:Element at line 60: Given relation id parameter is not a number.</span></strong> || Does not work, ID required.
|}

== Fordítás ==
If the parameter <tt>tools</tt> is set to <tt>all</tt>, the link labelled <tt>history</tt> will be shown. In case of {{t|1=Relation}} there is an additional link <tt>analyse</tt>. Their labels will align themselves to the page language. There is also a <tt>lang</tt> parameter for explicitly setting the language. Extracting the language of a page seems to be an expensive process (for the parser which takes longer to create the page). Unfortunately, this is also repeated for every occurrence of the template even on the same page. Therefore, translations are limited to a minimum (i.e. there is a translation with <tt>tools=all</tt> only). 

=== A <tt>lang</tt> paraméter ===
The <tt>lang</tt> parameter is used to explicitly request a translated version of the template. It translates two English texts ("analyse" and "history"). These are used with the setting <tt>tools=all</tt> only. It also adds the prefix for the link to the article "relation" (below the icon) regardless of its existence. Whilst the language is automatically detected, the link will not change without request. This is due to the fact that the icon's wikicode is generated before the language version may be detected.

=== Nyelvek fordításhoz ===
The module stores all translations in [[Module:Element/translation]]. There are the following priorities for examining the correct language:
# user input in <tt>lang</tt> parameter
# dedicated language namespace (DE, ES, FR, IT, JA, NL, RU)
# language title prefix (all other prefixes)
# English as default
This means that there is no specified fallback language used apart from English.<br>
The templates {{t|1=Hu:Relation}}, {{t|1=Pl:Relation}} and {{t|1=Pt:Relation}} are versions of this template which fall back to Hungarian, Polish and Portuguese if no user input is provided. 

=== Egy nyelv hozzáadása ===
Please paste the following lines into the code of [[Module:Element/translation]]:
<syntaxhighlight lang="Lua">
 translateAnalyse = {
 	-- other language codes alphabetically before 'code'
 	['code'] = "your translation",
 	-- other language codes alphabetically after 'code'
 },
 translateHistory = {
 	-- other language codes alphabetically before 'code'
 	['code'] = "your translation",
 	-- other language codes alphabetically after 'code'
 },
</syntaxhighlight>

=== Hiányzó nyelv ===
If there is no complete translation, the page is also added to one of the subcategories of [[:Category:Pages_with_missing_translation|Category:Pages with missing translation]]. This is useful for finding missing translations in this wiki. The language name is read from [[Module:OSM Constants]] or <tt>mw.language.fetchLanguageName(pageLanguage, 'en')</tt>.

== Tervezési döntések ==
This section aims to explain why this template works this way. It should be read before proposing any changes. There may be different opinions (see [[Template_talk:Relation|Discussion page]]), but this documentation only focuses on the current implementation. 
; Why are the tools not shown by default?
: This is simply too "expensive" (see [[#Translation|translation]]). This setting would result in many pages being displayed in maintenance categories like [[:Category:Pages where template include size is exceeded]]. It would also assume that everyone using this template (think of a mapper fixing a wiki error without wiki background) wants to have all tools available. 
; Why are there so few tools only?
: This is a general purpose template, if you need special links, you can add them directly to your page. Please remember that the parser is not able to cache this template, so if you link to five relations, it has to create 35 (= 5 * 7) links in the worst case (i.e. displaying all tools).
; Why was the "undefined relation" option dropped?
: Simply because it fails its purpose: This template is for linking to a relation, if there is no relation (yet) you can simply leave out this template (this is commonly done now anyway). This would be like a link to a web page with an "under construction" banner only. In addition, as it displayed text, it had to compute the page language and translate the text for every call, a functionality that can be archived at lower cost by inserting the text itself. 
; Why is there no "status"?
: [[Template:State]] provides a more detailed way of documenting mapping statuses. 
; Why are shortened URLs used instead of the long forms?
: There are pages that include this template over 1000&nbsp;times. Replacing short URLs like <tt>osm.org</tt> with <tt>openstreetmap.org</tt> would increase the size of the expanded text by 11&nbsp;characters. The change would scale up to 11,000&nbsp;characters in such an article. There are also options which use multiple links, this would result in an even bigger increase.


{{ElementTemplates}}
[[Category:Hu:Link to hardcoded object ID templates]]