hexo+github 博客搭建历程

详细的将自己搭建博客的过程记录了下,主要是出于两方面考虑:
第一,希望能够对同样打算建博客的朋友有所帮助。
第二,为自己写博客立起点,让自己养成写博客的习惯,将平日学到的进行总结,避免遗忘。

一. 准备工作

1)node.js 安装
下载地址:https://nodejs.org/en/download
2) git 安装
下载地址:https://git-scm.com/download
3) github注册并建立一个名为123.github.io的仓库,123为你的github账户名

二. git配置

该步骤主要目的:将git和github连接起来,便于今后博客的上传部署等操作。

2.1 设置账户和邮箱

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

2.2 生成并获取ssh秘钥

git bash 输入命令:

1
ssh-keygen -t rsa -C "***@gmail.com"

***@gmail.com为你注册github时的邮箱,接下来可能需要你输入windows账户的密码,取决于你的账户操作权限,输入密码后一直回车即可。

2.3 配置github ssh

将上一步生成的秘钥添加至github中,首先复制秘钥,id_rsa.pub文档中,位置如下供参考

1
C:Users元天墨染.sshid_rsa.pub

登录github账户,选择Personal settings > SSH and GPG keys,添加秘钥

2.4 验证链接

1
2
$ ssh -T [email protected]
Hi xxx! You've successfully authenticated, but GitHub does not provide shell access.

三. hexo安装配置

3.1 安装

首先建立一个hexo文档夹作为安装目录,git bash【在hexo文档夹也就是你的安装位置打开】
输入下列命令

1
2
3
4
5
6
npm install hexo-cli -g //安装hexo
hexo init blog //hexo初始化于blog文档夹
cd blog
npm install //安装相关依赖包
hexo server //本地启动hexo【用作博客发布前本地预览】
npm install hexo-deployer-git --save //使用git方式进行部署博客所需插件

3.2 配置

_config.yml 站点配置文档
package.json 主要描述hexo版本信息及安装的依赖
打开_config.yml文档找到deploy并参照下方进行修改

1
2
3
4
5
deploy:
type: git
//repo: 应为你的github仓库ssh clone,注意repo:后的空格不能省略
repo: [email protected]:zyz-1998/zyz-1998.github.io.git
branch: master

3.3 部署

hexo根目录blog打开git bash输入下列命令

1
hexo g -d

此时就可以在浏览器输入https://123.github.io/打开hexo默认接口。

四. hexo更换主题

访问hexo官网:https://hexo.io/zh-cn/ 在主题页面有许多主题,这里我选择的是miho
miho地址:https://blog.minhow.com/
里面有详细的操作流程,这里就不再赘述。

五. 常用命令总结

1
2
3
4
5
6
hexo new "我的博客" //新建文章,在blogsource_posts会生成对应的md文档
hexo new page "pageName" //新建页面,blogsource中生成相应的pageName文档夹
hexo g == hexo generate //生成静态网页
hexo s == hexo server //启动服务预览
hexo d == hexo deploy //开始部署
以上是文章摘要 <!--more--> 以下是余下全文 //设置文章摘要