Redigerer Mal:Konverter/dok

{{Dokumentasjonsunderside}}
<!-- LEGG TIL KATEGORIER OG INTERWIKIER PÅ BUNNEN AV DENNE SIDEN -->
<includeonly>{{Lua|Modul:Convert}}</includeonly>
== Formål ==
Konvertere enheter der dette er nødvendig eller ønskelig. Denne malen viser mengdeenheter som primær og konverterte sekundere enheter med valgfri avrunding, internlenker, forkortelser og ulike separatorer, inkludert parenteser «(&nbsp;)», «eller», bindestreker, komma, «til» eller streker. Malen bidrar til riktig konvertering fra en mengdeenhet til en annen, spesielt for mer komplekse enheter.

Malen kan bukes til blant annet avstander «{{Konverter|32|m|ft}}» og «{{Konverter|32|m|ft|disp=or}}», temperaturer «{{Konverter|18|°C|°F}}», masser «{{Konverter|55.0|kg|lb|abbr=on}}» eller «{{Konverter|65|til|80|kg|lb|abbr=on}}».

== Bruk ==
=== Eksempler ===
==== Enkeltverdier ====
{| class="wikitable"
! Input !! Vises som
|-
|<nowiki>{{Konverter|3.21|kg|lb}}</nowiki>||{{Konverter|3.21|kg|lb}}
|-
|<nowiki>{{Konverter|3.21|kg|lb|0}}</nowiki>||{{Konverter|3.21|kg|lb|0}}
|-
|<nowiki>{{Konverter|10|kg|lb|disp=eller}}</nowiki>||{{Konverter|10|kg|lb|disp=eller}}
|-
|<nowiki>{{Konverter|6|ft|5|in|m}}</nowiki>||{{Konverter|6|ft|5|in|m}}
|-
|<nowiki>{{Konverter|10|mi}}</nowiki>||{{Konverter|10|mi}}
|-
|<nowiki>{{Konverter|120|km/t}}</nowiki>||{{Konverter|120|km/t}}
|-
|<nowiki>{{Konverter|18|°C|°F}}</nowiki>||{{Konverter|18|°C|°F}}
|-
|{{Anchor|sigfig}}<nowiki>{{Konverter|1250|sqft|m2|lk=in|sigfig=2}}</nowiki> ||{{Konverter|1250|sqft|m2|lk=in|sigfig=2}}<br/>Merk at 'lk=in' kun lenker input-enheten.
|- 
|<nowiki>{{Konverter|20.5|m3|cm3|lk=out|abbr=on}}</nowiki>||{{Konverter|20.5|m3|cm3|1|lk=out|abbr=on}}<br/>Merk at 'lk=out' lenker kun output-enheten, [[kubikkcentimeter]].
|-
|<nowiki>{{Konverter|641|acre|ha m2|lk=on}}</nowiki>||{{Konverter|641|acre|ha m2|lk=on}}<br/>Merk at 'lk=on' lenker alle enheter.
|-
|<nowiki>{{Konverter|641|acre|ha m2|2|lk=on}}</nowiki>||{{Konverter|641|acre|ha m2|2|lk=on}}
|}

==== Dobbeltverdier ====
:''Merk: Fungerer ikke for alle enheter''
{| class="wikitable"
! Input !! Vises som
|-
|<nowiki>{{Konverter|60|og|170|kg|lb}}</nowiki>||{{Konverter|60|og|170|kg|lb}}
|-
|<nowiki>{{Konverter|60|til|170|kg|lb}}</nowiki>||{{Konverter|60|til|170|kg|lb}}
|-
|<nowiki>{{Konverter|60|til(-)|170|kg|lb}}</nowiki>||{{Konverter|60|til(-)|170|kg|lb}}
|-
|<nowiki>{{Konverter|60|-|170|kg|lb}}</nowiki>||{{Konverter|60|-|170|kg|lb}}
|-
|<nowiki>{{Konverter|41|til|50|F|C}}</nowiki>||{{Konverter|41|til|50|F|C}}
|-
|<nowiki>{{Konverter|41|-|50|F|K}}</nowiki>||{{Konverter|41|-|50|F|K}}
|-
|<nowiki>{{Konverter|60|x|120|m|ft}}</nowiki>||{{Konverter|60|x|120|m|ft}}
|-
|<nowiki>{{Konverter|60|+/-|10|m|ft}}</nowiki>||{{Konverter|60|+/-|10|m|ft}}
|-
|<nowiki>{{Konverter|19|til|27|l|USgal}}</nowiki>||{{Konverter|19|til|27|l|USgal}}
|-
|<nowiki>{{Konverter|5|til|7|l|USgal}}</nowiki>||{{Konverter|5|til|7|l|USgal}}
|-
|<nowiki>{{Konverter|4|-|9|l|USgal|abbr=off}}</nowiki>||{{Konverter|4|-|9|l|USgal|abbr=off}}
|-
|}

