Redigerer Mal:Språk/dok

{{Dokumentasjonsunderside}}
<!-- LEGG TIL KATEGORIER OG INTERWIKIER PÅ BUNNEN AV DENNE SIDEN -->
{{Malsnarvei|annet språk|lang}}

== Formål ==

For tekst som er på andre språk enn bokmål/riksmål, gir denne malen muligheten til å merke hvilket språk teksten er på. I de fleste nettlesere fører ikke bruk av malen til noen synlige endringer, men programvare for tekst-til-tale, som brukes av blant andre synshemmede, kan bruke merkingen til å velge riktig uttale, og det kan også hjelpe vanlige nettlesere til å velge en fornuftig font for det aktuelle språket.

== Bruk == 
<templatedata>
{
	"description": "Mal som merker fremmedspråklig tekst med riktige metadata.",
	"paramOrder": [
		"1",
		"2",
		"translit",
		"lenke",
		"div",
		"rtl"
	],
	"params": {
		"1": {
			"description": "ISO 639-språkkoden til språket.",
			"type": "string",
			"required": true,
			"label": "Språkkode",
			"example": "ru"
		},
		"2": {
			"description": "Selve den fremmedspråklige teksten",
			"type": "string",
			"required": true,
			"label": "Tekst",
			"example": "Россия"
		},
		"translit": {
			"description": "Den samme teksten translittert til det latinske alfabet",
			"type": "string",
			"required": false
		},
		"lenke": {
			"description": "Angis dersom man ønsker lenke til språket",
			"type": "boolean"
		},
		"div": {
			"description": "Angis dersom man ønsker en div-tag istedenfor en span-tag",
			"type": "boolean"
		},
		"rtl": {
			"description": "Angis dersom avsnittet består av høyre-til-venstre tekst",
			"type": "boolean"
		}
	},
	"format": "inline"
}
</templatedata>
* Det første argumentet er være språkets [[ISO 639]]-kode, enten ISO 639-1 eller ISO 639-3 (helst ikke ISO 639-2). 
* Det andre argumentet er selve teksten på det fremmede språket.
* Hvis teksten er på et fremmed alfabet, kan en velge å bruke <code>translit=</code> for å også legge til den samme teksten translitterert til det latinske alfabet.
* Hvis teksten er et helt avsnitt kan det gis et argument <code>div</code> for å bruke [[Span og div|div]]-tag istedenfor [[Span og div|span]]-tag (som er standard). 
* For hele avsnitt bestående av høyre-til-venstre tekst, kan det gis et argument <code>rtl</code> for å høyrejustere avsnittet. Argumentet <code>rtl</code> benyttes vanligvis kun sammen med <code>div</code>, men i noen spesielle tilfeller kan det også være nødvendig i andre tilfeller (les mer om det under).

== Eksempler ==

=== Enkelt eksempel ===

