Hexo的那些事儿

什么是 Hexo

hexo 是一款基于 Node.js 的静态博客框架, hexo github 链接

本文地址：http://tigerliu.site/2017/06/Hexo-github/

Hexo 准备工作

未安装 node.js、git 的同学请戳这里Node 本地环境搭建

Hexo 环境搭建

利用 npm 命令或者 cnpm(淘宝镜像)即可安装

npm install -g hexo 或者 cnpm install -g hexo

初始化 hexo,在你喜爱的文件夹下新建 hexo 目录（如 D:\hexo），执行以下指令(在 D:\hexo 内点击鼠标右键，选择 Git bash),Hexo 即会自动在目标文件夹建立网站所需要的所有文件

hexo init

安装依赖包(hexo-server 初始化默认不带 server)

npm install --save hexo-server
npm  install

现在我们已经搭建起本地的 hexo 博客了，执行以下命令(在 D:\hexo)，然后到浏览器输入 localhost:4000 看看

hexo generate
hexo server

好了，至此，本地博客已经搭建起来了，只是本地哦，别人看不到的。下面，我们要部署到 Github

github 创建

• 注册账号https://github.com/

输入账号、邮箱、密码,然后点击注册按钮.

• 创建页面仓库

仓库的名字需要和你的账号对应，格式: yourname.github.io
输入基本信息，然后点击创建仓库.

命名规则：你的 github 账号.github.io，这里一定要注意，博主就被坑了。

• 获取仓库地址
  打开刚才的仓库，可以看到页面上 Clone or download 按钮，点击获取 SSH 链接地址，若为 HTTPS，点击 use SSH 就可以了，复制链接地址。如图：
  

Hexo 基本配置

• 目录结构

├── .deploy #需要部署的文件
├── node_modules #Hexo 插件
├── public #生成的静态网页文件
├── scaffolds #模板
├── source #博客正文和其他源文件，404、favicon、CNAME 都应该放在这里
| ├── _drafts #草稿
| └── _posts #文章
├── themes #主题
├── _config.yml #全局配置文件
└── package.json

• _config.yml 全局配置文件修改
  拉到文件底部 修改配置，填写刚刚复制的 git SSH 链接地址

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@github.com:yourname/yourname.github.io.git
  branch: master

配置文件的冒号“:”后面有一个空格 repo: 刚刚 github 创库地址.git

• 查看 package.json

项目根目录找到 package.json 查看 dependencies 属性内是否包含 hexo-deployer-git

包含直接运行：

npm install

不包含：

npm install hexo-deployer-git --save

至此环境配置就 OK 了

hexo 与 github 关联

hexo 默认是使用 git 来提交的，故 git 也需要简单的配置。

• 修改提交的用户名、邮箱
  Windows 下打开 Git Bash，输入以下命令，回车

$ git config  --global user.name 你的目标用户名；
$ git config  --global user.email 你的目标邮箱名;

• SSH Key 配置
  继续在 Git Bash 中输入命令，创建 SSH Key，按提示输入密码，可以不填密码一路回车

$ ssh-keygen -t rsa -C "注册邮箱"

获取 key，打开.ssh 下的 id_rsa.pub 文件，里面的内容就是 key 的内容，ctrl+a 全部拷贝

$ start ~/.ssh/id_rsa.pub

登录 GitHub，打开”SSH Keys”页面，快捷地址：https://github.com/settings/ssh,添加 SSH key 值，如图：

测试 ssh key 是否成功，使用命令“ssh -T git@github.com”，如果出现 You’ve successfully
authenticated, but GitHub does not provide shell
access。这就表示已成功连上 github
PS: 关于更多 git 资料请移步拜读 GIT 操作

• hexo 部署
  运行 hexo clean ,hexo d -g 部署到 github

hexo clean
hexo d -g

以下提示说明部署成功

[info] Deploy done: git

刷新 github 就可以看到代码已经更新到 github
输入http://yourname.github.io (github 仓库–》Settings–》GitHub Pages 下面的链接就是) 就可以查看效果

Hexo 命令使用

• 常用命令：

hexo help #查看帮助
hexo init #初始化一个目录
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成网页，可以在 public 目录查看整个网站的文件
hexo server #本地预览，'Ctrl+C'关闭
hexo deploy #部署.deploy目录
hexo clean #清除缓存，**强烈建议每次执行命令前先清理缓存，每次部署前先删除 .deploy 文件夹**

• 简写：

hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

• 新建文章

hexo new "标题"

在 _posts 目录下会生成文件标题.md

title: Hello World
date: 2015-07-30 07:56:29 #发表日期，一般不改动
categories: hexo #文章文类
tags: [hexo,github] #文章标签，多于一项时用这种格式
---
正文，使用Markdown语法书写

编辑完后保存，hexo server，浏览器输入 localhost:4000 预览

Hexo 主题

https://hexo.io/themes/
https://github.com/hexojs/hexo/wiki/Themes

赏

×

纯属好玩

扫码打赏，你说多少就多少

打开支付宝扫一扫，即可进行扫码打赏哦