==== Triple og firedoble verdier ====
:''Merk: Fungerer ikke for alle enheter''
{| class="wikitable"
! Input !! Vises som
|-
|<nowiki>{{Konverter/3 |2|x|4|x|6|m|ft}}</nowiki>||{{Konverter/3 |2|x|4|x|6|m|ft}}
|-
|<nowiki>{{Konverter/3 |60|-|70|-|80|kg|lb}}</nowiki>||{{Konverter/3|60|-|70|-|80|kg|lb}}
|-
|<nowiki>{{Konverter/4 |60|-|70|-|80|-|90|kg|lb}}</nowiki>||{{Konverter/4|60|-|70|-|80|-|90|kg|lb}}
|-
|<nowiki>{{Konverter/3 |60|til|80|eller|85|m|ft}}</nowiki>||{{Konverter/3 |60|til|80|eller|85|m|ft}}
|-
|<nowiki>{{Konverter/3 |11|ganger|15|, knapt|16|ft|m}}</nowiki>||{{Konverter/3 |11|ganger|15|, knapt|16|ft|m}}
|-
|<nowiki>{{Konverter/3 |41|til|50|til|60|F|C}}</nowiki>||{{Konverter/3 |41|til|50|til|60|F|C}}
|-
|<nowiki>{{Konverter/4 |2|til|12|om sommeren|25|til|36|C|F}}</nowiki>||{{Konverter/4 |2|til|12|om sommeren|25|til|36|C|F}}
|-
|<nowiki>{{Konverter/3 |41|-|50|, nesten|51|F|K}}</nowiki>||{{Konverter/3 |41|-|50|, nesten|51|F|K}}
|}
For {&#123;Konverter/3}} eller {&#123;Konverter/4}} kan separatorordet være hva som helst tekst.

=== Parametre ===
:'''Merk''': Alle parametre fungerer ikke for alle enheter.
{|
|- bgcolor="#FAFEFF" valign=top
| Valgene&nbsp;inkluderer:&nbsp;||[[#lk_in|<code>lk=in</code>]], [[#abbr_on|<code>abbr=on</code>]], [[#abbr_on|<code>abbr=off</code>]], [[#disp_or|<code>disp=x</code>]], [[#disp_table|<code>disp=table</code>]] og [[#sortable_on|<code>sortable=on</code>]] (forklart under). Som standard er output [[#Avrunding|avrundet]] for å passe med nøyaktigheten til input-verdien; alternativer inkluderer [[#sigfig|<code>sigfig=3</code>]] eller å bruke sluttparameteret «<code>&#124;1</code>» for å vise tiendeler eller «<code>&#124;-2</code>» for å vise hele hundretall osv.
|}

{| class="wikitable"
|-
! colspan="2" | Parametre
|-
| {{anchor|lk_in}}Lenke enheter
| legg til <code><nowiki>|lk=on</nowiki></code> &nbsp; for å lenke alle enheter (standard: <code>lk=off</code>)<br />legg til <code><nowiki>|lk=in</nowiki></code> &nbsp; for å lenke bare input-enhetene<br />legg til <code><nowiki>|lk=out</nowiki></code>&nbsp; for bare lenke output-enheten
|-
| {{anchor|abbr_on}}Forkortede enheter, eller ikke
| legg til<code><nowiki>|abbr=on</nowiki></code> for å vise enhetens symboler<br /> legg til <code><nowiki>|abbr=off</nowiki></code> &nbsp; for å vise alle navnene på enhetene fullt utskrevet<br /> legg til <code><nowiki>|abbr=in</nowiki></code> for bare å forkorte input-enheten<br /> legg til <code><nowiki>|abbr=out</nowiki></code> for bare å forkorte output-enheten<br /> legg til <code><nowiki>|abbr=values</nowiki></code> for å skjule enhetene og bare vise verdiene (<nowiki>{{Konverter|6|mi|abbr=values}}</nowiki> gir: {{Konverter|6|mi|abbr=values}}).
|-
| {{anchor|disp_or}}Endre «( )» til å vise andre separatorer
| legg til <code>&#124;disp=komma</code> for å sette komma i stedet for parenteser<br /> legg til <code>&#124;disp=eller</code> for å sette inn «eller» mellom enhetene<br /> Standardverdien er&nbsp; disp=b for parenteser.
|-
|-
| Endre «( )» til å vise egendefinerte separatorer
| legg til <code>&#124;disp=x&#124; (start &#124; slutt)</code> for å vise «xx (start yy slutt)». Se eksempel 1<br /> legg til <code>&#124;disp=x&#124;;</code> for å vise «xx; yy». Se eksempel 2<br /> legg til <code>&#124;disp=x&#124; (samme som &#124;)</code> for å vise «xx (samme som yy)». Se eksempel 3<br />Eksempel 1: {{nowrap|<nowiki>{&#123;Konverter|9|km|mi|disp=x| [|]}}</nowiki>}}&rarr;{{nowrap|9 kilometer [5,6 mi]}} (merk mellomrommet før <nowiki>[|</nowiki>)<br />Eksempel 2: {{nowrap|<nowiki>{&#123;Konverter|9|km|mi|disp=x|;}}</nowiki>}}&rarr;{{nowrap|9 kilometer;5,6 mi}}<br />Eksempel 3: {{nowrap|<nowiki>{&#123;Konverter|10|km|mi|disp=x| (ca. |)}}</nowiki>}}&rarr;{{nowrap|10 kilometer (ca. 6,2 mi)}} (merk mellomrommene brukt i koden).
|-
| Vis kun output
| legg til <code>&#124;disp=output only</code> for å vise resultattallet og enhet<br /> legg til <code>&#124;disp=output number only</code> for å vise bare resultattallet<br />Merk at ved bruk av «disp=output only» kan enhetsnavnet fortsatt vises som fulltekst ved abbr=off eller lenket ved lk=on. <br>Eksempel:<nowiki>  {{Konverter|7500|acre|m2|disp=output only }} </nowiki>→  {{Konverter|7500|acre|m2|disp=output only }}
|-
| Vis enheter snudd i motsatt rekkefølge
| legg til <code>&#124;disp=flip</code>&nbsp; for å snu rekkefølgen og vise output-enheten først<br /><nowiki>{{Konverter|6|km|disp=flip}}</nowiki> viser «3,7 miles (6 km)».<br />For å få symbolet «mi», bruk abbr=in for å forkorte input-enheten (den på venstre side).
|-
| Vis enhetsnavn (kun)
| legg til <code>&#124;disp=unit</code> for å vise enhetsnavnet for et symbol<br />Enhetsnavnet vil være i flertall når mengden ikke er 1, eller bindestrek ved adj=on. <nowiki>{{Konverter|2|in|disp=unit}}</nowiki> viser «tommer» i flertall.
|-
| {{anchor|disp_table}}Vis mengder som tabellceller
| legg til <code>&#124;disp=table</code> (eller <code>&#124;disp=tablecen</code>) Merk: For bruk i tabeller, må malen starte på en ny linje etter en pipe, eller etter doble pipes på samme linje. Bare nummeret vil vises med mindre du setter <code><nowiki>|abbr=on</nowiki></code>, <code><nowiki>|lk=on</nowiki></code>, <code><nowiki>|lk=in</nowiki></code> eller <code><nowiki>|lk=out</nowiki></code>. Se [[Mal:Konverter/Eksempel/Tabell|eksempel]]
|-
|{{anchor|sortable_on}}Generer en a [[Hjelp:Sortering|skjult sorteringsnøkkel]] for bruk i [[Hjelp:Sortering|sorterbare tabeller]].
| legg til <code><nowiki>|sortable=on</nowiki></code> for å generere en [[Hjelp:Sortering#Sorting with hidden sortkey|skjult sorteringsnøkkel]] slik at [[Hjelp:Sortering|sorteringstabellene]] blir sortert riktig. Dette bruker {{tl|sorterbart tall}} for å generere en nøkkel fra den første numeriske veriden. Den ignorerer tilleggsverdier, det vil si hvis du bruker <code>6|ft|2|in</code> som verdi, vil den bare bruke 6 til sorteringsnøkkelen. Dette vil føre til at numeriske verdier sorteres i numerisk rekkefølge, det vil si 5, 10, 15 i stedet for 10, 15, 5.
|}

=== Avrunding ===
''Konverter'' støtter fire typer avrunding:
;Avrunding til en gitt nøyaktighet
:Angi ønsket nøyaktighet med det fjerde navnløse parameteret (eller tredje navnløse hvis «konverter til»-parameteret er utelatt; eller femte navnløse hvis en rekke er spesifisert; eller fjerde parameter igjen hvis en reke er angitt og «konverter til»-parameteret er utelatt). Konverteringen er avrundet til nærmeste {{Brøk|1/10}} av dette nummeret. For eksempel, hvis resultatet er {{formatnum: 8621 }} og avrundingen angis som '-2', vil resultatet bli {{formatnum: 8600 }}. Hvis resultatet er '234,0283043' og avrundingen angis som '0', vil resultatet bli 234.

;Avrunding til et gitt antall signifikante tall
:Spesifiser ønsket antall signifikante tall ved å bruke <code><nowiki>|sigfig={tall større enn null}</nowiki></code> som vist [[#sigfig|over]].

;Standard avrunding
:Hvis det ikke er angitt noen ønsket avrunding eller ønsket antall signifikante tall, vil konverteringen bli avrundet enten til en nøyaktighet som passer med input-verdien (antall desimaler etter desimaltegnet – eller det negative antall ikke-signifikante nuller før tegnet – økes med én hvis konverteringen er en multiplikasjon av et tall mellom 0,02 og 0,2, reduseres med hvis det er mellom 2 og 20, osv.) eller to signifikante tall, avhengig av hva som er mest nøyaktig. Et unntak her er temperaturer, hvor konverteringen vil bli avrundet til en nøyaktighet som samsvarer med input-verdien eller til det som gir tre signifikante tall når de uttrykkes i kelvin, avhengig av hva som er mest nøyaktig.

{| class="wikitable"
|-
! colspan="3" | Eksempler på standard avrunding
|-
! Input !! Vises som||'''Merknad'''
|-
|<nowiki>{{Konverter|550|ft|m|0}}</nowiki>||{{Konverter|550|ft|m|0}}  || Omtrentlig verdi er 167,64 m
|-
|<nowiki>{{Konverter|550|ft|m}}</nowiki>||{{Konverter|550|ft|m}} || Avrunder til 170, mens den omtrentlige verdien er 167,64 m
|-
|<nowiki>{{Konverter|500|ft|m|0}}</nowiki>||{{Konverter|500|ft|m|0}}  ||  Omtrentlig verdi er 152,4 m
|-
|<nowiki>{{Konverter|500|ft|m}}</nowiki>||{{Konverter|500|ft|m}}  || Avrunder til 150, mens den omtrentlige verdien er 152,4 m
|}

=== Enheter ===
{{Konverter/liste over enheter}}

=== Nye enheter ===
For å opprette nye enheter legger du inn malen med de parametrene som den skal ha. Hvis enhetene ikke støttes, eller det mangler noen undermaler, vil det komme opp en rød lenke der malen er satt inn. Opprett disse rødlenkene med basis fra en:wp og tilpass de til norsk. Hvis du for eksempel får en rødlenke som heter ''Mal:Konverter/'''et eller annet''''', er det siden ''Template:Convert/'''et eller annet''''' som skal kopieres og tilpasses. 

Når du oppretter maler for enheter, er det noen parametre som ofte må tilpasses norsk språk. Dette er parametrene <code>|n=</code>, som er enhetens fulle navn, <code>|l=</code> som er enhetens flertallsform, <code>|t=</code>, som er artikkelen det skal lenkes til, og <code>|h=</code>, som er enhetens adjektivform.

#Hvis for eksempel enhetens fulle navn, flertallsform og vår artikkel heter det samme, trenger man bare angi parameteret <code>|n=</code>. Se for eksemepel [[Mal:Konverter/m|meter]].
#Hvis entallsformen og vår artikkel heter det samme, men flertallsformen er ulik, må det settes inn både <code>|n=</code> og <code>|l=</code>. Se for eksempel [[Mal:Konverter/AE|astronomisk enhet]]
#Hvis hverken entallsformen, flertallsformen eller vår artikkel heter det samme, må det settes inn både <code>|n=</code>, <code>|l=</code> og <code>|t=</code>. Se for eksempel [[Mal:Konverter/"|tomme]].

== Se også ==
*{{tl|M til ft}}

<includeonly>
<!-- KATEGORIER OG INTERWIKIER UNDER DENNE LINJEN -->
[[Kategori:Konverteringsmalen]]
[[Kategori:Matematiske maler|{{PAGENAME}}]]

[[ar:قالب:Convert]]
[[bn:টেমপ্লেট:Convert]]
[[ca:Plantilla:Convert]]
[[en:Template:Convert]]
[[es:Plantilla:Convert]]
[[et:Mall:Convert]]
[[fr:Modèle:Conversion]]
[[ko:틀:단위 변환]]
[[id:Templat:Convert]]
[[it:Template:Converti]]
[[ja:Template:Convert]]
[[map-bms:Cithakan:Convert]]
[[os:Шаблон:Convert]]
[[pt:Predefinição:Convert]]
[[ro:Format:Conversie]]
[[sco:Template:Convert]]
[[simple:Template:Convert]]
[[tpi:Template:Convert]]
[[su:Citakan:Convert]]
[[th:แม่แบบ:Convert]]
[[vi:Bản mẫu:Convert]]
[[zh:Template:Convert]]
</includeonly>