使用Hexo+github搭建个人博客

安装Hexo

安装node.js,安装git for windows。

所有必备的应用程序安装完成后,创建一个文件夹(用来存放所有blog的东西),然后在该文件夹下使用 npm 安装 Hexo。(所有命令建议使用git的终端来执行)

1
npm install -g hexo-cli

过程有点慢以为没反应失败,其实一直在安装,建议切换npm镜像

1
npm config set registry "https://registry.npm.taobao.org"

设置淘宝镜像源后,很快就安装完毕了。

安装 Hexo 完成后,请执行下列命令,Hexo 将会在该文件夹中新建所需要的文件。

1
2
hexo init 
npm install

到此,Hexo安装完成。

hexo常用命令

常见命令

1
2
3
4
5
6
7
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本

缩写:

1
2
3
4
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

组合命令:

1
2
hexo s -g #生成并本地预览
hexo d -g #生成并上传

Github Pages设置

什么是Github Pages

GitHub Pages 本用于介绍托管在GitHub的项目,不过,由于他的空间免费稳定,用来做搭建一个博客再好不过了。

每个帐号只能有一个仓库来存放个人主页,而且仓库的名字必须是yourgithubname.github.io,这是特殊的命名约定。你可以通过http://yourgithubname.github.io 来访问你的个人主页。

需要注意的个人主页的网站内容是在master分支下的。

创建Github Pages

在github创建了一个repo叫做 hombinwong.github.io. 创建完成之后,需要有一次提交(git commit)操作,然后就可以通过链接http://hombinwong.github.io/ 访问了。

Hexo搭桥到github

首先需要明白部署到github的原理。

  1. 之前在Github上创建的那个特别的仓库(hombinwong.github.io)一个最大的特点就是其master中的html静态文件,可以通过链接http://hombinwong.github.io来直接访问。
  2. Hexo -g 会生成一个静态网站(第一次会生成一个public目录),这个静态文件可以直接访问。
  3. 需要将hexo生成的静态网站,提交(git commit)到github上。

配置SHH Key

如果你之前已经配置好git个人信息,请跳过这一个步骤

设置Git的user name和email:(如果是第一次的话)

1
2
git config --global user.name "yourname"
git config --global user.email "your email"

生成密钥

1
ssh-keygen -t rsa -C "your email"

连续三个回车,生成密钥,最后得到了两个文件:id_rsa和id_rsa.pub(默认存储路径是:C:\Users\Administrator.ssh)。

打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key。将id_rsa.pub文件里的key粘贴到key那里,title随便填,保存。

配置Deployment

打开 站点配置文件_config.yml,找到deploy,然后按照如下修改:(PS:如果要配多个deploy,type前面加-)

1
2
3
4
deploy:
type: git
repo: git@github.com:yourname/yourname.github.io.git
branch: master

比如我的仓库的地址是hombinwong.github.io,所以配置如下:

1
2
3
4
5
deploy:
- type: git
repository: git@github.com:hombinwong/hombinwong.github.io.git
branch: master
- type: baidu_url_submitter ## 推送到百度搜索

安装部署到github的插件:

1
npm install hexo-deployer-git --save

执行命令(建议每次都按照如下步骤部署):

1
2
hexo g
hexo d

在浏览器中输入http://yourgithubname.github.io就可以看到你的个人博客。

绑定个人域名

当然,你不绑定域名肯定也是可以的,就用默认的 yourgithubname.github.io 来访问,如果你想更个性一点,想拥有一个属于自己的域名,那也是OK的。

首先注册一个域名,域名注册推荐去阿里云,本来想用.me域名,不过现在这些非主流的域名工信部还没有纳入备案的条件,如目前的.online,.xyz,.me等都不能备案。如果有需要可以绑定国外服务器,这样就不需要备案了,比如godaddy

绑定域名分2种情况:带www和不带www的。

域名配置最常见有2种方式,CNAME和A记录,CNAME填写域名,A记录填写IP,由于不带www方式只能采用A记录,所以必须先ping一下yourgithubname.github.io的IP,然后到你的域名DNS设置页,将A记录指向你ping出来的IP,将CNAME指向yourgithubname.github.io,这样可以保证无论是否添加www都可以访问,如下:

mark

然后到你的Hexo/source目录新建一个名为CNAME的文件(无后缀),里面填写你的域名,加不加www看你自己喜好,因为经测试:

另外说一句,在你绑定了新域名之后,原来的yourgithubname.github.io并没有失效,而是会自动跳转到你的新域名。

发表博客

写博客

定位到我们的hexo根目录,执行命令:

1
hexo new 'my-first-blog'

然后你就可以在source/_posts路径下看到生成的相关md文件。我们只需要打开这个文件就可以开始写博客了,默认生成如下内容:

mark

当然你也可以直接自己新建md文件,用这个命令的好处是帮我们自动生成了时间。

关于具体的文章编辑可以看下官网的介绍

让博文列表不显示全部内容

默认情况下,生成的博文目录会显示全部的文章内容,如何设置文章摘要的长度呢?

在合适的位置加上<!--more-->即可。例如:

mark

写博客工具

markdown语法参考markdown

markdown编辑器推荐一个极致简洁的:Typora

图床,推荐七牛+MPic-图床神器 组合。

参考

https://hexo.io/zh-cn/docs/index.html