Redigerer Mal:Språk/dok (avsnitt)

== 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}})