利用GitHub零基础搭建免费Blog博客

效果

前言
其实平时自己写的文章并不多，偶尔看到一些东西会做点笔记，但是每次写的东西都会到处放，不好找，所以才想着自己搭建一个人博客网站，现在大家用hexo比较多，也比较方便

1. 安装Git Bash

我一直不太喜欢在cmd中操作各种命令，所以挑了这个比较好使的Git Bash, 我的是windows环境，所以下载windows版本并安装就可以了。

• 下载地址

• 安装步骤：双击下载好的exe文件，一路next就好啦

• 安装好后，打开gitbash，查看版本：

  • 命令：git version (写这篇博客的时候最新版本：2.17)
    
    image.png

• 然后你就可以在这里发挥你的聪明才智了

2. 安装NodeJs

Hexo是基于nodeJS环境的静态博客，里面的npm工具很有用啊，所以还是老老实实把这玩意儿装了吧

• 下载地址(说明：LTS为长期支持版，Current为当前最新版)
• 安装步骤：反正下载好msi文件后，双击打开安装，也是一路next，不过在Custom Setup这一步记得选 Add to PATH ,这样你就不用自己去配置电脑上环境变量了，装完在按 win + r 快捷键调出运行，然后输入cmd确定，在cmd中输入path可以看到你的node是否配置在里面（环境变量），没有的话你就自由发挥吧。
• 查看版本：
  • 命令：node -v

3. 安装hexo
   看到这么多安装，千万不要紧张，小哥哥小姐姐们一定要稳住，别怕，因为后面的东西都是在gitbash中用npm工具安装就好了。

• 先创建一个文件夹（用来存放所有blog的东西），然后cd到该文件夹下。
• 安装hexo命令：npm i -g hexo

• 安装完成后，查看版本

  
  
  
  

  ：

• 初始化命令：hexo init ，初始化完成之后打开所在的文件夹可以看到以下文件：

  
  
• 解释一下：
  • node_modules：是依赖包
  • public：存放的是生成的页面
  • scaffolds：命令生成文章等的模板
  • source：用命令创建的各种文章
  • themes：主题
  • _config.yml：整个博客的配置
  • db.json：source解析所得到的
  • package.json：项目所需模块项目的配置信息
• 做好这些前置工作之后接下来的就是各种配配配置了。

4. 搭桥到github

• 没账号的创建账号，有账号的看下面。

  • 创建一个repo，名称为yourname.github.io, 其中yourname是你的github名称，按照这个规则创建才有用哦，如下：

    
    
    
    
    image.png

• 回到gitbash中，配置github账户信息（YourName和YourEail都替换成你自己的）：

  
  
  image.png

image.png

• 创建SSH,在gitbash中输入：

ssh-keygen -t rsa -C "[email protected]

生成ssh。然后按下图的方式找到id_rsa.pub文件的内容。

• 将上面获取的ssh放到github中：

  
  
  image.png

• 添加一个 New SSH key ，title随便取，key就填刚刚那一段。

• 在gitbash中验证是否添加成功：

ssh -T [email protected]

• 完成下一步你就成功啦！

5. 一步之遥

• 用编辑器打开你的blog项目，修改_config.yml文件的一些配置(冒号之后都是有一个半角空格的)：

deploy:
  type: git
  repo: https://github.com/YourgithubName/YourgithubName.github.io.git
  branch: master

• 回到gitbash中，进入你的blog目录，分别执行以下命令：

hexo clean
hexo generate
hexo server

注：hexo 3.0把服务器独立成个别模块，需要单独安装：

npm i hexo-server。

• 打开浏览器输入：

http://localhost:4000

• 接着你就可以遇见天使的微笑了~

6. 上传到github

• 先安装一波：

npm install hexo-deployer-git --save

• （这样才能将你写好的文章部署到github服务器上并让别人浏览到）
• 执行命令(建议每次都按照如下步骤部署)：

hexo clean
hexo generate
hexo deploy

• 注意deploy的过程中要输入你的username及passward。如下：

  
  
• 在浏览器中输入http://yourgithubname.github.io就可以看到你的个人博客啦，是不是很兴奋！
• 感觉gitbash中东西太多的时候输入clear命令清空。

7. 修改及配置Themes

• hexo初始化之后默认的主题是landscape , 然后你可以去Hexo themes里面找到你想要的主题。在github中搜索你要的主题名称，里面都会有该主题的如何使用的介绍，按着来就好了，反正就是改改改！我选的是pacman,看起来挺不错，至少是我喜欢的类型。

• 跟该主题相关的配置在themes/pacman/_config.yml里面,然后根据你的需要在这配配配就行了。
  

8.Git bash 中 hexo常用指令

• 常见命令

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #部署到GitHub
hexo help  # 查看帮助
hexo version  #查看Hexo的版本

• 缩写

hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

• 组合命令

hexo s -g #生成并本地预览
hexo d -g #生成并上传

9. _config.yml 全局配置

这里面都是一些全局配置，每个参数的意思都比较简单明了，所以就不作详细介绍了。

需要特别注意的地方是，冒号后面必须有一个空格，否则可能会出问题。

10.写博客

• 定位到我们的hexo根目录，执行命令：

hexo new 'my-first-blog'

• hexo会帮我们在_posts下生成相关md文件：

  
  

• 我们只需要打开这个文件就可以开始写博客了，默认生成如下内容：

  
  

• 当然你也可以直接自己新建md文件，用这个命令的好处是帮我们自动生成了时间。

• 一般完整格式如下：

---
title: postName #文章页面上的显示名称，一般是中文
date: 2013-12-02 15:30:16 #文章生成时间，一般不改，当然也可以任意修改
categories: 默认分类 #分类
tags: [tag1,tag2,tag3] #文章标签，可空，多标签请用格式，注意:后面有个空格
description: 附加一段文章摘要，字数最好在140字以内，会出现在meta的description里面
---

以下是正文

本教程参考

http://blog.haoji.me/build-blog-website-by-hexo-github.html?from=xa
https://www.cnblogs.com/visugar/p/6821777.html