Thesis4SWUFE

西南财经大学本科毕业论文 LaTeX 模板。

1. 项目目标

本项目提供一个可直接编译的 SWUFE 本科论文模板，重点覆盖：

• 论文封面与声明页
• 中英文摘要
• 目录与章节标题格式
• 正文字体、页边距、行距与页码样式

2. 当前已实现功能（对应 swufe.cls）

2.1 文档类与编译引擎

• 文档类：swufe（继承 report）。
• 编译引擎：仅支持 XeLaTeX 或 LuaLaTeX，若使用 pdfLaTeX 会报错。
• 可选项：
  • cover=true：启用封面、声明页、封底。
  • cover=false：不启用上述页面（默认）。

2.2 字体与版式

• 中文默认字体：宋体（SimSun），并配置黑体、华文中宋、华文仿宋族。
• 英文字体：Times New Roman （times/timesbd/timesi/timesbi）。
• 字体文件从 fonts/ 目录加载。
• 版式设置：
  • 纸张：A4
  • 页边距：3cm
  • 行距：1.5

2.3 标题与目录样式

• chapter：居中、二号、华文中宋、加粗，编号格式
• section：黑体、小三
• subsection：黑体、四号
• 自定义目录页标题样式与章节/小节引导点格式（titletoc）。

2.4 前后置页面

• \makecover：生成本科毕业论文封面。
• \makestatement：生成“原创性及知识产权声明”页。
• \makebackcover：插入 logo/back.pdf 作为封底。
• 当启用 cover=true 时：
  • 文档开始自动插入封面和声明页；
  • 文档结束自动插入封底。

2.5 元信息命令

可在导言区设置以下字段（用于封面）：

• 论文题目\title{...}
• 论文作者\author{...}
• 所属学院\school{...}
• 所在专业\major{...}
• 学号\studentid{...}
• 年级\grade{...}
• 指导教师\advisor{...}
• 日期\date{...}（默认可用 \today，格式为“YYYY 年 M 月”）

2.6 摘要环境

• 中文摘要环境：cnabstract
• 英文摘要环境：enabstract
• 关键词命令：
  • \cnkeywords{...}
  • \enkeywords{...}
• 两类摘要会自动加入目录。

2.7 页码

• 页脚页码样式已重定义为居中、小五号数字（plain 页眉页脚风格）。

2.8 图表与浮动体格式（已实现）

• 图题与表题样式：
  • 图名为“图”，表名为“表”。
  • 标题字体为小四黑体（\zihao{-4}\heiti）。
  • 标题居中，编号与标题文字间使用空格分隔。
  • 标题上下间距为 0.5\baselineskip。
• 图表编号：
  • 图编号：\thechapter-\arabic{figure}（例如“图 2-1”）。
  • 表编号：\thechapter-\arabic{table}（例如“表 2-1”）。
• 图表内容样式：
  • 浮动体（figure、table）内容默认五号、单倍行距、居中。
  • tabular、tabularx、longtable 内文字为五号，且 \arraystretch=1。
• 浮动参数：
  • figure/table 的标准可选参数（如 [!htbp]）可正常使用。

2.9 数学环境、编号与交叉引用（已实现）

• 已加载：amsmath、amsthm、hyperref、cleveref。
• 超链接样式：hyperref 采用 hidelinks，默认不显示颜色和边框。
• 公式编号：按章编号（\numberwithin{equation}{chapter}）。
• 定理类环境：
  • theorem 按章编号；
  • lemma、proposition、corollary、definition 与 theorem 共用编号序列。
• 已配置中文交叉引用名：equation、theorem、definition、lemma、proposition、corollary、figure、table（可直接用 \cref）。

2.10 附录与致谢（已实现）

• 附录环境：swufeappendix
  • 自动切换到 \appendix；
  • 提供“附录”标题，并按“附录A/附录B ...”样式显示附录节标题。
• 致谢命令：\makeacknowledgements
  • 输出无编号“致谢”标题页（chapter*）。

3. 目录结构

.
├── main.tex
├── example.bib
├── swufe.cls
├── fonts/
│   ├── SimSun.ttc
│   ├── simhei.ttf
│   ├── STFANGSO.TTF
│   ├── STZHONGS.TTF
│   └── times*.ttf
├── logo/
│   ├── swufebanner.pdf
│   ├── swufelogo.pdf
│   └── back.pdf
└── README.md

4. 快速使用

4.1 最小示例

% 生成封面、原创性及知识产权声明和封底
\documentclass[cover=true]{swufe}
% 不生成，直接从摘要开始
\documentclass{swufe}

\usepackage{lipsum}

\title{论文标题}
\author{张三}
\school{数学学院}
\major{数学与应用数学}
\studentid{4xxxxxxx}
\grade{2023级}
\advisor{张某三}
\date{\today}

\begin{document}
\begin{cnabstract}
中文摘要正文。
\cnkeywords{关键词1；关键词2；关键词3}
\end{cnabstract}

\begin{enabstract}
English abstract text.
\enkeywords{keyword1; keyword2; keyword3}
\end{enabstract}

