Quelltext der Seite Vorlage:SortKey/Doku

<noinclude>{{Dokumentation/Dokuseite}}
</noinclude>{{VoWP}}
{{Veraltete Vorlage|das Attribut <tt>data-sort-value</tt>|2=[[#Beispiele mit Attribut]]}}
Diese Vorlage wurde vor Einführung des Tabellenzellen-Attributs <tt>data-sort-value</tt> verwendet, um bei sortierten Tabellen die richtige Sortierung von Einträgen in Tabellenspalten zu erreichen.
Analog zu [[Hilfe:Kategorien#Sortierung der Seiten in einer Kategorie]] müssen alle Sonderzeichen und Buchstaben mit [[Diakritisches Zeichen|diakritischen Zeichen]] (Akzente etc.) durch die 26 Grundbuchstaben des [[Lateinisches Alphabet|lateinischen Alphabets]] ersetzt werden.

Damit der Tabelleninhalt richtig einsortiert wird, werden die Umlaute ü→u, ö→o, ä→a, ß→ss seit Dezember 2011 von der Software automatisch ersetzt. Weitere Sonderzeichen (é→e, č→c, …) können mit dieser Vorlage oder seit September 2012 mit dem Attribut <code>data-sort-value</code> ersetzt werden.

Um eine Darstellung von Namen nach den [[Wikipedia:Namenskonventionen#Personen]] als ''vorname nachname'', aber Sortierung nach ''nachname, vorname'' zu erreichen, kann auch die [[Vorlage:SortKeyName]] verwendet werden, allerdings nur, wenn der Name keine Sonderzeichen enthält. 

Eine Beschreibung der genauen Hintergründe findet sich in [[Meta:Help:Sorting#Specifying a sort key]] (englisch).

''Siehe auch:'' [[Vorlage:Dts]] für Datumsangaben, [[Vorlage:Nts]] und [[Vorlage:0]] für Zahlen, [[Vorlage:SortKeyName]] für Personennamen

== Verwendung ==

Der '''erste Parameter''' gibt den Sortierschlüssel an, der zusammen mit dem nachfolgenden Rest der Tabellenzelle zur Sortierung verwendet wird,<br />
der '''optionale zweite Parameter''' den anzuzeigenden Text.

* <code><nowiki>{{SortKey|Departement|[[Département]]}}</nowiki></code> → {{SortKey|Departement|[[Département]]}} (mit anzuzeigendem Wert)
* <code><nowiki>{{SortKey|Departement}} Département</nowiki></code> → {{SortKey|Departement}} Département (anzuzeigender Wert nachfolgend)
* <code><nowiki>{{SortKey|Departement}}</nowiki></code> → {{SortKey|Departement}} (ohne anzuzeigenden Wert)

== Beispiele mit Vorlage ==

{| class="wikitable sortable"
|- class="hintergrundfarbe6"
!class="unsortable"|Vorlage-Syntax !! Ausgabe !! Sortierwert
|-
|<code><nowiki>{{SortKey|Maier, Franz|Franz Maier}}</nowiki></code>|| {{SortKey|Maier, Franz|Franz Maier}}|| maier, franz!franz maier
|-
|<code><nowiki>{{SortKey|Muller, Franz}}Franz Müller<sup>Anmerkung</sup></nowiki></code>|| {{SortKey|Muller, Franz}}Franz Müller <sup>Anmerkung</sup>|| muller, franz!franz muller anmerkung
|-
|<code><nowiki>{{SortKey|Musterfrau, Franz|Franz Musterfrau}}</nowiki></code>|| {{SortKey|Musterfrau, Franz|Franz Musterfrau}}|| musterfrau, franz!franz musterfrau 
|}

== Beispiele mit Attribut ==

Es wird nur der Wert des Attributes <code>data-sort-value</code> zum Sortieren verwendet. Bei der Vorlage wurde auch der Zelleninhalt mit verwendet. Enthält das Attribut beispielsweise nur Ziffern wird – anders als bei der Vorlage – auch ''numerisch'' sortiert!
{| class="wikitable sortable"
|- class="hintergrundfarbe6"
!class="unsortable"|Vorlage-Syntax !! Ausgabe !! Sortierwert
|-
|<code><nowiki>data-sort-value="Maier, Franz"|Franz Maier</nowiki></code>|| data-sort-value="Maier, Franz"|Franz Maier|| maier, franz
|-
|<code><nowiki>data-sort-value="Muller, Franz"|Franz Müller<sup>Anmerkung</sup></nowiki></code>|| data-sort-value="Muller, Franz"|Franz Müller<sup>Anmerkung</sup>|| muller, franz
|-
|<code><nowiki>data-sort-value="Musterfrau, Franz"|Franz Musterfrau</nowiki></code>|| data-sort-value="Musterfrau, Franz"|Franz Musterfrau|| musterfrau, franz
|}