Windows环境下Hexo、Github搭建个人博客

Windows环境下Hexo、Github搭建个人博客

• 感谢github提供免费空间
• 带有“$”符号的是git命令
• 站在巨人的肩膀上

---

去我的Blog查看效果

环境准备

1. git
   git安装

2. node.js
   node.js安装

3. hexo
   hexo操作步骤

正确搭建姿势

新建github项目

(前提：gihub账号，通过github上提供的方式或者通过git的git gui 获取并且设置了github的SSH 获取SSH参考网址)
建立与你github用户名对应的仓库，仓库名必须为your_user_name.github.io

安装配置Hexo
此处给出的并不是完全适合hexo所有版本的方法，具体还应以hexo官网的方式作为参考。

1. 安装hexo

   安装hexo之前必须先安装git，之后的操作基本大多集中在git的操作上。
   打开git命令行输入：

   $ npm install -g hexo

2. Quick Start
   （比较重要的一部分）
   1 . Setup your blog

   $ hexo init

   Hexo随后会自动在目标文件夹建立网站所需要的文件。然后按照提示，还是 在/E/Hexo执行：

   $ npm install

   在E:\Hexo目录中安装 node_modules。

   2 .Start the server
   运行下面的命令（在 /E/Hexo下）

   $ hexo server
   [info] Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.
   [info]表明Hexo Server已经启动了，在浏览器中打开http://localhost:4000/，这时可以看到Hexo已为你生成了一篇blog。
   在这里如果你接下来要上传一个自己的文章就要按Ctrl+C 停止Server。否则会提交两次。

   3 .Create a new post

   $ hexo new “My New Post”
   [info] File created at e:\Hexo\source_posts\My-New-Post.md
   刷新http://localhost:4000/，可以发现已生成了一篇新文章”My New Post“。（我开启hexo server之后才可以看到）

   4 .Generate static files
   将markdown（My New Post）文件生成静态网页

   $ hexo generate
   该命令执行完后，会在 E:\Hexo\public\ 目录下生成一系列html，css等文件
   注意：在每次 hexo generate之后才能保存修改。

   5 .编辑生成的文档

   hexo new “My New Post”会在E:\Hexo\source_posts目录下生成一个markdown文件：My-New-Post.md
   可以使用一个支持markdown语法的编辑器（比如 Sublime Text）来编辑文件。

   6.部署到Github

   部署到Github前需要配置_config.yml文件，首先找到下面的内容
   deploy:
   type:
   然后将它们修改为：
   deploy:
   type: git
   repository: [email protected]:Darksiderlyd/Darksiderlyd.github.io
   branch: master

   注意：使用SSH [email protected]:Darksiderlyd/Darksiderlyd.github.io
   所有键的冒号后面留一个空格，如type: git
   url不能为空,否则报错
   type: github报错hexo ERROR Deployer not found: github的解决方法：
   先运行 npm install hexo-deployer-git –save
   再改为 type: git

   执行：

   $ hexo deploy
   [info] Start deploying: github
   [error] is not a valid repositor URL!
   使用SSH url，如果电脑没有开放SSH 端口，会致部署失败。
   fatal: Could not read from remote repository.Please make sure you have the correct access rightsand the repository exists.
   另外：如果你是为一个项目制作网站，那么需要把branch设置为gh-pages。

   7.测试
   当部署完成后，在浏览器中打开http://Darksiderlyd.github.io/（以我的为例https://Darksiderlyd.github.io/） ，正常显示网页，表明部署成功。

   8.总结：部署步骤
   每次部署的步骤，可按以下三步来进行：
   hexo clean
   hexo generate
   hexo deploy

3. 命令总结

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

   复合命令：
   hexo deploy -g #生成加部署
   hexo server -g #生成加预览

   命令的简写为：
   hexo n == hexo new
   hexo g == hexo generate
   hexo s == hexo server
   hexo d == hexo deploy

4. 主题插件安装和优化
   推荐参考文章：主题详细介绍

5. 问题Issue
   在操作过程中，由于对.deploy_git文件的误操作（删除.git），导致提交不上文件，然后还执行了hexo init等操作，究其原因，主要是_config.yml文件也被初始化，回到了最初的状态，导致hexo deploy没有反应也不报错，所以重新配置一下deploy就好了，还有就是强烈建议备份一下这个文件。

6. 域名绑定
   推荐参考文章：http://blog.csdn.net/qq_23435721/article/details/50876942

以上搭建过程共参考以下文章:
http://www.cnblogs.com/zhcncn/p/4097881.html
https://segmentfault.com/a/1190000000458953
http://www.cnblogs.com/liulangmao/p/4323064.html
http://blog.csdn.net/qq_23435721/article/details/50876942