利用Hexo、GitHub pages从零开始创建个人博客

从搭建到成功以及本文的诞生,前后花了两天时间,真是一把辛酸泪,感觉还是挺费事的,中途一度想放弃,可还是咬牙坚持下来了,但看到结果后感觉一切的辛苦都是值得的。过程中一定要有耐心,毕竟需要用到的东西挺多的,比如:node.js、git、 github、hexo其中的知识。废话不多说了,详情如下:

一、系统环境配置:

要想利用Hexo、GitHub搭建个人博客,首先要安装Node.js、git:

1、Node.js安装:

下载Node.js

或者通过如下命令安装:
  brew install node  #最新版的node.js的包中已经集成了npm包管理工具 
通过如下命令查看是否安装成功:
node -v    
npm -v
2、Git安装及配置:

下载Git

或者通过如下命令安装:
brew install git          #Mac电脑使用brew安装    
sudo apt-get install git  #Ubuntu系统使用这条命令安装

配置详见另外一篇博客: git安装与配置

3、Hexo安装:
$ npm install hexo -g  #-g表示全局安装, npm默认为当前项目安装
如遇错误,请使用一下安装:
$ npm install hexo --no-optional
验证是否成功安装:
$ hexo -v

目前我用到的环境如下 ,出现类似如下环境说明hexo安装成功

hexo-cli: 1.0.2
os: Darwin 16.4.0 darwin x64
http_parser: 2.7.0
node: 6.10.0
v8: 5.1.281.93
uv: 1.9.1
zlib: 1.2.8
ares: 1.10.1-DEV
icu: 58.2
modules: 48
openssl: 1.0.2k

创建博客的根目录并切换到更目录下:
$ mkdir myblog
$ cd myblog
初始化myblog文件夹使其成为Hexo博客:
$ hexo init
自动根据当前目录下文件,生成静态网页:
$ hexo generate  
运行本地服务:
$ hexo server         
有必要提下Hexo常用的几个命令:
$ hexo new "postName" #新建文章
$ hexo new page "pageName" #新建页面
$ hexo generate (或者hexo g) 生成静态文件,会在当前目录下生成一个新的叫做public的文件夹
$ hexo server (或者hexo s) 启动本地web服务,用于博客的预览
$ hexo deploy (或者hexo d) 部署播客到远端(比如github, coding等平台)
      
常用简写:
$ hexo n == hexo new
$ hexo g == hexo generate
$ hexo s == hexo server
$ hexo d == hexo deploy      
常用组合:
$ hexo d -g #生成部署
$ hexo s -g #生成预览       

通过hexo g生成静态文件和hexo s启动本地web服务后,现在我们打开http://localhost:4000/ 就可以看到一篇内置的blog了。看到后是不是感觉很有成就感?反正我是这么认为的。

二、Hexo主题设置

默认的主题是landscape,这里以主题yilia为例进行说明。Hexo中文官网:下载主题、配置详解

安装主题
$ hexo clean
$ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia   
修改主题
修改myblog目录下的_config.yml配置文件中的theme属性,将其设置为yilia。 
并按照主题说明进行相关的配置,这点很重要,否则修改后的主题样式会有变化   
例如:git clone https://github.com/GeekaholicLin/hexo-theme-ylion.git这个主题
就需要在_config.yml配置文件添加如下内容:
### search插件基于 https://github.com/PaicHyperionDev/hexo-generator-search
### 使用说明请参考该repo
search:
  path: search.xml
  field: all
更新主题
$ hexo g # 生成
$ hexo s # 启动本地web服务器

三、GitHub Pages配置

1、注册、登录GitHub

github官网:https://github.com/

你值得拥有
你值得拥有

2、创建项目仓库

注册并登陆Github官网成功后,点击页面右上角的+,选择New repository。


你值得拥有
3、填写项目名

在Repository name中填写:Github账号名.github.io 必须这样填,否则会出错 例如我的账号为:allen,那么就必须填allen.github.io

你值得拥有

4、设置GitHub pages

打开settings,有一个Github Pages 的设置,点击 source 中的本来的 None ,使其变成 master 分支,也就是作为部署github pages 的分支,然后点击 save。


你值得拥有
5、查看网址

页面刷新之后,再看 github pages 设置框处,多了一行网址,就是你的 github pages 的网址了,点击进去就进入属于你自己的博客网址了。


你值得拥有

四、部署到GitHub pages

1、修改_config.yml

千万要注意冒号:后边要留有空格

基本设置

# Site
title: allen #标题
subtitle: welcome to allen blog #副标题
description:        #描述
author: John Doe         #作者
language: zh-CN #语言
timezone:        #时区

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://suxianglun.github.io  #用于绑定域名, 其他的不需要配置,即为GitHub pages生成的那个网址
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:


# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: hexo-theme-landfarz   #主题设置

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:   #部署, 发布在 GitHub 上面
  type: git
  repo: git@github.com:suxianglun/suxianglun.github.io.git #GitHub 项目仓库
  branch: master
2、部署到GitHub 上
$ hexo clean #清除
$ hexo g #生成
$ hexo d #部署 # 可与hexo g合并为 hexo d -g

$ hexo d 之后如果出现ERROR Deployer not found: Git,请键入如下命令

$ npm install hexo-deployer-git --save 

部署之后去查看GitHub pages那个网址http://suxianglun.github.io,有可能会出现:
Your site is having problems building: unable to build page. Please try again later. 或者
Your page is having problems building: page build failed
同时也会收到github发来的page build failure的邮件,但是邮件中显示的错误信息和settings页面上的一样, 就这句话, 什么都没有, 没有任何错误提示.我就卡在这一天,后来用了好长时间来解决了。我分析的主要原因如下:
1、Hexo未进行构建html,即未执行hexo g,这个过程需要一段时间,构建好html后myblog根目录下完整目录应该如下:

README.md   db.json     package.json    scaffolds   themes
_config.yml node_modules    public      source

2、Hexo 配置不正确,请严格按照要求进行配置

另外说一下我的个人博客地址 https://suxianglun.github.io/ 欢迎来骚扰。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,445评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,889评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,047评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,760评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,745评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,638评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,011评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,669评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,923评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,655评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,740评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,406评论 4 320
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,995评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,961评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,023评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,483评论 2 342

推荐阅读更多精彩内容