github + hexo 搭建个人网站详细过程.
本文针对的主要是Windows用户,不过总体步骤和Linux/Mac大同小异。
- 本文中所有需要打开文件编辑的地方均不推荐记事本,推荐使用nodepad++或sublime text。
环境配置
安装git bash
直接在官网下载最新版本并安装;
申请github账号
在github填写信息注册账号;
- 方便起见,以下均假设你的github用户名为 XXX.
- 方便起见,以下均假设你的github邮箱为 aa@bb.com
建立github仓库
- 建立一个仓库来存博客的源码,假设标题为“blog”;
- 建立一个github仓库,标题是
XXX.github.io
;
安装Node.js
- 安装Node.js:直接在Node.js官网下载最新版本并安装;
安装hexo
- 在git bash中执行如下命令以安装hexo(必须在安装Node.js之后进行);
1 | npm install -g hexo |
- 执行以下语句以安装hexo所需的依赖包;
1
npm install
搭建博客
本地搭建
- 任意建一个名为“hexo”文件夹,并在该文件夹下运行git bash(右键菜单中选择运行git bash);
- git bash中执行如下命令,hexo会自动将搭建所需的所有初始材料放入hexo文件夹中;
1 | hexo init |
- 在git bash中运行如下命令,即可将博客的静态页面生成在
\hexo\public
目录下;
1 | hexo generate #(或简写为 hexo g) |
- generate完毕后即可运行如下指令,成功后即可在
localhost:4000
浏览博客;1
hexo server #(或简写为 hexo s)
部署到github
- 修改hexo文件夹中的
_config.yml
文件:
1 | deploy: |
保存后即可将本地博客与XXX.github.io
建立关联;
- 本地浏览确认无误后运行如下命令即可将博客部署到
XXX.github.io
;
1 | hexo deploy #(或简写为 hexo d) |
- 部署完毕后即可在
XXX.github.io
浏览页面。
可能出现的问题及解决办法
1 | 在执行 hexo d 时,可能会出现提示: |
1 | 在执行 hexo s 时,可能会出现提示: |
博客源码备份
git配置
初次使用git,需要进行如下配置:
全局配置
在git bash中依次执行如下语句以完成全局配置:
1 | git config --global user.name XXX |
配置ssh-key
- 在git bash中执行以下语句:
1 | ssh-keygen -t rsa -C "your_email@example.com" #(在github注册的邮箱) |
- 添加key到ssh: 将
C:/Users/xxxx/.ssh/github_rsa.pub
中的全文复制,添加到github。 (浏览器登录github,找到settings -> SSH and GPG keys -> new SSH key
粘贴进去确认即可)
至此,你的github账户已经和你的电脑建立了关联。 有关SSH的更详尽步骤可以参考这里,本文不再细化。
git仓库更新
- 在hexo目录下运行git bash;
- 运行如下命令即可将该文件夹初始化为git仓库;
1 | git init |
- 运行如下命令,将本地仓库至连接远程仓库(blog);
1 | git remote add origin git@github.com:XXX/blog |
- 依次运行如下命令,即可将源码更新至github的blog仓库,至此备份已经完成。
1 | git add . |
每次写新文章之后,都可以按照相同方式将源码再次更新一遍。 更多git操作可以查阅相关文档(例如这里),本文不再赘述。
后续操作
主题的选择
hexo默认的主题是landscape,样子比较难看,网络上有各种其他样式的主题:
- litten:yilia,一个简洁优雅的hexo主题.
- forsigner:fexo,一个极简主义风格的hexo主题.
- iissnan:next,An elegant theme for Hexo.
- MOxFIVE:yelee,简而不减Hexo双栏博客主题.
例如你想用的主题是yilia,那么需要先执行如下操作:
1 | git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia |
然后将hexo目录中的_config.yml
文件修改为theme: yilia
,再重新部署一次即可使用yilia主题。
在使用各种主题时,可以按照自己的需要修改主题中的_config.yml
文件。 修改主题的各项操作均可在该主题的说明文档中查阅,本文不再赘述。
撰写新文章
- 运行如下命令,在
hexo\source\_posts
文件夹中就会出现一个名为AAA.md
的文件;
1 | hexo new "AAA" |
- 按照markdown语法编辑该文件并保存;
- 依次运行如下命令即可完成部署。
1 | hexo g |
关于markdown语法以及编辑器可自行查阅相关资料,本文不再赘述。
将博客绑定在自己的域名上
方便起见,假定域名为www.domain.com
。 绑定域名步骤如下:
- 进入仓库
github.com/XXX/XXX.github.io
,进入settings页面,在custom domain一项中填写www.domain.com
(也可以在hexo
目录下直接新建一个名为CNAME的文件,内容为www.domain.com
,然后更新博客源码即可); - 然后在域名的设置页面设置解析为
lzcwr.github.io
即可。 具体解析步骤可在自己购买域名后查看,本文不再赘述。
hexo的常用命令
1 | hexo new "postName" # 新建文章 |
总结
以上谈到的步骤按照顺序大概是:
- 安装所需要的软件:git bash,Node.js,hexo;
- 申请github账号并新建仓库储存源码和博客页面;
- 本地配置好git:全局配置(用户名和邮箱),和SSH-key配置;
- 本地搭建博客:
hexo init
,hexo g
,hexo s
预览; - 将博客部署至github:修改
_config.yml
中的deploy
部分,执行hexo g
,hexo d
; - 可能会出现无法部署至git的问题:安装
git-deployer
; - 撰写新文章:
hexo new "postName"
,hexo g
,hexo d
; - 更新源码:git操作(
add
,commit
,push
)。
## 可能遇到的其他问题