这是我的第一篇博客,记录 通过Git Hub Pages搭建博客遇到的坑。
前言
我是在简书上看到的教程。来自BYQiu的【利用 GitHub Pages 快速搭建个人博客】
只要搜索 【git hub 搭建博客】 能搜到很多相关的内容。这里更多写一些踩到的坑。
起步
首先,注册Github账号 ,(- 。-)!千万别忘了自己密码!!!
第二步,拉别人仓库中配置好的博客模板(模板有很多,更重要的是修改配置文件),修改仓库名为 你的注册账号名.github.io
第三步,根据各位大神提供的描述去修改配置文件。通过 _config.yml 修改展示内容(标题,欢迎语,个性签名,友情链接,图片位置等),这些很容易掌握。本文重点:博客配置个人域名、博客配置git Talk评论系统、博客自定义图标。
核心思路:克隆博客模板仓库,修改名称为 注册账号名.github.io ,再修改仓库中的配置内容。修改配置可以通过github 在线修改,也可以通过git工具进行管理。
下载安装GIT==》(点击跳转)
推荐git教程==》(学习GIT使用)
ps:(很多地方提到需要一些其他的工具,如果没有特殊需求,实际上不需要下载安装github桌面版、hexo、Node.js 等其他工具。)
问题解决
基本的配置都很容易找得到,被作者忽略的配置在此补充一下:
-
配置将网站添加到屏幕(将博客添加到主屏幕,一般很少会遇到这个场景,在pad上无意发现的)
基本配置完成后,发现我的博客在添加到主屏幕时,竟然还是原作者留下的信息。于是就开始找配置该项的位置,最终在 pwa/manifest.json 找到。可以修改src引用的图片位置,也可以把对应图片替换掉。
-
配置个人域名
-
注册购买域名 :首先需要注册购买域名,域名一定要实名认证!否则注册商将禁止域名解析(无法解析则无法通过域名访问)。注册域名时填写通讯地址 最好与身份证上保持一致!
(我填写了保密,有文章说不一致会认证失败,但我认证成功了。)
-
配置解析 : 在域名管理中,可以找到自己注册的域名。然后点击解析
配置成图中样例。
注意,如果评论功能出现问题,跟域名配置一点关系也没有!
-
这时只差最后一步:在仓库中根目录(就是有_config.yml 文件的目录) ,上传叫做 CNAME的文件。CNAME中第一行写自己的域名,不要加多余空格,文件不要有任何结尾格式(.txt之类)。
-
如果仍然出现问题,点击仓库settings(https://github.com/你的用户名/你的仓库名/settings) 在 GitHub Pages 下查看配置。如图:
-
此时,即可通过域名访问到你的博客。如果想通过更改二级域名访问到其他的服务器,可以配置解析
如果填写abc,就可以通过abc.litany.cn去访问记录值配置的ip地址。
-
-
配置gitTalk 评论系统
-
遇到了【发布的新文章提示“未找到相关的 Issues 进行评论,请联系xxx初始化创建】。点击登陆后会跳回首页,通过抓包发现权限验证401问题,访问报错。
如图所示:
-
解决方案只有去检查gitTalk 的配置参数,看格式是否正确。
一般情况下只需要关心填写的值(也有可能是属性名称有问题,不过一般概率不大),
-
owner:去个人主页查看一下自己当前的name,是不是和填写的owner对应属于一致,这里需要的是当前名称而不是注册时名称。(建议当前名和注册名保持一致)
-
repo:可以配置该账号中任意一个仓库的名称,之后所有的评论会存在Issues 中。
-
admin:填写该项目的管理员(没有测试是填写用户名还是账号名)
注意:这里没做测试,admin可以填写多个[‘账号1’,’账号2’,’账号3’],和github支持的最大管理员数有关。强烈建议用户名与注册账号保持一致。
-
-
配置确认无误,如果仍然出现问题,需要去配置repo的仓库settings 查看Issues是否打勾。如图:
-
-
配置统计系统
-
通过google的Analytics
- 点击 左下角 Admin进行设置。
- 点击 Account右边 +Create Account 添加一个账户配置
- 根据提示配置即可。可以参考谷歌文档
-
通过baidu的百度网站统计
-
点击立即使用后,点击管理按钮进入管理(需登陆)
-
点击新增网站进行配置
-
配置完成点击获取代码看到如下内容:
<script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?A8439c327fb5167f1431feb7c50a8822"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script>
其中hm.src属性中问号后面的A8439c327fb5167f1431feb7c50a8822 是你的trackId。
-
-
注册完成后,在_config.yml 配置文件中填入对应的信息,保存即可。
-
推荐几个网站 :
编写Markdown 时用到图片,可以通过图床工具进行上传获取图片url。
上传博客背景或图片,可以通过压缩图片工具减小图片提及,提高访问速度。
图标ico文件:转换格式为ico
Logo设计:
designmantis:在线设计网: 设计商店
brandmark:the most advanced AI logo design tool
logo生成:Logo设计在线制作神器,智能标志logo生成器
想找一些好的图片:Pexels