[giscus][giscus]

December 31, 2024 · View on GitHub

Un sistema de comentaris desenvolupat amb Discussions de GitHub. Permet als visitants deixar comentaris i reaccions al teu lloc web mitjançant GitHub! Inspirat en utterances.

Codi obert. 🌏
Sense seguiment, sense anuncis, sempre gratuït. 📡 🚫
No es necessita una base de dades. Totes les dades s'emmagatzemen a les Discussions de GitHub. :octocat:
Suporta temes personalitzats! 🌗
Suporta múltiples idiomes]multiple-languages. 🌐
Ampliament configurable. 🔧
Obté automàticament nous comentaris i edicions des de GitHub. 🔃
Pot ser autoallotjat! 🤳

Nota:
giscus segueix sent un projecte en desenvolupament. GitHub també continua desenvolupant activament les Discussions i la seva API. Per tant, és possible que algunes característiques de giscus puguin trencar-se o canviar amb el temps. És recomanable mantenir-se actualitzat amb les últimes versions i actualitzacions de giscus i seguir les actualitzacions relacionades amb les Discussions i la seva API a GitHub. Això assegurarà que giscus segueixi funcionant de manera òptima i s'aprofiti de les últimes funcionalitats i millores.

Com funciona

Quan es carrega giscus, s'utilitza l'API de cerca de discussions de GitHub per trobar la discussió associada amb la pàgina en funció de la forma de mapeig triada (URL, pathname, , etc.). Si no es pot trobar cap discussió que coincideixi, el bot giscus crearà automàticament una discussió la primera vegada que algú deixi un comentari o una reacció.

Per deixar un comentari, els visitants han d'autoritzar l'aplicació de giscus per publicar en el seu nom utilitzant el flux de GitHub OAuth. Alternativament, els visitants poden comentar directament a la Discussió de GitHub. Pots moderar els comentaris a GitHub.

Si estàs utilitzant giscus, considera recomanar 🌟 giscus a GitHub i afegir el tema giscus al teu repositori! 🎉

Ús avançat

Pots afegir configuracions addicionals (com permetre orígens específics) seguint la guia d'ús avançat.

Per utilitzar giscus amb React, Vue o Svelte, consulta la biblioteca de components de giscus.

Migrant

Si has utilitzat anteriorment altres sistemes que fan servir GitHub Issues (com ara utterances o gitalk), pots convertir les issues existents en discussions. Després de la conversió, assegura't que el mapeig entre els títols de la discussió i les pàgines sigui correcte, i giscus utilitzarà automàticament les discussions.

Webs que utilitzen giscus

Contribució

Veure CONTRIBUTING.md

Aquest fitxer README està disponible en: