Wikivoyage:VCard/Entwicklung

Entwicklungsphasen der vCard[Bearbeiten]

12/2016: Umstellung auf Lua
2017: Anbindung Wikidata
2017: Anzeige Zusatzinformationen
2017: Editor
Export nach Wikidata: komplex (Kommentare bei Kontakten etc, Analyse von Öffnungszeiten)

Vorschläge[Bearbeiten]

display: show = block anstelle show = inline, Test ob als Listenelement möglich. Parameter show = inline. CSS/Skripten, um Text vor und nach {{vCard}} zu detektieren. Nichts außer *, show = inline einfügen.
- Vorerst bleibt es bei inline für vier Länder (Deutschland, Österreich, Schweiz, Italien), einfach noch zu viele vCards.
Klappbar: Bild, technische Daten, überlanger Text (Abschneiden, wenn mobil).
Smartphones: Beschreibung maximal bis 150 Zeichen anzeigen, ausklappbar, Linie als Trenner zwischen mehreren vCards, auf linker Seite Bild.

Aufgaben zur Verbesserung der vCard[Bearbeiten]

Allgemein
- Neue show-Parameter: noWDusage: nur Ausgabe WD-Sitelink, aber keine Nutzung zur Zeitersparung.
- Anpassungen für dark mode: Farben, weißer Rand für Marker. Abhängig auch von Implementierung des dark modes. Scheint .
- Verringerung der Rechenzeit.
  - Etwa 50 % der Rechenzeit gehen auf das Konto von zwei teuren Funktionsaufrufen: frame:extensionTag( 'maplink', … ) und frame:callParserFunction{ name = '#coordinates', … )
  - Bereits ermittelte Informationen können nicht zwischen verschiedenen #invoke weitergeleitet werden (siehe T67258)
- Dokumentation (begonnen)
- Symbole
  - Symbole für status verbessern bzw. neu gestalten. Möglichst selbsterklärend.
  - Symbol für Info.
  - Symbole für diese Features inkl. Telefon, Fax, Email etc.
- Subtypes: Arrays mit Icon-Dateinamen, Übersetzungen . Legende für Smartphones.
- (Ausgewählte) Subtypes, evtl. ausgewählte Qualifier (Modul:Hours/i18n‎, Modul:VCard/Qualifiers) in Kategorien.
- Evtl. Hauptverwaltung (P159) auswerten.
- Mehrere Einrichtungen derselben (Restaurant- usw.) Kette und gleicher Beschreibung.
- Name, Adresse, Lage in Landessprache: + Umschrift , IPA, Audio, Hochsprache und Dialekt.
- Neue Metadaten: Zeitzone bzw. Zonenzeit (time zone: UTC-3; MEZ usw.), Zeitzone aus Tabelle (mit Standard-Regel zur Vereinfachung) oder WD (P421; Ort, Land (evtl. mehrere Zeitzonen), Koordinate). Zeitraum Sommerzeit, wohl aus eigener Tabelle, mit Start (Regel, Datum laufendes Jahr) und Ende (Regel, Datum laufendes Jahr), Regel mit #time Parser-Function. Daraus lässt sich aus den Öffnungszeiten (hours) die Angabe generieren: „Jetzt geöffnet.“
  - Liste der Zeitzonen
  - Länder nach Zeitzonen
- Zusatzinformationen: Anzeige/Aufklappen Bild, Link auf weitere Bilder in Commons-Kategorie. Wohl nur im Blockmodus sinnvoll. Siehe auch Gadget-ListingInfo.
- Aufteilung von Gruppen in Untergruppen.
- Slideshow für angegebene Kategorie.
- Übersetzung von Hilfetexten:
  - Hilfe:Erstellen einer VCard/Merkmale

Gadget-ListingEditor
- Auslagerung sprachabhängiger Teil in Extra-Skript
- Laden bei Bedarf
- Kleinschreibung Werte für type, subtype, show erzwingen
- Positionierung Dialog
- Eignung für mobile Bearbeitung: Ersatz jquery.ui.dialog und jquery.ui.autocomplete durch OOjs UI o.ä.
- Evtl. Vorschau an der Stelle der Beschreibung, um Platz zu sparen.
- Sonderzeichen (Umlaute etc, Währungssymbole für alle Felder).
- Koordinatenpicker.
- Behandlung: Typ aus Wikidata, bisher wird Typ aus data-type des Tags übernommen.
- Prüfen, ob, wie und unter welchen Bedingungen Synchronisation mit Wikidata mit Eingabewerten sinnvoll und machbar ist.
- Chosen: select-Liste volle Höhe.
- jQuery unwrap(): testen, ob funktioniert, insbesondere bei Fehlern und Captchas.

