Hexo是什么
Hexo是一款基于Node.js的快速,简单并且强大的静态博客框架,可以用Markdown写博客然后Hexo会在几秒钟之内生成漂亮的静态网页。生成后的静态网页可以直接部署到到Github Pages上。本文将介绍mac下的具体搭建方法。
如何安装
安装需求
安装Hexo非常简单。只需要先安装下面两个软件
安装Git
$ brew install git
安装Node.js最好的方法是用nvm,nvm全称Node Version Manager,之所以需要这个工具是因为Node.js的各种特性没有稳定下来,可以使用它切换版本
$ curl https://raw.github.com/creationix/nvm/master/install.sh | sh
nvm安装完成之后就可以安装Node.js了
$ nvm install 0.12
接着安装Hexo
$ npm install -g hexo-cli
安装Hexo
安装Hexo只需要一条命
$ npm install hexo-cli -g
配置
接下来需要新建一个文件夹来存放博客内容,这里我创建在~/blog 目录下
然后把路径切换至这个目录下面
$ hexo init ~/blog
$ npm install
配置好了之后,文件夹内容如下所示
.
├── _config.yml
├── package.json
├── scaffolds
├── scripts
├── source
| ├── _drafts
| └── _posts
└── themes
安装常用插件
npm install hexo-generator-index --save #索引
npm install hexo-generator-archive --save #归档
npm install hexo-generator-category --save #分类
npm install hexo-generator-tag --save #标签
npm install hexo-server --save #本地服务器
npm install hexo-deployer-git --save #git部署
npm install hexo-generator-feed@1 --save #生成rss
npm install hexo-generator-sitemap@1 --save#生成站点地图
写文章
使用下面命令写文章
$ hexo new [layout] <title>
Hexo提供了三种布局:post,page和draft,默认值为:post。例如写一篇名为“Hexo简介”的文章,命令为
$ hexo new "Hexo简介"
命令执行后文章文件被保存到source/_posts下,名为“Hexo简介.md”为md格式文件,打开即可编辑文章的内容。打开内容入下
title: Hello World
date: 2013/7/13 20:46:25
tag:
---
可编辑tag的值,并且添加categories等字段,例如
title: Hello World
date: 2013/7/13 20:46:25
categories:
- 随笔
tags:
- Python
- 算法
comments: false #不显示评论
执行下面命令,打开http://0.0.0.0:4000,本地查看效果
$ hexo server #简写命令 hexo s
如果无法正常打开,请关闭各种代理或fq软件
部署到Github上
生成Github Pages
- 登陆到Github
- 在主页右上角创建New repository,Repository name必须为用户名yourname,github.io,比如我的用户名为geekzph,因此应设置为geekzph.github.io
- 选为public,点击Create
- 在打开的页面右侧点Settigs,之后点Launch automatic page generator,这样Github Pages就已经生成了
发布博客到Github上
打开博客目录下的站点配置文件_config.yml,添加以下字段,注意冒号后面都得有空格,否则会出错,yourname为自己的Github账户名字
deploy:
type: git
repository: https://github.com/yourname/yourname.github.io.git
branch: master
生成静态网页
$ hexo generate #简写命令 hexo g
执行下面命令部署
$ hexo deploy #简写命令 hexo d
输入Github的用户名和密码。
这时候就可以打开Github查看效果了。
注意:执行 hexo server 等命令时需要先到博客所在目录才可以。mac下如出现编译错误需要从App Store安装Xcode。安装之后打开Xcode, Preferences -> Download -> Command Line Tools -> Install 来安装命令行工具,或者使用命令 $ xcode–select –install。