Kleines HowTo

Falls euch eine eigene Domain gehört, könnt ihr diese als bluesky-handle verwenden, z.B. @it-frettchen.de. Hier wird beschrieben wie ihr ein Codeberg-Pages-Repo umbaut, falls eure Webseite bereits dort liegt.

Voraussetzungen

  • Besitz einer Domain
  • konfiguriertes Codeberg-Pages-Repo
  • Bluesky-Account
  • optional: CMS-Kenntnisse oder
  • Static-Site-Generator wie Beautiful Jekyll

Vorbereitungen in bluesky

Unter „Einstellungen“, „Handle ändern“ könnt ihr eine Unterseite öffnen. Dort klickt ihr auf „Ich habe meine eigene Domain“. Dann seht ihr die Konfig-Seite, hierbei ist No DNS Panel aktiviert, da ich nur das Codeberg-Repo anpassen möchte:

Handle ändern

Hier im Beispiel wird die Domain verkehrswen.de verwendet, diese wäre später der Bluesky-Handle @verkehrswen.de.

Im Git-Repo

Den Identifier did:plc:blablubb123 braucht ihr, also kopiert euch den String und legt gleich eine Datei an unter:

Dateiname: atproto-did
Dateiendung: keine

Mit diesem Inhalt:

—
layout: none
permalink: .well-known/atproto-did
—
did:plc:blablubb123blablubb

Falls ihr Direkt-Zugriff auf euren Webspace habt, könnt ihr einfach eine Datei dort ablegen (unter .well-known/atproto-did). Aber das geht hier nicht, da es eine Codeberg-Pages-Seite ist (alles liegt im Repo, DNS zeigt auf Codeberg, “No DNS Panel” ausgewählt in bluesky).

Wozu ist diese Datei?

Wir sollen im Webspace folgende Datei hinterlegen, die von bluesky abgefragt wird, wenn ihr auf Verify Text File klickt:

https://verkehrswen.de/.well-known/atproto-did

Diese Seite wird als versteckte Unterseite angelegt, da wir layout: none angegeben haben. Der permalink verweist auf den Ort, an dem bluesky die Datei erwartet, um sicher zu stellen, dass es eure Domain ist.

Zum Schluss committed ihr eure Git-Repo-Änderungen und wartet, bis der Build von Jekyll fertig ist.

Bekannte Probleme

Als ich noch Github-Pages verwendet habe, kam es des Öfteren vor, dass die Meldung invalid handle erschien. Die genaue Ursache dafür ist mir nicht bekannt, die Vermutung, dass es an Github selber lag, kann ich nicht bestätigen. Durch manuelles Bestätigen der Custom Domain in den bluesky-Einstellungen konnte das Problem jederzeit gelöst werden.

Hilfreiche URLs

Worauf wird nicht eingegangen

  • Was ist Markdown?
  • Was ist Beautiful Jekyll?
  • Wie lege ich einen Bluesky-Account an?
  • Was ist ein DNS-Panel?
  • Was sind Codeberg/Git-Pages?