创建 GitHub Application
引入 gitalk 的代码
在 themes/[theme_name]/layout/_script/_comments/ 目录下,创建gitalk.swig文件。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
| <!-- gitalk.swig --> <link href="https://cdn.bootcss.com/gitalk/1.4.0/gitalk.min.css" rel="stylesheet" /> <script src="https://cdn.bootcss.com/gitalk/1.4.0/gitalk.min.js"></script> <script src="https://cdn.bootcss.com/blueimp-md5/2.10.0/js/md5.min.js"></script> <script type="text/javascript"> var gitalk = new Gitalk({ clientID: '{{ theme.gitalk.ClientID }}', clientSecret: '{{ theme.gitalk.ClientSecret }}', repo: '{{ theme.gitalk.repo }}', owner: '{{ theme.gitalk.owner }}', admin: ['{{ theme.gitalk.adminUser }}'], id: md5(location.pathname), // ISSUE:location.href 限制50个字符 (应该是Issue 内容存数据库的标识, 具体在页面上无感) labels: '{{ theme.gitalk.labels }}'.split(',').filter(l => l), // 需要的 labels需要一个数组,否则会报错 perPage: {{ theme.gitalk.perPage }}, pagerDirection: '{{ theme.gitalk.pagerDirection }}', createIssueManually: {{ theme.gitalk.createIssueManually }}, distractionFreeMode: {{ theme.gitalk.distractionFreeMode }} }) gitalk.render('gitalk-container') </script>
|
1 2
| <!-- themes/[theme_name]/layout/_script/comments.swig --> {% include '_comments/gitalk.swig' %}
|
如果没有找到这个 comments.swig , 可以直接放到themes/polarbear/layout/_layout.swig 的 body 结束标签前
添加配置
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
| # theme/[theme_name]/_config.yaml 添加配置 # =========================================== # Comments Settings # =========================================== gitalk: enable: true # 是否启动 ClientID: Your ClientID # 之前的Client ID ClientSecret: Your ClientSecret # 之前的Client Secret repo: gitalk # 留言板内容需要存放的仓库名称 owner: wsuo # 你 github 的帐号 eg: www.github.com/wsuo ,帐号就是wsuo adminUser: wsuo # 管理员用户 labels: # issue 的标签 - gitalk perPage: 15 # 每页展示条数 pagerDirection: last # 排序方式是从旧到新(first)还是从新到旧(last) createIssueManually: false #如果当前页面没有相应的 isssue ,且登录的用户属于 admin,则会自动创建 issue。如果设置为 true,则显示一个初始化页面,创建 issue 需要点击 init 按钮。 distractionFreeMode: false #是否启用快捷键(cmd|ctrl + enter) 提交评论.
|
指令
修改主题配置文件
/themes/stun/_config.yml
1 2 3
| menu: categories: /categories/ || fas fa-layer-group tags: /tags/ || fas fa-tags
|
文章规范
文章元数据
1 2 3 4 5 6 7 8
| title: date: categories - 父类别 - 子类别 tags: - 标签1 - 标签2
|
主页不显示全部