hexo博客搭建

本文详细指导如何注册GitHub账号,安装Node.js和Git,配置环境,解决npm和Hexo安装问题,以及部署Hexo到GitHubPages的过程,包括常见错误的解决方法。
摘要由CSDN通过智能技术生成


参考链接: https://zhuanlan.zhihu.com/p/60578464

1、注册github账号并创建仓库

注册账号过程省略
创建仓库:
在这里插入图片描述
创建后默认自动启用 HTTPS,博客地址为:https://用户名.github.io

2、安装node.js

下载链接:https://nodejs.org/en/download
在这里插入图片描述
下载完后,双击打开
在这里插入图片描述
出现安装界面,一路默认设置即可成功安装(不过安装路径可以选择性修改,最好安装在除C盘外的地方)
安装完后,win+R,输入cmd
在这里插入图片描述
打开后输入node -v查看版本号
在这里插入图片描述
出现版本号,即安装完成

3、nodejs配置环境

①找到nodejs文件夹,在其下创建node_cache和node_global这两个文件夹
在这里插入图片描述
②win+R,打开cmd
输入npm config set prefix "node_global的路径"和npm config set cache "node_cache的路径"将npm的目录配置到创建的文件中
在这里插入图片描述
③配置环境变量
新建系统变量
在这里插入图片描述
在用户变量-PATH-新建-node_global路径-确定
在这里插入图片描述

4、安装git

下载链接:https://git-scm.com/downloads
在这里插入图片描述
因为我之前安装过git所以这里没有安装过程记录,可以自行百度安装过程
安装完成后再cmd输入git version查看安装版本
在这里插入图片描述

5、连接 Github

设置用户名和邮箱:

$ git config --global user.name "Github 用户名"
$ git config --global user.email "Github 邮箱"

在这里插入图片描述
创建SSH密钥:(一直按回车键)

$ ssh-keygen -t rsa -C "Github 邮箱"

在这里插入图片描述
进入 [C:\Users\用户名.ssh] 目录(要勾选显示“隐藏的项目”),用记事本打开公钥 id_rsa.pub 文件并复制里面的内容。
在这里插入图片描述
在这里插入图片描述
登陆 GitHub ,进入 Settings 页面,选择左边栏的 SSH and GPG keys,点击 New SSH key。
在这里插入图片描述
在这里插入图片描述
Title 任意填写,将id_rsa.pub记事本中的内容复制到Key 中,点击 Add SSH key 完成添加
在这里插入图片描述
验证连接:
打开 Git Bash,输入 :

$ ssh -T git@github.com 

输入 yes- 回车
在这里插入图片描述
成功链接
在这里插入图片描述

6、安装 Hexo

使用 npm 一键安装 Hexo 博客程序:

$ npm install -g hexo-cli

问题1:npm安装报错npm ERR! :

在这里插入图片描述
解决办法:
参考链接:https://blog.csdn.net/m0_52309938/article/details/120689806

安装完成:
在这里插入图片描述
验证 Hexo 安装是否成功:

$ hexo -v

在这里插入图片描述
初始化:

问题2:hexo init初始化报错:FATAL ~not empty

在这里插入图片描述
解决办法:
参考链接:
https://blog.csdn.net/f2315895270/article/details/91355552
https://blog.csdn.net/Colincoin/article/details/102594799
利用命令行创建我们即将使用的 hexo 博客的目录文件夹,里面将存放关于 hexo 博客的各种配置文件、源码、文档、主题等。(如果在安装 hexo 中出现任何问题,可以删除此目录文件夹,重新执行之前的步骤即可)。执行如下操作后,可在自己创建的目录下看到 hexoblog 文件夹。

$ pwd
$ cd d:
$ mkdir hexoblog
$ cd hexoblog

pwd:查看当前所在路径

在这里插入图片描述

问题2.1 hexo init初始化报错:WARN Failed to install dependencies.

在这里插入图片描述
解决方法:
按照它的要求,运行npm install

$ hexo init

在这里插入图片描述
启动本地服务器进行预览:

$ hexo g  //生成页面
$ hexo s  //启动预览

在这里插入图片描述
复制网址到浏览器打开
在这里插入图片描述
本地博客安装成功

5.、部署 Hexo 到 GitHub Pages

将hexo上传到 gitHub 进行部署,使其能够在网络上访问
安装 hexo-deployer-git:

$ npm install hexo-deployer-git --save

在这里插入图片描述
然后去创建的hexoblog录下找到文件_config.yml
在这里插入图片描述
修改文件末尾的 Deployment 部分,修改如下:

#Deployment
##Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repository: git@github.com:用户名/用户名.github.io.git
branch: master

在这里插入图片描述

完成上述步骤之后保存修改,使用如下命令:

$ hexo clean

在这里插入图片描述

$ hexo g

在这里插入图片描述

$ hexo d  //将网站上传部署到 GitHub Pages。

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
就能将我们本地的内容推送到远程 GitHub 仓库了,然后在浏览器中访问:

https://用户名.github.io/
在这里插入图片描述
搭建完成

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值