一文详解Hexo 博客搭建

💡 原文中文,约4200字,阅读约需10分钟。
📝

内容提要

本文介绍了如何通过Github Actions将Hexo博客部署到Github Pages,使用一个私有仓库存放源文件和一个公共仓库存放静态网页。内容涵盖环境准备、Token生成、Github Actions工作流配置及自定义域名设置等步骤。

🎯

关键要点

  • 本文介绍如何通过Github Actions将Hexo博客部署到Github Pages。

  • 使用两个仓库:一个私有仓库存放源文件,一个公共仓库存放静态网页。

  • Github Actions服务的用量:公共仓库免费,私有仓库有使用限制。

  • 安装并初始化Hexo环境,已有环境可跳过安装步骤。

  • 在Github上新建两个仓库,一个Private的blog_base,一个Public的username.github.io。

  • 生成Personal access tokens,至少包含repo权限,并配置给Github Action。

  • 修改_config.yml以设置推送地址,指向公共Github Pages仓库。

  • 配置Github Actions工作流,创建deploy.yml文件以自动化部署。

  • 配置Github Pages的来源分支,并推送以查看效果。

  • 设置.gitignore文件以排除不必要的文件。

  • 备份已有的Github Pages文件以防丢失。

  • 注册自定义域名并进行解析,配置Github Pages以使用自定义域名。

🔎

延伸解读

使用两个仓库的优势

本文提到使用一个私有仓库存放源文件和一个公共仓库存放静态网页,这种做法可以有效保护源文件的隐私,避免潜在的安全风险。对于希望保持内容私密的用户,这种方法尤为重要。

Github Actions的使用限制

虽然公共仓库的Github Actions服务是免费的,但私有仓库的使用会受到限制。用户在选择仓库类型时,应考虑到自己的需求和预算,确保能够满足博客的更新频率和自动化部署的需求。

注意Node.js版本兼容性

在配置Github Actions时,需注意Node.js的版本选择。旧版Hexo可能与新版本的Node.js不兼容,导致生成失败。因此,用户应根据自己的Hexo版本选择合适的Node.js版本,以确保顺利生成静态文件。

自定义域名配置的细节

注册自定义域名后,用户需要在Github Pages的设置中进行相应配置,并确保域名解析正确。特别是CNAME文件的创建和HTTPS的强制使用,都是确保网站正常访问的重要步骤。

延伸问答

如何通过Github Actions将Hexo博客部署到Github Pages?

首先需要在Github上创建两个仓库,一个私有仓库用于存放源文件,另一个公共仓库用于存放静态网页。然后生成Personal access tokens并配置给Github Action,修改_config.yml以设置推送地址,最后配置Github Actions工作流以自动化部署。

Github Actions的使用限制是什么?

公共仓库可以免费使用Github Actions,但私有仓库会有使用限制,具体取决于账户的类型和使用情况。

如何生成Personal access tokens?

在Github上,点击头像 -> Settings -> Developer Settings -> Personal access tokens,选择Generate new token并勾选repo和workflow权限,然后记录生成的token。

如何配置Github Actions的工作流?

在blog_base目录下创建.github文件夹,再在其中创建workflows文件夹,最后创建deploy.yml文件,配置相应的步骤以实现自动化部署。

如何设置自定义域名?

在Github Pages仓库的Settings中配置Custom domain,并在域名解析中设置CNAME记录和A记录,最后在根目录创建CNAME文件,内容为自定义域名。

在Hexo中如何排除不必要的文件?

可以通过设置.gitignore文件来排除不必要的文件,如node_modules、public目录和系统生成的垃圾文件等。

🏷️

标签

➡️

继续阅读