安装环境

链接Github

1
2
git config --global user.name "GitHub 用户名"
git config --global user.email "GitHub 邮箱"

创建SSH密钥

1
ssh-keygen -t rsa -C "GitHub 邮箱"

添加密匙

进入 [C:\Users\用户名.ssh] 目录(要勾选显示“隐藏的项目”),用记事本打开公钥 id_rsa.pub 文件并复制里面的内容。

登陆 GitHub ,进入 Settings 页面,选择左边栏的 SSH and GPG keys,点击 New SSH key。

Title 随便取个名字,粘贴复制的 id_rsa.pub 内容到 Key 中,点击 Add SSH key 完成添加。

验证连接

打开 Git Bash,输入 ssh -T git@github.com 出现 “Are you sure……”,输入 yes 回车确认。

创建仓库

填写仓库名,格式必须为<用户名>.github.io,然后点击Create repository

安装 Hexo

使用 npm 一键安装 Hexo 博客程序

1
npm install -g hexo-cli

Mac 用户需要管理员权限(sudo)

1
sudo npm install -g hexo-cli

初始化hexo

创建blog文件夹
进入并输入以下命令完成初始化

1
2
hexo init      # 初始化
npm install # 安装组件

启动本地服务器进行预览

1
2
hexo g   # 生成页面
hexo s # 启动预览,访问 http://localhost:4000

使用

创建新页面

1
hexo new [layout] <title>

写作

source/_posts目录下创建markdown文章

了解更多:https://hexo.io/zh-cn/docs/writing

修改主题

本博客主题:hexo-theme-Anatole2,文档在README.md
官方主题:https://hexo.io/themes/

部署 Hexo 到 GitHub Pages

安装 hexo-deployer-git

1
npm install hexo-deployer-git --save

然后修改 _config.yml 文件末尾的 Deployment 部分,修改成如下:

1
2
3
4
deploy:
type: 'git'
repo: 'https://github.com/用户名/用户名.github.io.git'
branch: master

完成后运行hexo d将网站上传部署到 GitHub Pages。

常见问题

  1. npm 下载速度慢
    临时更换方法:在 npm 安装命令后面加上:
    1
    --registry https://registry.npm.taobao.org