1、如何使用 github page 部署个人博客
- 登录 github,点击右上角新建仓库,仓库名填
username.github.io
,其中username
填自己的github
名称,例如博主的是hz-bin
,则仓库名为hz-bin.github.io
。
- 进入项目的
Settings->Pages
页面,Source
选择master
,然后点击Save
,则完成部署,即可通过 https://hz-bin.github.io 进行访问了。
2、如何使用 jekyll 和 TeXt 主题编辑博客内容
- 本地部署
jekyll
环境参考 jekyll 中文文档 - 本地克隆 TeXt 主题,然后进入到
jekyll-TeXt-theme
目录,如果有Gemfile.lock
文件,先删除该文件。 - 然后在命令行中先执行
gem install bundler jekyll
命令,再执行bundle exec jekyll serve
,则本地博客搭建完成 - 浏览器中输入
http://localhost:4000/
即可访问博客内容。 - 如何新增一篇博客:在
_posts
目录中新建markdown
格式文件,文件名格式为yyyy-mm-dd-blogname.md
。jekyll
会自动进行构建。
3、如何配置 gitalk 作为博客的评论系统
- 首先需要新建一个 OAuth application(右上角头像 -> Settings -> Developer settings -> OAuth Apps -> New OAuth App),如下图所示:
- 点击
Generate a new client secret
:
- 将
Client ID
和 刚刚产生的Client secrets
拷贝到_config.yml
文件中,其他参数如图所示:
配置完成之后,登录 gitalk
时可能会出现403错误,参考 Gitalk 评论登录 403 问题解决 和 在cloudflare上创建一个免费的在线代理来解决gitalk授权登录报403问题
4、如何配置 leancloud 记录文章访问次数
- 首先进入 LeanCloud,新建一个应用,应用名称自己随便填。然后进入到设置界面,如下所示,
_config.yml
配置中,pageview
的provider
填leancloud
,leancloud
的app_id
和app_key
分别填应用凭证界面的AppID
和AppKey
。
app_class
填Blog
或者自己定义一个名字,LeanCloud
会用该名称在 数据存储 -> 结构化数据 中创建Class,相当于存储访问次数的表。
- 修改
_includes/pageview-providers/leancloud/leancloud.js
,如下所示,serverURLs
改为serverURL
,值改为上面应用凭证中的REST API 服务器地址
。
可参考官方文档:
初始化:https://leancloud.cn/docs/sdk_setup-js.html#hash20935048
数据存储入门教程 · JavaScript:https://leancloud.cn/docs/leanstorage-started-js.html
5、如何给自己的博客设置自定义域名
- 添加如下2条记录,其中
ip
地址是通过ping hz-bin.github.io
得到的:
- 进入到
github
项目的Settings -> Pages
配置界面,Custom domain
填刚刚注册的域名,同时勾选上Enforce HTTPS
,然后保存。等待10分钟左右,就可以通过https://www.hz-bin.cn
访问了。
gitalk 和 cloudflare 修改
- 配置完域名之后,会发现 gitalk 登录不上了,且文章计数也获取不到了,需要对相关配置进行修改。
- 登录
github
,右上角头像 -> Settings -> Developer settings -> OAuth Apps,看到如下界面,点击第3节新建的OAuth application
,将Homepage URL
和Authorization callback URL
改成新的博客地址https://www.hz-bin.cn
,然后保存。
- 登录 cloudflare,按如图所示操作: