grtnr.com

Solid Comments In Static Website

Di 11. Feb 2025
Translated by: gpt-4o-2024-08-06 | Original version

Kurzfassung: Ich habe Kommentare zu meiner statischen Website hinzugefügt. Hier erfahren Sie, wie ich es gemacht habe – einschließlich einiger technischer Details. Ich habe verschiedene mögliche Lösungen recherchiert, um die solideste zu finden, sie für alle Beiträge integriert und einen Zähler für die Anzahl der Kommentare auf der Beitragsübersichtsseite hinzugefügt.

2025-05-23 Update Seitdem ich von Jekyll zu Pelican gewechselt bin, habe ich einige Details aktualisiert.

Auswahl einer Lösung

Da ich vorhatte, mit dem neuen Deep Research Model von OpenAI zu experimentieren, habe ich es bei diesem Thema ausprobiert: lesen Sie gerne hier. Insgesamt war die Recherche hilfreich und ich habe mich letztendlich für Giscus für die Kommentare entschieden. Teilweise, weil es am robustesten und zuverlässigsten erschien, teilweise, weil ich vor einigen Jahren wirklich schlechte Erfahrungen mit Disqus gemacht habe.

Die Wahl basierte auf den Kriterien, die ich dem Modell gegeben habe. Hier sind die wichtigsten:

  • Kein selbst gehosteter Server – Ich möchte keinen Server verwalten (und bezahlen 😉).
  • Datenportabilität – Die Kommentare können exportiert werden.
  • Datenschutzfreundlich – keine zusätzlichen Tracker oder Werbung über das hinaus, was ich bereits verwende (z. B. Google Analytics).
  • Markdown-Unterstützung – ermöglicht reichhaltige Formatierung (Codeblöcke usw.), geeignet für technische Diskussionen.
  • Spamschutz – verfügt über Maßnahmen zur Reduzierung von Spam, insbesondere wenn anonyme oder nicht authentifizierte Kommentare erlaubt sind.

Die Werkzeuge, die Deep Research analysiert hat, waren:

  • Giscus
  • Utterances
  • Staticman
  • Commento
  • Hyvor Talk
  • Disqus
  • Einige selbstgemachte Lösungen

Integration von Giscus

Im Anschluss an die Recherche habe ich das Modell gebeten, mir eine Schritt-für-Schritt-Anleitung zur Integration der Lösung zu geben. Dies war weitaus weniger zuverlässig als die erste Recherche, aber dennoch hilfreich.

Hier ist die Zusammenfassung (die Details finden Sie im Chat, den ich mit der KI hatte):

  • Schritt 1: Aktivieren Sie GitHub Discussions für Ihr Repository. Das bedeutet das Repo, in das die statische Seite generiert wird (was manchmal nicht dasselbe wie die Quelle ist).
  • Gehen Sie zu Ihrem GitHub-Repository
  • Navigieren Sie zu Einstellungen > Allgemein.
  • Scrollen Sie nach unten zum Abschnitt Discussions und aktivieren Sie ihn.
  • Zwischenschritt, den die KI nicht erwähnt hat: Installieren Sie Giscus für alle oder einige Ihrer Repos. Hier alt text
  • Schritt 2: Installieren und Konfigurieren Sie Giscus
  • Besuchen Sie die Giscus-Einrichtungsseite: https://giscus.app/.
  • Unter “Repository” geben Sie Ihren Reponamen ein. Sie sollten jetzt das grüne Häkchen sehen, dass Ihr Repo alle Kriterien für die Verwendung von Giscus erfüllt.
  • Die Option „Page discussion mapping“ bestimmt eine Beziehung zwischen Ihren Seiten, z. B. einem Artikel, und einer GitHub-Diskussion. Ich habe den Pfadnamen ausgewählt.
  • Für die Diskussionskategorie habe ich „general“ ausgewählt. Setzen Sie das Theme auf “Match OS” oder definieren Sie manuell den hellen und dunklen Modus. Klicken Sie auf “Code kopieren”, sobald Sie das