Hexo+Github/Coding免费搭建个人博客网站

时间:2024-05-19 20:34:38

体验更优排版请移步原文: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 -vnpm -v输出当前版本号说明node环境搭建完成。

Hexo+Github/Coding免费搭建个人博客网站

1.2 git安装和准备

在Git官网 https://git-scm.com/downloads (如未*下载过慢可参考地址)下载对应安装文件,保持默认设置一路next也没毛病,这里一点提醒,Git出于安全考虑,只能在Git Bash中进行Git有关的命令操作,如果想要在命令提示符中使用Git命令,在安装过程中调整PATH环境一步需勾选第二项,这样Git安装程序会在系统PATH中设置Git路径,以便于我们在命令提示符中直接使用Git命令(尽管可以这样设置,但还是建议都在Git Bash中输入命令)。

Hexo+Github/Coding免费搭建个人博客网站

打开命令提示符,输入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 你就可以访问自己的博客主页了。

Hexo+Github/Coding免费搭建个人博客网站

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处保存,设置完毕。

Hexo+Github/Coding免费搭建个人博客网站

测试配置是否成功:

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
2
git config --global user.name "username" // github用户名,不是昵称
git config --global user.email "xxx@qq.com" // 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
2
hexo init // hexo初始化
hexo g // 生成网站源文件

生成之后的目录结构应该是这样的,

Hexo+Github/Coding免费搭建个人博客网站

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
2
hexo clean // clean删除public文件夹
hexo s -g // 生成网站源文件并启动测试服务(合并命令)

刷新 http://localhost:4000 是不是发现高端大气上档次了一些!至于头像、title、菜单等的配置,仔细读一下官方文档,研究一下配置文件(主要有两个_config.yml,一个在博客根目录下,另一个在themes下对应的主题文件夹下),相信这些都难不倒你。

3.2.2 Deployment配置

这个很关键,因为博客搭建好了,你不可能让它一直在本地运行,需要把它托管到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

3.2.3 Hexo部署到Git

1
2
hexo clean
hexo d -g // 生成网站源文件并部署到Git(合并命令)

Hexo+Github/Coding免费搭建个人博客网站

现在到浏览器里访问一下 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博客绑定域名及域名解析相关,找个时间会补充上来,不过正常情况域名这种小事应该难不倒作为码农的我们,博主这里有些精品域名可供大家选择,都来逛逛!——大传送门(•‿•)