Modul:Tennisturniere-Herren/Doku

Das Modul:Tennisturniere-Herren erzeugt eine Tabelle mit den Turnierergebnissen der ATP 1000 Turniere. Für die Parameter siehe Vorlage:Tennisturniere-Herreneinzel bzw Vorlage:Tennisturniere-Herrendoppel.

Die Funktion TennisturniereHerren ist zuständig für die Erzeugung der Tabelle und der ersten Zeile mit den Links auf die jeweiligen ATP Tour Artikel (wie zB ATP 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). Gibt wasHeld true zurück, so wird das über Parameter angegebene Resultat des jeweiligen Turniers in die Zeile eingetragen, anderenfalls wird die Zelle ausgegraut. 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 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 TennisturniereHerrenEinzel bzw TennisturniereHerrenDoppel, die dafür sorgen, dass die Links in der Tabelle auf den entsprechenden Wettkampf gesetzt werden.

Änderungsbedarf

neues ATP 1000 Turnier

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

if isUsed(frame, firstYear, lastYear, 'XXX') then
  table:node(getRow(frame, 'ATP XXX|XXX', '#', 'XXX', firstYear, lastYear)):newline()
end

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

Zusätzlich müssen die Funktionen getRow und wasHeld um elseif Blöcke für das neue Turnier erweitert 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.

Die ATP Tour wird umbenannt

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

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

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

for year = letztesJahrNeuerName, erstesJahrNeuerName, -1
do
  head:node(mw.html.create('th'):wikitext('[[NeuerName ' .. year .. '|' .. year .. ']]'))
end
for year = lastYearATPTour, firstYear, -1
do
  head:node(mw.html.create('th'):wikitext('[[ATP Tour ' .. year .. '|' .. year .. ']]'))
end