Hexo搭建教程

作者:Xie 日期:2021/08/11 分类:技术分享

目录
  1. 在Github创建仓库
  2. 安装所需软件并连接GitHub
  3. 连接GitHub
  4. 创建 SSH
  5. 安装Hexo
  6. 初始化博客:
  7. 本地预览
  8. 部署到GitHub
  9. Hexo命令

在Github创建仓库

登录GitHub,
点击GitHub中的右上角的 + 创建新仓库(new repository),仓库名应该为:yourname.github.io
这里的yourname使用你的GitHub帐号名称代替,这是固定写法,文章接下来出现的yourname皆为你的GitHub账号名称

安装所需软件并连接GitHub

  1. 安装Git

    Git是一个开源的分布式版本控制系统,可以有效、高速地处理从很小到非常大的项目版本管理。Git 是 Linus Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。
    在官网下载安装,安装时一路继续就好了。
    安装完成后在命令行内输入 git 查看是否成功。
    若提示 “‘git’是内部或外部命令,也不是可运行的程序或批处理文件。” 就说明失败了。

  2. 安装Node.js

    Hexo基于Node.js,Node在官网下载安装包,注意安装Node.js会包含环境变量及npm的安装。
    安装后检测Node.js和npm是否安装成功,在命令行中分别输入 (显示版本号即安装成功)

    node -v 
    npm -v

连接GitHub

成功安装后在桌面右键点击 Git Bash Here
设置user.name和user.email配置信息,

在弹出界面中输入以下内容

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

创建 SSH

输入以下内容

ssh-keygen -t rsa -C "你的GitHub注册邮箱"

直接三个回车即可,即不设置密码
C:\Users\Username.ssh 路径下找到名为 id_rsa.pub 的文件,就是你刚刚创建的密钥,右键用记事本打开然后复制全部内容
然后进入GitHub添加密钥
将复制的内容粘贴至Key中,title随便填然后点击 Add SSH key

在Git Bash中检测GitHub公钥设置是否成功
bash中输入下面这一行内容

ssh -T git@github.com

当出现
“Hi,yourname! You’ve successfully……”
则已经成功。

这里之所以设置GitHub密钥原因是,通过非对称加密的公钥与私钥来完成加密,公钥放置在GitHub上,私钥放置在自己的电脑里。GitHub要求每次推送代码都是合法用户,所以每次推送都需要输入账号密码验证推送用户是否是合法用户,为了 省去每次输入密码的步骤 ,采用了ssh,当你推送的时候,git就会匹配你的私钥跟GitHub上面的公钥是否是配对的,若是匹配就认为你是合法用户,则允许推送。这样可以保证每次的推送都是正确合法的。

安装Hexo

Hexo就是我们的个人博客网站的框架,我们需要在电脑里创建一个文件夹(称之为博客根目录),用来存放Hexo的相关文件以及博客文章,文件夹名字随意(建议不要出现中文),我文件夹名字为 Hexo-Blog 。创建好后,进入文件夹中,右键进入 Git Bash Here
(注意,之后有关操作都需要在博客根目录进入 Git Bash Here )
输入以下内容

npm install -g hexo-cli

初始化博客:

输入以下内容

hexo init

文件夹中大致如下

  1. node_modules 是 node.js 各种库的目录,
  2. public 是生成的网页文件目录(一开始可能没有)
  3. scaffolds 里面就三个文件,存储着新文章和新页面的初始设置
  4. source 是我们最常用到的一个目录,里面存放着文章、各类页面、图像等文件
  5. themes 存放着主题文件
  6. _config.yml 站点配置文件

本地预览

按顺序输入以下两条命令:

hexo generate
hexo server

部署到GitHub

我们需要将hexo和GitHub关联起来,也就是将hexo生成的文章部署到GitHub上,
打开站点配置文件 _config.yml(博客根目录中),
划到最后,将deploy中的内容修改成下面的样子(yourname改成你GitHub的用户名)

deploy:
type: git
repository: https://github.com/yourname/yourname.github.io.git
branch: master
(repository冒号后面只有一个空格哦)

然后我们还需要安装部署所需插件 deploy-git
在bash中输入

npm install hexo-deployer-git --save

然后按顺序输入以下三条命令

hexo clean
hexo generate
hexo deploy

全部完成后,恭喜,你的博客已经搭建完成,当然,只是一个雏形。

Hexo命令

下面会介绍常用的Hexo命令(若有 ==> 则右边为简写)

1. npm install hexo -g #安装Hexo
2. npm update hexo -g #升级
3. hexo init #初始化博客
4. hexo new "mypost" ==> hexo n "mypost" #新建文章(在 /source/_posts 文件夹中创建 mypost.md 文件)
5. hexo generate ==> hexo g #生成页面(页面在public文件夹中)
6. hexo server ==> hexo s #本地预览
7. hexo deploy ==> hexo d #部署
8. hexo clean #清除缓存
9. hexo server #Hexo会监视文件变动并自动更新,无须重启服务器
10. hexo server -s #静态模式
11. hexo server -p 5000 #更改端口
12. hexo server -i 192.168.1.1 #自定义 IP

配置修改后需hexo g重新生成界面, hexo s本地预览过程中若对某些配置文件(好像主题配置文件可以)修改,可直接刷新本地预览页面,按Ctrl+C可停止本地预览

命令之间可用 && 相连接
hexo g && hexo shexo g && hexo d 等等
当然 对于上面两种常用的命令,hexo提供了简写 hexo s -g (生成界面并本地预览) 和hexo g -d (生成界面并部署)

对博客修改之后只有进行了部署才会发布到网上

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注