搭建个人github博客

基本配置

申请Github账号

• Github注册页面

创建博客仓库

• 然后右上角选择 Create a new repository
• 仓库名应该为：用户名.github.io
• 比如:我的仓库名是：Moking1997.github.io

环境安装

• node下载地址
• git下载地址

配置SSH

• 打开git bash终端
• 设置user.name和user.email

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

将公匙添加到github上

• 生成SHH密匙
  ssh-keygen -t rsa -C "你的GitHub注册邮箱"
• 在User下就会有一个新的文件夹.ssh，里面有刚刚创建的ssh密钥文件id_rsa和id_rsa.pub
• 进入SSH and GPG keys
• New SSH key→将id_rsa.pub中的内容复制到Key文本框中，然后点击Add SSH key(添加SSH)按钮

Hexo

安装hexo

• 执行下列代码
  npm install -g hexo-cli
• 在自己喜欢的目录下初始化博客文件夹，右键点击“在此处打开命令窗口”，输入
  hexo init blog

初探hexo

• 初始化hexo 之后source目录下自带一篇hello world文章, 所以直接执行下方命令

# 生成静态页面
hexo generate
# 开启本地服务器
hexo s

• 访问http://localhost:4000/ 便可以看到博客网站初步的模样
• 问题：为什么访问http://localhost:4000/，无反应？
  解决方法：可能是由于端口问题引起的。使用Ctrl+C中断本地服务，使用命令hexo s -p 5000重新开启本地服务，访问http://localhost:5000/可以看到博客页面了

将hexo博客部署到github上

• 在blog目录下，用sublime打开_config.yml文件，修改参数信息

• 修改网站相关信息

title: Moking's Blog
subtitle: 副标题
description: 网页描述
author: Moking
language: zh-CN

• 配置部署

deploy:
  # 类型
  type: git 
  # 仓库
  repo: [email protected]:Moking1997/Moking1997.github.io.git 
  # 分支
  branch: master

• 注意：type: git中的冒号后面由空格。
• 注意：将[email protected]:Moking1997/Moking1997.github.io.git 中的用户名换成自己的用户名

发表文章

• 在blog目录下的cmd中输入

hexo new "测试文章"

• 打开该文章文件

---
title: 测试文章
date: 2018-05-27 11:03:44
tags:
---
这是一篇测试文章，欢迎关注作者博客[1]: https://moking1997.github.io/

• 保存，然后执行下列步骤：

# 清空静态页面
hexo clean
# 生成静态页面
hexo generate
# 开启本地服务器
hexo server
# 部署 
hexo deploy

• 打开http://localhost:4000/，发现刚才的文章已经成功了
• 打开github上托管的博客。如我的博客地址是：https://moking1997.github.io/

常见问题

• hexo deploy没有反应？
  修改配置文件：_config.yml时，冒号后面没加空格。

• 执行 hexo deploy 后,出现 error deployer not found:github 的错误
  执行：npm install hexo-deployer-git --save

• hexo s 网站打不开？
  端口占用，换个端口就好了。执行命令hexo s -p 5000，并在浏览器地址栏输入http://localhost:5000

• hexo命令缩写

hexo g：hexo generate	  # 生成静态页面
hexo c：hexo clean 		# 清空静态页面
hexo s：hexo server		# 开启本地服务器
hexo d：hexo deploy		# 部署

• hexo组合命令

# 清除、生成、启动
hexo clean && hexo g -s
# 清除、生成、部署
hexo clean && hexo g -d