Github+Hexo搭建个人博客网站
Github
- 是一个面向开源及私有软件项目的托管平台,不需要一分钱就可以搭建自由的个人网站
- 绑定个人域名自由、方便、快捷
- 数据安全,可以回档各个历史版本
- 发布轻松,访问速度一般,网页没有广告
搭建环境
-
注册Github(https://github.com/)
-
成功安装node.js、npm(https://nodejs.org 已集成npm)
-
安装Git(https://git-scm.com/ 找到对应自己系统的版本下载并安装)
-
详细信息:
本文环境
- Windows 10 Pro x64
- node.js v8.9.3
- npm v5.5.1
- Git v2.17.0
- Hexo v3.5.0
搭建Github博客
创建仓库
在Github里新建名为用户名.github.io的仓库,例如用户名是Ender,库名就是Ender.github.io,将来访问网址就是http://ender.github.io(每人只能创建一个这样的仓库)
绑定个人域名(可直接跳过)
并非必须,用 用户名.github.io 访问也可以.
- 首先,注册一个域名。博主觉得国内的阿里云不错,价格便宜,优惠力度大,服务也好.
- 注册完域名之后添加解析,用cmd ping一下用户名.github.io获取到的ip添加到A记录的记录值,主机记录填写@。CNAME的记录值填写你的用户名.github.io,主机记录填写www。
- 最后在你的Github项目目录创建一个名为CNAME的文件,里面填写你的域名。原用户名.github.io会直接跳转到新域名。
配置SSH key
打开Git bash,执行
1 | cd ~/. ssh |
如果提示:No such file or directory 说明你第一次使用Git.
执行
1 | ssh-keygen -t rsa -C "你的邮箱地址" |
然后连按三次回车,打开你电脑上的用户目录,找到.ssh\id_rsa.pub并复制里面内容,打开Github个人设置-> SSH and GPG keys ->New SSH key,将之前文件的内容复制到里面,Title随便填。
测试
用Git bash执行(邮箱不用改)
1 | ssh -T git@github.com |
如果提示re you sure you want to continue connecting (yes/no)?,输入yes,然后返回
Hi 你的用户名! You’ve successfully authenticated, but GitHub does not provide shell access.
说明SSH配置成功。
然后执行
1 | git config --global user.name "用户名"// 你的github用户名,非昵称 |
Hexo
简介
- Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具,支持Markdown格式,有众多优秀插件和主题。
- 官网:http:hexo.io
- Github:https://github.com/hexojs/hexo
用前准备
- 安装
1 | npm install -g hexo |
- 初始化 在电脑某个地方新建一个文件夹,名字随便取,最好不要移动。
1 | cd /f/Workspaces/hexo/ |
然后hexo会自动下载文件到这个文件夹,目录结构如下:
- 生成初始界面,执行
1 | hexo g -s |
会开启本地预览服务,打开浏览器访问 http://localhost:4000
我们会看到默认的很丑的主题,以及一篇自动生成的Hello World文章。
修改主题
默认主题比较丑,我们先来安装一个好看的主题,博主推荐 NexT主题,官网:http://theme-next.iissnan.com/ 在官网你会获得很多使用方面的帮助。
执行
1 | $ cd your-hexo-site |
修改hexo主目录的_config.yml文件中的theme: landscape改为theme: next,然后重新执行
1 | hexo g |
来重新生成网页文件。
如果出现一些莫名其妙的问题,可以先执行
1 | hexo clean |
来清理一下public的内容,然后再来重新生成和发布。
上传
- 打开主目录的_config.yml文件,修改deploy部分:
1 | deploy: |
- 安装插件
1 | npm install hexo-deployer-git --save |
- 打开Git bash 执行hexo d就可以提交本次所有代码到Github了。
保留CNAME文件
由于hexo每次提交都会将原有代码删除(包括之前创建的用于解析的CNAME文件),所以我们为了保留解析,在主页面下source文件夹中创建CNAME文件(没有后缀),其中填写你的域名,这样我们每次提交都会保留CNAME文件,让解析能够正常运行。
常用命令
常见命令
1 | hexo new "postName" #新建文章 |
缩写
1 | hexo n hexo new |
组合命令
1 | hexo s -g #生成并本地预览 |
写博客
在hexo根目录下运行Git bash(在文件夹右键,选择Git Bash Here),执行
1 | hexo n "name" #名称内不要有空格、汉字 |
打开生成的文件
一般完整格式为
1 | --- |
让博客主页显示博文一部分
在合适地方加上
1 | <!--more--> |
在目录上就会在添加的位置截取,显示阅读全文按钮。