Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

中文 LaTeX 论文模板

可复用的中文 LaTeX 论文写作工作区。每次以本文件夹为基础新建 VS Code 会话即可开始一篇全新论文。

快速开始

  1. 在 VS Code 中打开此文件夹。
  2. 编辑 main.tex,将 TODO 占位内容替换为你的论文内容。
  3. 运行构建任务 Build LaTeX PDFCtrl+Shift+B),或双击 build.bat
  4. 编译成功后自动打开 main.pdf 预览。

与 Copilot 协作生成论文

你可以直接告诉 Copilot 你的论文主题和要求,让 AI 帮你生成 main.tex

"帮我写一篇关于 XXX 的中文论文,要求包含摘要、引言、方法论、结果分析、结论和参考文献"

Copilot 会按以下工作流处理:

  1. 确定论文标题、摘要、章节结构、参考文献格式、是否需要图片或公式
  2. 生成完整的 main.tex 内容(包含中文环境、数学公式、图表等元素)
  3. 若主题明确就直接围绕主题写正文;若主题不明确则先给出默认论文框架

本模板内置 6 个 AI 协作 Skill,覆盖论文写作全流程(详见下方 AI 协作 Skill 套件)。

技术约束(已内建在模板中):

  • 中文排版使用 ctex 宏包,适合课程论文 / 学术论文版式
  • 使用 xelatex 编译两遍(不使用 latexmk),确保交叉引用和目录稳定
  • 图片占位使用 \IfFileExists 处理缺失图片,避免编译失败
  • 编译脚本 build.bat 执行两遍 xelatex,成功后自动打开 PDF,失败时提示错误
  • 输出为可直接保存的完整文件,不添加无关的项目结构或说明

编译方式

方式 操作
VS Code 任务 Ctrl+Shift+B → 选择 Build LaTeX PDF
命令行 双击根目录的 build.bat
清理辅助文件 Ctrl+Shift+PTasks: Run TaskClean LaTeX Aux Files

编译引擎为 XeLaTeX(基于 MiKTeX 或 TeX Live),自动执行两次编译以生成目录和交叉引用。

前置要求:使用前请确保已安装 MiKTeX 或 TeX Live,且 xelatex 已加入系统 PATH。可在命令行运行 where xelatex 验证。若未找到,build.bat 会自动提示并退出。

文件结构

论文/
├── main.tex              ← 论文主文件(从这里开始写)
├── build.bat             ← 一键编译脚本
├── restore.ps1           ← 恢复干净模板脚本(备选方案)
├── .gitignore            ← 排除编译产物
├── README.md             ← 本文件
├── .git/                 ← Git 仓库(隐藏)
├── _template/            ← 干净模板备份(请勿修改)
│   └── main.tex
├── .github/
│   └── copilot/
│       └── skills/       ← AI 协作 Skill 套件(6 个)
│           ├── paper-planner/       ← 大纲规划
│           ├── lit-review-helper/   ← 文献综述
│           ├── section-writer/      ← 逐节写作
│           ├── bib-curator/         ← 参考文献管理
│           ├── latex-review/        ← 论文审查
│           └── pre-submit-guard/    ← 投稿前检查
├── images/               ← 图片目录
│   └── example-image.tex ← TikZ 绘图示例(可选参考)
└── .vscode/
    ├── settings.json     ← LaTeX Workshop 配置
    └── tasks.json        ─ VS Code 构建任务

版本控制(Git)

本模板已初始化 Git 仓库并提交了干净模板的初始快照。

常用命令

场景 命令
开始新论文 git checkout . — 丢弃所有修改,回到初始模板
保存当前进度 git add -A && git commit -m "写了某节"
查看修改记录 git log --oneline
查看改了什么 git diff

开始新论文

写完一篇论文后,想写下一篇时:

git checkout .         # 丢弃所有修改,回到初始模板
git clean -fd          # 删除 untracked 文件(如旧图片)

