Hexo+Github 搭建个人博客

Hexo 介绍

Hexo 是一个快速、简洁且高效的博客框架. Hexo 使用 Markdown 解析文章, 在几秒内, 即可利用靓丽的主题生成静态网页.

本地搭建

安装 Hexo 非常简单, 只需几分钟就能安装完成

安装前提

安装之前请确保已经有下列程序:

  • Node.js
  • Git

Mac 用户可以使用 brew 安装:

安装 Node.js

brew install node

安装 Git

brew install git

安装 Hexo

执行下列命令安装

npm install -g hexo-cli

安装成功后执行下列命令新建本地博客存放文件夹

hexo init myBlog
cd myBlog
npm install

完成之后运行 hexo s 命令, 在浏览器输入 http://localhost:4000 就可以看到博客了.

目前的博客系统只是搭建在本地上, 别人是无法查看的. 那怎么样才能让别人也能看到我们的博客呢? 很简单, 把它部署到 GitHub Pages 上.

部署到 GitHub Pages

在 GitHub 上创建仓库

打开 GitHub, 还没有账号就先注册一个. 登录账号后找到左上角的 + 点击 New repository 创建一个新仓库, 在 Repository name 下填入 你的用户名.github.io 其他的保持默认即可, 点击 Create repository 完成.

配置 SSH key

获取 SSH Key

cat ~/.ssh/id_rsa.pub

如果之前没有配置 SSH Key, 先执行下列命令配置本地 git 账户

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

生成密钥 SSH key

ssh-keygen -t rsa -C '邮箱地址'

完成后输入 cat ~/.ssh/id_rsa.pub 获取 SSH Key.

获取之后在 Github 上添加 SSH Key, 步骤如下:

Settings -> SSH and GPG keys -> New SSH keys -> 输入 Title 粘贴 Key -> Add SSH keys

开始部署

修改 _config.yml 文件

deploy:
  type: git
  repo: 
        github: git@github.com:[你的用户名]/[你的用户名].github.io.git,master

安装部署插件 hexo-deployer-git

npm install hexo-deployer-git --save

执行下列命令就可以部署上传到 Github 了

hexo g -d

现在只要在浏览器访问: 你的用户名.github.io 任何人都能看到你的博客了.

写作

新建文章

执行下列命令来创建一篇新文章

hexo new "文章名称" 
# 或者 
hexo n "文章名称"

文章文件保存在 /source/_posts 中, 可以用支持 MarkDown 的编辑器比如 Typora 编写文章. 具体的 MarkDown 语法可以参考我的另一篇文章 MarkDown 语法

当然你要是乐意, 也可以用 vim 等纯文本编辑器 (逃

发表文章

执行下列命令就可以在 http://localhost:4000 上看到文章了

hexo g
hexo s

最后, 执行下列命令部署在 Github 上

hexo clean && hexo g -d

在浏览器打开 你的用户名.github.io 就能看到刚刚编写的新文章了.


本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 ,转载请注明出处!