PROFILPELAJAR.COM

Wikipedia:Lua/Modul/CatUtil

Vorlagenprogrammierung Diskussionen Lua Unterseiten
Modul Deutsch English

Modul: Dokumentation

CatUtil – Modul mit Hilfsfunktionen im Zusammenhang mit Kategorien.

Funktionen für Vorlagen

count
Gesamtzahl der Elemente (Seiten) in mehreren Kategorien.
Das Ergebnis ist eine unformatierte Zahl (ohne Tausendertrennzeichen), sonst eine formatierte Fehlermeldung bei unerlaubten Parametern oder ein ergebnisabhängiger Alternativtext.
Bis zu 400 Titel von Kategorien können ausgezählt werden; siehe Hilfe:Vorlagenbeschränkungen #expensive.
Parameter der umgebenden Vorlageneinbindung (alle optional):
1
Titel der ersten auszuzählenden Kategorie.
Als Titel darf der Namensraum Kategorie: nicht vorangestellt sein.
Weder muss eine Kategoriebeschreibungsseite vorhanden sein, noch muss es Einträge geben. Es wird durchgezählt, ob irgendwo im Projekt etwas auf diese Weise kategorisiert wurde.
2 3 4 5 6 7 8 9 …
Beliebig viele weitere Titel von Kategorien.
Die numerisch angegebenen Parameter müssen nicht lückenlos aufeinander folgen. Bei den in der Regel zu erwartenden unbenannten Parametern wäre das allerdings automatisch der Fall.
scope
Art der zu zählenden Einträge.
Einer von pages files subcats all – Seiten, Mediendateien, Unterkategorien oder alle vorgenannten.
Vorgabe: pages
show0
Wenn kein Eintrag gefunden wird, dann statt der Zahl 0 diesen Text anzeigen.
Ein leerer Parameterwert unterdrückt die Anzeige.
showN
Wenn mindestens ein Eintrag gefunden wird, dann statt der Zahl diesen Text anzeigen.
Wenn der Parameter den Platzhalter %d enthält, dann an dieser Stelle die gefundene Anzahl darstellen.
  • Alle sonstigen Prozentzeichen müssen dann und nur dann durch % oder %% escaped werden.
  • Auch die Notation {{formatnum:%d}} kann eingesetzt werden, um größere Zahlen mit Tausendertrennzeichen zu formatieren.
Ein leerer Parameterwert unterdrückt die Anzeige.
show1
Wenn genau ein Eintrag gefunden wird, dann statt der Zahl 1 diesen Text anzeigen.
Wirkt unabhängig davon, ob showN angegeben wurde.
Ein leerer Parameterwert unterdrückt die Anzeige.
countYears
Ähnlich count, jedoch mit einem einzigen Mustertitel, der mit fortlaufend durchgezählten Zahlen angewendet wird, was insbesondere bei Jahreszahlen hilfreich ist.
Parameter der umgebenden Vorlageneinbindung (optional, wo nicht gesondert angegeben):
serial
Mustertitel für alle Kategorien.
Pflichtparameter
Muss den Platzhalter %d enthalten, an dessen Stelle der jeweilige Zahlenwert eingefügt wird.
Alle sonstigen Prozentzeichen müssen durch % oder %% escaped werden.
since
Startwert für die einzufügenden Zahlenwerte.
Pflichtparameter
Natürliche Zahl ≥0.
stop
Endwert für die einzufügenden Zahlenwerte.
Vorgabe: Aktuelle Jahreszahl.
  • Natürliche Zahl ≥0.
  • Relative Angabe +nn oder -nn beispielsweise wie folgt:
    • +1 nächstes Jahr.
    • +2 übernächstes Jahr.
    • -1 letztes Jahr.
scope
Art der zu zählenden Einträge.
Einer von pages files subcats all – Seiten, Mediendateien, Unterkategorien oder alle vorgenannten.
Vorgabe: pages
show0
Wenn kein Eintrag gefunden wird, dann statt der Zahl 0 diesen Text anzeigen.
Ein leerer Parameterwert unterdrückt die Anzeige.
showN
Wenn mindestens ein Eintrag gefunden wird, dann statt der Zahl diesen Text anzeigen.
Wenn der Parameter den Platzhalter %d enthält, dann an dieser Stelle die gefundene Anzahl darstellen.
  • Alle sonstigen Prozentzeichen müssen dann und nur dann durch % oder %% escaped werden.
  • Auch die Notation {{formatnum:%d}} kann eingesetzt werden, um größere Zahlen mit Tausendertrennzeichen zu formatieren.
Ein leerer Parameterwert unterdrückt die Anzeige.
show1
Wenn genau ein Eintrag gefunden wird, dann statt der Zahl 1 diesen Text anzeigen.
Wirkt unabhängig davon, ob showN angegeben wurde.
Ein leerer Parameterwert unterdrückt die Anzeige.

Beispiele (Testseite)

Eine Testseite illustriert praktische Beispiele.

Allgemeine Hinweise zur Einbindung von Modulen

Eine Einbindung erfolgt jeweils im Format

{{#invoke: CatUtil | Funktionsname | Wert1 | Wert2 | NameX=Wert … }}

Die Parameter können wie bei Vorlagen benannt oder unbenannt sein; deren Regeln gelten analog.

Wenn unbekannte Zeichenketten von außen kommen (als Vorlagenparameter), sollte immer mit der Form 1=Wert gearbeitet werden.

Zu allgemeinen Problemen beachte die Abhilfen wie bei Vorlagen.

Wenn in einer Vorlage ein Modul verwendet wird, sollte auch immer die Vorlage:Dokumentation/Lua in der Dokumentationsseite eingebunden werden.

  1. Das gibt einem Programmierer Aufschluss, dass ein Lua-Modul benutzt wird, welche/s und ggf. welche Einzelfunktion daraus, und verlinkt auf die Dokumentation.
  2. Die Modul-Dokumentationen bekommen ein Link, in welchen Vorlagen sie eingesetzt werden, und wo bei eventuellen Funktionsänderungen Anpassungen erforderlich werden.
  3. Die Vorlage wird zur Übersicht kategorisiert in Kategorie:Vorlage:mit Lua-Programmierung.

Zu weiteren Informationen siehe Hilfe:Lua.

Bei Problemen wende dich bitte an die Vorlagen-Werkstatt, in schweren Fällen hilft auch die Lua-Werkstatt.

Content Disclaimer

Informasi ini disarikan dari Wikipedia dan disajikan kembali untuk tujuan edukasi. Konten tersedia di bawah lisensi CC BY-SA 3.0. Kami tidak bertanggung jawab atas ketidakakuratan data yang bersumber dari kontribusi publik tersebut.

  1. The information displayed on this website is sourced in part or in whole from Wikipedia and has been adapted for the purpose of restating it. We strive to provide accurate and relevant information, however:
  2. There is no guarantee of absolute accuracy. Wikipedia is an open, collaborative project that can be edited by anyone, so information is subject to change.
  3. It is not intended to constitute professional advice. The content displayed is for informational and educational purposes only. For important decisions (e.g., medical, legal, or financial), please consult a professional.
  4. Content copyright. Wikipedia is licensed under the Creative Commons Attribution-ShareAlike License (CC BY-SA). This means that content may be reused with appropriate attribution and shared under a similar license.
  5. Responsible use. Any risk arising from the use of information from this website is entirely the responsibility of the user.