Modul:Entity/Location/Starmap/doc
Aus Star Citizen Wiki
Weitere Optionen
Dies ist die Dokumentationsseite für Modul:Entity/Location/Starmap
| Function list |
|---|
| L 30 — p.celestialByCode L 61 — p.celestialByName L 93 — p.celestialName L 116 — p.celestialParent L 138 — bucketShortName L 166 — p.systemShortName L 211 — p.systemPageName L 250 — canonicalRecords L 282 — canonicalShort L 298 — foldTrailingParen L 337 — p.systemPageTitle L 358 — p.systemLinkTarget L 378 — p.systemLinkLabel L 398 — p.storedSystem L 429 — p.rawSystem L 446 — p.entrySystem L 469 — p.gateEntrySystem L 496 — p.subjectName L 513 — p.starsystemOf L 524 — p.manifestArg L 537 — p.systemNameFrom L 555 — p.resolvedStarmapCode L 569 — plainKey L 582 — pickStarsystem L 625 — normalizeAggregates L 654 — p.attachCelestialObject L 693 — p.attachStarsystem L 720 — p.celestialStarmapCode |
Die ARK-Starmap-Datensätze, die ein Location-Leaf liest: die beiden Brücken für den enrich-Hook, Lookups im angehängten System-Payload sowie Systemnamen und Starmap-Code, zu denen eine Seite auflöst.
Editoren rufen dieses Modul nie direkt auf; es läuft innerhalb von Vorlage:Location oder Vorlage:Entity. Die Leafs, die es aufrufen, stehen auf Modul:Entity/Location.
Für Modul-Editoren
API
p.systemShortName(name): ein Systemname in Kurzform (abschließendesSystemgestrippt, Alias-Klammer und Vanduul-Katalogform entfernt).p.entrySystem(apiData):apiData.systemdurchsystemShortNamereduziert.p.gateEntrySystem(apiData): das System des Datensatzes, sonst die eingangsseitige Hälfte der Objektbezeichnung; lässt auch eine datensatzlose|family=jumppoint-Seite ihr System kennen.p.subjectName(apiData, args): der Name dessen, worum es auf der Seite geht:|starmapname=, sonst der Datensatzname, sonst|name=, sonst der Seitentitel. Der Starmap-Suchschlüssel einer Systemseite und zugleich der Eigenname eines Planeten oder Mondes.p.attachStarsystem(apiData, args, name?): Brücke über den Namen zu/api/starsystems; hängt den Datensatz alsapiData.starsysteman. Ein Leaf, dessen Subjekt NICHT das System ist, muss den Namen mitgeben. Soft-failt.p.attachCelestialObject(apiData, code): Brücke über den Starmap-Code zu/api/celestial-objects/<code>; hängt alsapiData.celestialobjectan. Kein Code, kein Fetch; soft-failt genauso.p.celestialByCode(starsystem, code),p.celestialByName(starsystem, name, types?): findet ein Objekt im System-Payload. Codes ganz und case-sensitiv; ein Namensmatch solltetypesmitgeben, weil ein Stern keinennameträgt und seine Bezeichnung die des Systems ist.p.celestialName(obj): der Anzeigename eines Objekts — eigenername, wenn die ARK einen gibt, sonst die von Dekorationen befreite Bezeichnung. Die Alias-Klammer wird überall gestrippt, nicht nur am Ende (die ARK schreibtKyuk'ya (Indra) A).p.celestialParent(starsystem, obj): löst die numerischeparent_idgegen die Objektliste des eigenen Systems; nil bei den elf Planeten ohne ARK-Elternteil.p.celestialStarmapCode(apiData, fallback): der Code des angehängten Objekts, sonst der Rohwert von|starmapcode=.p.starsystemOf(apiData),p.manifestArg(args, manifest, key),p.systemNameFrom(apiData, args, manifest),p.resolvedStarmapCode(args, manifest, obj): die Reads eines Leafs, bevor die redaktionelle Auflösung lief.systemNameFromliest nie das erste Starmap-Code-Segment, das nicht immer das System ist.
Stolperfallen
attachStarsystemslocalereitet auf dem Endpunkt-String (...&locale=en_EN), nicht inparams: Apiunto hängtparamsals zweite?queryan und würde das?filter[...]korrumpieren.attachCelestialObjects Endpunkt trägt keinen eigenen Query-String, seinlocalereitet sicher inparams.normalizeAggregatesverwirft den zurückgehaltenen Vermessungs-Stub der ARK (die identischen Bevölkerungs-/Wirtschafts-/Größenblöcke der Vanduul- und Sonden-Systeme), wann immer ein Datensatz keine katalogisierten Körper und einen unveröffentlichten Status (M/N) hat; kein Test allein ist sicher.pickStarsystemlöst einefilter[name]-Teilstring-Trefferliste per Präzedenz: exakter Namensmatch, dann die Xi'an-Form<name> (<alias>), dann die erste Zeile.systemShortNamestrippt Dekorationen in fester Reihenfolge: erst die Vanduul-Katalogform (VS-9 "Vulture"wirdVulture), dann das SuffixSystem, dann erst die Alias-Klammer — das Suffix muss zuerst weg, weil sich die Klammer am Stringende verankert. Keine Dekoration ist ein Wiki-Seitenname; eine stehen zu lassen rendert einen roten Link und legt eine Phantomekategorie an.


