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