使用Hexo-Github搭建个人博客-详细

查看更多：https://breezedawn.github.io/

搭建环境准备：

1. 下载Node.js
2. 安装Git
3. 拥有github账号

下载完成后（全部按NEXT就好），按下WIN+R，调出运行窗口，打cmd回车进入命令行，验证node和Git是否安装正确，输入下面指令:

node -v
npm -v
git --version

如果都安装成功就会显示对应的软件版本号。

安装Hexo

进去你要放置博客文件夹的目录，点击鼠标右键，点击 Git Bash Here，然后依次输入并执行下面的代码。

$ npm install hexo-cli -g 
$ hexo init Hexo
$ cd Hexo
$ npm install
$ hexo server

第一行是安装 hexo 扩展插件。

第二行是创建一个为 Hexo 的文件夹，我们要把 hexo 相应的代码下载到该文件中下。

第三行进入到新创建的文件夹内。

第四行是安装 hexo 相关的代码。

第五行启动本地服务，启动完成后，在浏览器输入 http://localhost:4000/ 就可以访问刚刚创建的博客了。

如果报错: 执行 npm cache clean --force 清缓存再安装

Hexo目录里会多出很多文件，此时的目录情况如下:

node_modules  npm 文件缓存目录
scaffolds     文夹件下存放文章和页面模版
scource       文夹件下存放资源文件
themes        文夹件下存放主题文件
package.json  站点版本和站点所需的依赖文件
_config.yml   站点配置文件

hexo 常用命令 ：

$ hexo g 生成静态文件
$ hexo s 启动本地服务
$ hexo d 提交到远程仓库
$ hexo n page 创建页面 
$ hexo n "" 创建文章
$ hexo d -g 生成静态并提交到远程仓库
$ hexo s -g 生成静态文件并启动本地预览
$ hexo clean 清除本地 public 文件

外网访问

第一步 - 创建仓库

在 Github 创建一个名字为 username.github.io 的仓库，这里的 username 必须是你的github用户名。

第二步 - 修改配置

**注意所有的命令都在git-bash里敲! 注意所有的命令都在git-bash里敲! 注意所有的命令都在git-bash里敲! **

**注意所有的配置冒号后都要有空格! 注意所有的配置冒号后都要有空格! 注意所有的配置冒号后都要有空格! **

修改depoly ，这里的 username 仍然是你的 Github 用户名：

deploy: 
    type: git 
    repo: git@github.com:username/username.github.io.git  // 后面对应的是仓库链接
    branch: master

示例：

deploy: 
    type: git 
    repo: git@github.com:BreezeDawn/BreezeDawn.github.io.git
    branch: master

修改 site 相关信息 ：

title: xx
subtitle:     
description: 中文最好用编辑器不要用记事本打开
keywords:
author: xx
language: zh-Hans
timezone:

注 ：网站名称（title），作者 (author)，语言 (language)，签名(description)

第三步 - 给本地 Git 添加 ssh免密登陆

首先我们需要修改 Git 的全局配置 user.name 和user.email

git config –-global user.name “xxxxxx”  // 自己的 github 用户名
git config –-global user.email “xxxxxx” // 自己的 github 里绑定的邮箱

在这里 user 不需要替换成自己…只需要修改双引号里的内容

然后我们进入存放密匙的文件夹，检查本地是否有 SSH key

$ cd ~/.ssh
$ ls

如果 SSH key 存在，就会显示 id_rsa、id_rsa.pub、know_hosts 三个文件 。

没有的话我们就来创建 SSH key

$ ssh-keygen -t rsa -C "你的邮箱"  

然后点击回车，接着会让你输入文件名，点击回车直接忽略，再然后会让设置密码并确认密码，我们点击两次回车，直接把密码设置为空，不用输入 。然后你会看到一堆泡泡，说明密匙创建成功。

创建成功后，可以通过如下命令拷贝 SSH key 的内容 ：

clip < ~/.ssh/id_rsa.pub"

你也可以手动打开~/.ssh/目录下的id_rsa.pub文件进行拷贝，所有内容一字不漏的拷贝!

然后我们打开 GitHub 点击右上角头像进入个人资料，点击Settings -> 左边 SSH and GPG keys，然后点击 New SSH key，title随便填，把之前拷贝的内容粘贴到 key 里面，然后点击 Add SSH key。

怎么去验证是否已经添加成功了呢 ？通过如下命令 ：

$ ssh -T git@github.com

验证成功，你会看到 successfully !! 但是我们还差一步~

第四步 - 更新静态文件，提交到 github 仓库

执行 $ npm install hexo-deployer-git --save - 安装关联 Github 的插件

执行 hexo d -g - 更新静态文件并提交到你的 github 仓库。

然后使用浏览器打开 https://username.github.io.git ，是不是可以外网访问了呢? 记住一定是https的哦，不然访问不到

更换主题

下载主题

如果不喜欢现在的主题，我们可以在 github 中搜索 hexo theme 寻找自己喜欢的主题。

我用的是人气最高的 Next 主题，它提供非常详尽的官方文档，并且支持很多第三方插件，十分的友好。

Next Github：https://github.com/iissnan/hexo-theme-next/

Next 官方文档：http://theme-next.iissnan.com/

我们现在通过 git 方式下载 Next，命令如下 ：

$ cd themes
$ git clone https://github.com/iissnan/hexo-theme-next next

hexo 的主题文件都放在 themes 文件夹下，所以我们要进入主题文件夹 下下载 Next。

下载完成后，我的博客 themes 下就多了一个 next 文件夹。

配置主题

首先我们要区分两个文件。

第一个是我们网站的 站点配置文件 _config.yml，它在我们的博客根目录 Hexo/下，Hexo 为 hexo init 初始化时自动创建的文件夹名称。

第二个是我们网站的 主题配置文件 _config.yml，它在我们的主题目录 Hexo/themes/next下。

然后我们修改 站点配置文件 :

theme : next

注 ：把默认主题 landscape 切换成 next。

此时我们的博客主题已经修改为 Next 主题，但 Next 主题其实有四个风格，Muse、Mist、Pisces、Gemini，且这里默认为 Muse。

如果我们想要修改，就需要打开 主题配置文件，

修改 Schemes ：

scheme: Muse
#scheme: Mist
#scheme: Pisces
#scheme: Gemini

根据自己的选择进行注释。

修改完毕后我们需要把静态文件按照新的配置重新生成，还记得重新生成静态文件的命令吗?

$ hexo g

然后我们就可以提交给远程仓库了

$ hexo d

完结

接下来我们就可以在 github 上看见我们提交的静态文件了，也可以通过 https://username.github.io/ 访问我们的博客了，username 改成你的github 用户名，一定要记得是https!!

如果你想发布文章、生成新页面、增加搜索或其他功能，在 Next 官方文档中你都能找到~

再放一下官方文档：

Next 官方文档：http://theme-next.iissnan.com/

当然还有一些不在官方文档上的骚操作，等我更新吧…

如果在进行操作时有 bug ，欢迎留言~~