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

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

感谢github提供免费空间

带有“$”符号的是git命令

站在巨人的肩膀上

去我的Blog查看效果

环境准备

git

git安装

node.js

node.js安装

hexo

hexo操作步骤

正确搭建姿势

新建github项目

(前提：gihub账号，通过github上提供的方式或者通过git的git gui 获取并且设置了github的SSH 获取SSH参考网址)

建立与你github用户名对应的仓库，仓库名必须为your_user_name.github.io

安装配置Hexo

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

安装hexo

安装hexo之前必须先安装git，之后的操作基本大多集中在git的操作上。

打开git命令行输入：

$ npm install -g hexo

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: git@github.com:Darksiderlyd/Darksiderlyd.github.io

branch: master

注意：使用SSH git@github.com: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

命令总结

常用命令：

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

主题插件安装和优化

推荐参考文章：主题详细介绍

问题Issue

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

域名绑定

推荐参考文章：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