Post

Abilitare i commenti su Jekyll usando Giscus

Ieri stavo ultimando la configurazione del blog e mi sono accorto di aver dimenticato di abilitare i commenti. I commenti in un blog sono importanti perchè ti permettono di comunicare con i lettori, leggere i loro suggerimenti, le critiche ed eventuali correzioni da fare agli articoli.

Tra le opzione rese disponibili da Jekyll ospitato su Github, quella più comoda è risultata Giscus. L’attivazione ha richiesto meno di 30 minuti (da neofita) seguendo i consigli di Martin e Seletz.

Giscus si basa sulle discussioni di Github. Queste possono essere abilitate nei repository ospitati offrendo commenti e statistiche sui siti web. Fortunatamente chirpy, il tema che ho scelto per il blog, ha la perfetta integrazione con Giscus.

Configurazione

La configuraizone è semplice. Ecco i passaggi:

  • Installare ed autorizzare l’app giscus nel repository Github del blog
  • Configurare i parametri su https://giscus.app
    • Inserire i parametri del repositori del blog di Github (username/repo).
    • Abilitare la mappatura Pagina ↔️ Discussione
    • Usare la categoria “Announcements”
    • Abilitare le reazioni per il post principale
    • Dallo snippet restituito si estrapolano i dati da inserire nel file _config.yml del blog
  • Abilitare i commenti giscus inserendo i dati nel file _config.yml di cui sotto posto un esempio:
1
2
3
4
5
6
7
8
9
10
11
comments:
  active: "giscus"
  giscus:
    repo: "danywebxx/danywebxx.github.io" # <gh-username>/<repo>
    repo_id: "ricavato da pagina Giscus"
    category: "Announcements"
    category_id: "ricavato da pagina Giscus"
    mapping: "pathname" # optional, default to 'pathname'
    input_position: "bottom" # optional, default to 'bottom'
    lang: "it" # optional, default to the value of `site.lang`
    reactions_enabled: "1" # optional, default to the value of `1`

Se hai trovato inesattezze fammelo sapere lasciando un commento (così mi assicuro che i commenti funzionino correttamente ;-P).

Questo post è sotto licenza CC BY 4.0 a nome dell'autore.