github+hexo+next搭建个人博客

发表于 更新于 分类于 ，
tobeabooker.github.io

几个比较详细的教程链接：

  • 知乎
  • 百度
  • 贴吧
  • b站 B站的评论最多，如果有问题可以去评论区看看，同时可以参考别人已经搭好的，基本每个搭好的人都会写一篇踩坑经历，多看看自然就会了。

以下为思路，从简。还是要多看上面的链接以及多百度。

1.git与node.js的安装

可自行百度，官网安装最新版。

2.hexo安装，hexo官网

右键git bash执行下列命令

1
2
3
npm install -g hexo-cli 
hexo init blog
hexo s （找到生成的blog目录，重新右键git bash。以后所有的命令都在个目录执行。）

在浏览器打开网址：localhost:4000即可本地预览。

2.1可能遇见的问题：

3.部署到github

3.1 注册账号、建立仓库。用户名、仓库名设置为相同。

3.2 git绑定github，生成ssh复制到github-settings-keys-new ssh key中。

1
2
3
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"
ssh-keygen -t rsa -C "你的GitHub注册邮箱"

3.3 在hexo站点配置文件（即根目录下的_config.yml）中加入github信息。下面是我的，将tobeabooker改成自己的github用户名。

1
2
3
4
deploy:
  type: git
  repo: git@github.com:tobeabooker/tobeabooker.github.io.git
  branch: main

3.4 在git bash中依次执行以下命令：

1
2
3
4
npm install hexo-deployer-git --save
hexo clean 
hexo g 
hexo d

部署成功后可在<你的GitHub用户名>.github.io访问。

3.5可能遇见的问题

  • github默认分支（branch）由master变为main，自行百度更改github branch名字。
  • ssh在c盘用户的文件夹下，id_rsa.pub应当用txt打开，不要用publisher。
  • FATAL can not read a block mapping entry。config.yml配置文件冒号后不能少一个空格。
  • err: Error: Spawn failed 解决办法1 解决办法2

4.主题优化

4.1 选择主题

hexo351个主题。next是得分比较高的主题。以下是next的几个重要链接。

下载好压缩包后解压到themes文件夹下。将文件夹命名为“next”，打开hexo站点配置文件（即根目录下的_config.yml），修改为：theme: next

4.2 next主题美化，（即themes/next目录下的_config.yml）

同样先上几个链接。各位可自行决定需要什么功能。多百度。

4.3可能遇见的问题

  • 如何写文章？在根目录下的source/-post文件夹下。用markdown编辑器写好，将md文件直接放到这里，hexo d -g即可。
  • 一般的报错都会有错误名称以及提示是哪个文件，那行，不要因为是英文就觉得看不懂。把错误名称拿去百度。
  • busuanzi只能在文章页面显示阅读量，无法在主页显示。
  • Social Links中的图标没有显示。解决链接
  • valine评论功能虽然好弄，但leancloud国内版不再提供二级域名。国际版倒是给，但不知道为啥，换了国际版的id和key连基本的评论功能都无法用，更别提邮件提醒。于是只能换来必力和gitalk。
  • gitalk 的Error: Bad credentials 和Error: Not Found。仓库名没错，不知道为啥，过一段时间就好了。另外，不要在本地测试gitalk功能。
  • err: TypeError: Cannot read properties of undefined (reading ‘enable’)。config.yml配置文件不能多一个空格。