如何搭建个人博客站点

1、如何使用 github page 部署个人博客

• 登录 [github]，点击右上角新建仓库，仓库名填 username.github.io，其中 username 填自己的 github 名称，例如博主的是 hz-bin，则仓库名为 hz-bin.github.io。

• 进入项目的 Settings->Pages 页面，Source 选择 master，然后点击 Save，则完成部署，即可通过 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错误

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 服务器地址。

可参考官方文档：

初始化：leancloud.cn/docs/sdk_setup-js.html#hash20935048]

数据存储入门教程 · JavaScript：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]，按如图所示操作：