Hexo + GitHub搭建个人博客

Posted on

Hexo + GitHub 搭建个人博客

Hexo是一个快速、简洁且高效的博客框架，而Github是一个免费的代码托管工具，利用Github Pages可以免费创建一个静态网站。下面将介绍如何使用Hexo和Github，在win10环境下搭建一个个人博客。

安装和配置Hexo及GitHub

注意：安装Hexo前，需要安装Node.js和Git。

安装好以上程序后，打开Git Bash或者cmd,这里采用Git Bash。

安装Hexo

以管理员身份运行Git Bash,输入

1
npm install -g hexo-cli

即可完成Hexo的安装。

使用Hexo进行本地建站

选择一个本地的文件夹（建议不要放在系统盘），如D:\SoftwareFiles\hexo，在Git Bash 命令行输入以下代码

1
cd D:\SoftwareFiles\\hexo
1
hexo init
1
npm install

即可完成Hexo的初始化，并安装成功npm。此时，在D:\SoftwareFiles\hexo文件夹下可看到初始化后的_config.yml，package.json,source,themes等文件目录。

为了测试本地建站是否成功，输入

1
hexo s

如果显示

1
INFO Hexo is running at http://0.0.0.0:4000/.

，则说明成功，可自行访问http://0.0.0.0:4000/查看网页效果。

将网站发布到GitHub的同名repository中

注意：此操作在已有GitHub账号前提下进行。并请自行配置SSH和新建repository（MyGitHub.github.io)。

在D:\SoftwareFiles\hexo下输入

1
npm install hexo-deployer-git --save

此时，可以看到在D:\SoftwareFiles\hexo下出现.deploy_git。

打开D:\SoftwareFiles\hexo文件夹中的_config.yml文件，找到

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

注： (1) 其中MyGitHub替换成你的Github账户用户名; (2) 注意在yml文件中，:后面都是要带空格的

此时，可以访问http://MyGitHub.github.io查看你的博客页面。
若无法访问，通过以下命令更新GitHub网页。

1
hexo g -d

注意：若无法git，则运行

1
npm install hexo-deployer-git --save

Hexo配置及发表文章

站点配置

在D:\SoftwareFiles\hexo文件夹中找到_config.yml文件，找到以下部分内容，并修改成自己的内容。

# Site
title: 网站标题
subtitle: 网站子标题（座佑铭）
description: 网站描述
author:  网站作者，也就是您的名字
language: 网站使用的语言        
timezone: 网站时区，Hexo 预设使用您电脑的时区。

分页配置

在D:\SoftwareFiles\hexo文件夹中找到_config.yml文件，找到以下部分内容，并修改成自己的内容。

# Pagination
per_page: 10   # 每页显示的文章量，如果设置值为0，则表示禁止分页
pagination_dir: page

主题配置

由于个人喜好，这里选择简洁的next主题。

下载next主题

在D:\SoftwareFiles\hexo下输入

1
git clone https://github.com/iissnan/hexo-theme-next themes/next

完成下载。

修改网站的主题为next

打开D:\SoftwareFiles\hexo下的_config.yml文件，找到以下内容，将theme修改为next。

# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: next

本地验证是否可用

输入

1
hexo s --debug

访问本地网站，确认网站主题是否切换为Next。

更新github

输入

1
hexo g -d

发表新文章

在D:\SoftwareFiles\hexo下输入

1
hexo n "name of the new post"

此时，在source文件夹下的_post文件夹下，可以看到新建的一个名为name of the new post.md的文件，打开该文件可以看到如下内容。

title: name of the new post
date: 2015-12-09 22:55:25
tags:
---

可以给文章贴上相应的tags，如有多个则按照如下格式

[tag1, tag2, tag3, ...]

在—下方添加正文内容即可，注意需要使用markdown语法进行书写，此处使用markdownpad2编辑。

文章撰写完成后保存，在Git Bash下打开D:\SoftwareFiles\hexo，输入

1
hexo g -d

即可生成新网站，并且同步Github上的网站内容。