如何在academicpages.github.io添加出版物并解决不显示问题、查找模板文档

• 检查文件前置YAML元数据格式：该模板要求所有出版物类markdown文件开头必须包含规范的YAML配置段，必填字段包括layout: publication、title、authors、publication_types、date、publication等，字段缺失、格式错误（比如缩进不对、冒号后没加空格）都会导致Jekyll渲染时跳过该文件，不会在站点生成对应条目。
• 确认文件名及后缀合规：你当前的文件名结构符合要求，需要注意检查是否存在隐藏后缀（比如实际是.md.txt而非.md）、文件名是否包含中文或特殊符号，这些问题都会导致文件无法被正确识别。
• 查看GitHub Pages构建状态：进入你的仓库的Actions标签页，查看最近的提交对应的构建任务是否成功，若构建失败说明你的代码存在语法错误，新提交的内容不会同步到线上站点。
• 排查浏览器缓存问题：如果构建显示成功但站点没有更新，大概率是CDN或浏览器缓存导致，使用强制刷新快捷键清除当前页面缓存后再查看即可。

该模板自带完整的官方说明文档，存放在原模板仓库的README文件以及docs目录下，你fork的仓库内也同步了这些内容，直接在本地或仓库内查看对应文件就能获取完整的配置、内容编辑、功能自定义教程。

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