Modul:Faktenbox/Doku: Unterschied zwischen den Versionen

← Zum vorherigen Versionsunterschied

Modul:Faktenbox/Doku (Quelltext anzeigen)

Version vom 1. Dezember 2025, 09:22 Uhr

3.790 Bytes hinzugefügt , Montag um 09:22

→‎Funktionen Modul:Faktenbox/Tabs/Karten

HeikoBot

Bots, SMW-Administratoren, SMW-Kuratoren, SMW-Editoren, Administratoren

15.082

Bearbeitungen

@@ Zeile 3: / Zeile 3: @@
 Dieses Modul enthält gemeinsame Funktionen, um eine Faktenbox zu füllen
-== Funktionen ==
+== Funktionen [[Modul:Faktenbox]] ==
 === <code>Faktenbox()</code> ===
@@ Zeile 10: / Zeile 10: @@
 Sie setzt ebenso Attribute wie die regulären Faktenboxen z.B. von Gebäuden, Straßen, Personen usw.
-=== <code>datenTabUniversal()</code> ===
+== Funktionen [[Modul:Faktenbox/Tabs]] ==
+=== <code>universalDatenTab()</code> ===
 Universeller Daten-Tab zeigt alle seine übergebenen Parameter außer die für Karte und Bild an.
 === <code>bildTab()</code> ===
 Selbsterklärend...
+=== <code>benennungenTab()</code> ===
+Tab mit Liste der Benennungen.
+=== <code>tab()</code> ===
+Vervollständigt Tab-Inhalt zu einem Tab.
+== Funktionen [[Modul:Faktenbox/Tabs/Karte]] ==
 === <code>kartenTab()</code> ===
 Selbsterklärend...
+=== <code>getKartenArgs()</code> ===
+Karten-Argumente übernehmen und aufbereiten.
+== Funktionen [[Modul:Faktenbox/Tabs/Adressen]] ==
+=== <code>adressenTab()</code> ===
+Tab mit Liste der Adressen.
+Die Adressen werden bestmöglich chronologisch aufsteigend sortiert.
+=== <code>p.sortIndex() und p.smwDate2SortIndex()</code> ===
+Erstellen Sortierindizes anhand Datum und Schlüsselwörtern (z.B. Geburtshaus ganz oben) für chronologische Sortierung.
+== Funktionen [[Modul:Faktenbox/Zeilen]] ==
 === <code>zeileKategorieSeite()</code> ===
@@ Zeile 29: / Zeile 53: @@
 Die AktenNr werden als Query-Link und mit Seitenanzahl mit dieser AktenNr angezeigt.
-=== <code>zeileGeokoordinate()</code> ===
+=== <code>zeileGeoDaten()</code> ===
-Zeile um alle [[Attribut:Geokoordinate]] mit OSM-Link zu anzuzeigen.
+Zeile um alle [[Attribut:Geokoordinate]]n mit OSM-Link und die [[Attribut:GeoJson]]-Karte zu anzuzeigen.
 === <code>zeileDatum()</code> ===
 Zeile um ein Datum standardisiert per <code>linkFormDate()</code> anzuzeigen.
-=== <code>zeileParg()</code> ===
+=== <code>zeileSemantikBrowsenAbfrage()</code> ===
-Standard-Zeile um Attribut <code>attr</code> von <code>fbdata.parg[]</code> mit Werte-table, -Liste oder Einzelwert zu setzen und anzuzeigen.
+Zeile mit Link zum semantischen Browsen (Datensicht) und zur Abfrage.
-Anstelle <code>attr</code> kann optional der Text <code>attrText</code> angezeigt werden.
 === <code>zeile()</code> ===