Aufgaben für Bots
- inline/block: Satzzeichen hinter {{vCard}}s weg. Text hinter vCard in description, Parameter evtl. neu anlegen. Wenn Text vor vCard oder mehrere vCards in Absatz, dann show = inline einfügen.

Diskussion
- Sollen überregionale Buchungs- und Bewertungsdienste wie booking.com z. B. über eine ausklappbare Liste angezeigt werden? In Wikidata vorhanden. Gegenwärtig gibt es nur Eigenschaften für booking.com. hotels.com, tripadvisor.com und recreation.gov. Andere wie holidaycheck.de, trivago.de, hrs.de, hotel-ami.com, holidaycheck.de, TUI.com, momondo.com, Amoma.com, Flyin.com, Trip.com und ebookers.com fehlen.
- Eigene Gruppen: Do: Kultur, Erholung, Sport und Fitness; other: Gesundheit, Bildung
- Bei fehlender Koordinate Anzeige eines leeren Rechtecks, siehe z. B. Александрия

Mobil
- Abgekürzte Beschreibung in der mobilen Ansicht. Wohl nur im Blockmodus sinnvoll.

Gemeldet in Phabricator (?)
Task T265565

Wikidata
- Hilfe:Wikidata ausbauen!: Hilfe:Erfassen einer VCard auf Wikidata
- Template:Statement+
- Übernahme/Übertragung von/nach Wikidata mit JS.
- Wikidata speichert keine Bearbeitungsdaten, nur Datum der letzten Bearbeitung. Vielleicht gibt es einen Weg, das Datum der letzten Bearbeitung aus der Versionsgeschichte als lastedit zu übernehmen. Bisher Datum aus Einzelnachweisen, nicht aus Q-Id-Info.

Gadget-ListingInfo
- Weitere Sprachen.
- Uhrzeitbehandlung: Uhrzeit von Server, nicht vom Client.
  - Über API-Aufruf mit Timestamp.

Synchronisation zwischen Gadget-ListingEditor und Wikidata
- prüfen, ob und wie die Synchronisation erfolgen kann.
- Nachladen Skript beim Öffnen des vCard-Editors.
- API: wbgetentities, wbsearchentities; wbcreateclaim, wbremoveclaims, wbsetclaimvalue, wbsetreference, wbremovereferences

Machbarkeitsstudie Koordinatenpicker
- Anschriftensuche in Nominatim.osm.org, Wikidata (Adressen). Standard-Koordinate aus Artikel.
- Einverständnis im Fall von Nominatim einholen (Privacy policy).
- Bestimmung Koordinate und Zoom; Setzen neue Koordinate.
- Oberfläche: Karte, darüber oder darunter Formatliste, Schalter Übernehmen, Verlassen, Anzeige ausgewählte Koordinate/Zoom; Suchfeld auf Karte mit Auswahl der Quellen (Nominatim, WD). Möglichst kompakt, damit auch auf Smartphones nutzbar.
- Zwei Modi: Standalone (umfangreichere Formateliste, Austausch über Zwischenablage), als Funktion für vCard-Editor (zwei Formate: nur Koordinate, Koordinate und Zoom).
- Nachladen bei Bedarf.
- Auswahl Koordinate durch Klick mit linker Maustaste.

Kommentare[Bearbeiten]

Der Parameter name-extra wird in der {{vCard}} nicht mehr unterstützt, auch wenn er im Quelltext verbleibt. Es besteht kein offensichtlicher Bedarf, z. B. bei Bahnstationen. Der Parameter wurde nur für Werbung benutzt. Alternativ stehen alt, comment und name-local zur Verfügung.
Aus den Namen (name, alt und name-extra) werden die Sternchen * entfernt. Wenn sie dennoch benötigt werden, können sie mit * nachgebildet werden. Hotelsterne gehören in den Parameter subtype.

Erledigte Aufgaben[Bearbeiten]

