By

文章目录

一. 准备相关工具

1.注册一个github账号 (用户名关系到仓库名和网址)；
github注册
2.安装node.js；
3.安装git(git终端执行命令行方便快捷)；

二. 创建github仓库

仓库格式为 （用户名.github.io）,比如说你的用户名为：zhangsan,那么仓库名为：zhangsan.github.io,将来的网站地址： https://zhangsan.github.io ，刚刚创建的仓库有默认的实例页面，以后你的网站所有代码都是放在这个库仓里了。

注:
A. 注册的邮箱一定要验证，否则不会成功；
B. 仓库创建成功不会立即生效，需要过一段时间；
C. 每一个github账户最多只能创建一个这样可以直接使用域名访问的仓库。

三. 绑定域名

域名绑定增加博客格调，可以现在绑定，也可以搭建好博客后绑定，或者使用默认的（用户名.github.io）访问是一样的。绑定域名国内的阿里云挺不错了，价格也不贵第一年基本便宜，续费贵点，如果博客使用很长时间，那么多买几年划算。这块我就不多说了，详细参考域名绑定吧。

这篇域名绑定不错：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
  网址：http://www.jianshu.com/p/cea41e5c9b2a?open_source=weibo_search
   注：现在的域名要实名认证，通过大概要两周时间。
四. 配置SSH KEY
配置SSH密钥，原因在于提交代码肯定要拥有github权限才行，直接使用用户名和密码不安全，因此我们使用SSH KEY来解决本地和服务器的连接问题。
温馨提示: 所有命令操作都是在git终端（安装了git，鼠标右键，git bash here）进行，切换到hexo目录下
``` bash
$ cd ~/. ssh   #检查本机已存在的ssh密钥
提示：No such file or directory 说明你是第一次使用git。
$ ssh-keygen -t rsa -C "邮件地址"
然后连续3次回车，最终会生成一个文件在用户目录下，打开用户目录，找到.ssh\id_rsa.pub文件，
记事本打开并复制里面的内容，打开你的github主页，进入个人设置 -> SSH and GPG keys -> New SSH key：
将刚复制的内容粘贴到key那里，title随便填，保存。
在git终端测试：
$ ssh -T git@github.com # 注意邮箱地址不用改
提示: Are you sure you want to continue connecting (yes/no)?，输入yes。
SSH KEY配置成功会看到：
    Hi zhangsan! You've successfully authenticated, but GitHub does not provide shell access.
继续在终端输入:
$ git config --global user.name "zhangsan"// 你的github用户名，非昵称
$ git config --global user.email  "xxx@qq.com"// 填写你的github注册邮箱
配置完成。

五. 配置与使用hexo
到这了，说明你已经翻越了很多高山和跳过隐藏大坑了，继续加油吧！点击ReadMore

  1. hexo简介

Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具，支持Markdown格式，有众多优秀插件和主题。
——进入hexo官网了解更多
——进入github查看hexo

  1. hexo作用

由于github pages存放的都是静态文件，博客存放的不只是文章内容，还有文章列表、分类、标签、翻页等动态内容，假如每次写完一篇文章都要手动更新博文目录和相关 链接信息，相信谁都会疯掉，所以hexo所做的就是将这些md文件都放在本地，每次写完文章后调用写好的命令来批量完成相关页面的生成，然后再将有改动的 页面提交到github。

  1. 安装hexo3.x(gir终端命令行)
1
$ npm install -g hexo
  1. 初始化
    新建文件夹HexoDemo(比如D:\weblog\HexoDemo)用于存放页面代码。
1
2
$ cd /f/Workspaces/hexo/
$ hexo init

hexo会自动下载一些文件到这个目录，包括node_modules文件夹

1
2
$ hexo g # 生成
$ hexo s # 启动服务，开启本地预览服务，打开浏览器访问 http://localhost:4000 即可看到内容

执行以上命令之后，hexo就会在public文件夹生成相关html文件，这些文件将来都是要提交到github

接下来看看你搭建的博客框架吧！第一次初始化的时候hexo已经帮我们写了一篇名为 Hello World 的文章，主题样子不怎么好看是吧？

4.6 修改主题

官方主题
这里使用一个hexo-theme-yilia主题讲解:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
$ cd /d/weblog/HexoDemo  #进入hexo根目录
$ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia #x下载主题
``` 
下载后的主题在/d/weblog/HexoDemo/themes下yilia
修改_config.yml中的theme: landscape改为theme: yilia，然后重新执行hexo g和hexo d来重新生成和发布。
如果出现一些莫名其妙的问题，可以先执行hexo clean来清理一下public的内容，然后再来重新生成和发布。
4.7 上传习惯养成
在上传代码到github之前，一定要记得先把你以前所有代码下载下来（虽然github有版本管理，但备份一下总是好的），因为从hexo提交代码时会把你以前的所有代码都删掉。
4.8 上传到github
注: 修改配置时，冒号后面空一格，不然配置不会生效，本人踩过的大坑
配置_config.yml中有关deploy的部分:
``` bash
deploy:
 type: git
 repository: git@github.com:username/username.io.git   (注意更换user)
 branch: master

安装一个插件：

1
npm install hexo-deployer-git

接着输入hexo d将本次代码改动提交，以后每次改动后，先hexo s，到本地预览效果，再hexo d提交到github服务器，更好的实现自己需要的效果。

注意：通过本文的发表，经常会遇到修改配置后没效果的现象，确定配置没错，那么试试hexo clean 清理public文件

六. hexo常用命令
hexo new “postName” #新建文章，生成的md文件位于hexo目录下source_posts

hexo new page “pageName” #新建页面,标签形式存在

hexo generate = hexo g #生成静态页面至public目录

hexo server = hexo s #开启预览访问端口（默认端口4000，’ctrl + c’关闭server）

hexo deploy = hexo d #部署到GitHub

hexo help # 查看帮助

hexo version #查看Hexo的版本

组合命令:
hexo s -g #生成并本地预览
hexo d -g #生成并上传

七. 写博客
到我们的hexo根目录，执行命令：

1
hexo new 'my-first-blog'   #hexo会在_posts下生成相关md文件：

打开md文件就可以开始写博客,这里就是博客正文
当然你也可以直接自己新建md文件，用这个命令的好处是帮我们自动生成了时间。

八. 博客效果

访问我的git博客来查看效果： https://jiangsir12356.github.io/

哈哈！这是我的第一篇博客还没买域名，不过用来记录个人学习足够。

"奔跑心情"

文章目录