-Standard-Zeile um Attribut <code>attr</code> mit Werte-table, -Liste oder Einzelwert <code>val</code> zu setzen und anzuzeigen.
+Standard-Zeile um ein Attribut zu setzen und anzuzeigen.
-Anstelle <code>attr</code> kann optional der Text <code>attrText</code> angezeigt werden.
+Wenn es sich beim Attribut-Wert um eine Liste mit mehreren Elementen handelt, wird vom Attribut-Anzeigetext automatisch die Mehrzahl gebildet.
+{| class="wikitable"
+|-
+! Parameter !! Beschreibung
+|-
+| <code>attr_name</code> || Attribut-Name
+|-
+| <code>attr_text</code> || Optionaler Attribut-Anzeigetext. Default: <code>attr_name</code>. Siehe auch [[#attr_text_anzeige|<code>attr_text_anzeige</code>]]
+|-
+| <code>attr_val</code> || Attribut-Wert. Wenn nicht übergeben, werden die von der #invoke:-Vorlage übergegebenen Parameter (<code>fbdata.pargs</code>) verwendet.
+|-
+| <code>fbdata</code> || [[#fbdata-Daten-table|fbdata-Daten-table]] mit von der #invoke:-Vorlage übergegebenen Parameter (<code>fbdata.pargs</code>).
+|-
+| <code>delimiter</code> || Trennzeichen bei Werte-Listen. Bei Nicht-Übergabe wird Attribut-Wert auch nicht als Liste behandelt.
+|-
+| <code>val_prefix</code> || Attribut-Wert-Prefix z.B. "ca."
+|-
+| <code>val_postfix</code> || Attribut-Wert-Postfix z.B. "km"
+|-
+| <code>val_show_only</code> || Attribut-Wert nur anzeigen, aber nicht setzen
+|}
-=== <code>faktenboxSemantikBrowsen()</code> ===
+=== <code>setPageAttr()</code> ===
-Zeile mit Link zum semantischen Browsen (Datensicht).
+Setzen eines Attributs vom Datentyp Seite in folgender Prüf- und Setzreihenfolge:
+# ''Wenn'' <code>val</code> problematische Wikitext/HTML-Inhalte enthält, dann wird
+#* <code>val</code> 1:1 angezeigt und ggf. gerendert (nicht innerhalb <code><nowiki>[[Attribut::Wert]]</nowiki></code>)
+#* Attribut <code>name</code> mit <code>val</code> per <code><nowiki>{{#set:Attribut=Wert}}</nowiki></code> unsichtbar im Hintergrund gesetzt, auch wenn das Verarbeitungsfehler provoziert (gewollt)
+# ''Ansonsten wenn'' <code>val</code> als Seite existiert, wird diese 1:1 gesetzt und angezeigt (<code><nowiki>[[Attribut::Wert]]</nowiki></code>)
+# ''Ansonsten wenn'' <code>val</code> Klammerungen am Anfang oder am Ende enthält (Beispiel: "(BlaBlub) Rathaus (BlaBla)"), wird geprüft, ob eine Seite ohne die Klammerungen (also [[Rathaus]]) existiert. Wenn ja, wird "(BlaBlub) [[Rathaus]] (BlaBla)" angezeigt und das Attribut mit nur "[[Rathaus]]" gesetzt.
+# ''Ansonsten wird''
+#* <code>val</code> 1:1 angezeigt und ggf. gerendert (nicht innerhalb <code><nowiki>[[Attribut::Wert]]</nowiki></code>)
+#* Attribut <code>name</code> mit <code>val</code> per <code><nowiki>{{#set:Attribut=Wert}}</nowiki></code> unsichtbar im Hintergrund gesetzt, auch wenn das Verarbeitungsfehler provoziert (gewollt)
+=== <code>setStandardAttr()</code> ===
+Setzen eines Standard-Attributs (nicht Datentyp Seite).
+Klammerwerte werden optional abgetrennt und Attribut-Wert wird optional nur angezeigt, aber nicht gesetzt.
+== Funktionen [[Modul:Faktenbox/Common]] ==
 === <code>common()</code> ===
 Sonstige gemeinsame Dinge anfügen
+* Klasse
 * Formular
 * Kategorien
 * Wartung
-=== <code>tab()</code> ===
-Vervollständigt Tab-Inhalt zu einem Tab.
 === <code>fbdata()</code> ===
@@ Zeile 61: / Zeile 116: @@
 Um die Parameter-Übergabe zu obigen Funktionen zu vereinfachen wird die <code>fbdata</code>-Daten-table verwendet, in der folgende Daten abgelegt werden:
 * <code>fbdata.frame</code> = <code>frame</code> von <code>Faktenbox(frame)</code>
-* <code>fbdata.pargs</code> = <code>frame:getParent().args</code>. Beispiel: <code>fbdata.pargs["Ehemals"]</code>
+* <code>fbdata.pargs</code> = <code>frame:getParent().args</code>. Beispiel: <code>fbdata.pargs["Ehemals"]</code> oder <code>fbdata.pargs.Ehemals</code>
 * <code>fbdata.klasse</code> Klassen-table. Beispiel Kirche: <code>fbdata.klasse = {"Kirche", "Gebäude"}</code> ("Kirche" ist primäre und "Gebäude" sekundäre Klasse)
 * <code>fbdata.kategorie</code> Kategorien-table. Beispiel Kirche: <code>fbdata.kategorie = {"Kirchen", "Gebäude"}</code> ("Kirchen" ist primäre und "Gebäude" sekundäre Kategorie)
+* <code>fbdata.kategorie_einzahl</code> Einzahl-Kategorien-table als Alternative zu <code>fbdata.klasse</code>. Beispiel Kirche: <code>fbdata.kategorie_einzahl = {"Kirche", "Gebäude"}</code> ("Kirche" ist primäre und "Gebäude" sekundäre Kategorie)
 * <code>fbdata.formular</code> Formular
 * Pagesnames
@@ Zeile 77: / Zeile 133: @@
 ** <code>frame.strasse_hnr.anzahlGebaeude  </code> Anzahl aller gültigen Straße/Hausnummer-Kombinationen
 * Ggf. weitere Klassen-abhängige Einträge
+== <code>attr_text_anzeige</code> ==
+Sofern kein [[#zeile()|<code>attr_text</code>]] angegeben, wird i. A. <code>attr_name</code> angezeigt.
+Jedoch wird bei manchen <code>attr_name</code>-Attributen stattdessen automatisch die ausgeschriebene Version angezeigt.
+Beispiel: Beim [[Attribut:TeilDesEnsembles]] wird anhand der table <code>attr_text_anzeige</code> "Teil des Ensembles" angezeigt.
+Diese Übersetzung von <code>attr_name</code> zur Anzeige-Version ist in <code>attr_text_anzeige</code> abgelegt und erfolgt global bei allen Faktenboxen.
 == Unterseiten ==