Wikipedia:Lua/Modul/Sort/cellNum

aus Wikipedia, der freien Enzyklopädie
Zur Navigation springen Zur Suche springen
Vorlagenprogrammierung Diskussionen Lua Test Unterseiten
Modul Deutsch English

Modul: Dokumentation

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 #invokealle 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 Basis 10 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 0 bis 9 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.
furnish
Wikitext mit Auflistung bekannter Schlüsselwörter
failsafe
Versionsbezeichnung (lokal): 2024-06-01
Optionaler Zusatzparameter:
  • 1 – Mindestversionsbezeichnung oder wikidata oder ~
{{#invoke:Sort/cellNum|failsafe}} ergibt 2024-09-19
Mit Angabe eines Parameters als Datum im ISO-Format wird verglichen, ob das aktuelle Modul diese Version oder später erfüllt.
  • {{#invoke:Sort/cellNum|failsafe|2001-01-01}} ergibt: »2024-09-19«
  • {{#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 (2024-06-01) 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 (2024-06-01).
Rückgabewert:
  • Leer, falls Mindestversionsbezeichnung nicht erfüllt, oder Übereinstimmung mit Wikidata
  • Versionsbezeichnung (auf Wikidata registriert:2024-06-01) 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:
  • ASCII-Bindestrich-Minus statt typografischem Minuszeichen
  • Punkt als Dezimaltrenner
  • Keine Tausendertrennung
Statt des Konstrukts ×10 wird der Buchstabe E kopiert, wodurch sich ein gängiges maschinenlesbares und in Programmiersprachen übliches Format ergibt.

Schlüsselwörter (adverbial)

Die nachstehenden Schlüsselwörter werden erkannt und bei ungenauen Angaben ausgewertet:

  • <
  • ±
  • >
  • gut
  • ca.
  • ungefähr
  • fast
  • unter
  • rund
  • ungef.
  • mehr als
  • beinahe
  • um
  • weniger als
  • bei
  • nahe
  • zirka
  • über
  • reichlich
  • etwa
  • circa
  • nahezu
  • knapp

Verwendung

Allgemeine Hinweise zur Einbindung von Modulen

Eine Einbindung erfolgt jeweils im Format

{{#invoke: Sort | 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.