Hexo是时下比较流行的博客框架,有比较丰富的主题和插件支持。Github为用户提供了GitHub Pages,空间免费稳定,用来搭建一个博客是非常合适的。
下面介绍一下如何使用GitHub+Hexo搭建一个属于自己的博客。
安装Node.js
搭建Node.js运行环境。安装Node.js。
安装Git
搭建Git环境。安装Git。
安装Hexo
Node环境搭好后,就可以用npm安装Hexo了。
$ npm install -g hexo-cli // 全局安装hexo-cli
$ hexo init my-blog // 创建一个hexo框架
$ cd my-blog // 进入目录
$ npm install // 安装依赖包
$ hexo generate // 生成静态文件(结果文件)
$ hexo server // 启动本地服务,可以通过http://localhost:4000/ 访问
其中,新建的框架目录如下
|—— _config.yml // 网站的配置信息
|—— package.json // 项目包信息
|—— scaffolds // 模板文件夹,Hexo根据scaffold中的模板来新建文件
|—— source // 存放用户资源的地方
| |—— _drafts // 存放草稿
| |—— _posts // 存放文章
|—— themes // 主题文件夹
在使用框架时,会常用到以下几个命令:
$ hexo generate // 简写:hexo g,生成静态文件,会在当前目录下生成一个public文件夹
$ hexo server // 简写:hexo s,启动本地服务,用于博客的预览
$ hexo deploy // 简写:hexo d,部署到远程(如GitHub,可以在_config.yml中配置)
$ hexo new post-name // 简写:hexo n post-name, 新建文章
$ hexo new page page-name //简写:hexo n page page-name,新建页面
还有常用的组合命令:
$ hexo d -g // 生成和部署
$ hexo s -g // 生成和预览
草稿命令:
$ hexo new draft <title> // 新建草稿,存放在source/_drafts
$ hexo publish post <title> // 发布草稿为文章,文章转移到source/_posts
$ hexo s -g --drafts // 显示草稿
设置Hexo主题
$ hexo clean
$ git clone https://github.com/LouisBarranqueiro/hexo-theme-tranquilpeak.git themes/tranquilpeak
然后修改Hexo目录下的_config.yml
配置文件中的theme属性,将其设置为transquilpeak。
重新启动服务,就可以看到最新的主题了。
有的主题在GitHub上不是最终的主题文件夹,需要经过编译生成。具体的以主题项目中的说明为准。
这里举例的tranquilpeak主题就是需要下载一个zip包来获得。
部署到GitHub Pages
前面有说过,GitHub Pages用于介绍托管在GitHub的项目的,每个帐号只能创建一个repository来存放GitHub Pages,而且仓库名称必须是username/username.github.io,这是固定的命名约定。
创建后,可以通过http://username.github.io来访问个人主页。
GitHub Pages中个人主页的内容是在master分支下的。
部署Hexo到GitHub Pages指的就是将hexo -g
生成的静态文件推送到GitHub Pages对应的仓库中。
Hexo提供了hexo-deployer-git工具,可以帮助部署Hexo到很多平台。
$ npm install hexo-deployer-git --save
修改_config.yml中的配置:
deploy:
type: git
repo: https://github.com/yanyinhong/yanyinhong.github.io.git
branch: master
然后执行命令:
$ hexo d