摘要:这是一篇有关如何使用Github Pages和Hexo搭建自己独立博客的详尽教程,里面介绍了如何使用和配置Hexo框架,如何将Hexo部署到自己的Github项目中,域名注册,以及域名的绑定,还有我在搭建自己博客过程中所遇到的各种困难。
首先欢迎各位来参观我的博客:集邮狗
(5)将本地的 Hexo 文件同步到 Github 的仓库中:
(1)下载和安装 Git:
Git 下载:在 Windows 平台下载安装 Git,点击下载 Git
Git 安装:直接一路next,直到安装完成
Git 是否安装成功:在 cmd 命令窗口中输入 Git –-version 查看 Git 版本
Git 配置:设置自己的 Git 用户名和邮箱:
$ git config --global user.name "你的用户名"
$ git config --global user.email "你的邮箱"
我的例子:
$ git config --global user.name "betterest8830"
$ git config --global user.email "15701588830@163.com"
(2)安装 Node.js:
Node.js 下载安装:官网下载 , 下载后,基本上都是点击下一步完成安装
Node.js 是否安装完成,在 cmd 命令窗口中输入 node -v 查看 Node 版本
(3)安装 Hexo:
Hexo 安装:新建目标文件夹Hexo (我的目录:C:\SoftWare\Hexo),在 hexo 文件夹里,单击右键选择 Git Bash Here,
输入以下命令安装 Hexo : npm install hexo-cli -g;输入 hexo -v 查看是否安装成功
Hexo 配置:新建目标文件夹blog (我的目录:C:\SoftWare\blog),在 blog 文件夹里,单击右键选择 Git Bash Here
输入以下命令初始化 Hexo : hexo init;
输入以下命令会自动安装需要的组件:npm install
网页测试 Hexo ::
$ hexo generate
$ hexo server
在浏览器查看本地静态网页:http://localhost:4000/
(4)github账户的注册和配置:
准备一个 Github 账号,没有的就去官网注册一个账号,创建一个仓库 repository,用来托管博客。仓库名为:项目名.github.io
例如:我创建的仓库名为 test_blog.github.io,然后在setting中任选一个theme,设置自己的博客主题样式。
下面 将Git和Github关联起来,在 github 设置中添加 SSH:
在 github 上添加 SSH key 的步骤:参考文档
(5)将本地的 Hexo 文件同步到 Github 的仓库中:
修改 blog 文件目录的 _config.yml 配置文件上保存:
deploy:
type: git
repo: https://github.com/betterest8830/test_blog.github.io
branch: master
注意:配置文件键值之间必须有个空格
将博客部署上去: $ hexo g $ hexo d 或者直接输入 $ hexo g -d
浏览器查看: 输入 https://betterest8830.github.io/test_blog.github.io/ ,就可以看到自己的博客了
注意:在执行 hexo deploy 后,出现 error deployer not found:git 的错误处理
输入代码:npm install hexo-deployer-git --save
(6)配置博客以及主题:
安装主题:git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia
使用主题:打开_config.yml做如下修改: theme: yilia
更新主题:进入C:\SoftWare\blog\themes\yilia,右键打开Git Bush,执行 git pull
测试推送: 回到C:\SoftWare\blog,执行: hexo generate , hexo server, 打开localhost:4000预览,就可以看到新的主题了
然后hexo deploy 推送到github.io,利用之前的 https://betterest8830.github.io/test_blog.github.io/ 就可以看到博客新主题(可能过一阵子会更新),
如果不能成功:尝试$ hexo clean $ hexo g -d
注意:出现如下问题,按照提示步骤解决。
缺失模块。1、请确保node版本大于6.2。。。
(7)Hexo 系列之 _config.yml 配置文件:
博客根目录下_config.yml 文件配置:目录(C:\SoftWare\blog)
参考资料 :参考文档
yilia 主题下的 _config.yml 文件配置:目录(C:\SoftWare\blog\themes\yilia)
参考资料:参考文档
(8)绑定域名:
在腾讯云上购买了一个域名:jiyougou.xyz
腾讯云注册域名修改 DNS 参考资料:参考文档
在test_blog.github.io的setting中有个Custom domain填上自己的域名,我的域名为jiyougou.xyz
防止域名失效:在source目录下增加CNAME文件填写域名jiyougou.xyz,再执行 hexo g&d后 登陆github就不会出现github上的CNEMA文件消失
(9)发布文章:
hexo new "第一篇文章",修改C:\SoftWare\blog\source\_posts中的文件内容,然后 hexo g; hexo d;就表示发布出去了。
hexo new draft "a" :我们会在source下看见一个新的文件夹,_drafts,这个里面会装我们所有的草稿文件。
hexo server --draft :可以预览草稿文件
hexo publish b :发布草稿
hexo new page c :和前两种不同,这个命令会在source文件夹内创建出c文件夹,与_posts,_drafts并列。文件夹里面有一个index.md文件
因为c不是一个blog page,所以它也不会出现在blog列表中,而是要通过URL去access
(10)markdown的使用:
下载markdown2编写markdown文档,然后上传到发布的文章中
markdown2参考资料:参考文档