Windows下GithubPages博客快速搭建

Windows下开发坑总是比较多的，但是本人没Mac，只好踩一遍坑记录下。本文主要是安装过程&踩坑记录，故不对细节过分讲解。

简单静态页面搭建部署

一. 跟随官方GithubPages搭建教程完成Helloword静态页面搭建

• 操作步骤：只需要完成步骤一即可，即完成Github上仓库创建，无需将仓库下拉
• 提示：仓库名字格式为：username + github.io, username必须与个人或组织Github名字完全相同，不同的话无法作为GithubPages展示

二. 使用Hexo框架搭建个人博客

• 提示：下载速度过慢的话找镜像站或者挂科学上网下载
• 重点：上面链接是官方文档，快速搭建看我，软件安装看文档
• 操作步骤

1. 安装git & NodeJS
   • git: Git in Windows
   • NodeJS: NodeJS in Windows
2. 安装Hexo到仓库文件夹
   • 打开Git Bash,键入命令并等待完成

     npm install -g hexo-cli
     

   • Git Bash中找到你想要安装hexo的位置, 键入命令并等待完成

     hexo init HexoBlog
     

   • 键入命令，并等待依赖安装完成

     cd HexoBlog
     npm i
     

3. 运行本地服务器测试
   • 提示：最好先查查端口占用再尝试
     • 继续在Git Bash当前位置键入命令， 没有报错的话就可以在浏览器输入localhost:5000查看博客的样式了：

       hexo server -p 5000
       

4. 修改上传配置
   • 在当前位置找到并打开_config.yml,拉到最下deploy这里,修改如下。YML格式文件依靠缩进来确定元素间的从属关系，请确保每个deployer的缩进长度相同并且使用空格缩进：

     deploy:
       type: git
       repo: 你的Github仓库地址
       branch: master
     

   • 提示：这里可能出现一些问题，将关键错误提示复制黏贴到Google查询一般都有答案哈哈
5. 基础博客生成
   • 继续在Git Bash当前位置键入：清理-生成-部署命令：

     hexo clean
     hexo g
     hexo d
     

   发布完成之后可以到浏览器输入自己的GithubPages地址(仓库名)查看博客情况，
   • 提示0: 先安装hexo的git发布插件：

     npm install hexo-deployer-git --save
     

   • 提示1：hexo d 之前需要配置好_config.yml和git
     • _config.yml按照步骤4配置
     • git需要配置name和email,按照下面键入配置一次,之后无需配置：

       git config --global user.email "you@example.com"
       git config --global user.name "Your Name"
       

   • 提示2: 每次发布文章时均使用清理-生成-部署命令

三. 开始编写博客

终于到了正经写博客的环节了，只需要简单在Git Bash输入指令：

hexo new "文章标题"

即可开始文章的编写。完成之后使用清理-生成-部署命令，刷新GithubPage界面就能看到您的新文章上架啦~

• 提示：文章使用Markdown语法编写，可在网上找简易入门教程边学边用。

参考链接

• 使用github page搭建hexo博客最佳实践--gnehz972
• Hexo文档
• GithubPages文档