hexo + github搭建个人博客

hexo + github搭建个人博客

准备：

• 安装node.js
• 安装hexo 链接
• 安装git，注册github 链接

前提：

• Node.js (Node.js 版本需不低于 8.10，建议使用 Node.js 10.0 及以上版本)
• 因为 Hexo 是基于 Node.js 的第三方模块，所以缺少 Node.js 不可。访问 Node.js官网下载适合自己系统的 Node.js 安装包。
• git：如果之后你需要安装一些 Hexo 的主题和插件，Git 是最好的下载方式。因为好多主题都被放在了 Github 上，你只需要敲几个字符就可以下载。
• Github 用来部署线上博客，（原因：没有服务器，域名）

一.本地创建hexo 博客（只在本地运行）

1.创建一个文件夹（存放博客代码），然后 git bash 打开安装hexo，

hexo的安装

npm install -g hexo

安装完毕，进行初始化（还是该目录）

初始化：
下载文件，可能会卡住，等等就好，没耐心的请用镜像

hexo init

此时 hexo 文件夹下出现了许多文件和文件夹。
接着：

npm install

hexo generate /** 生成一套静态网页 **/
hexo server /** 在服务器上运行 **/
简写：
hexo s
hexo g

输入完毕后，会提示你使用浏览器进入 http://localhost:4000/
如果没有页面，则可能是4000端口被占用，请更改端口，重新hexo s
修改端口：
1.可以在_config.yml内加上如下代码更改hexo-server运行时的端口号：

server:
  port: 4000  //想要修改的端口
  compress: true
  header: true

2.可以通过 hexo server -p 5000 命令来指定端口。

hexo new post "我的第一篇博文" /** 创建一个“我的第一篇博文”的md文件。 **/

这里就是提示你“我的第一篇博文”这个 md 文件创建在了 source/_posts/ 的文件下

你可以选择使用其它编辑器编辑这个 md 文件（Brackets、Dreamweaver等），或者直接在终端上编辑，最终要求保存为 UTF-8 的格式。

二、更改主题：

到主题商场选择主题，链接

方法：选择主题跳转到github上，复制 SSH或者HTTP，并且请进入到themes文件夹克隆：
例如：

git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

若出现问题，下载太慢，直接下载zip解压到themes也行。
landscape为默认的主题，yilia为你更改的主题

修改_config.yml中的theme: landscape改为theme: yilia，然后重新执行hexo g来重新生成。
接着 hexo s

三。github pages

1.创建 github 仓库，库名要与你的账号名一致username.github.io
https://github.com/username/username.github.io.git
设置中打开github pages

2.设置用户信息

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

git config --list 检验用户信息

.npm install hexo-deployer-git --save

3.配置_config.yml中有关deploy的部分

4.下载部署插件

5部署：hexo deploy

在上传代码到github之前，一定要记得先把你以前所有代码下载下来（虽然github有版本管理，但备份一下总是好的），因为从hexo提交代码时会把你以前的所有代码都删掉。

• ssh key肯定要配置好。

• 其次，配置_config.yml中有关deploy的部分：

正确写法：
：后有空格

deploy:
  type: git
  repository: git@github.com:liuxianan/liuxianan.github.io.git
  branch: master

错误写法：

deploy:
  type: github
  repository: https://github.com/liuxianan/liuxianan.github.io.git
  branch: master

后面一种写法是hexo2.x的写法，现在已经不行了，无论是哪种写法，此时直接执行hexo d的话一般会报如下错误：

Deployer not found: github 或者 Deployer not found: git

原因是还需要安装一个插件：

npm install hexo-deployer-git --save

总结：

一、本地博客创建：

• 安装hexo npm install -g hexo
• 初始化 hexo init
• npm install
• 生成静态文件 hexo g
• 在服务器上运行 hexo s
• 写博客 hexo new "file"

二、更改主题

• 选择主题
• 克隆 git clone ...
• 修改_config.yml中的theme
• 在服务器上运行 hexo s

三、github pages

• 创建github仓库
• 打开 GitHub pages用来当站点
• 设置用户信息 git config --global
• 下载上传插件 npm install hexo-deployer-git --save
• 配置_config.yml中有关deploy的部分
• 部署：hexo deploy

出现bug：

1.建立完本地博客，没有页面，则可能是4000端口被占用，请更改端口，重新hexo s
2 页面出现乱码，._config.yml 文件没有保存为utf-8 编码模式