现在市面上的博客有许多,比如:博客园、简书、掘金等。虽然使用很人性化,发表内容也很方便,但终归不是自己的平台,经常会受限制。基于此,决定建立自己的博客。经过多方尝试,决定使用Hexo + Github Pages的方式,而这一切都是免费的。下面就带大家一起来搭建自己的博客。
Hexo 简介
Hexo 是一个快速、简洁且高效的静态博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
只需要通过Markdown语法(Markdown快速上手教程[Markdown基础教程]),就可以写好自己的博客内容,然后通过简单的几个步骤就能够将生成的博客网页上传到 Github,大家就可以通过Github网址访问博客内容了。
安装部署
安装 Hexo 相当简单,只需要先安装下列应用程序即可:
在 Github官网 上申请注册一个Github账户,并记住账户名
和邮箱
。
Github的账户名建议不要太复杂,但是又要能体现博客特点,方便别人访问并记住自己的博客。
新建public仓库
在Github的 Repository 页面建立一个public类型的个人仓库,仓库名称必须以**用户名.github.io
**作为仓库名。
重要的事情说三遍:
public 类型的 用户名.github.io 名称的Github仓库
public 类型的 用户名.github.io 名称的Github仓库
public 类型的 用户名.github.io 名称的Github仓库
从Git官网上下载安装Git工具。
Window:下载并安装
Linux(Debian,Ubuntu):
sudo apt-get install git-core
Linux(Fedora、RedHat、CentOS):
sudo yum install git-core
我们已Windows系统为例。
安装成功后,将 Git 与 GitHub 账号绑定,右键打开 Git Bash,然后设置配置信息:
# 配置用户名和邮箱
git config --global user.name "github 用户名"
git config --global user.email "github 注册邮箱"
接着生成 ssh 密钥文件,输入如下命令后直接三次回车即可,一般不需要设置密码:
# 生成 ssh 密钥
ssh-keygen -t ed25519 -C "github 注册邮箱"
执行上述命令之后,一般在系统盘的当前用户目录下的.ssh目录下
生成 id_rsa
和 id_rsa.pub
两个文件,前者是我们私有的,而后者则是对外开放的。
然后打开 GitHub –> Settings –> SSH and GPG keys 页面,创建一个新的 SSH key,填写 Title
和 Key
,Title
可以随意,而 Key
的内容则是我们刚才复制的 id_rsa.pub
中的内容,最后点击 Add SSH key
即可。
Node.js 为大多数平台提供了官方的 安装程序。对于中国大陆地区用户,可以前往 淘宝 Node.js 镜像 下载。
- Windows:官网下载 或使用 nvs(推荐)、 nvm 安装。
- Mac:官网下载 或使用 Homebrew 、 MacPorts 安装。
- Linux(DEB/RPM-based):从 NodeSource 安装。
- 其它:使用相应的软件包管理器进行安装,可以参考由 Node.js 提供的 指导。
Windows 用户
使用 Node.js 官方安装程序时,请确保勾选 Add to PATH 选项(默认已勾选)
安装完成后,可以通过以下命令检查是否安装成功:
node -v
npm -v
由于下载包是从国外服务器,所以速度较慢,因此我们推荐用阿里的国内镜像进行设置:
npm config set registry https://registry.npm.taobao.org
1、安装hexo-cli
hexo-cli是hexo的命令行工具,后续工作的很多操作都会用到此工具。
npm i hexo-cli -g
2、初始化
在指定目录新建自己的博客目录(此目录要保证持久稳定),然后切换到此目录。用如下命令进行初始化并安装必备组件:
hexo init .
npm install
初始化后,目录结构如下:
.
├── _config.yml # 网站配置信息
├── package.json # 应用程序信息
├── scaffolds # 模板文件夹
├── source # 用户资源
| ├── _drafts #
| └── _posts #
└── themes # 主题文件夹
3、启动
输入如下命令,建立博客名,生成静态网页,启动本地服务器。
# 新建博客名称
hexo new "博客名"
# 生成静态网页
hexo g
# 启动本地服务器
hexo s
在浏览器中打开:http://localhost:4000
即可打开Hexo博客主页。
更多的Hexo操作及知识,请参考:Hexo中文文档
4、安装Hexo的Git插件
在博客目录下,安装 hexo-deployer-git 插件,这是Hexo与Github交互的插件。
npm install hexo-deployer-git --save
5、配置博客repo
在博客根目录中的修改站点配置文件 _config.yml
:
deploy:
type: git
repo: https://github.com/账户名/账户名.github.io
6、部署到Github
完成上述步骤之后,使用如下命令,就能将博客本地的内容推送到远程 GitHub 仓库了。
hexo clean # 清除之前的内容
hexo g # 重新生成静态文件
hexo d # 上传到github
7、访问Github博客
在浏览器中访问:
https://用户名.github.io
比如我的博客网址: