Gitment 项目常见问题解决方案

Gitment 项目常见问题解决方案

gitment A comment system based on GitHub Issues. 项目地址: https://gitcode.com/gh_mirrors/gi/gitment

项目基础介绍

Gitment 是一个基于 GitHub Issues 的评论系统，可以在前端直接使用，无需任何服务器端实现。该项目的主要编程语言是 JavaScript，使用了 HTML 和 CSS 进行前端界面的构建。Gitment 的主要功能包括 GitHub 登录、Markdown/GFM 支持、语法高亮、GitHub 通知等。

新手使用注意事项及解决方案

1. OAuth 应用注册问题

问题描述：新手在使用 Gitment 时，可能会遇到 OAuth 应用注册的问题，尤其是在获取 client_id 和 client_secret 时。

解决步骤：

1. 访问 GitHub 的 OAuth 应用注册页面。
2. 填写应用名称、主页 URL 和回调 URL。回调 URL 通常是你的网站的域名，例如 https://example.com。
3. 提交后，GitHub 会生成 client_id 和 client_secret，务必妥善保存。

2. 评论初始化问题

问题描述：在页面发布后，用户可能无法看到评论框，或者无法初始化评论。

解决步骤：

1. 确保页面发布后，访问该页面并使用 GitHub 账号登录。
2. 点击页面上的“初始化”按钮，创建一个与该页面相关的 GitHub Issue。
3. 初始化完成后，其他用户即可在该页面上发表评论。

3. 样式和脚本加载问题

问题描述：新手在集成 Gitment 时，可能会遇到样式或脚本无法正确加载的问题。

解决步骤：

1. 确保在 HTML 文件中正确引入 Gitment 的样式和脚本文件。例如：

   <link rel="stylesheet" href="https://imsun.github.io/gitment/style/default.css">
   <script src="https://imsun.github.io/gitment/dist/gitment.browser.js"></script>
   

2. 如果使用 npm 安装 Gitment，确保在项目中正确引入：

   import 'gitment/style/default.css';
   import Gitment from 'gitment';
   

3. 检查浏览器的开发者工具，查看是否有网络请求失败或脚本加载错误。

通过以上步骤，新手可以更好地理解和使用 Gitment 项目，解决常见的问题。

gitment A comment system based on GitHub Issues. 项目地址: https://gitcode.com/gh_mirrors/gi/gitment