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/