\tableofcontents
\maketitle
\chapter{引言}
\section{第一节}
\lipsum[1]
\end{document}

4.2 编译命令

latexmk -xelatex main.tex
# 或手动执行：xelatex main.tex -> biber main -> xelatex main.tex -> xelatex main.tex

4.3 数学、交叉引用、附录与致谢示例

\begin{align}
\label{eq:demo}
  a^2+b^2=c^2
\end{align}

\begin{definition}[环]
  定义内容
\end{definition}

\begin{theorem}[解的存在唯一性定理]
\label{thm:demo}
  定理内容
\end{theorem}

参见\cref{eq:demo,thm:demo}。

\begin{swufeappendix}
  \section{实验一}
  附录内容...
\end{swufeappendix}

\makeacknowledgements

5. 当前行为说明（使用前建议了解）

• cover 默认值为 false，如需封面/声明页/封底请显式设置 cover=true。
• cnabstract、enabstract、\maketitle 内部都调用了 \pagenumbering{arabic}，会触发页码重新计数。
• \maketitle 当前仅负责打印论文标题；封面信息主要由 \makecover 负责。
• 浮动参数建议使用 [!htbp]、[htbp] 等标准组合；[!] 不是完整位置参数。
• 参考文献使用 biblatex+biber，文末默认按“中文在前、外文在后”排序。

6. 参考文献（example.bib）

仓库已提供完整参考文献示例文件：example.bib，覆盖以下类型：

• 期刊 [J]（ex_article_journal）
• 图书 [M]（ex_book）
• 会议论文 [A] + 论文集 [C]（ex_inproceedings）
• 学位论文 [D]（ex_thesis）
• 报告 [R]（ex_report）
• 专利 [P]（ex_patent）
• 标准 [S]（ex_standard）
• 报纸 [N]（ex_newspaper）
• 电子文献：DB/OL、DB/MT、M/CD、CP/DK、J/OL、EB/OL （ex_db_ol、ex_db_mt、ex_book_cd、ex_cp_dk、ex_j_ol、ex_eb_ol）

模板当前参考文献行为（swufe.cls）：

• 文末排序：中文在前、外文在后。
• 会议论文：按 文章题目[A]. 论文集名[C], 出版项... 输出。
• 专利：按 专利所有者. 专利名称: 专利国别, 专利号[P]. 发布日期. 输出。
• 电子文献：按 作者. 题名[xx/yy]. URL, 日期. 严格输出。

最小调用示例：

\bibresource{example.bib}

... \cite{ex_article_journal}
... \cite{ex_inproceedings}
... \cite{ex_patent}
... \cite{ex_eb_ol}

\printrefs

7. LICENSE 版权声明

本作品采用 知识共享署名-非商业性使用 4.0 国际许可协议 （CC BY-NC 4.0）进行许可。作者：cherrchen，仅限非商业性使用。完整许可条款见 LICENSE。

8. 后续更新计划（待实现）

• 图表标题格式：统一图题/表题的位置、字号、编号格式及中英文标点规范。
• 参考文献格式：统一文内引用样式与参考文献表样式，明确 BibTeX/BibLaTeX 的推荐方案与示例。
• 致谢环境：定义 acknowledgements（或 thanks）环境，提供标准标题样式与目录收录规则。
• 公式与编号格式：统一行间公式编号格式（含按章编号规则）及常用数学排版间距。
• 数学定理环境：定义 theorem、lemma、proposition、corollary、definition 等环境及编号体系。
• 注释（脚注）格式：统一脚注编号、字号、行距及脚注分隔线样式。

9. Issue 与 PR 要求

9.1 提 Issue 前

• 先搜索是否已有相同或相近 Issue，避免重复提交。
• 使用最新仓库代码复现问题后再提交。
• 标题建议带类型前缀：[Bug]、[Feature]、[Docs]。

9.2 Issue 内容要求

• 运行环境：操作系统、TeX 发行版版本、编译引擎（xelatex）。
• 复现步骤：给出最小可复现示例（MWE）与操作步骤。
• 现象描述：分别写清“期望行为”和“实际行为”。
• 证据材料：附关键报错日志（如 .log）或结果截图。
• 影响范围：说明是否影响封面、摘要、目录、章节、公式、图表或参考文献。

9.3 提 PR 前

• 修复类改动请先关联对应 Issue。
• 保持单一目的：一个 PR 仅处理一类问题。
• 不混入无关重构、格式化或大范围排版调整。

9.4 PR 内容要求

• 变更说明：简述“改了什么、为什么改、影响哪些文件”。
• 验证方式：给出可复现的验证步骤或编译命令。
• 风险说明：若可能影响既有版式，请明确指出。
• 文档同步：新增命令/环境或行为变更时，同步更新 README.md。

9.5 合并前检查清单

• xelatex main.tex 可成功编译。
• 新增功能包含最小示例或必要说明。
• 不破坏现有封面、摘要、目录与章节编号行为。
• 不包含与本次改动无关的文件修改。

10. 模板编写参考

• 《西南财经大学本科生毕业论文（设计）撰写与印制规范》（2025 年版）
• 《本科生毕业论文撰写指南》（2021 年 11 月）