Hexo+Github 博客的搭建详细步骤

Hexo+Github 博客的搭建详细步骤

1. 工具的安装配置

1.1 下载安装 node.js：

• 中国官网：https://nodejs.org/zh-cn/
• 安装后在终端中检验：node -v (结果为类似 v14.18.1 即成功 )

1.2 cnpm安装

node安装后会自动下载 npm ，但npm太慢，所以用淘宝的cnpm

• 终端输入命令： npm install -g cnpm --registry==https://registry.npm.taobao.org
• 安装后检验： cnpm -v

1.3 下载安装git：

• 官网下载：https://git-scm.com/download/win

• 安装后检验： git --version (eg: git version 2.33.1.windows.1)

• 推荐2篇git的详细安装过程：

  (10条消息) Git 详细安装教程（详解 Git 安装过程的每一个步骤）_mukes的博客-CSDN博客_git安装

  安装Git - 廖雪峰的官方网站 (liaoxuefeng.com)

注意：安装完成后要确定你的用户名和邮箱
git config --global user.name "Your Name"
git config --global user.email "email@example.com"

1.4 安装 hexo

• 新建文件夹后，在此打开git或终端输入：npm install -g hexo-cli

2. hexo本地搭建博客

2.1 初始化

首先右键某文件夹打开 Git Bash Here，输入 hexo init（ 静静地等待）

（如果右键没有的话可能是在git安装过程中没有选将其添加在右键中，也可以在windows的命令终端中执行）

（ 静静地等待可能会遇到各种奇怪的问题，将报的错Ctrl+ c/v 到百度搜素，再不行就多试几遍，再次试的时候要将你文件夹中的内容清空再init，git和终端换着用，总有解决的方法）

然后在当前文件目录下输入 hexo g

​ hexo s

如果没有不成功，你就成功 init 了[doge]，在浏览器访问http://localhost:4000你就会看到的你新生的blog

要是报错的话在网上找找，相关的内容还是比较全的

hexo命令的详解：[Hexo系列(三) 常用命令详解 - 半虹 - 博客园 (cnblogs.com)](https://www.cnblogs.com/wsmrzx/p/9439448.html#:~:text=hexo init 命令用于初始化本地文件夹为网站的根目录,%24 hexo init [folder])

2.2 美化

在本地搭好博客后不要着急部署到github上，因为你还要换主题，魔改主题，等你基本弄完后再部署上去，遇到的错更少一些，也更好解决。

• hexo的主题网站：https://hexo.io/themes/
• 找到你心仪的主题下载，可以在之前初始化的文件夹中找到themes文件夹，右键git bash ，输入：git clone 主题的github链接

链接如图：

或是直接download压缩包，解压后放在themes文件中

• 将下载的文件夹的名字复制，打开你博客目录下的_config.yml文件 ，找到theme，将landscape改为你复制的文件夹名

• eg:

• 最后hexo -clean hexo g hexo s

• 遇到的问题:

  更换主题加载页面后，页面出现extends includes/layout.pug block content include includes/recent-posts.pug include includes/partial

  • 解决方法：cmd命令输入 cnpm install hexo-renderer-pug hexo-renderer-stylus --save,然后hexo三连：clean g s

• 之后就可以根据你选择的主题在网上找资料开始魔改了。

3. 部署到github上

• 注册github账号，新建一个仓库（可能会很。。。慢）

  • 

  • 

    注意：owner name要和仓库名字相同

    • 

• 在你博客所在目录下git bash ： cnpm install hexo-deployer-git --save -> 安装 hexo-deployer-git 插件

• 在你博客所在目录下的_config.yml 中修改（注意不是主题文件夹中的_config.yml ），如图：

github地址：

• 最后博客所在目录下输入命令hexo d,过程中可能需要输入github的username和passwd
• 成功后。你就可以访问https://xxx.github.io/

4. 绑定域名

• 你可以在阿里云、腾讯云等购买一个自己的域名，我是新用户一块钱买的，一年有效期。

• 操作：

  • 再买完和一系列操作之后，解析域名，如图：

    

  • 根据下图配置：

    

  • 然后打开github做相关配置： 找到你之前创建的仓库 settings -> Pages ->Custom domain
    
    

• okk,如果一切顺利现在你可以通过你自己的域名来访问博客网站了。

5. Typora+PicGo 写文章

• 因为要在本地写markdown,所以我推荐用Typora来写文章或学习笔记等等，Typora也有一些不足但在同行衬托下，我还是选择使用它。因为插入图片很不爽，所以可以结合PicGo自动上传图片到图床。

• Typora下载：Typora — a markdown editor, markdown reader.

  PicGo下载：PicGo

• PicGo下载完后，打开设置 -> 设置Server -> 地址和端口如图：

注意：监听地址是 127.0.0.1，端口为 36677，不是的话会上传失败。

• Typora设置： 点击文件选择偏好设置 -> 图像

注意:

• 最后你完成所有工作后，点击 验证图片上传选项 检验是否配置好，但失败了也没关系，因为可能有一些小问题，但不要纠结，你可以再截张图放在文章里看上传是否成功。

总结：

​ 这些是我在hexo框架下搭建博客的大体历程，因为是时候写的博客所以更为详细的内容省略了一些。经过了好几天，犯了很多错误，看了许许多多的文章，那些文章确实给了我很大的帮助，所以我也想记录一下，如果对你有一点帮助，我会赶到十分荣幸，也希望你继续帮助别人。因为弄这些的过程中间停滞了一段时间，所以遇到的很多的bug没有即使记录下来，也都忘了是啥，所以如果你遇到我这没有的错误，你可以将error内容复制到百度，基本上都有其他博主的解答，也可以评论区留言。

theend