1.1. 环境安装

下载必须环境

NodeJS：下载 | Node.js 中文网 (nodejs.cn)

Git：Git - Downloads (git-scm.com)

测试是否安装成功

node -v
npm -v
git --version

安装cnpm以使用国内景象

npm install -g cnpm --registry=https://registry.npm.taobao.org

安装hexo

cnpm install hexo-cli -g
hexo -v

1.2. 建立Github仓库

注册GitHub账号（略）

建立GitHub仓库

这里注意，要将Repository name设置为 用户名.github.io，建立一个README.md。

1.3. 生成并绑定ssh key

1. 打开命令行，定位到某文件夹下，输入ssh查看ssh是否已经正常安装。

   ssh-keygen -t rsa -C "注册GitHub时使用的邮件地址"
   # 例如：
   ssh-keygen -t rsa -C "abc@example.com"
   # 输入命令后，根据提示按四次回车
   

2. 生成完毕后，进入.ssh文件夹。Linux/mac用户在~/.ssh/，Windows用户一般在C:\Users\用户名\.ssh，找到里面的id_rsa和id_rsa.pub。

3. 打开GitHub的settings页面，在左边找到SSH and GPG keys，点击绿色的New SSH key按钮。Title随便写都行，并将刚才的id_rsa.pub中的内容复制到Key栏，点击Add SSH key。

4. 测试SSH是否绑定成功：

   ssh -T git@github.com	# 此命令无需任何修改，直接复制执行即可。
   # 根据提示输入“yes”，最后提示“success”则绑定成功。
   

二、本地生成博客

1. 选择一个空文件夹，进入命令行。

   hexo init	# 由于是从GitHub上拉取，可能会遇到网络问题，多试几次
   hexo s		# 生成本地静态页面，并打开本地服务器
   

2. 找到刚才文件夹下的_config.yml，用Notepad++打开。在文件的最底部添加下列内容（将用户名添加上）：

   deploy: 
   	type: git
   	repository: https://github.com/用户名/用户名.github.io.git
   	branch: main
   

   其中的repository项可在对应仓库中找到自己的.git文件。

3. 安装部署工具。在博客文件夹下打开命令行，输入

   cnpm install hexo-deployer-git --save
   

三、部署博客

1. 在博客文件夹下打开命令行，输入

   hexo g		# 生成
   hexo d		# 上传
   # 连接可能不稳定，多试几次
   

2. 在弹出的窗口中输入GitHub用户名，密码别着急输入，看下一步（别输错，否则得重来）；

3. 打开浏览器，进入[Personal Access Tokens (github.com)](https://github.com/settings/tokens)，点击Generate new token，随便取个名字。

   • 有效期限30 days；
   • 下面的Select scopes全选上；
   • 由于令牌只在第一次生成时可见，建议将其复制到其他地方保存；
   • 复制令牌到刚才到OpenSSH的密码框中。

4. 启用GitHub pages；

5. 打开 用户名.github.io 查看页面。

四、自定义博客

4.1 简单配置

1. Hexo的文章在source/_posts下，我们可以看到hello-world.md文件，打开即可修改。
2. 网站的关键信息可以在_config.yml下修改；
3. 具体修改可以参考配置 | Hexo。

4.2. 配置主题

• 打开Themes | Hexo
• 注意：Hexo 5.x相对4.x是一次破坏性升级，所以很多4.x下的主题在5.x中并不可用。
• 以xoxo主题为例：

git clone --depth 1 https://github.com/KevinOfNeu/hexo-theme-xoxo themes/xoxo
hexo config theme xoxo
hexo s