软件安装

  • 安装Node.js
  • 安装git

检查安装结果

同时按下Win和R，打开运行窗口，输入cmd，回车运行。

输入

1
2
3
node -v
npm -v
git --version

如果返回版本号则说明安装成功，如果没有返回版本号，则需要重新安装或排查原因。

安装git时，可以同下图一样，选择Use Git from the Windows Command Prompt。

这个选项可使cmd也可以调用git，而不需要在git bash中才能对git进行相关操作。

配置github

如果已经拥有github账号，直接跳过

创建代码库

Repository name 填写your name.github.io。

注意，your name 需要是注册账号名，填写其他则无法生效。

开启gh-pages功能

点击界面右侧的Settings，，向下拖动，找到见GitHub Pages，点击Automatic page generator。

配置hexo

在自己认为合适的地方创建一个文件夹，然后在文件夹空白处按住Shift+鼠标右键，然后点击在此处打开命令行窗口。（同样要记住啦，下文中会使用在当前目录打开命令行来代指上述的操作）

在命令行中输入：

1
npm install hexo-cli -g

安装成功时可能会出现WARN，可以直接忽略，不影响使用。

在命令行中输入：

1
npm install hexo --save

完成后再命令行输入

1
hexo -v

如果返回版本号，则说明安装成功。

初始化hexo

在命令行输入：

1
2
hexo init
npm install

编译运行hexo

1
2
hexo g
hexo s

完成以上命令后会出现：

1
INFO  Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

在浏览器输入http://localhost:4000/即可看见编译完成的页面。

如果对于页面格式和其他功能没有要求，到这一步hexo就算配置就算完成了。

使用git发布到github

打开网站配置文件_config.yml，找到Deployment，按照如下修改：

1
2
3
4
deploy:
  type: git
  repo: git@github.com:yourname/yourname.github.io.git
  branch: master

保存后，运行命令行，输入：

1
2
git config --global user.name "yourname"
git config --global user.email "youremail"

最后发布本地hexo到github

1
hexo d

完成后打开浏览器，输入your name.github.io，检测上传结果。

添加文章及页面

  • 方法一

在命令行输入 ：

1
hexo new post your-post-name

完成后在hexo/source/_post中找到同名字的md文档，打开即可修改。

打开文档会看到类似如下的yml信息，可自行进行修改。

1
2
3
4
5
6
---
title: hello-world   //在此处添加你的标题。
date: 2014-11-7 08:55:29   //在此处输入你编辑这篇文章的时间。
categories: test   //在此处输入这篇文章的分类。
tag: test  //在此处输入这篇文章的标签。
---

正文在此信息下方写入，格式可参照Markdown的语法。

完成后保存，并在命令行输入：

1
2
3
hexo clean
hexo g
hexo d

即可编译发布。

  • 方法二
    直接在source/_post目录中创建md文档，打开进行编辑。

此处注意要保证创建的文档所使用的编码是UTF-8，否则可能会出现乱码的情况。

编辑完成后在命令行输入：

1
2
3
hexo clean
hexo g
hexo d

即可编译发布。

DIY hexo

修改全局配置文件

配置文件详细说明可参照Hexo官方文档

其他待续