环境准备

准备环境:git、node.js 推荐使用 Homebrew

安装 brew

Homebrew官网

但是推荐下面安装脚本:

安装脚本

1
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

卸载脚本

1
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh)"

常见问题

安装node

1
brew install node

确认是否安装完成

1
2
node -v
npm -v

这些命令将分别显示安装的 Node.js 版本和 npm 版本

安装 Git

官网 Git 下载对应系统版本的安装包或根据官网指引安装。安装完成后在终端输入 git -v,如果能正确显示 git 版本说明安装成功。也可以通过 brew 安装 git

配置 Git

1
2
3
4
5
6
7
8
#1. 设置用户名(可以用你github账号用户名)
git config --global user.name '你的用户名'

#2. 设置邮箱 (可以用你github账号邮箱)
git config --global user.email 'xxxx@163.com'

#3. 查看配置项(可以检查下前面配置号的用户名和邮箱)
git config --list

配置 Github - SSH 链接

git 基础配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
#1. 设置用户名(可以用你github账号用户名)
git config --global user.name '你的用户名'

#2. 设置邮箱 (可以用你github账号邮箱)
git config --global user.email 'xxxx@163.com'

#3. 查看配置项(可以检查下前面配置号的用户名和邮箱)
git config --list

#4. 生成ssh密钥文件
ssh-keygen -t rsa -C "xxxx@163.com"
# (1)期间会让你确认密钥文件生成在哪里?(直接回车就是默认路径 C:\Users\用户名\.ssh)
# (2)会让你输入密码(这个密码是每次链接 github 需要输入的密码,可以直接回车,表示不设置密码)
# (3)如果是 mac 电脑,可以通过 cat ~/.ssh/id_rsa.pub 查看

登陆 Github 找到 Setting 页面,选择左边的 点击左边的“SSH and GPG keys”,然后点击右边的“New SSH Key” 如下图所示
New SSH key

把刚才复制的公钥贴在 Key 的框框里面,同时在 Title 的框框里给这个公钥取一个名字,方便和其他的公钥区分,然后点击 Add SSH key 按钮即可添加成功

Add new SSH key

验证是否配置成功

1
2
ssh -T git@github.com
# Attempts to ssh to GitHub

您可能会看到类似如下的警告:

1
2
3
> The authenticity of host 'github.com (IP ADDRESS)' can't be established.
> ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU.
> Are you sure you want to continue connecting (yes/no)?

验证所看到消息中的指纹是否与 GitHub 的公钥指纹匹配。 如果是,则键入 yes

1
2
> Hi USERNAME! You've successfully authenticated, but GitHub does not
> provide shell access.

这块内容也可以参考 Github 官方教程

Github Pages

使用个人 GitHub 创建仓库,并配置 GitHub Pages

注意:此仓库用于存放个人博客页面,仓库名必须使用 <GitHub用户名>.github.io 格式

GitHub Pages

安装 Hexo

可以参考 Hexo官网安装教程 进行详细步骤操作

1
npm install -g hexo-cli

自选合适的目录,新建文件夹 <folder>

1
2
3
cd <folder>
hexo init
npm install

hexo 常用命令

1
2
3
4
5
hexo n "我的博客" == hexo new "我的博客" #新建文章
hexo g == hexo generate #生成静态文件
hexo s == hexo server #启动服务本地预览
hexo d == hexo deploy #部署
hexo clean #清除缓存 网页正常情况下可以忽略此条命令

安装主题

目前站点用的主题是 fluid 可以按照官方教程安装即可

相关主题配置留意查看官方文档以及配置文件注释信息 _config.fluid.yml

修改配置

如果已经新建了 Gtihub Pages 打开 _config.yml 配置文件添加如下内容

1
2
3
4
deploy: 
type: git
repository: git@github.com:lanyecheng/lanyecheng.github.io.git
branch: main

安装插件

一键部署官方文档

1
npm install hexo-deployer-git --save

总结

后续大概的流程就是

  • hexo n xxx
  • hexo clean
  • hexo g
  • hexo s
  • hexo d