如何搭建个人博客站点

bin斌 - 2021-08-17 17:29:08

原文地址：https://www.hz-bin.cn/BuildBlog

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，然后保存。