注意git checkout . 会同时回退 .vscode/settings.json.vscode/tasks.json 中的编译配置。如果你修改了这些文件(例如调整了 LaTeX Workshop 设置),恢复后需要重新配置。

或对 Copilot 说 "恢复干净模板",我会帮你执行。

备选方案(无 Git 时)

.\restore.ps1

_template/main.tex 恢复空白模板并清理编译产物。

模板功能

main.tex 预置了以下开箱即用的配置:

  • 中文支持ctex 宏包,章节编号为一、二、...格式
  • 数学环境amsmath / amssymb / amsthm
  • 定理环境:定义(definition)、定理(theorem),可按需添加引理、命题等
  • 插图graphicx,图片放入 images/ 后用 \includegraphics 引用
  • 页眉页脚fancyhdr,页眉显示论文标题,页脚显示页码
  • 超链接hyperref,目录和引用可点击跳转
  • 页面布局:A4 纸,2.5cm 页边距,1.5 倍行距

写新论文的步骤

  1. 运行 git checkout ..\restore.ps1 清理上次残留
  2. 编辑 main.tex(或让 Copilot 帮你生成内容),修改标题、摘要、关键词、章节内容、参考文献
  3. 将论文用到的图片放入 images/ 目录
  4. 编译并检查 PDF 输出
  5. 反复修改、编译,直至完成

图片使用

引用外部图片

将 PNG、JPG、PDF 图片放入 images/ 目录后引用:

% 单张图片
\begin{figure}[htbp]
  \centering
  \includegraphics[width=0.7\linewidth]{images/your-image.png}
  \caption{图片标题}
  \label{fig:your-label}
\end{figure}

% 并排两张图片
\begin{figure}[htbp]
  \centering
  \begin{minipage}{0.48\linewidth}
    \centering
    \includegraphics[width=\linewidth]{images/fig-a.pdf}
    \caption{子图 A}
  \end{minipage}
  \hfill
  \begin{minipage}{0.48\linewidth}
    \centering
    \includegraphics[width=\linewidth]{images/fig-b.pdf}
    \caption{子图 B}
  \end{minipage}
\end{figure}

使用 TikZ 绘制矢量图(推荐)

images/ 目录提供了 4 个可直接编译的 TikZ 示例:

文件 类型 适用场景
example-function-plot.tex 函数曲线图 展示数学函数、衰减曲线、信号波形
example-bar-chart.tex 对比柱状图 实验对比、算法性能比较
example-flowchart.tex 方法流程图 算法流程、系统架构、实验步骤
example-neural-net.tex 网络结构图 神经网络、模型架构示意

编译 TikZ 图为 PDF:

cd images
xelatex example-function-plot.tex   # 生成 example-function-plot.pdf
xelatex example-bar-chart.tex
xelatex example-flowchart.tex
xelatex example-neural-net.tex

编译后在 main.tex 中引用:

\includegraphics[width=0.7\linewidth]{images/example-function-plot.pdf}

修改 TikZ 图: 编辑 .tex 文件中的颜色、数据、标签等,重新编译即可更新 PDF。

直接嵌入正文(无需单独编译):main.tex 导言区添加 \usepackage{tikz},然后将 \begin{tikzpicture}...\end{tikzpicture} 代码直接放入 figure 环境中。

图片格式建议

格式 适用场景 特点
PDF TikZ 导出、矢量图表 矢量无损,推荐首选
PNG 截图、渲染结果 无损压缩,适合位图
JPG 照片、自然图像 有损压缩,文件小
SVG 需先转 PDF LaTeX 不直接支持

提示:论文插图优先使用矢量格式(PDF/TikZ),避免放大后模糊。位图分辨率建议 ≥ 300 dpi。

自定义

  • 添加宏包:在 main.tex 导言区添加 \usepackage{...}
  • 修改页边距:调整 \geometry{...} 参数
  • 修改行距:调整 \setstretch{...}
  • 添加定理环境:取消注释 main.tex 中对应的 \newtheorem

