关于Hexo+NexT搭建个人博客的分享
徐徐 抱歉选手

踩坑与出坑

Mac终端生成SSH key并添加到Github上

参考这篇博客

比较实用的部分是如何检测SSH key是否有权限访问github这一部分,通过在终端输入ssh git@github.com

执行npm install出现的各种问题

错误1:npm ERR! Unexpected end of JSON input while parsing near

执行npm cache clean --force,再执行npm intsall。可能要多尝试几次。

错误2:Missing write access to /usr/local/lib/node_modules

执行sudo chown -R $USER /usr/local/lib/node_modules,具体解释在此处

错误3:Git Bash: remote error: You can’t push to git://github.com/

需要使用HTTPS或SSH URL。

区分._config.yml文件

hexo site root direcotorytheme directory under site root directory下分别有两个._config.yml文件,在阅读安装教程时请一定要看仔细每一步操作是针对哪一个配置文件进行的。

学会熟练使用配置文件comment中给出的链接,阅读相关内容即可设置出想要的效果。在遇到问题时优先选择阅读最新官方文档!

CNAME文件部署后消失

直接在hexo/source目录下创建一个纯文件CNAME,里面存放的内容为从域名服务商处购买来的域名。

对于创建纯文件CNAME,应当在终端目录hexo/source下执行命令行vi CNAME,进入vim文本编辑输入模式your-domain-name,退出保存即可。

本地重新部署后浏览器没有显示网页变化

由于学习使用的时候用的主要还是Chrome浏览器,他会自动缓存上一次的浏览记录,会让重新部署后的网页无法正确显示。在CNAME文件本地创建并上传多次后依然网页404,在设定favicon多次之后发现依然不出现小图标。

可以尝试在Chrome浏览器中删除最近一小时的浏览记录,问题即可解决。也可以多尝试其他浏览器,比如Firefox、Safari。

实用指南

博客运作原理

彻底搞懂如何使用Hexo+GitHubPages搭建个人博客

建议参考这篇文章前半部分,能够帮助理解Hexo和Github Pages之间的关系,Hexo在博客中扮演什么角色,Github Pages在博客中扮演什么角色。

域名解析配置

A Guide of Making Your Personal Blog - Part3

这系列文章都为我部署我的个人博客提供了很大的帮助。这一篇为我理解域名解析提供了很大帮助,它不仅告诉你操作流程,还告诉你操作流程背后的原因。

主要有三个部分:Namecheap购买域名,Cloudflare域名解析,Github响应解析。

Namecheap购买完域名之后,我们需要告诉Namecheap我需要通过Cloudflare的服务器进行域名解析,而不是通过namecheap自带的服务器解析。所以,我们需要在购买的域名中选择Custom DNS,并将nameservers的值更改为Cloudflare的服务器的地址。

为了获得Cloudflare的服务器地址,需要访问Cloudflare的网站。在这里为购买的域名添加记录,目的是将域名指向Github服务器的地址,添加记录的类型均为CNAME。

我们在这个定位到的是Github服务器的地址,但是服务器却不知道该返回什么样的子资源。为了让属于我们的Github Pages被返回,我们需要将Github Pages的Settings中的Custom Domain设定为在Namecheap购买的域名。

由此才可以建立起完整的域名解析。

Hexo官方文档

这是Hexo官方文档

此官方文档能够指导的内容有:Node.js的安装、Hexo的安装、Hexo生成文件中各个参数的作用、如何使用Hexo来产出博客内容。

NexT官方文档

这是NexT最新说明文档

之前一直参考的是iissnan给出的说明文档,但是由于NexT更新,最新的指南应该根据最新的文档,否则会发现有hexo/themes/next/_config.yml配置文件内容的不同。

另外,这个最新的文档似乎没有中文版。

  • 本文标题:关于Hexo+NexT搭建个人博客的分享
  • 本文作者:徐徐
  • 创建时间:2020-10-02 13:00:11
  • 本文链接:https://machacroissant.github.io/2020/10/02/hexoandnext/
  • 版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!
 评论