<code><nowiki>{{språk|fr|C'est en français}}</nowiki></code> gir <code><nowiki><span lang="fr" xml:lang="fr">C'est en français</span></nowiki></code>

Siden tekst på andre språk i de fleste nettlesere ikke skiller seg ut visuelt fra annen tekst, anbefales det å sette tekst på andre språk i ''kursiv'':
 <code><nowiki>''{{språk|fr|C'est en français}}''</nowiki></code>
som gir
 ''{{språk|fr|C'est en français}}''

=== Merking av skriftsystem ===

Hvis nødvendig kan [[ISO 15924]]-koder brukes for å indikere skriftsystem.

For eksempel skrives [[russisk]] vanligvis med [[det kyrilliske alfabet]], derfor er det unødvendig og overflødig å spesifisere <var>Cyrl</var>. Bruk bare <var>ru</var> fremfor <var>ru-Cyrl</var>. Hvis teksten derimot er [[Transkripsjon (språkvitenskap)|transkribert]] til [[det latinske alfabet]], bruk <var>ru-Latn</var> eller <var>ru-Latn-NO</var> for å indikere at [[Wikipedia:Transkripsjon fra kyrillisk|norske transkripsjonsregler]] er brukt.  Eksempel:

<pre>
 Moskva ([[russisk]]: {{språk|ru|Москва́}}, {{språk|ru-Latn-NO|''Moskva''}})
</pre>

[[Internet Assigned Numbers Authority|IANA]] vedlikeholder en liste over når skriftsystem bør indikeres og ikke.[http://www.iana.org/assignments/language-subtag-registry]

=== Div og span ===
For tekst som inneholder linjebrekk er det fornuftig å bruke div fremfor span:

{| class="wikitable"
|-
! Kode
! Resultat
|-
| <pre style="border:0px">{{språk|ga|Lá breithe mhaith agat.}}</pre>
| {{språk|ga|Lá breithe mhaith agat.}}
|-
| <pre style="border:0px">{{språk|na|Nauru bwiema, ngabena ma auwe.<br />
Ma dedaro bwe dogum, mo otata bet egom.<br />
Atsin ngago bwien okor, ama bagadugu<br />
Epoa ngabuna ri nan orre bet imur.<br />
Ama memag ma nan epodan eredu won engiden,<br />
Miyan aema ngeiyin ouge,<br />
Nauru eko dogin|div}}</pre>
| {{språk|na|Nauru bwiema, ngabena ma auwe.<br />
Ma dedaro bwe dogum, mo otata bet egom.<br />
Atsin ngago bwien okor, ama bagadugu<br />
Epoa ngabuna ri nan orre bet imur.<br />
Ama memag ma nan epodan eredu won engiden,<br />
Miyan aema ngeiyin ouge,<br />
Nauru eko dogin|div}}
|}

=== Høyre-til-venstre tekst===

Vanligvis kan høyre-til-venstre tekst settes inn akkurat som venstre-til-høyre tekst. Eksempel:
<pre>Wikipedia ({{språk|ar|ويكيبيديا:عن}}) er en internasjonal internettbasert encyklopedi.</pre>
gir
: Wikipedia ({{språk|ar|ويكيبيديا:عن}}) er en internasjonal internettbasert encyklopedi.
Hvis høyre-til-venstre teksten også inneholder latinske tegn, kan det være nødvendig å spesifisere parameteren <code>rtl</code> (right-to-left). Denne parameteren setter inn <code><nowiki>direction:rtl; unicode-bidi: embed;</nowiki></code>. I praksis er dette svært sjeldent nødvendig.

For hele avsnitt på høyre-til-venstre språk vil det derimot være gunstig å høyrejustere avsnittet. Dette gjøres ved å spesifisere parameteren <code>div</code> for å indikere ''avsnitt'' og parameteren <code>rtl</code> for å indikere ''høyre-til-venstre'' (right-to-left). Eksempel:
:<code><nowiki>{{språk|ar|</nowiki><span style="direction:rtl;unicode-bidi:embed">'''هنريك يوهان إبسن''' (Henrik Johan Ibsen؛ 20 مارس 1828 - 23 مايو 1906)&lrm;</span></code>
:<code><span style="direction:rtl;unicode-bidi:embed"> كاتب مسرحي نرويج، يعرف بـ "أبو المسرح الحديث". له 26 مسرحية.&lrm;</span></code>
:<code><span style="direction:rtl;unicode-bidi:embed">كانت شهرته تأتي بعد شكسبير.&lrm;</span><nowiki> |div|rtl}}</nowiki></code>
gir
{{språk|ar|هنريك يوهان إبسن (Henrik Johan Ibsen؛ 20 مارس 1828 - 23 مايو 1906) كاتب مسرحي نرويجي، يعرف بـ "أبو المسرح الحديث". له 26 مسرحية. كانت شهرته تأتي بعد شكسبير.|div|rtl}}
men hvis vi utelater <code>rtl</code>:
:<code><nowiki>{{språk|ar|</nowiki><span style="direction:rtl;unicode-bidi:embed">'''هنريك يوهان إبسن''' (Henrik Johan Ibsen؛ 20 مارس 1828 - 23 مايو 1906)&lrm;</span></code>
:<code><span style="direction:rtl;unicode-bidi:embed"> كاتب مسرحي نرويج، يعرف بـ "أبو المسرح الحديث". له 26 مسرحية.&lrm;</span></code>
:<code><span style="direction:rtl;unicode-bidi:embed">كانت شهرته تأتي بعد شكسبير.&lrm;</span><nowiki> |div}}</nowiki></code>
får vi
{{språk|ar|هنريك يوهان إبسن (Henrik Johan Ibsen؛ 20 مارس 1828 - 23 مايو 1906) كاتب مسرحي نرويجي، يعرف بـ "أبو المسرح الحديث". له 26 مسرحية. كانت شهرته تأتي بعد شكسبير.|div}}
Legg merke til at når latinske tegn er inkludert i den arabiske teksten, blir rekkefølgen også feil her!

=== Lenke til språk ===
Malen har støtte for å genere lenke til språket fra språkkoden for noen språk, men denne støtten er langt fra komplett, og trolig er det like greit å sette inn lenke til språket manuelt istedet. Diskuter gjerne på diskusjonssiden.
<pre>
''Gi meg et fast punkt, og jeg skal bevege hele jorden'' ({{språk|grc|Δοσ μοι που στω και κινω την γην|lenke}}),
</pre>
gir
''Gi meg et fast punkt, og jeg skal bevege hele jorden'' ({{språk|grc|Δοσ μοι που στω και κινω την γην|lenke}})

== Se også == 
* {{tl|zh}} for kinesisk tekst
* {{tl|ar}} er en snarvei for {{tlc|språk|ar}} for arabisk tekst

== Eksterne lenker ==
* [http://www.w3.org/International/questions/qa-lang-why Why use the language attribute?] W3C

<includeonly>
<!-- KATEGORIER OG INTERWIKIER UNDER DENNE LINJEN -->
{{DEFAULTSORT:{{PAGENAME}}}}
[[Kategori:Hjelpemaler]]
[[Kategori:Språkmaler]]
</includeonly>