使用Hugo LoveIt主题搭建GitHub Pages遇Jekyll构建失败求助

核心问题：GitHub Pages默认Jekyll构建与Hugo语法冲突 #

本地用Hugo生成静态文件正常，但推送GitHub后，GitHub Pages默认触发Jekyll自动构建，Hugo模板里的特殊语法（比如{{</* ... */}}）被Jekyll误判为自身Liquid模板语法，导致解析失败。

步骤1：禁用Jekyll自动构建 #

在你的GitHub仓库根目录创建空的.nojekyll文件，推送后GitHub Pages会跳过Jekyll构建流程，直接部署你上传的静态文件。

步骤2：推送正确的静态文件 #

本地执行hugo命令生成完整静态网站到public目录，将该目录下所有文件推送到GitHub仓库的Pages源分支（通常是main或gh-pages，以你仓库的Pages设置为准）。

步骤3：规范管理LoveIt主题 #

不要直接复制整个主题仓库到项目中，用Git子模块管理更合理：

# 在Hugo项目根目录执行
git submodule add https://github.com/dillonzq/LoveIt.git themes/LoveIt

主题代码会作为子模块独立存在，不会占用主仓库空间，后续更新主题仅需拉取子模块最新代码即可。

内容的提问来源于stack exchange，提问作者xZhiLx