Book of Quests Format Codes
ChristianEine kurze Übersicht...
Im BoQ können momentan Formatcodes verwendet werden, um die Anzeige in Listen (/list) und in per Ticker angezeigten Quests zu verändern.
Grundsätzlich, wird der eingegebene Text verwendet. Es gibt zwei Arten von Schlüsselwörtern, die ihr verwenden könnt:
:Location: - Beginnt und endet mit : - wird durch ein Emoji-Symbol ersetzt. Ihr könnt natürlich auch alle emoji direkt im Text eingeben.
{stop} - in {} eingeschlossen - das sind Datenfelder aus dem Quest (ähnlich zu Serienbriefen in einer Textverarbeitung). Hier sind teilweise auch noch Argumente zulässig, mit denen man die Ausgabe feiner einstellen kann.
Beispiele für Emoji-Codes:
:Quest:📃 :Reward:🏆 :Edit:✏️ :Location:📍
Unterstützte Felder:
{stop} - Name des Stops
{gmaps} - Link auf den Ort des Stops in Google Maps
{gmaps?p} - Link auf den Ort, aktivierung der Vorschau in Telegram. Link muss der erste Link in der Nachricht sein!
{loc} - Extra Nachricht mit Standort VOR der Nachricht.
{quest} - Aufgabe, die es hier zu finden gibt.
Optionen: {quest?brief} => Kürze die Aufgabe ab - von jedem Wort nur den ersten Buchstaben.
{reward} - Belohung, die es hier zu finden gibt.
Optionen: {reward?ee} - Zeige das Emoji für Begegnung am Anfang
{reward?brief} - Kein Text, wenn ein Emoji für das Item existiert
{distance} - Nur Liste - Distanz vom Standort.
{nby} - Nur Liste - Link /nbyxx
{img} - Nur Ticker - Link auf das Bild des Stops
{stopLnk} - Nur Ticker - Link, um zum persönlichen Bot zum kommen.
{likes},{found},{notfound} - Nur Ticker - Aktuelle Anzahl von Stimmen für diese Kategorie
Optionen: {likes?zero} - Blende dies aus, wenn die Anzahl momentan 0 ist.
{a} - Nur Ticker - Alle dem Bot bekannten Adressdetails - macht ohne Parameter nichts.
{a?city,town,village} gibt das Feld City oder Town oder Village aus (nur das erste, das definiert ist).
{a?suburb,neighbourhood,city_district} - in sehr vielen Fällen der Name des Stadtteils.
{a?road,path,way} - Sollte der Name eines Weges sein, wenn vermerkt.
Diese Felder bezieht der Bot von der Openstreetmap - mit /info kann man an einzelnen Stops sehen, welche Felder dort gesetzt sind.
Die Nachrichten selbst benutzen für Fett/Kursiv/Hyperlinks die markdown Syntax von Telegram: https://core.telegram.org/bots/api#markdown-style
Ein Beispiel:
[:Location:]({img})[{stop}]({gmaps}) {likes?zero}{found?zero}{notfound?zero} {a?suburb,neighbourhood,city_district}[:Edit:]({stopLnk})
:Quest:{quest}
:Reward:{reward?ee}
:Location:[{stop}]({gmaps?p}) [:Edit:]({stopLnk}){scanned}{a?suburb,neighbourhood,city_district}
:Quest:{quest}
:Reward:{reward}
{found?zero}{likes?zero}{notfound?zero}
Eigene Formate im BoQ können