ATProto Post Formatierung

Auf Bluesky (einer ATproto basierten Plattform) ist es möglich in Posts Links, Erwähnungen anderer Accounts und Hashtags zu verwenden. Das ist soweit nicht neu, allerdings ist es auch möglich den angezeigten Text eines Links anzupassen.

Leider lässt sich das mit den offiziellen Bluesky Apps bis dato (2026-08) nicht realisieren. Ich habe herausgefunden wie es auch ohne offizieller App funktioniert.

Bluesky verwendet hierzu sogenannte “facets”. Das sind Zusatzinformationen, die an den Daten des Bluesky-Posts dranhängen. Diese facets kann man eben aktuell nicht in den offiziellen Bluesky Apps festlegen.

Es gibt allerdings die Website pds.ls, mit derer man Posts “händisch” erstellen kann. Dies erfordert nur ein bisschen Genauigkeit.

1. Auf pds.ls mit dem persönlichen Bluesky Account einloggen
2. Oben rechts auf das Symbol, das so wie ein Notizblock mit Stift aussieht.
3. Nun ist eine Art Formular erschienen. In diesem sieht man nun schon einige Informationen vorausgefüllt. Wir müssen ein paar davon ändern und ein paar hinzufügen.
   • Der Wert für den Schlüssel text ist der Textinhalt des Posts. Hier sollte der gesamte gewünschte Textinhalt, so wie er dann zu sehen sein soll, eingesetzt werden.
   • Den embed Schlüssel kann man ganz löschen, außer man möchte eine Linkvorschau zu einer bestimmten Website an den Post anhängen. Dazu aber uri, title und description mit den richtigen Informationen befüllen.
   • langs listet die Sprache(n) des Posts auf. Hier sollte die richtige Sprache(n) mit den korrekten Sprachcodes angegeben werden. de ist Deutsch, en ist Englisch.
   • facets wird auf der selben Ebene wie text eingefügt und soll folgendermaßen aussehen:

     "facets": [
       {
         "index": {
           "byteStart": 0,
           "byteEnd": 3
         },
         "features": [
           {
             "$type": "app.bsky.richtext.facet#link",
             "uri": "https://example.com"
           }
         ]
       }
     ]
     byteStart und byteEnd geben an, wo im Text der Link vorkommt. Dazu muss man die Zeichen des Textest abzählen. Die Zählung beginnt allerdings bei 0. Auch muss man bei byteEnd 1 zur Position des letzten Zeichens hinzuzählen. uri ist die URL des Links.
4. Sobald alles fertig angepasst und ausgefüllt ist, auf Create klicken um den Post abzusenden. Fertig!

Technische Details zu dieser Funktion finden sich in der offiziellen Dokumentation.