Modul:Tennisturniere-Damen/Doku

Das Modul:Tennisturniere-Damen erzeugt eine Tabelle mit den Turnierergebnissen der wichtigsten Turniere der WTA Tour. Für 1990-2008 sind das die Turniere der Kategorie Tier I, für 2009-2020 die der Kategorien Premier Mandatory und Premier 5 und ab 2021 die der Kategorie WTA-1000. Für die Parameter siehe Vorlage:Tennisturniere-Dameneinzel bzw Vorlage:Tennisturniere-Damendoppel.

Die Funktion TennisturniereDamen ist zuständig für die Erzeugung der Tabelle und der ersten Zeile mit den Links auf die jeweiligen WTA Tour Artikel (wie zB WTA Tour 2021). Daneben wird die Funktion isUsed genutzt, um für jedes Turnier festzustellen, ob es einen Eintrag dafür gibt, oder ob die jeweilge Turnierzeile weggelassen werden kann. Wird die Zeile benötigt (isUsed gibt true zurück), so wird die Funktion getRow genutzt, um die Ergebnisse des Turniers in einer Zeile zusammen zu fassen.

Die Funktion getRow stellt für jedes über die Parameter vorgegebene Jahr fest, ob das Turnier stattgefunden hat (mittels der Funktion wasHeld) und ob es in einer der oben genannten Kategorien war (über die Funktion differentCategory). Gibt wasHeld true zurück und differentCategory false, so wird das über Parameter angegebene Resultat des jeweiligen Turniers in die Zeile eingetragen, anderenfalls entweder n.a. für nicht ausgetragen oder a.K. für andere Kategorie. In der Funktion sind die Links auf die jeweiligen Turnierartikel hard coded. Falls sich an einem Turniernamen mehr als die Jahreszahl ändert, muss diese Funktion also erweitert werden.

Die Funktion differentCategory prüft ob das Turnier im jeweiligen Jahr einer der oben angegebenen Kategorien angehört hat. Die Kategoriezugehörig der Turniere ist in dieser Funktion hard coded.

Die Funktion wasHeld prüft ob das Turnier im jeweilgen Jahr stattgefunden hat. Wann welches Turnier stattgefunden hat ist in dieser Funktion hard coded.

Einsprungpunkte in das Modul sind die Funktionen TennisturniereDamenEinzel bzw TennisturniereDamenDoppel, die dafür sorgen, dass die Links in der Tabelle auf den entsprechenden Wettkampf gesetzt werden.

Änderungsbedarf

neues Turnier wird in die Kategorien aufgenommen

In diesem Fall ist die Funktion TennisturniereDameneinzel zu ergänzen um einen Dreizeiler der Form:

if isUsed(frame, firstYear, lastYear, 'DOH') then
  table:node(getRow(frame, 'WTA Doha|Doha', '#', 'DOH', firstYear, lastYear)):newline()
end

Dabei ist DOH durch das Kürzel des neuen Turniers zu ersetzen und WTA Doha|Doha durch den Übersichtsartikel des neuen Turniers vor der Pipe und seine Bezeichnung in der Tabelle dahinter.

Zusätzlich müssen die Funktionen getRow, differentCategory und wasHeld um elseif Blöcke für das neue Turnier erwaeitert werden.

Turnierartikel wird umbenannt

Wird der Turnierartikel umbenannt (mehr als die Jahreszahl ändert sich), muss der zugehörige elseif Block des Turniers in der Funktion getRow angepasst werden.

Turnier findet nicht (mehr) statt

Der zugehörige elseif Block in der Funktion wasHeld muss angepasst werden.

Turnier rutscht in eine andere Kategorie

Der zugehörige elseif Block in der Funktion differentCategory muss angepasst werden.

Die WTA Tour wird umbenannt

Davon ist nur die erste Zeile der Tabelle betroffen. Diese wird in der Funktion TennisturniereDameneinzel erzeugt. Es muss also die Loop

for year = firstYear, lastYear
do
  head:node(mw.html.create('th'):wikitext('[[WTA Tour ' .. year .. '|' .. year .. ']]'))
end

zu zwei (oder mehr) Loops geändert werden.

for year = firstYear, letztesJahrWTATour
do
  head:node(mw.html.create('th'):wikitext('[[WTA Tour ' .. year .. '|' .. year .. ']]'))
end
for year = erstesJahrNeuerName, lastYear
do
  head:node(mw.html.create('th'):wikitext('[[NeuerName ' .. year .. '|' .. year .. ']]'))
end