注意事项

  • 文件名和路径中避免使用中文和空格,防止编译问题
  • 首次编译若缺少宏包,MiKTeX 会提示自动安装
  • PDF 查看器已设为外部打开,避免 VS Code 内置 PDF 视图锁定文件

AI 协作 Skill 套件

本模板内置 6 个 VS Code Copilot Skill(.github/copilot/skills/),覆盖论文写作全流程。在 Copilot Chat 中输入触发词即可调用,无需额外安装。

graph LR
    A["📐 paper-planner<br/>大纲规划"] --> B["📚 lit-review-helper<br/>文献综述"]
    B --> C["✍️ section-writer<br/>逐节写作"]
    C --> D["🔍 latex-review<br/>审查排版"]
    D --> E["🛡️ pre-submit-guard<br/>投稿前检查"]
    F["📎 bib-curator<br/>文献管理"] -.-> B
    F -.-> C
    F -.-> E
Loading

📐 paper-planner — 论文大纲与论证结构规划

项目 说明
触发词 规划论文、论文大纲、章节结构、论证结构、研究框架、帮我规划
功能 根据主题生成多级章节大纲、检查论证链完整性(循环论证/跳跃推理/缺失章节)、输出可填入 main.tex\section{} 骨架
示例 "帮我规划一篇关于深度学习图像分割的论文结构"

📚 lit-review-helper — 文献检索与综述撰写

项目 说明
触发词 文献综述、找文献、literature review、文献检索、综述框架、相关研究
功能 多源检索策略指导(arXiv/CNKI/Semantic Scholar)、文献按方法/时间线聚类、生成综述骨架、检查是否有遗漏方向
示例 "帮我找 Transformer 在时间序列预测方向的文献,梳理成综述"

✍️ section-writer — 逐节学术写作助手

项目 说明
触发词 写这一节、展开段落、润色这段、写摘要、改写这段、学术润色
功能 要点→段落展开、段落润色(口语→学术)、中英文摘要编写/翻译、章节过渡句生成
示例 "帮我把引言这段润色得更学术一些"

📎 bib-curator — 参考文献策展与管理

项目 说明
触发词 参考文献、引用格式、bib、文献条目、GB/T 7714、补全文献、检查引用
功能 DOI/arXiv ID → GB/T 7714 条目、交叉比对幽灵引用与孤立条目、格式校验(标点/字段完整性)、生成 .bib 文件
示例 "帮我把 10.1038/nature12373 转成 GB/T 7714 参考文献格式"

🔍 latex-review — LaTeX 论文审查与交付

项目 说明
触发词 检查论文、审查论文、论文查错、LaTeX 审查、review paper
功能 学术性错误排查(逻辑漏洞/循环论证)、排版格式检查(编译错误/标点/图片路径)、改进建议、审查后修改并交付 PDF
示例 "帮我全面检查一下这篇论文"

🛡️ pre-submit-guard — 投稿前合规检查

项目 说明
触发词 投稿检查、提交前检查、格式检查、submission check、最终检查、合规检查
功能 编译验证(Error/Warning 解析)、格式合规(页数/行距/标题编号)、引用完整性、图表路径检查,只检查不修改
示例 "投稿前帮我跑一次完整检查"

典型协作流程

1. 说"帮我规划一篇关于 XXX 的论文"     → paper-planner 生成章节骨架
2. 说"帮我找这个方向的文献"            → lit-review-helper 检索 + 聚类
3. 说"帮我把引言这一节展开写"           → section-writer 逐节成稿
4. 说"帮我生成参考文献"                → bib-curator 格式化引用
5. 说"帮我全面检查论文"                → latex-review 审查 + 修改
6. 说"投稿前帮我跑一次检查"            → pre-submit-guard 最终把关

About

用来和ai一起搞论文的基础构建

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages