小白专属Hexo手摸手详细搭建教程，0成本搭建属于自己的个人博客

书浩 • 2023-05-18 • 技术教程, 网站搭建

必备条件

  1. Node.js 官网下载地址：https://nodejs.org/en
  2. Git，官网下载地址：吉特 (git-scm.com)
  3. GitHub账号，在GitHub进行注册

可以在cmd终端输入node -v 和git -v 来验证是否已经安装完成，如果显示版本号则代表安装成功。

安装Hexo

在一个合适的位置创建一个文件夹以存放博客文件，所有必备的应用程序安装完成后，即可私用npm安装Hexo。
  1. 右键创建的文件夹点击`Git Bash Here`或进入文件夹在地址栏输入cmd
  2. 输入以下命令安装hexo 
    npm install -g hexo-cli
  3. 在安装完成以后输入下方代码检查是否安装和成功 
    hexo -v && git -v && node -v

    若输出版本号相关表示安装成功

  4. 复制下方命令，进行初始化博客文件夹 
    // hexo init 博客文件夹  若为空表示在当前文件夹
hexo init blog
// 或
hexo init
  5. 复制npm install 命令，安装hexo的扩展插件

配置ssh

  1. 打开git bash终端。
  2. 设置user.name和user.email。 
    git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

     

  3. 生成ssh密匙 
    ssh-keygen -t rsa -C "你的GitHub注册邮箱"
  4. 此时，在用户文件夹下就会有一个新的文件夹.ssh，里面有刚刚创建的ssh密钥文件id_rsa和id_rsa.pub。

将公匙添加到github上

   用户头像→Settings→SSH and GPG keys→New SSH key→将id_rsa.pub中的内容复制到Key文本框中，然后点击Add SSH key(添加SSH)按钮。

创建仓库

在GitHub中创建一个仓库，将仓库的名字更改为 yourname.github.io，例如我的仓库名是zsuh.github.io

初探Hexo

当在第一次使用hexo时，在本地创建服务器使用
# 生成静态页面
hexo generate
# 开启本地服务器
hexo s
根据提示，使用ctar + 左键单击 进入链接应该就可以看到刚刚创建的博客了

部署至GitHub

修改配置文件**blog/_config.yml**，修改deploy项的内容，如下所示：
# Deployment 注释
## Docs: https://hexo.io/docs/deployment.html
deploy:
  # 类型
  type: git
  # 仓库
  repo: https://github.com/zsuh/zsuh.github.io.git
  # 分支
  branch: main
注意事项：
  • 在冒号后面有一个空格，没有会报错
  • 将repo的地址更换为自己的仓库地址
输入下面的命令将hexo博客部署到github中：
# 清空静态页面
hexo clean
# 生成静态页面
hexo generate
# 部署
hexo deploy
#可以简写为
hexo clean && hexo g -d && hexo s

疑难杂症

hexo每次上传后都需要重新配置自定义域名

在`sourcce`下创建文件`CNAME`在其中填入你的自定义网址 如 zsuh.cc
注意事项：
  • 文件没有后缀
  • 文件命名必须是大写
  • 网址不要带协议

 

第一次部署时无法上传至GitHub

由于hexo不自带上传插件，安装Git上传插件即可

版权声明：
作者：书浩
链接：https://www.zsuh.cc/8.html
来源：晨讯博客
文章版权归作者所有，未经允许请勿转载。

THE END
分享
二维码
海报
小白专属Hexo手摸手详细搭建教程，0成本搭建属于自己的个人博客
必备条件 Node.js 官网下载地址：https://nodejs.org/en Git，官网下载地址：吉特 (git-scm.com) GitHub账号，在GitHub进行注册 可以在cmd终端输入node -v ……
<<上一篇
下一篇>>