Gridea 小白上手教程

如果你使用过 Hexo 等工具基于 Github 做个人博客,那么恭喜你,你可以很轻松的上手使用Gridea 如果你以前没有使用过,那么希望这篇文章可以帮助你顺利的完成博客搭建。话不多说,Let's Go!

由于项目之前叫做 Hve Notes,所以截图还是旧版软件,但不影响使用,各位小伙伴先将就咯

准备工作

由于 Github 和 Coding 的步骤差不多,下面就以 Github 为例来操作一下

必须:确保你已经安装过 GitHve Notes

首先你需要一个 Github 账号,如果没有的话,快去注册一个吧!

登录 Github,然后进入到 这里 创建一个 Token,勾选上 repo 的相关权限即可,下面是对应的截图示例: Github Personal access tokesn

生成之后你可以复制 Token 到你可以再次找到的某个地方,因为一旦你关了这个网页就再也不会看到它了,稍后会在软件中使用

Token示例

接下来你需要创建一个仓库,用来存放博客构建后的静态文件。我们建议你创建仓库名为 用户名.github.io 的仓库,因为 Github 会默认将此仓库设置成 Github Pages 可访问类型,若不是用此命名的仓库,则不能默认使用 Github Pages,所以请认真确认。例如我的 Github 用户名为 EryouHao,则仓库名为 EryouHao.github.io。使用这种方式还有一个好处是,在没有自定义域名的情况下,使你的博客域名更短。当然如果想使用其他仓库来存放博客静态文件的话,也不是不可以,只不过,存放之后,若没有设置自定义域名,则访问地址将变成 https://用户名.github.io/blog (blog 为仓库名)这种二级目录的形式。

开始使用

打开 Hve Notes 进入到配置页面,然后按照下面示例,输入相关配置并保存

配置示例

在不开启文章评论的情况下,到此为止,你已经可以点击预览,点击同步进行博客部署啦,快去试试看吧!(当然在不同步的情况下)

开启文章评论

Hve Notes 目前提供了 GitalkDisqus 两种评论系统支持。

Gitalk 是一个基于 GitHub Issue 和 Preact 开发的评论插件。如果你博客使用的是 Gitalk 的话,建议你可以选择 Gitalk 来作为评论插件。

你可以按照 Gitalk 的文档 进行相关字段配置,或者按照下面的步骤操作。

首先你需要有一个 Github OAuth Application,点击这里创建,字段填写可以参照下图

Github OAuth

创建完成后可将 Client IDClient Secret复制一下,保存到本地

接下来就可以去应用里面填写对应的信息,并开启评论

这样评论插件就设置好了,在预览时会在文章页显示评论模块,但不会显示具体的评论信息,因为这个是本地预览,而 Github OAuth 设置的域名为线上的域名。待博客同步到线上时就可以显示啦!

快快开始你的创作吧!