体验更优排版请移步原文:http://blog.kwin.wang/other/hexo-github-build-blog.html
很早之前就想搭建一个属于自己的博客网站,一方面是给自己做笔记,把平时遇到的问题和解决问题的方式方法记录下来,顺便提升自己的表达能力、总结能力;另一方面,个人博客就像是自己在网络世界中的一个小家,一个完全属于自己的空间,你可以在这里尽情发挥,别人可以通过它来了解你。前段时间偶然间发现了Hexo,看了两天官方文档,参考网上教程,搭建了自己的个人网站:http://vblog.win/ 欢迎访问!搭建完毕在此记录一下搭建过程。
1. 环境准备
1.1 node.js安装和准备
在node.js官网 http://nodejs.cn/download/ 下载对应安装文件,保持默认设置,一路next,安装结束。
打开命令提示符,输入node -v
,npm -v
输出当前版本号说明node环境搭建完成。
1.2 git安装和准备
在Git官网 https://git-scm.com/downloads (如未*下载过慢可参考地址)下载对应安装文件,保持默认设置一路next也没毛病,这里一点提醒,Git出于安全考虑,只能在Git Bash
中进行Git有关的命令操作,如果想要在命令提示符中使用Git命令,在安装过程中调整PATH环境一步需勾选第二项,这样Git安装程序会在系统PATH中设置Git路径,以便于我们在命令提示符中直接使用Git命令(尽管可以这样设置,但还是建议都在Git Bash中输入命令)。
打开命令提示符,输入git --version
输出当前版本号说明Git环境搭建完成。
2. Github账户配置
2.1 创建仓库
相信很多coder都有自己的GitHub账号(没有的话去注册一下),利用GitHub建立自己的博客首先需要创建一个username.github.io
的仓库,这里的username
必须是你的用户名(不是昵称),之后你的个人博客地址就是 http://username.github.io 了。
2.2 代码库设置
接下来,在新建立好的仓库主页点击菜单栏Settings,找到下方GitHub Pages开启该功能,选择一个主题并提交更改,几分钟后打开 http://username.github.io 你就可以访问自己的博客主页了。
2.3 配置SSH key
因为我们的博客内容托管于GitHub,因此提交代码需要提供权限给本地,这里使用SSH key相对来说要安全一些,输入命令:
1 |
ssh-keygen -t rsa -C "注册邮箱" |
之后会提示输入一个密码,这个密码在提交代码时使用,这里也可以直接回车,密码置空。最终会在用户目录下生成.ssh
文件夹,进入文件夹找到id_rsa.pub
文件并打开,复制内容并打开 https://github.com/settings/keys 新建SSH key,title自己命名,把刚刚复制的内容粘贴到key处保存,设置完毕。
测试配置是否成功:
1 |
ssh -T git@github.com |
Hi wangqingkai! You’ve successfully authenticated, but GitHub does not provide shell access.
看到如上信息则说明SSH key配置成功。
2.4 配置Git个人信息
1 |
git config --global user.name "username" // github用户名,不是昵称 |
3. Hexo安装与配置
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。还是推荐花时间看下官方文档:https://hexo.io/zh-cn/docs/
3.1 Hexo安装
新建一个用于存放个人博客源文件的文件夹,进入文件夹开始安装Hexo,由于npm下载一些包在国内会非常慢,这里推荐使用淘宝镜像,右击Git Bash
输入以下命令等待安装:
1 |
npm install -g cnpm --registry=https://registry.npm.taobao.org |
安装完成之后基本所有命令中的npm
都可以用cnpm
替代。输入命令:
1 |
cnpm install -g hexo |
Hexo安装完成之后紧接着开始初始化,输入命令:
1 |
hexo init // hexo初始化 |
生成之后的目录结构应该是这样的,
1 |
hexo s // 启动本地测试服务 |
服务启好之后浏览器打开 http://localhost:4000 ,如果可以正常访问,说明我们本地博客已经搭建起来了。Ctrl+C关闭测试服务。
3.2 Hexo配置
3.2.1 Hexo主题配置
因为默认主题达不到我们的要求,首先对Hexo主题进行配置,这里是Hexo官方主题。我们用比较受大众喜爱的yilia
主题为例,在博客根目录输入命令:
1 |
git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia |
之后修改博客根目录下_config.yml
文件中主题配置为:theme: yilia
。
1 |
hexo clean // clean删除public文件夹 |
刷新 http://localhost:4000 是不是发现高端大气上档次了一些!至于头像、title、菜单等的配置,仔细读一下官方文档,研究一下配置文件(主要有两个_config.yml
,一个在博客根目录下,另一个在themes下对应的主题文件夹下),相信这些都难不倒你。
3.2.2 Deployment配置
这个很关键,因为博客搭建好了,你不可能让它一直在本地运行,需要把它托管到GitHub或者Coding上,别人才可以访问,因此需要配置Deployment。全局配置文件_config.yml
中找到Deployment,配置如下代码:
1 |
deploy: |
我这里同时托管到GitHub和Coding,单独托管到GitHub也可以,把另外一条配置去掉就好。不过这样配置提交的时候一般会报错ERROR Deployer not found: git
,不要慌,安装一个插件即可:
1 |
cnpm install hexo-deployer-git --save |
3.2.3 Hexo部署到Git
1 |
hexo clean |
现在到浏览器里访问一下 http://vueker.github.io 惊不惊喜,意不意外!这里是我的测试博客,欢迎访问正式博客 http://vblog.win/ 查看效果,与我交流。
4. 如何写博客
4.1 使用命令创建博客
cd到博客根目录,输入命令:
1 |
hexo new 'hello-first-blog' |
这样,Hexo会帮我们在\source\_posts
下新建md文件,打开该文件即可使用Markdown语法开始写博客。
4.2 手动新建md文件
当然,我们也可以在\source\_posts
目录下新建md文件直接进行编辑,需要注意的是md文件的命名一般采用英文,文件内title名为中文即可。推荐作业部落在线编辑器。
5. 后记
Hexo + Github搭建静态博客的确很方便,上手也不难,而且静态博客访问速度快,易于维护,很重要的一点它是完全免费的。目前还可以采用很多第三方系统进行扩展服务,只要你想,几乎都可以做到。在此记录下自己搭建博客的点滴,希望可以和广大coder一起交流,共同进步,欢迎访问主页。关于Hexo博客绑定域名及域名解析相关,找个时间会补充上来,不过正常情况域名这种小事应该难不倒作为码农的我们,博主这里有些精品域名可供大家选择,都来逛逛!——大传送门(•‿•)