Paper Pages 技能文档（仓库定制版）
本文件基于当前仓库 paper-pages 的真实结构总结，不是通用模板。
1. 目录与架构现状
当前论文页面目录：
- •
paper-pages/SVDecode/index.html - •
paper-pages/cpguard/index.html - •
paper-pages/cpguardp/index.html - •
paper-pages/cp-uniguard/index.html - •
paper-pages/InfoReasoner/index.html
样式分层：
- •全站基础：
../../styles.css - •论文页公共层：
../paper-common.css - •单页差异层：每个页面自己的内联
<style>
结论：目前是“公共样式 + 单页覆盖”的混合模式，符合该仓库现状。
2. 新建论文页的标准骨架（本仓库）
新页面建议放在：
- •
paper-pages/<paper-folder>/index.html
<head> 最少应包含：
- •
../../styles.css - •
../paper-common.css - •Font Awesome
- •favicon
正文建议顺序（与仓库主流页面一致）：
- •Header（标题、按钮、作者、单位）
- •Abstract
- •Method
- •Figures
- •Formulas（如有）
- •Results tables
- •Case study（如有）
- •Conclusion
- •BibTeX
- •Disclaimer（放最后）
3. 可复用组件（优先复用，少造轮子）
优先使用 paper-common.css 中已有类：
- •
.paper-header - •
.paper-title - •
.paper-buttons/.paper-btn - •
.authors/.affiliations - •
.paper-section - •
.paper-abstract - •
.highlight-box - •
.image-container/.image-caption - •
.contribution-list
表格建议继续使用：
- •
.table-container（横向滚动） - •
.paper-table
4. 图、公式、表格的实战规则
4.1 图（最容易出问题）
- •建议统一放：
paper-pages/<paper-folder>/fig/ - •页面中使用相对路径：
fig/xxx.png - •文件名和大小写必须严格一致（GitHub Pages 对大小写敏感）
- •页面展示风格默认使用“裸图”：
- •不加卡片背景
- •不加边框
- •不加圆角
- •不额外外层框包裹（除非用户明确要求）
- •每张图必须配“详细解释”（不能只写 Figure X）：
- •图在讲什么（任务/流程/对比对象）
- •关键元素含义（颜色、箭头、坐标轴、指标）
- •读图结论（从图中得到的核心发现）
- •与正文关系（该图支持哪一段主张）
4.2 公式（MathJax）
- •有公式就在
<head>配置 MathJax，再defer加载脚本 - •使用
$$...$$块公式 - •公式容器建议带横向滚动（避免移动端溢出）
- •文案策略默认“少公式”：
- •优先文字解释
- •非必要推导不放页面（细节指向论文原文）
4.3 表格
- •大表必须套
.table-container - •第一列左对齐，其余列居中
- •“我们的方法”行可加浅色高亮，保持可读性
5. publications.json 联动规范
新增论文页后，必须同步更新 data/publications.json 的 Project 标签：
- •链接格式：
paper-pages/<paper-folder>/index.html - •
paper-folder名字与实际目录完全一致（包括大小写）
这是首页“Project”能否正常打开的关键点。
6. 本仓库已踩坑（重点）
- •
路径大小写不一致会导致线上 404
data/publications.json中链接与paper-pages实际文件夹名必须逐字符一致。 - •
图文件缺失会直接破图
页面里引用了fig/*.png，仓库里若没提交同名文件，页面不会显示。 - •
内联 SVG 特殊字符未转义会整图失效
例如&必须写成&。 - •
单页样式重复定义较多
导航、下拉等规则在多个页面重复，改样式时要同步检查同类页面。 - •
不要使用未定义 CSS 变量
使用var(--xxx)前先确认在styles.css已定义。
7. 上线前检查清单（必跑）
- • 页面能打开，导航正常
- • PDF / Code / Project / BibTeX 链接全部可用
- • 所有图片加载正常（无破图）
- • 每张图都有详细 caption/解释（含图意+结论）
- • MathJax 公式渲染正常（如适用）
- • 大表在手机上可横向滚动
- • 作者与单位信息完整
- • 免责声明在页面末尾
- •
data/publications.json的 Project 链接路径正确
8. InfoReasoner 当前说明（按现状）
当前页面：
- •
paper-pages/InfoReasoner/index.html
若使用论文原图，默认引用位置应为：
- •
paper-pages/InfoReasoner/fig/overview.png - •
paper-pages/InfoReasoner/fig/em_score_mean_comparison.png - •
paper-pages/InfoReasoner/fig/all_score_infogain_iroutput_comparison.png - •
paper-pages/InfoReasoner/fig/entropy_loss_comparison.png - •
paper-pages/InfoReasoner/fig/response_length_comparison.png - •
paper-pages/InfoReasoner/fig/boxplot_comparison.png - •
paper-pages/InfoReasoner/fig/dict_lineplot.png - •
paper-pages/InfoReasoner/fig/case_study.png（可选）
如需改目录名或改为 assets/，请同时批量更新 HTML 路径，避免混用。
9. 已确认的页面规范（本轮沉淀）
以下规范已在 InfoReasoner 页面实践并确认：
- •
图不加框
图像不使用卡片背景/边框/圆角，直接展示论文图。 - •
图要有详细解释
每张图至少给出：图意、关键元素说明、读图结论、与正文关系。 - •
公式从简
页面仅保留最关键的公式，其余改为可读性更高的文字说明。 - •
免责声明放最后
Disclaimer 固定放在页面末尾（通常在 BibTeX 后），不放在页首。 - •
作者信息详细化
作者使用单位上标，单位映射与通讯作者信息完整展示。 - •
细节以原文为准
页面作为导读，不替代论文原文；定义、推导、实验细节、结论以论文为准。