Hexo – Song's Share

0 环境

Windows 10

1 环境安装

1.1 安装Node.js

Node.js下载地址：https://nodejs.org/en/，下载完成后安装
（由于很多程序都是从境外的网站下载的，下载会比较慢，挂个VPN后下载更快，可以从网上找免费的VPN，但绝大多数都不稳定，建议购买付费VPN，花钱买时间，大家若没有自己喜欢的VPN的话，可以试下我正在使用的’一枝红杏’：https://my.yizhihongxing.com/aff.php?aff=2840）

1.2 安装Cmder(with git)

Cmder是一款Windows下的命令行终端软件，完爆Windows自带的cmd，推荐下载！
Cmder(with git)下载地址：https://cmder.net/
直接下载包含git的完全版，可以不用再去单独安装git了。

1.3 安装Hexo

打开Cmder，输入以下命令使用npm安装Hexo

    npm install -g hexo-cli

等待时间视网速而定，此时可以先去找找自己喜欢的主题：https://hexo.io/themes/，或是先按照1.4 配置Github来进行Github的配置

1.4 配置Github

1.4.1 创建New repository

Github网址：https://github.com

注册完账号后（如之前没有的话），点击右上角的+ ,而后选择New repository
在Repository name内填入你的用户名.github.io，如下图，务必保证两个红框内的用户名一致，否则会导致404 not found error，将来你的用户名.github.io就是你的博客域名，如我的博客域名就是’shelmingsong.github.io’

1.4.2 生成SSH key

在Cmder内输入

    ssh-keygen -t rsa -C '你的Github注册邮箱'

一直enter下去就可以了，最后会提示：

    Your public key has been saved in /c/Users/smy/.ssh/id_rsa.pub.

找到这个文件，用sublime或是其它编辑器打开，复制文件内全部内容，而后打开https://github.com/settings/keys，点击new SSH key，Title随便写，建议写Blog，Key内粘贴刚才复制的内容。

2 Hexo博客本地发布

在你认为合适的目录创建文件夹，将来博客的所有本地内容将存储在此目录
在所创建文件夹内按住shift后鼠标右击，选择Cmder here
在打开的Cmder内输入（就这样写，不要在init后面加任何东西，不然后面进行设置的时候会比较麻烦）：

    hexo init

等待一段时间后，成功提示：

    INFO  Start blogging with Hexo!

输入以下命令，生成静态页面：

    hexo g

输入以下命令，启动本地服务器：

    hexo s

* 在浏览器地址栏输入https://localhost:4000/就可以看到你的博客了，此时你的博客仅本地可见，要挂到Github服务器上还需要执行下面的步骤

3 修改博客参数

执行完上述步骤后，你的博客上尚未体现出你的任何信息，此时需要修改博客参数
* 在你所创建的博客目录里面，找到_config.yml

* 用sublime或其它编辑器打开_config.yml，修改以下参数，#后面为注释：

在Site菜单

    title: Shelming.Song's Blog # 博客主标题
    subtitle: Song's Share # 博客副标题
    description: Life is short, I use Python! # 网站描述
    author: Shelming.Song # 作者信息
    language: zh-Hans # 语言
    timezone: # 时区，可以空着

在Deployment菜单

    deploy: 
      type: git # 就填这个，别改成其它的
      repo: https://github.com/shelmingsong/shelmingsong.github.io.git # 将两个'shelmingsong'改成你的用户名
      branch: master # 就填这个，别改成其它的

注意
yml文件内每个参数的冒号后面，都需要加上一个空格，在sublime文件内通过颜色能显现

4 上传博客到Github服务器

在Cmder输入以下命令

    hexo d

出现以下提示即为上传成功

    INFO  Deploy done: git

如果提示error deployer not found:git，则需要执行以下命令

    npm install hexo-deployer-git --save

如果提示No such device or address，则需要将_config.yml文件内的repo改成ssh格式的，如下：

    deploy: 
      type: git
      repo: git@github.com/shelmingsong/shelmingsong.github.io.git# 将两个'shelmingsong'改成你的用户名
      branch: master

如果提示登录Github登录，输入账号密码登录就可以了
然后你就可以在浏览器地址栏输入你的博客网址，如https://shelmingsong.github.io/，如此别人也可以通过域名来访问到你的博客了
如果打开网页后提示404 not found error，一般有两种可能，一是网速不好，Github是美国的网站，会延迟个几分钟，二是你创建New repository的时候，没有将以下图片中红框内的用户名保持一致

5 常用hexo命令

创建新文章

    hexo new '文章名'

而后进入所提示的目录，用md编辑器（推荐使用MarkdownPad）打开文件，用Markdown语法写文章
Markdown语法教程：https://wowubuntu.com/markdown/basic.html

生成静态文件

    hexo g

启动本地服务器（用于修改后的预览）

    hexo s

发布博客到服务器

    hexo d

6 修改博客主题

在https://hexo.io/themes/上挑选自己喜欢的主题，不同的主题会有不同的配置方法，推荐使用next主题，next主题使用文档：https://theme-next.iissnan.com/

Song's Share

标签：Hexo

免费搭建个人技术博客 Github and Hexo