Sort/cellNum – Modul zum Generieren von sortierbaren Zahlenwerten in Tabellen und zur gehobenen Zahlenformatierung.
Funktionen für Vorlagen
f
Formatieren.
Parameter einer umgebenden Vorlageneinbindung:
keine
Parameter des#invoke – alle optional:
n
(Basis-)Zahl (Mantisse)
Typografisches Minuszeichen zulässig.
Punkt . als Dezimaltrennzeichen zulässig, aber auch Komma , der deutschen Notation.
Das maschinenlesbare Format 1.234E56 für Exponentialdarstellung zur Basis10 ist ebenfalls möglich; löst Präsentation in Exponentialdarstellung aus.
Tausendertrennzeichen nicht empfehlenswert, weil 1.234 nicht zweifelsfrei zugeordnet werden könnte; Einskommazwei oder Tausendzweihundert? Wird im Zweifelsfall als internationalisierte Angabe interpretiert.
Ziffern aus zahlreichen nichtwestlichen Schriften, die auf 0bis9 abgebildet werden können, sind möglich und führen zu einer adäquaten Sortierung gemischt mit westlichen Ziffern.
Vorgabe:0
exp
Exponent (Zehner)
Ganze Zahl erwartet.
Typografisches Minuszeichen zulässig.
Löst Exponentialdarstellung aus.
suffix
Nichtnumerisches direktes Anhängsel an die Basiszahl
pre
Kurzes Präfix
Wird ohne Zeilenumbruch mit dem Zahlenwert verbunden; normaler Weißraum.
plus
Positive Werte (einschließlich Null) mit vorangestelltem Pluszeichen präsentieren
post
Kurzes Postfix
Wird ohne Zeilenumbruch mit dem Zahlenwert verbunden; normaler Weißraum.
pad
Versuch einer links- oder rechtsbündigen Ausrichtung von Dezimaltrennern
Positive ganze Zahl: Anzahl von Nachkommastellen, auf die rechtsbündig ausgerichtet werden soll.
Negative ganze Zahl: Anzahl von Stellen vor dem Komma, auf die linksbündig ausgerichtet werden soll.
cell
Wenn 1 dann notwendige Tabellensyntax für sortierbare Werte voranstellen.
Sonst <span> bilden, falls erforderlich.
rowspan
Tabellen-Attribut: Anzahl der Zeilen
Nur bei cell=1 wirksam.
colspan
Tabellen-Attribut: Anzahl der Spalten
Nur bei cell=1 wirksam.
class
Universal-Attribut: Leerzeichen-getrennte Liste von Klassenbezeichnern
style
Universal-Attribut: CSS-Deklaration
URL sowie Anführungszeichen " sind unzulässig.
id
Universal-Attribut: Fragmentbezeichner
cssNum
Seitenbezeichner einer TemplateStyles-Seite, für allgemeine Formatierung
cssNumExp
Seitenbezeichner einer TemplateStyles-Seite, für wissenschaftliche Formatierung
cat
Titel einer Wartungskategorie im Fehlerfall
Rückgabewert: Wikitext.
Bei nicht entschlüsselbarer Eingabe erfolgt eine Fehlermeldung.
{{#invoke:Sort/cellNum|failsafe|2099-01-01}} ergibt:»«– leer, falls Mindestversionsbezeichnung nicht erfüllt
Ist dieser Zusatzparameter das Schlüsselwort wikidata, so ist der Wert die auf Wikidata registrierte Versionsbezeichnung (2025-01-27) oder lokal, falls dort keine gefunden.
Ist der Zusatzparameter das Zeichen ~, so ist das Ergebnis leer, falls Übereinstimmung der lokalen mit der auf Wikidata registrierten Versionsbezeichnung besteht().
Rückgabewert:
Leer, falls Mindestversionsbezeichnung nicht erfüllt, oder Übereinstimmung mit Wikidata
Versionsbezeichnung (auf Wikidata registriert:2025-01-27) bei wikidata, oder lokal falls dort keine gefunden, bzw. leer wenn synchronisiert
Darstellung, Formate, Besonderheiten
Darstellung
Immer typografisches Minuszeichen.
Immer Komma als Dezimaltrenner.
Immer Punkt zur Tausendertrennung.
Der Multiplikationspunkt zwischen Mantisse und 10 wird gut erkennbar dargestellt.
Parameterformat
Sowohl einfaches ASCII- wie auch typografisches Minuszeichen möglich.
Komma oder Punkt als Dezimaltrenner möglich.
Ein Syntaxfehler im Eingabewert (etwa Bis-Strich statt Minuszeichen, oder Buchstabe „O“ statt Ziffer Null) wird markiert.
Sortierung
Vorangestellte Zeichen oder typografisches Minuszeichen stören nicht die Sortierung.
Zellen mit einfachen Zahlen können kombiniert werden, und mit den anderen Vorlagen der Familie.
Padding
Es wird eine integrierte Ausrichtung des Dezimaltrenners versucht.
Dabei wird für alle Zellen in der Spalte der gleiche Positionswert vorgegeben, und in jeder Zelle anhand des momentanen Zahlenwerts daraus der vermutlich freizulassende Weißraum ermittelt.
Copy & Paste
Beim Copy & Paste einzelner Zahlen oder auch ganzer Tabellen wird die deutsche typografische optische Darstellung ersetzt durch das computergerechte internationale Datenformat, wodurch die Werte einfach in andere Vorlagen oder externe Berechnungsprogramme eingefügt werden können:
Wenn in einer Vorlage ein Modul verwendet wird, sollte auch immer die Vorlage:Dokumentation/Lua in der Dokumentationsseite eingebunden werden.
Das gibt einem Programmierer Aufschluss, dass ein Lua-Modul benutzt wird, welche/s und ggf. welche Einzelfunktion daraus, und verlinkt auf die Dokumentation.
Die Modul-Dokumentationen bekommen ein Link, in welchen Vorlagen sie eingesetzt werden, und wo bei eventuellen Funktionsänderungen Anpassungen erforderlich werden.