Hexo搭建网站并一键部署至GitHub

original_author2024-08-29

hexo搭建网站步骤以官网为准！！！

hexo官网文档：https://hexo.io/zh-cn/docs/setup

hexo如果还未安装，请参考hexo官网文档完成安装操作

一、Hexo建站

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

如果已经在目标目录(文件夹)下，可以省略<folder>

hexo init <folder>

新建完成后，指定文件夹的目录如下：

.
├── _config.yml   	
#网站的 配置 信息，您可以在此配置大部分的参数。

├── package.json	
#应用程序的信息。EJS, Stylus 和 Markdown 渲染引擎 已默认安装，您可以自由移除。

├── scaffolds	
#模版 文件夹。当您新建文章时，Hexo 会根据 scaffold 来创建文件。Hexo 的模板是指在新建的文章文件中默认填充的内容。例如，如果您修改 scaffold/post.md 中的 Front-matter 内容，那么每次新建一篇文章时都会包含这个修改。

├── source	
|   ├── _drafts
|   └── _posts
#资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

└── themes
#主题 文件夹。Hexo 会根据主题来生成静态页面。

二、在 GitHub Pages 上部署 Hexo

Hexo 提供了快速方便的一键部署功能，让您只需一条命令就能将网站部署到服务器上。

1、生成SSH密钥

设置帐号和名称

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

windows系统

打开Git-Bash，输入以下命令，然后一直回车和按【y】即可：

ssh-keygen -t rsa -C "GitHub注册的邮箱账号"

最后获取到的ssh认证在C:\Users\yourname\.ssh中

2.Linux系统

cd ~
ssh-keygen -t rsa -C "Github的注册邮箱帐号"

在.ssh目录会有两个文件id_rsa和id_rsa.pub,
接下来要将id_rsa.pub里面的所有内容添加到github里，即SSH keys里的Key，Title随便填，
然后Add SSH key

2、测试连接

通过SSH方式测试

ssh -T git@github.com

连接成功显示：

$ ssh -T git@github.com
The authenticity of host 'github.com (198.18.0.38)' can't be established.
ECDSA key fingerprint is SHA256:p2QAMXNIC1TJOttrVc98/R1BUFWu3/LiyKgUfQM.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added 'github.com,198.18.0.38' (ECDSA) to the list of known hosts.
Hi xxxx/xxxx.github.io! You've successfully authenticated, but GitHub does not provide shell access.

3、一键部署插件Git

1.安装 hexo-deployer-git

npm install hexo-deployer-git --save

2.修改**_config.yml**配置

deploy:
  type: git
  repo: # https://github.com/xxxx/xxxx.github.io.git   # 库（Repository）地址 
  branch: [branch]		# 分支名称   例：main

3、生成站点文件并推送至远程库。执行

 hexo clean && hexo deploy

参考