Parameter section-from unterstützt die Integration von vCards in andere Artikel, in denen die Bearbeitung natürlich nicht möglich ist.
Begrenzung der Textlänge für die Beschreibung für vCards für Restaurants, Unterkünfte und Aktivitäten auf 1000 Zeichen.
Abschaltung der Währungsumrechnung möglich.
Interpunktion internationalisierbar, nötig z. B. für CJK-Sprachen.
Berücksichtigung/Einfügung Startzeitpunkt bei Preisen.
Vereinheitlichung {{vCard}}, {{Marker}}.
Neue show-Parameter: nosocialmedia, nositelinks.
MAKI-Symbole in schwarz und weiß.
Umstellung der MAKI-Symbole auf Version 7.2.
Unbekannte Wikidata-subtypes werden angezeigt.
Parameter format in {{Marker}} abgeschaltet.
Darstellung der Symbole mit CSS.
Hours, Hours/i18n: Qualifikatoren können auch ausgeschlossen werden, indem man ihm eine leere Zeichenkette zuordnet.
Parameter copy-marker eingeführt.
Parameter status (Werte kommasepariert (stub, outline, usable, guide, star, class-x; top-sight) ) für Marker und vCard, der vor dem Marker-Symbol Hinweise zur Artikelqualität oder Bedeutung der Einrichtung/Sehenswürdigkeit gibt. Eintrag als Klassenbezeichner.
Neuer Parameter: country ISO-Landescode, wenn Einrichtung nicht in Wikidata enthalten oder Landesangabe nicht aus Artikel bestimmbar ist. Gelegentlich in Themenartikeln.
Anzeigemodus show = copy/duplicate. Marker ist Marker-Kopie (Selbstreferenz).
Marker: neuer Parameter name-local.
Wikidata: Superior bei Hotelsternen.
Subtypes können auch Typen nutzen.
Prüfung auf Sterne im Namen ergänzt.
Variable show = poi entfernen.
Identische Kontaktdaten und Preise zusammenfassen.
Darstellung im inline-Mode: Info und Bearbeiten kompakter.
Gadget-Listingeditor: Behandlung von Kommentaren, Umwandlung von Pipes.
Aliase für Typen, Gruppen und Subtypen.
Überprüfung Suche/Auftrennung vCard. Problematisch, wenn verschachtelte Vorlagen wie bei Berlin/Mitte: Berliner Ensemble Station + Rint.
Anzeige von Ereignisdaten.
Internationalisierung vCard, Marker, Gadget-Listingeditor.
Gadget-Listingeditor: Uhrzeit, Checkin, Checkout aus Wikidata angeben.
Gadget-Listingeditor: Auftrennung einzelne Einträge bei Kontakten, Abtrennung Kommentar, vereinfachte Regex
Gadget-Listingeditor: Tabellen Q-Id -> Label
Unterscheidung Festnetz-, Mobiltelefon
Auszeichnung (P166): Michelin-Sterne (Q20824563)
indent -> outdent
Fehler(kategorien) für nichtdezimale Koordinaten , unbekannte Parameter, fehlerhafte URLs und Emails, farbliche Markierung fehlerhafter vCards
Mikroformate einsetzen
Symol(e) am Anfang (Flaggen, Bewertungen). Folge der Umstellung auf display:block. Evtl. neue Parameter: before = und after = , die vor- und nachgestellte Textteile aufnehmen können.
Daten aus WD mit Klasseneigenschaft class="wikidata-content" o.ä. versehen.
Parameter auf Gültigkeit prüfen
Korrektur aufeinander folgender Satzende-Punkte
Abkürzungen mit title hinterlegen, siehe auch {{Abk}}
weitere Untertypen/Features wie GLBT, Behinderungen, Parkplätze, Internet/WiFi/frei, Dienstleistungen, Haustiere, keine Kinder.
Skype einbinden
Google+, Twitter, Facebook mit passenden Symbolen , Problem: Link in Kiwix fehlt
vCard/d: mit und ohne vorangestelltes Q, Groß-/Kleinschreibung
Feinschliff Poi. Mit dem Einsatz von WikiData-Daten, insbesondere den Koordinaten, muss der Parser-Vorgang vom Quelltext auf Quelltext mit ausgeführten Vorlagen (action=raw&templates=expand) oder auf Datenbankzugriff umgestellt werden, weil die Koordinaten im Quelltext nicht mehr sichtbar sind. Neue Kartenwerkzeuge? -> ja: Kartographer, Vorlagen wie {{Marker}} bereits angepasst.
Telefonnummern aus Wikidata irgendwie gruppieren, mehr als drei Telefonnummern -> einklappen
Modul:LinkPhone, Verlinkung Telefonnummer
Modul:Coordinates, Modul:GeoData, Koordinatenumrechnung.
Telefonnummern nicht umbrechen
Keine lokale Bezeichnung aus Wikidata, wenn lang = wikiLang.
vCard/Marker: Test ob P31 (ist ein) überhaupt gesetzt ist.
Editor: group nicht übernehmen, wenn identisch zum Typ
Marker: +technische Daten
Taxi-Hinweis: Bitte bringen Sie mich [name] + [address] in Wiki- und Landessprache
Marker/vCard: Wikipedia-Link: Wikisprache -> en -> Landessprache
Marker/vCard: Links zu WV-Artikel aus WD, aber nur, wenn nicht Artikel selbst
Formelle Prüfung URLs
Marker: url = n/no etc: keine URL, auch nicht aus wikidata
Neue Metadaten: Währung (currenty: EUR, €, c)
Auslagerung gemeinsamer Marker/vCard-Funktionen: Modul:Marker utilities
Unterscheidung Anschriften / lokale Anschriften bei Bezug aus Wikidata
Unterstützung lat = lat, long
Mehrere kommaseparierte Typen, erster bestimmt die Farbe. Z. B. restaurant, bar.
Anschrift in unterschiedlichen Sprachen, aber nicht Wikisprache: Hierarchie; z. B. en vor it
ms.options (i18n) für wikiweite Anpassungen
Ergänzen Google Maps Customer ID (P3749), Foursquare-ID (P1968)
vCard/Marker: Parameter commonscat für Commons-Kategory, aber nur, wenn wikidata nicht existiert. Fehlermeldung, wenn sowohl commonscat und wikidata
Konvertierung von/zu Open Location Code (Plus code): Anzeige im Marker-Tooltip.
vCard/Marker: Namensräume Datei/Bild/File/Image beim Parameter image entfernen.
Zahlungsarten, subtypes aus Wikidata.
Wertprüfung für Parameter show.
vCard, Marker: Internationalisierung der Parameternamen.
subtypes: inkl. Rollstul, WLAN aus WD; directions aus WD.
Variable intl-area-code entfernen, Variable credit-cards in payment umbenennen (wenn nicht mehr ohne Argument eingesetzt).
Commons-Kategorie: Zusätzlich zu P373 sitelinks.commonswiki ausgewertet.
Angabe mehrerer Staaten in WD: Suche.
Marker: +IATA, ICAO.
Leichte Fehler unterdrückt, auch ohne Stilvorlage wirksam
Parameter zoom ergänzt.
Gadget-ListingEditor: Parameter commonscat ergänzen
Gadget-ListingEditor: Anzeige Wiki-Syntax
Gadget-ListingEditor: Links nach URL, Facebook etc.
Gadget-ListingEditor: Behandlung Wikidata-Typen (monolingual, id)
Gadget-ListingEditor: Hinweis, wenn Beschreibung (description) zu lang: Ausgabe Zeichenanzahl.
Gadget-ListingEditor: Behandlung Mehrfachangaben bei type und subtype.
Gadget-ListingInfo: Berücksichtigung Benutzersprache
Gadget-ListingEditor: Erweiterung Sister.wikidataClaim, um komplexere WIKIDATA_CLAIMS (z. B. mehrere Eigenschaften) behandeln zu können wie in vCard.
Gadget-Listingeditor: Auskommen ohne section wrapper (nur noch während Dialog)
Gadget-Listingeditor: hinter Merkmalen "+"-Symbol (gelb hinterlegt, mit Wikidata-Symbol) zur Anzeige de aus Wikidata bezogenen Merkmale
Gadget-Listingeditor: Bildsymbole für Bearbeiten-, Info-Links
Gadget-Listingeditor: gemeinsame Initialisierung mit Gadget-ListingInfo
Gadget-Listingeditor: Mehrfacheinträge wie Telefon, Fax, Email, Prüfung Name
Marker utilities, Gadget-Listingeditor: Prüfung IDs von sozialen Medien
vCard: lokale Sprache aus Telefonnummer(n) bestimmt
Anzahl der Merkmale berücksichtigt
Prüfung veraltete Angabe lastedit.
Öffnungszeit aus Wikidata
Kommentare zu Kontakten, Merkmale standardmäßig aktiviert.
Uhrzeitformatierung, 12/24 h.
Bildsyntaxprüfung: keine URLs, richtige Erweiterungen.
vCard/Marker-Stilvorlagen nach Vorlage:VCard/styles.css ausgelagert.
Unterstützung Parameter-Aliase.

Analyse Qualifikatoren bei Koordinaten[Bearbeiten]

Beispiel Qualifikator „ist ein“: Portal Q854429, Tür Q36794 für Wat Ron Khun table#1 {

   table#2 {
       ["id"] = "Q496543$bdcec553-435f-c11a-1ce8-edde46f6714a",
       ["mainsnak"] = table#3 {
           ["datatype"] = "globe-coordinate",
           ["datavalue"] = table#4 {
               ["type"] = "globecoordinate",
               ["value"] = table#5 {
                   ["globe"] = "http://www.wikidata.org/entity/Q2",
                   ["latitude"] = 19.82424,
                   ["longitude"] = 99.76329,
                   ["precision"] = 0.00027777777777778,
               },
           },
           ["property"] = "P625",
           ["snaktype"] = "value",
       },
       ["rank"] = "preferred",
       ["type"] = "statement",
   },

}