2017-04-02

利用hexo在windows下搭建静态博客ovo

搭建博客前的本地工作

安装Git

Git是一个版本控制工具，我们主要使用Git Bash功能把本地的hexo内容提交到Github上去。
Github是一个用Git做版本控制的项目托管平台，有很多源码，在全世界适用范围广泛。

官网下载安装Git（推荐）或者从Github获取
要根据自己的系统选择合适的版本下载安装哦~

安装Node.js

Node.js是一个Javascript运行环境，用来生成静态页面。

不用那么乖的去查API文档啦，只要安装好就可以了。

安装编辑器（可选）

在后面配置文件的时候，系统自带的记事本支持很差，为了能够更方便的编辑，可以选择下载Sublime,Text3,VS code或者Notepad++，方便编辑。

安装并部署Hexo

Hexo是一个采用Node.js的静态博客框架。
Hexo官网（中文支持）或者从Github获取

你可以使用Hexo官网文档达到与下述步骤同样的效果，强烈建议你使用官网文档获得最新的帮助和支持。
极客学院在获得允许的情况下制作了Hexo说明文档的离线版本：
点击下载 [PDF版] (http://passport.jikexueyuan.com/sso/login?referer=http%3A%2F%2Fwiki.jikexueyuan.com%2Fdownload%2Fhexo-document%2Fpdf)[ePub版](http://passport.jikexueyuan.com/sso/login?referer=http%3A%2F%2Fwiki.jikexueyuan.com%2Fdownload%2Fhexo-document%2Fepub) 或者访问极客学院 Wiki

所有必备的应用程序安装完成后，即可使用npm安装 Hexo：

1	$ npm install -g hexo-cli

如果npm install时，出现npm error: RPC failed错误：
开启翻墙软件或将npm镜像修改为淘宝镜像。

1	$ npm config set registry "https://registry.npm.taobao.org"

在你想要放置博客文件的位置新建一个名为hexo的文件夹（不要选择需要管理员权限才能创建文件的文件夹），然后在hexo文件夹内右键Git Bash Here，常用的Hexo指令执行下列命令：

1	$ hexo init

然后，Hexo会自动为你生成你网站所需要的全部文件。此时，我们已经在本地搭建好Blog了。
在hexo文件夹内右键Git Bash Here，执行下列命令：

1 2	$ hexo g $ hexo s

然后在浏览器输入 http://localhost:4000 可以看到当前博客效果，按Ctrl+C停止。
如果依旧无法访问表示4000端口（默认）被占用，输入：

1	$ hexo s -p 5000

这里切换成5000端口，浏览器输入 http://localhost:5000 访问即可。

美化博客

推荐通过Next主题使用文档学习并且了解Hexo主站和皮肤的配置。
我自己用的是Yelee主题啦。

Github

注册并登陆Github

Github用来做博客的远程创库、域名、服务器等等。
打开Github的官方网站，注册一个Github账户。
记住注册时的用户名、密码和验证绑定用的邮箱。

开启Github Page服务

点击New repository建立一个新的仓库，重要的事情说三遍：
仓库名和自己的ID一致！！！
仓库名和自己的ID一致！！！
仓库名和自己的ID一致！！！
标准格式：用户名.github.io
举个栗子：用户名为“qwq”，仓库名为“qwq.github.io”

勾选默认生成一个README.md文件，会后台自动开启pages。
如果成功开启，在对应仓库的setting - GitHub Pages会有提示：

Your site is published at https://用户名.github.io/
GitHub Pages is designed to host your personal, organization, or project pages from a GitHub repository.

配置ssh密钥

Github 除了ssh 还可以用https 连接哟~

打开桌面的Git Bash，检查本机的密钥：

1	$ cd ~/.ssh

密钥生成文件的位置为：
windows: C:/Users/用户名/.ssh/
mac: ~/.ssh/
.ssh文件为隐藏文件，需要先设置隐藏文件可见才可以看到

如果提示：No such file or directory 说明你是第一次使用Git。
如果不是第一次使用Git，输入下列指令：

1
2
3

$ mkdir key_backup  
$ cp id_rsa* key_backup  
$ rm id_rsa*

生成自己的密钥，记得””中间的邮箱改成自己的。生成过程中会让你输入passphrase口令，可以直接回车，以后出现都是空密码。

1	$ ssh-keygen -t rsa -C "Your_Email@Yourmail.com"

生成密钥后，在目录（系统盘下的用户或者 Users 文件夹 /用户名/.ssh）找到私钥 id_rsa 和公钥 id_rsa.pub 这两个文件。千万不要把私钥文件 id_rsa 透露给任何人，否则别人可以以管理员身份登录你的blog。

建立和Github的SSH连接：

使用文本工具打开id_rsa.pub,复制里面的所有内容。进入Github主账户下面的Settings - SSH and GPG keys. New SSH key，把刚才复制的东西全部粘贴进去，然后Add添加。

测试是否可以连接到服务器：

1	$ ssh -T git@github.com

如果是第一次连接，需要输入yes后回车，提示输入passphrase，如果刚才是空密码，那么直接回车过去就好。
如果出现下面的字符，就说明成功了：

Hi xxxxx! You’ve successfully authenticated, but GitCafe does not provide shell access.

设置Git账户信息

在桌面右键Git Bash Here，键入：

1 2	$ git config --global user.name "yourname" $ git config --global user.email "yourmaill@maili.com"

要和注册Github的信息保持一致！

添加Pages目录

如果直接上传，上传上去的只是所谓的博客源码，如果我们要让我们博客显示出来，就要建立pages目录。

打开hexo文件夹，右键Git Bash Here，然后键入：

echo 'Hello, world' > index.html  
git init  
git add .  
git commit -a -m 'Hello, world!'  
git remote add origin git@github.com:用户名/用户名.github.io  
git checkout -b master  
git push origin master

这里提两个点：
1.上述git add操作后面是空格+.，别忘记了空格；
2.默认创建的仓库”用户名.github.io”有一个默认分支master,似乎Github Page功能不支持其它名字的branch分支，所以其它名字的分支可以作为备份，但是不能作为page页面。

设置使Hexo默认更新到Github

用编辑器打开hexo文件夹下的_config.yml文件(称为站点配置文件)，打开之后把最后的deploy改为：

deploy:  
  type: git  
  repository: git@github.com:用户名/用户名.github.io  
  branch: master

注意冒号后面的空格，检查非常严格。

完成配置

每一次本地测试完成后，在Hexo目录右键Git Bash，键入：

1 2	$ hexo g $ hexo d

这里的hexo g不是复制，是渲染，用主题帮你的md加上css,js效果
hexo d是将本地文件上传到github

你的网站地址就是用户名.github.io

注意，如果你发现本地hexo s测试达到预期效果，但是Github Page没有更新，请再次执行 hexo d 指令。

常见问题

在阅读这个部分的内容前，希望你充分阅读了Hexo官网（中文支持）和Next主题使用文档，绝大多数的问题都能够从中得到解决。

如果报错：

1 2	ERROR Deployer not found: git ERROR Deployer not found: github

解决方法：

1	npm install hexo-deployer-git --save

备份！

如果你觉得默认的主题不那么让人满意，想要自己修改样式的话，请一定记得：
先备份！备份！备份

来自博客崩了无数次的果子的心声

电脑重装或者更换电脑使用后如何管理博客

这个问题其实就是本地的文件丢失啦，但是没有关系，我们可以从github上将以前的文件下载到本地。
教程前面讲的node.js, hexo, git仍然需要你安装并部署好，然后我们只需要在想要放置博客本地文件的文件夹右键Get Bash Here，键入

1	$ clone URL

这个URL是指你放于github上的blog文件地址

其他问题请从互联网等渠道获取解决方式。

你为什么这么熟练啊

有的人的教程里面会解释很多具体步骤，我在这里都省略了，主要原因是这些工具、网页仍处于保持更新阶段。而你现在所看到的这个页面就是它出生时的样子，无特殊情况不会进行太多修改。如果使用图文说明，在多次更新后甚至会适得其反。庆幸的是，Hexo官网（中文支持）和Next主题使用文档的更新可以得到保证（只要原作者还在进行开发），这也是为什么我强烈建议读者详细阅读说明文档的原因。

如果你仔细地阅读过了说明文档，应该能独立完成以下要求：
1.为你的博客设置作者昵称、头像和站点描述等；
2.设置修改菜单栏和侧边栏的功能；
3.设置文章的标签、分类、字体和代码高亮等；
4.侧边栏添加社交链接，自定义图片样式
5.（一些第三方服务）

绑定域名

如果你购买了一个域名，你需要在hexo的sources目录下新建一个CNAME文件，内容就是你购买的域名地址（不需要任何的额外内容）。
在域名解析（域名提供商）中添加设置三项：

记录类型A 主机记录@ 记录值192.30.252.153
记录类型A 主机记录@ 记录值192.30.252.154
记录类型CNAME 主机记录www 记录值用户名.github.io.

过一段时间访问你购买的域名即可。
Markdown语法

点击查看Markdown 语法说明(简体中文版)
下载MarkdownPad2 激活Pro版本：

邮箱： Soar360@live.com
授权秘钥：根据邮箱提示关键词自行获取

七牛云图床

注册七牛云和极简图床，傻瓜式操作，解决图片储存问题。

参考博客

Doge - 小fa的奇思幻想
Processor - Windows下利用Hexo搭建静态博客
LoRexxar - Windows Hexo博客安装配置优化（小白篇）
向以上博主表示衷心的感谢，侵删。