GitHub上部署Hexo博客

Hexo博客
Hexo博客
发布日期:   2023-10-20

1.安装Node.js和Git：

Hexo是基于Node.js的，所以你需要在你的电脑上安装Node.js和npm(Node.js包管理器)。你也需要安装Git，因为GitHub Pages是基于Git的。

在使用Git与GitHub交互之前，你需要在本地机器上配置Git，并且在GitHub上创建一个账户。

以下是步骤：

  1. 安装Git

    首先，你需要在本地计算机上安装Git。不同的操作系统安装Git的方法有所不同，你可以访问Git的官方下载页面（https://git-scm.com/downloads ）进行安装。

  2. 配置Git

    安装完Git之后，你需要配置你的用户名和邮箱地址，因为每次Git提交都会使用这些信息。打开命令行或终端，然后输入以下命令：

    git config --global user.name "root"
    git config --global user.email "root@qq.com"

  3. 创建GitHub账户

    访问GitHub官网（https://github.com/ ）并注册一个新账户。

  4. 在GitHub上创建新仓库

    登录到你的GitHub账户，然后在右上角点击”+”按钮，选择”New repository”，为仓库命名为 <yourusername>.github.io，然后点击”Create repository”。这里<yourusername>应该是你的GitHub用户名。

  5. 连接本地Git与GitHub

    在你的本地计算机上，你需要生成一个SSH密钥对，并将公钥添加到你的GitHub账户中。首先，在终端中输入以下命令生成新的SSH密钥对：

    ssh-keygen -t ed25519 -C "root@qq.com"

    在提示你输入文件位置时，直接按Enter接受默认位置。然后在提示你输入密码时，可以选择输入一个密码或者直接按Enter跳过。

    将ssh命令生成到指定位置
ssh-keygen -t rsa -C "root@qq.com" -f C:\\Users\\dadam\\.ssh\\id_rsa

    然后在终端中输入以下命令，将SSH公钥复制到剪贴板：

    clip < ~/.ssh/id_ed25519.pub

    接下来，登录到你的GitHub账户，点击右上角的头像，然后选择”Settings”。在左侧菜单中选择”SSH and GPG keys”，然后点击”New SSH key”，在”Title”中输入一个描述，然后在”Key”中粘贴你的公钥，然后点击”Add SSH key”。

    最后，你可以测试你的SSH连接。在终端中输入以下命令：

    ssh -T git@github.com

    如果一切配置正确，你应该会看到一条消息说你已经成功连接到GitHub。

现在你已经完成了Git和GitHub的基本设置，可以开始使用Git来管理你的项目，并且将你的项目推送到GitHub上了。

2.安装Hexo：

打开命令行窗口，输入以下命令来全局安装Hexo：

npm install -g hexo-cli

3.创建一个Hexo项目：

在你想要创建博客的地方，输入以下命令：

hexo init blog
cd blog
npm install

这将在myblog文件夹中创建一个新的Hexo项目。

4.生成静态文件：

使用以下命令生成静态文件：

hexo g

5.创建GitHub仓库：

在GitHub上创建一个新的仓库，仓库名应该为<yourusername>.github.io，其中<yourusername>应该是你的GitHub用户名。

启用 GitHub Pages 功能

  1. 打开您的 GitHub 仓库页面。
  2. 点击仓库页面上方的 “Settings”（设置）选项卡。
  3. 在设置页面的左侧菜单中，向下滚动找到 “Pages”（页面）选项。
  4. 在 “Source”（源）部分，您可以选择用于发布 GitHub Pages 的源代码。通常，选择 “main” 或 “master” 分支作为源。
  5. 选择正确的分支作为源后，点击 “Save”（保存）按钮。

GitHub 将会自动保存您的选择，并在几秒钟内开始构建和部署您的 GitHub Pages 网站。构建完成后，您将在设置页面的 “Pages” 部分看到您的 GitHub Pages 网站的链接。您可以单击链接访问您的网站。

6.安装部署插件：

你需要安装一个Hexo插件来帮助你将你的网站部署到GitHub Pages上。你可以使用以下命令来安装这个插件：

npm install hexo-deployer-git --save

7.配置部署插件：

打开你Hexo项目中的_config.yml文件，找到deploy部分，将其修改为以下内容：

deploy:
  type: git
  repo: git@github.com:<yourusername>/<yourusername>.github.io.git
  branch: main

8.部署你的网站：

hexo d

9.GitHub Pages 未部署成功

需要去仓库的action里添加jekyll-gh-pages.yml文件并保存，需要手动添加。

Hexo博客
  目录