Skip to content

snowdreams1006/hexo-plugin-gitalk

Repository files navigation

欢迎访问 hexo-plugin-gitalk 官网 👋

npm:version npm:download github:documentation github:maintenance npm:license github:snodreams1006 微信公众号:雪之梦技术驿站-brightgreen.svg

Hexo 整合 gitalk 组件实现博客评论功能

🏠 主页

效果

gitalk-use-preview.png

用法

Step #1 - 更新 _config.yml 配置文件

_config.yml 配置文件中,配置 gitalk 插件相关信息,详情见 gitalk.

plugins:
  gitalk:
    clientID: GitHub Application Client ID
    clientSecret: GitHub Application Client Secret
    repo: GitHub repo
    owner: GitHub repo owner
    admin: 
      - GitHub repo owner and collaborators, only these guys can initialize github issues
    distractionFreeMode: false

注意: 前往 gitalk 申请开通 gitalk 功能后,一定要替换成自己的相关配置!

其中,主要配置参数含义如下:

  • clientID String

    必须. GitHub Application Client ID.

  • clientSecret String

    必须. GitHub Application Client Secret.

  • repo String

    必须. GitHub repository.

  • owner String

    必须. GitHub repository 所有者,可以是个人或者组织。

  • admin Array

    必须. GitHub repository 的所有者和合作者 (对这个 repository 有写权限的用户)。

  • distractionFreeMode Boolean

    Default: false。

    类似Facebook评论框的全屏遮罩效果.

Step #2 - 运行 hexo 相关命令

  • 运行 npm install 命令安装到本地项目
$ npm install hexo-plugin-gitalk --save
  • 运行 hexo generate 命令构建本地项目或者 hexo server 启动本地服务.
$ hexo generate

或者

$ hexo server

注意: 本地测试时无法正常运行,必须是线上环境才会生效,且必须由管理员登录github进行初始化.

示例

不仅 hexo-plugin-gitalk 官方文档已整合 gitalk 版权保护插件,此外还提供了示例项目,详情参考 example 目录.

作者

👤 snowdreams1006

🤝 贡献

如果你想贡献自己的一份力量,欢迎提交 Issues 或者 Pull Request 请求!

支持

如果本项目对你有所帮助,欢迎 ⭐️ hexo-plugin-gitalk 项目,感谢你的支持与认可!

📝 版权

Copyright © 2019 snowdreams1006.

This project is MIT licensed.