GitHub Pages部署portfolYOU模板失败：缺失highlight.html文件求助

一、未修改_config.yml时的跳转/交互报错 #

• 核心原因：本地Jekyll运行路径与GitHub Pages部署路径的相对引用不匹配
• 修复步骤：
  1. 打开_config.yml，确认url设为https://evklo.github.io，baseurl设为空字符串（baseurl: ""）
  2. 检查所有页面内的链接、资源引用，确保都使用{{ site.baseurl }}前缀，比如跳转链接需写成{{ site.baseurl }}/about/而非直接/about/

二、修改_config.yml后构建失败（缺失elements/highlight.html） #

• 核心原因：要么误删了模板依赖的高亮组件文件，要么修改配置时启用了未对应组件的高亮功能
• 修复二选一：
  1. 保留高亮功能：从portfolYOU原模板仓库复制_includes/elements/highlight.html文件到你的仓库对应目录；同时确保_config.yml的高亮配置正确：

     markdown: kramdown
     highlighter: rouge
     kramdown:
       syntax_highlighter: rouge
       syntax_highlighter_opts:
         block:
           line_numbers: true
     

  2. 禁用高亮功能：在_config.yml中设置highlighter: none，避免Jekyll尝试加载缺失的高亮组件

三、收尾检查 #

• 确认仓库Pages设置：进入仓库「Settings」→「Pages」，部署源选择main分支的/root目录
• 手动触发重新构建：在仓库「Actions」页面找到最新构建任务，点击「Re-run jobs」清除缓存
• 同步本地与远程仓库：执行git pull确保本地文件与远程完全一致，再重新推送变更

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