Quelltext der Seite Vorlage:PersonZelle/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
{ "description": "'''Personenname''' in einer '''Zelle''' einer '''sortierbaren Tabelle''' richtig sortierbar machen<noexport>; ''zunächst nach dem Familiennamen'' (restliche Angaben nach [[Wikipedia:Namenskonventionen #Personen]] „Vorname&nbsp;Familienname“)</noexport> – Einfügung am Zellenanfang oder als letztes Attribut der Zelle.",
  "params": { "1":
              { "label":       "Vorname",
                "description": "Rufname(n) der Person<noexport>.<br />
Ohne diesen Parameter ist die Verwendung der Vorlage meist sinnlos; der Familienname kann direkt angegeben werden, es sei denn, er würde besondere Formen lateinischer Buchstaben enthalten.<br />
Damit die Vorlage in der Programmierung übergeordneter Vorlagen (etwa für eine Tabellenzeile), die ihre Daten anderweitig beziehen, einfacher genutzt werden kann, ist diese Situation ausdrücklich zugelassen.</noexport>",
                "type":        "line",
                "suggested":   true,
                "example":     "Petra"
              },
              "2":
              { "label":       "Familienname",
                "description": "Familienname der Person, bestimmt die Sortierreihenfolge. Bei  Künstlernamen usw. wie „[[Pelé]]“ oder „Ronaldo“ ist dieser als Familienname anzugeben.",
                "type":        "line",
                "required":    true,
                "example":     "Meier"
              },
              "3":
              { "label":       "Lemma",
                "description": "Direkt zu verlinkendes Lemma, falls vom Namen abweichend (und nicht als Klammerlemma notiert)",
                "type":        "wiki-page-name",
                "suggested":   false,
                "example":     "Johannes Paul I."
              },
              "k":
              { "label":       "Klammerinhalt",
                "description": "Rufname und Familienname formen zu verlinkendes Klammerlemma",
                "type":        "line",
                "suggested":   true,
                "example":     "Politiker, 1964"
              },
              "nl":
              { "label":       "keine Verlinkung",
                "description": "Die Angabe „1“ unterbindet die Verlinkung des Namens",
                "type":        "boolean",
                "suggested":   true,
                "default":     "0",
                "example":     "1"
              },
              "fett":
              { "label":       "Fettschrift",
                "description": "Die Angabe „1“ zeigt den Namen in Fettschrift an",
                "type":        "boolean",
                "suggested":   true,
                "default":     "0",
                "example":     "1"
              }
  },
  "format": "inline"
}
|TOC=1}}

== Quelltext ==
Wenn die Zelle keine Attribute enthällt wird die Vorlage am Zellenanfang eingefügt. Sind für die Zelle Attribute (class, style, rowspan, colspan,…) geschrieben, wird die Vorlage nach dem letztem Attribut eingefügt. Die Vorlage schreibt das Attribut ''data-sort-value'', das Pipe-Symbol <code>|</code> und den sichtbaren Personennamen:
<pre>
|-
| {{PersonZelle|Franz|Bäcker}} || Spalte 2
|-
| Spalte 1 || {{PersonZelle|Ernst von|Bodelschwingh}}
|-
| class="hintergrundfarbe6" {{PersonZelle|Hein|Blöd}} {{Anker|B}} mehr Text || {{PersonZelle||Simplicissimus}}
</pre>

== Beispiele ==
{| class="wikitable toptextcells sortable"
|+ Parametersyntax
|- class="hintergrundfarbe6"
!class="unsortable"| Beispiel für
! Vorlage-Syntax
! Ausgabe in der Zelle
|-
| keine Besonderheiten || <code><nowiki>{{PersonZelle|Franz|Bäcker}}</nowiki></code> || {{PersonZelle|Franz|Bäcker}}
|-
| Klammerlemma || <code><nowiki>{{PersonZelle|Peter|Muster|k=Gummistiefelweitwerfer}}</nowiki></code> || {{PersonZelle|Peter|Muster|k=Gummistiefelweitwerfer}}
|-
| Klammerlemma (veraltet) oder sonst abweichend || <code><nowiki>{{PersonZelle|Peter|Muster|Peter Muster (Gummistiefelweitwerfer)}}</nowiki></code> || {{PersonZelle|Peter|Muster|Peter Muster (Gummistiefelweitwerfer)}}
|-
| keine Verlinkung || <code><nowiki>{{PersonZelle|Gunnar|Einarsson|nl=1}}</nowiki></code> || {{PersonZelle|Gunnar|Einarsson|nl=1}}
|}

