初次搭建博客

不忘初心,勉励前行!

Posted by Litany on November 1, 2019

这是我的第一篇博客,记录 通过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引用的图片位置,也可以把对应图片替换掉。

  • 配置个人域名

    • 注册购买域名 :首先需要注册购买域名,域名一定要实名认证!否则注册商将禁止域名解析(无法解析则无法通过域名访问)。注册域名时填写通讯地址 最好与身份证上保持一致

      (我填写了保密,有文章说不一致会认证失败,但我认证成功了。)

    • 配置解析 : 在域名管理中,可以找到自己注册的域名。然后点击解析Kv0XPe.md.png

      ​ 配置成图中样例。

      注意,如果评论功能出现问题,跟域名配置一点关系也没有

    • 这时只差最后一步:在仓库中根目录(就是有_config.yml 文件的目录) ,上传叫做 CNAME的文件。CNAME中第一行写自己的域名,不要加多余空格,文件不要有任何结尾格式(.txt之类)

    • 如果仍然出现问题,点击仓库settings(https://github.com/你的用户名/你的仓库名/settings) 在 GitHub Pages 下查看配置。如图:

      Kvmro8.md.jpg

    • 此时,即可通过域名访问到你的博客。如果想通过更改二级域名访问到其他的服务器,可以配置解析 Kvnsn1.md.png

      如果填写abc,就可以通过abc.litany.cn去访问记录值配置的ip地址

  • 配置gitTalk 评论系统

    • 遇到了【发布的新文章提示“未找到相关的 Issues 进行评论,请联系xxx初始化创建】。点击登陆后会跳回首页,通过抓包发现权限验证401问题,访问报错。

      如图所示:

      • 解决方案只有去检查gitTalk 的配置参数,看格式是否正确。

        一般情况下只需要关心填写的值(也有可能是属性名称有问题,不过一般概率不大),

        格式是这样的:KHGyGQ.md.png

      • owner:去个人主页查看一下自己当前的name,是不是和填写的owner对应属于一致,这里需要的是当前名称而不是注册时名称。(建议当前名和注册名保持一致)

      • repo:可以配置该账号中任意一个仓库的名称,之后所有的评论会存在Issues 中。

      • admin:填写该项目的管理员(没有测试是填写用户名还是账号名)

        注意:这里没做测试,admin可以填写多个[‘账号1’,’账号2’,’账号3’],和github支持的最大管理员数有关。强烈建议用户名与注册账号保持一致。

    • 配置确认无误,如果仍然出现问题,需要去配置repo的仓库settings 查看Issues是否打勾。如图:

KvuzGD.md.png

  • 配置统计系统

    • 通过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