因为图片占用 Github 太多空间,现在已经放弃 GithubPage 了,但是还是把以前的搭建过程记录一下,说不定哪天又要用到了。
一、环境和工具
1.1 安装 Git:
- 下载地址:Git官网
- 安装教程:Mac 上安装GIT
- Git 入门:Pro Git(中文版)
1.2 安装 Node.js
- 下载地址:Nodejs官网
- 安装教程: 一路 Next 即可,默认会安装 nodejs 和 npm 于 /usr/local/bin/ 目录下,由于该目录默认已经添加到 PATH 环境变量,所以安装完成之后可以直接使用
node -v
命令查看是否安装成功
nodejs_install_result
1.3 安装Hexo
-
什么是Hexo: Hexo官方文档。Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
-
安装教程:使用下面的命令来下载和安装 Hexo
npm install hexo-cli -g //或者 npm install hexo -g --no-optional
这里 -g 代表全局安装,这样 hexo 包将放在 /usr/local/lib/node_modules (Windows 位于 ~/AppData/Roaming/npm/node_modules),不带的话是本地安装,将放在当前目录的 node_modules 下
我在 Mac OS X 上使用不带
--no-optional
方式安装会出现DTraceProviderBindings MODULE_NOT_FOUND
的错误,加上可以解决,应该是缺少某些 module,具体不是很清楚。
CLI = Command Line Interface 命令行界面。我的理解是:hexo-cli 是 hexo 的命令行模式,类似于 Git Bash 和 Git 的关系
1.4 注册github账号
这里我们就不多讲了,请进入 官网 进行注册
1.5 创建github pages
- 什么是github pages: 官方教程
- 创建 github pages 对应仓库:在github上创建一个名字为 your_github_name.github.io 的 repository
二、在本地创建博客
1. 初始化博客环境
第一次创建博客目录,首先创建一个文件夹作为博客根目录,然后进入该目录在这里执行
// 初始化hexo环境
hexo init
// 使用npm安装所需的组件
npm install
这样我们以后就可以在该目录里进行博客创作
2. 发表一篇新文章
我们可以使用下面命令来创建一篇新的文章,或者直接将文章放到 <blog_root>/source/_posts 目录里
hexo new "文章标题"
3. 生成博客静态网页
使用下面命令将 source 文件生成静态网页,生成的文件放在<blog_root>/public 目录下
hexo generate
4. 将网页发布到server端
hexo server
最后我们就可以通过浏览器访问服务器网页。这里我们还没配置server信息,所以server其实还是本机(http://localhost:4000)
三、部署到github pages
接下来我们开始 commit to github,这样才可以在github.io上看到我们的博客。这个很简单,首先在全局配置文件 _config.yml 里的 deploy 部分进行配置,其中 repo为你的github pages对应的仓库地址(yourname.github.io ):
deploy:
type: git
repo: git@github.com:i-am-zhaozekai/i-am-zhaozekai.github.io.git
branch: master
配置完成之后执行
hexo deploy
这样 hexo 就会把 public 目录上传到你的 github.io,大家就可以通过你的github pages 看到你的博客了
- 执行deploy命令的时候可能会出现
deployer not found:git
的错误信息,此时可以先执行npm install hexo-deployer-git --save
- 貌似从hexo提交代码时会把你以前的代码删掉,所以上传之前最好先备份一下
四、配置主题
Hexo 默认使用的主题是 landscape ,我们可以到官网 Hexo themes 上查看各种主题效果,或者看这里的一些介绍 知乎:有哪些好看的 Hexo 主题。挑选一个自己喜欢的然后配置使用。我个人比较喜欢 BlueLake 这个主题。
1. 下载主题
您可以直接到 BlueLake发布页 下载,然后解压拷贝到 themes 目录下,修改配置即可。不过推荐使用 git 来 checkout 代码,之后也可以通过 git pull 来快速更新。
在博客根目录下执行
git clone https://github.com/chaooo/hexo-theme-BlueLake.git themes/BlueLake
2. 启用主题
在_config.yml 下修改 themes 节点值为 BlueLake 即可
3. 其他配置
关于该主题的其他配置项,有一些是属于 BlueLake 特有的,例如该主题需要安装 jade和stylus 主题渲染包,详细的请参考 BlueLake 作者博客
网友评论