{| class="wikitable toptextcells sortable"
|+ Parameterkombinationen und Wirkung
|- class="hintergrundfarbe6"
! 1
! 2
! 3
! k
! nl
! fett
! Name
! Generiert
|-
| Theodor W.
| Adorno
|
|
|
|
| {{PersonZelle|Theodor W.|Adorno}}
| {{#tag:nowiki|{{PersonZelle|Theodor W.|Adorno}}}}
|-
|
| Loriot
|
|
|
|
| {{PersonZelle||Loriot}}
| {{#tag:nowiki|{{PersonZelle||Loriot}}}}
|-
|
| Molière
|
|
|
|
| {{PersonZelle||Molière}}
| {{#tag:nowiki|{{PersonZelle||Molière}}}}
|-
| Irena
| Česneková
|
|
|
|
| {{PersonZelle|Irena|Česneková}}
| {{#tag:nowiki|{{PersonZelle|Irena|Česneková}}}}
|-
| Veronika
| Zvařičová
|
|
|
|
| {{PersonZelle|Veronika|Zvařičová}}
| {{#tag:nowiki|{{PersonZelle|Veronika|Zvařičová}}}}
|-
| Peter
| Muster
| Peter Muster (Gummistiefelweitwerfer)
|
|
|
| {{PersonZelle|Peter|Muster|Peter Muster (Gummistiefelweitwerfer)}}
| {{#tag:nowiki|{{PersonZelle|Peter|Muster|Peter Muster (Gummistiefelweitwerfer)}}}}
|-
| Wladimir
| Putin
| Wladimir Wladimirowitsch Putin
|
|
|
| {{PersonZelle|Wladimir|Putin|Wladimir Wladimirowitsch Putin}}
| {{#tag:nowiki|{{PersonZelle|Wladimir|Putin|Wladimir Wladimirowitsch Putin}}}}
|-
| Michael
| Müller
|
| Politiker, 1964
|
|
| {{PersonZelle|Michael|Müller|k=Politiker, 1964}}
| {{#tag:nowiki|{{PersonZelle|Michael|Müller|k=Politiker, 1964}}}}
|-
| Charles
| Eblé
|
|
|
|
| {{PersonZelle|Charles|Eblé}}
| {{#tag:nowiki|{{PersonZelle|Charles|Eblé}}}}
|-
| Gunnar
| Einarsson
|
|
| <code>1</code>
|
| {{PersonZelle|Gunnar|Einarsson|nl=1}}
| {{#tag:nowiki|{{PersonZelle|Gunnar|Einarsson|nl=1}}}}
|-
| Hosni
| Mubarak
|
|
|
|
| {{PersonZelle|Hosni|Mubarak}}
|{{#tag:nowiki|{{PersonZelle|Hosni|Mubarak}}}}
|-
| Winfried
| Kretschmann
|
|
|
|
|class="hintergrundfarbe9" {{PersonZelle|Winfried|Kretschmann}}
| {{#tag:nowiki|{{PersonZelle|Winfried|Kretschmann}}}}
|-
| Michael
| Müller
|
| Politiker, 1964
|
| <code>1</code>
| {{PersonZelle|Michael|Müller|k=Politiker, 1964|fett=1}}
| {{#tag:nowiki|{{PersonZelle|Michael|Müller|k=Politiker, 1964|fett=1}}}}
|-
| Charles
| Eblé
|
|
|
| <code>1</code>
| {{PersonZelle|Charles|Eblé|fett=1}}
| {{#tag:nowiki|{{PersonZelle|Charles|Eblé|fett=1}}}}
|-
| Gunnar
| Einarsson
|
|
| <code>1</code>
| <code>1</code>
| {{PersonZelle|Gunnar|Einarsson|nl=1|fett=1}}
| {{#tag:nowiki|{{PersonZelle|Gunnar|Einarsson|nl=1|fett=1}}}}
|-
| Gunnar
| Einarsson
|
|
| <code>1</code>
| <code>0</code>
| {{PersonZelle|Gunnar|Einarsson|nl=1|fett=0}}
| {{#tag:nowiki|{{PersonZelle|Gunnar|Einarsson|nl=1|fett=0}}}}
|}
Česneková wird in Spalte 2 hinter Z sortiert; steht in Spalte „Name“ zwischen Adorno und Eblé. Müller wird immer richtig sortiert, weil der Sortieralgorithmus für die deutschsprachige Wikipedia die deutschsprachigen äöüß kennt; nicht aber Akzente und weitere diakritische Gemeinheiten.

== [[Vorlage:SortKeyName]] ==
Bis 2017 hatte [[Vorlage:SortKeyName]] diese Aufgabe mit den früher möglichen syntaktischen Konstrukten wahrgenommen. Dies kann wie folgt umgestellt werden:
* eine an Zellenattribute angefügte Pipe eliminieren;
* sollte die bisherige Einbindung sich nicht an Pipe <code>|</code> oder auch <code>!</code> unmitttelbar anschließen, war die bisherige Verwendung sinnfrei und wirkungslos gewesen, darf aber auch nicht ersetzt werden.
* Leerzeichen zwischen dem Tabellensymbol und der Vorlageneinbindung sind nicht relevant.
Ansonsten ist die neue Vorlage parameterkompatibel (betreffend bisheriger Parameter); es muss nur der Name angepasst werden.

Frühere Rücksichtnahmen auf Akzente und weitere [[Diakritisches Zeichen|diakritische Zeichen]] und besondere Formen lateinischer Buchstaben sind hinfällig.

== Wartung und Fehlermeldungen  ==
* In [[:Kategorie:ÖsterreichWiki:Vorlagenfehler/Vorlage:PersonZelle]] werden Seiten mit fehlerhaften Einbindungen aufgelistet (zurzeit&nbsp;<code>{{PAGESINCATEGORY:Wikipedia:Vorlagenfehler/Vorlage:PersonZelle}}</code>)
* Bei enzyklopädischen Artikeln sehen Benutzer mit Sichterrechten Fehlermeldungen in der Tabelle; auf allen anderen Seiten sind die Fehlermeldungen immer sichtbar.
* Alle Benutzer sehen bei Quelltextbearbeitung in der Vorschau eine Liste der Fehler im Seitenkopf, verlinkend auf Fehlermeldungen in der Tabelle.
<includeonly>
{{Lua-Vorlage|Vorlage:PersonZelle #f}}
[[Kategorie:Vorlage:Tabellenformatierung]]
</includeonly>