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. So habe ich es gemacht - 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 in der Beitragsübersichtsseite hinzugefügt.

Aktualisierung vom 2025-05-23 Da 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 zu diesem Thema ausprobiert: lesen Sie hier gerne weiter. Insgesamt war die Recherche hilfreich und ich habe mich letztendlich für Giscus für die Kommentare entschieden. Teilweise, weil es sich am robustesten und zuverlässigsten anfühlte, 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.), die für technische Diskussionen geeignet ist.
  • Spamschutz – verfügt über Maßnahmen zur Reduzierung von Spam, insbesondere wenn anonyme oder nicht authentifizierte Kommentare zugelassen werden.

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. Diese war weit 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 ist wie die Quelle).
  • Gehen Sie zu Ihrem GitHub-Repository
  • Navigieren Sie zu Einstellungen > Allgemein.
  • Scrollen Sie nach unten zum Abschnitt Diskussionen 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 Sie Giscus und konfigurieren Sie es
  • Besuchen Sie die Giscus-Setup-Seite: https://giscus.app/.
  • Unter "Repository" geben Sie Ihren Repo-Namen 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 „allgemein“ ausgewählt. Stellen Sie das Thema auf "Match OS" oder definieren Sie manuell den hellen und dunklen Modus. Klicken Sie auf "Code kopieren", sobald Sie das