安装与配置

1,右击选择Git Bash,然后输入初始化 Hexo 博客,git 就会自动帮你下载 hexo 框架

1
$ hexo init hexo

2,这个时候就会自动新建一个名为 hexo 的文件夹,并且 hexo 已经在该文件夹内完成初始化

3,hexo 的基本命令如下:

1
2
3
4
5
6
7
8
$ hexo clean #清除生成的博客静态文件
$ hexo g #生成博客静态文件=命令hexo generate
$ hexo s #启动博客的本地预览=命令hexo server
$ hexo d #推送博客到远程仓库=命令hexo deploy
$ hexo new page xxx #新建名为"xxx"的页面
$ hexo new xxx #新建名为"xxx"的文章
$ hexo d -g #生成静态博客并推送到Git远程仓库
$ hexo s -g #生成静态博客并启动本地预览

4,直接输入(注意:不能在原来那个窗口输入,需要进入到 hexo 文件夹中打开 git bash 窗口输入),在执行 hexo g 的时候就会给我们生成一个 public 文件夹,这个文件夹就是我们之后部署到 Github 或者 Coding 等平台的文件

1
2
$ npm install ##需要安装 hexo 必须的依赖
$ hexo clean && hexo g && hexo s

5,执行完之后,在浏览器输入:localhost:4000,就会显示如下:

6,下载主题,随便选一种下载:

Next 主题:

1
2
$ git clone -b dev https://github.com/iissnan/hexo-theme-next themes/next
$ npm i hexo-renderer-swig ##hexo在5.0之后把swig给删除了需要自己手动安装

或者 butterfly 主题:

1
2
$ git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
$ npm install hexo-renderer-pug hexo-renderer-stylus --save ##需要下载pug 以及 stylus 的渲染器

7,然后打开 hexo 目录下的**_config.yml**配置文件,找到第 101 行将 theme 参数修改为你所应用的主题,我这里使用 next 主题,修改之后保存。

在 YAML 语法中,冒号后面必须要有一个空格。

1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next ##landscape

8,再次执行,并在浏览器输入:localhost:4000,就可以发现和之前不一样了

1
$ hexo clean &&  hexo g && hexo s

9,接下来就可以写文章了,在命令行输入,就会在 hexo/source/_posts/目录下生成.md 文件,在打开该文件就可以进行编写文章了

1
$ hexo new  "文件名" ##创建文章

10,编写文章,然后重新执行启动命令,打开网页

部署

1,如果没有账号,请点此前往 GitHub 注册一个 GitHub 账号。

2,新建一个公开仓库,仓库名格式为 your_username.github.io 例如你的 GitHub 用户名是 Jrebes ,那么你的仓库地址名称就应该是 Jrebes.github.io

3,复制该仓库的 HTTPS/SSH 地址,一般格式为 https://github.com/your_username/your_reponame.git 在下一步会用到。

4,分别输入如下命令:

1
2
3
$ git config --global user.name "username" # username是你的Github用户名,注意大小写保持一致
$ git config --global user.email "your email address" # your email address填写你的Github注册用的邮箱
$ ssh-keygen -t rsa -C "your email address" # 生成SSH公钥,your email address同上填

5,完成上面步骤后默认生成的密钥在 C:\Users\用户名.ssh\ 目录下,以文本编辑器打开 id_rsa.pub 文件,复制里面的所有内容,在 Github 中配置

6,打开 Git Bash,输入下面命令,检查是否可以与 github 连接

1
$ ssh -T git@github.com

7,打开 hexo 目录下的_config.yml 文件,修改最后一行的 deploy 配置信息:

1
2
3
4
5
deploy:
type: git
repo:
github: https://github.com/username/username.github.io.git # Git仓库地址,username是Github用户名
branch: master # 部署到仓库的master(主)分支

8,执行命令,第一次 push 的时候需要你输入你的 Github 的用户名和密码

1
2
$ npm install hexo-deployer-git --save ##安装hexo-deployer-git插件
$ hexo clean && hexo g && hexo d

9,本来是需要自动去开启 Github Page 服务的,若没有则去 GitHub 中设置(在 setting 的 Options 中找到 Github Pages),好像最近更新之后就默认自动开启,所以在浏览器输入你的博客网站就可以了,博客网站如下:


1
https://username.github.io/  ##username是Github用户名