djtu-thesis-latex-template

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# 开箱即用的 LaTeX 通用笔记模板 (基于 DJTU)

本模板专为 **Visual Studio Code** 用户打造，基于 `ctexart` 文档类，提供了一套**零配置、模块化、自动化**的 LaTeX 写作环境。

## ✨ 核心亮点

1.  **项目目录极致整洁**：编译产生的 `.aux`, `.log` 等中间文件自动收纳至 `out/` 目录，根目录只保留源码和最终 PDF。
2.  **双向同步定位 (SyncTeX)**：支持 `Ctrl + Alt + J` (代码跳转 PDF) 和 `Double Click` (PDF 跳转代码)，写作校对更高效。

---

## 🛠️ 所需工具清单

在使用本模板之前，请确保您已安装以下工具：

### 1. Visual Studio Code
*   **简介**：VS Code 是一款轻量级但功能强大的源代码编辑器，支持丰富的扩展插件。
*   **下载地址**：[https://code.visualstudio.com/](https://code.visualstudio.com/)

### 2. TeX Live（推荐）
*   **简介**：TeX Live 是一个完整的 LaTeX 发行版，包含了编译 LaTeX 文档所需的所有工具和宏包。
*   **推荐理由**：
    *   ✅ **完整跨平台**：支持 Windows、macOS 和 Linux 系统
    *   ✅ **宏包强大**：内置数千个常用宏包，满足各类排版需求
    *   ✅ **更新齐全**：定期更新，保持与最新 LaTeX 标准同步
*   **下载地址**：
    *   **国外官网**：[https://www.tug.org/texlive/](https://www.tug.org/texlive/)
    *   **国内清华镜像源**（推荐，速度更快）：[https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/](https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/)

### 3. LaTeX Workshop 插件
*   **简介**：这是 VS Code 的一个强大插件，提供 LaTeX 文档的编写、编译、预览等一站式支持。
*   **安装方法**：
    1. 打开 VS Code
    2. 点击左侧活动栏的"扩展"图标（或按 `Ctrl + Shift + X`）
    3. 搜索 "LaTeX Workshop"
    4. 点击 "安装" 按钮
*   **插件市场链接**：[LaTeX Workshop](https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop)

---

## 🚀 快速上手指南 (从 0 开始)

### 第一步：环境准备
1.  安装 **TeX Live** (推荐 2024 或更新版本)，设置环境变量。
2.  安装 **Visual Studio Code (VS Code)**。
3.  在 VS Code 中安装 **LaTeX Workshop** 插件。
4.  **应用项目配置** (任选一种方法)：
    *   **方法一：全局配置 (推荐)**
        *   适合希望以后打开任何 LaTeX 项目都能自动应用此配置的用户。
        *   在 VS Code 中按下 `Ctrl + Shift + P`，输入 `Preferences: Open User Settings (JSON)` 并回车。
        *   打开本项目文件夹 `.vscode/settings.json`，将其中的内容复制，粘贴到刚才打开的全局 `settings.json` 文件的大括号 `{ ... }` 中（注意合并 JSON 内容，不要破坏原有格式）。
    *   **方法二：项目独立配置 (已内置 - 开箱即用)**
        *   本项目根目录已包含 `.vscode` 文件夹，内置了所有必要的编译和清理配置。
        *   **您无需进行任何手动配置**，直接打开项目即可开始写作和编译。
    *   *这一步非常重要，它包含了自动清理中间文件和正确编译中文文档的关键配置。*

### 第二步：开始写作
1.  **修改封面**：打开 `latex/cover/cover.tex`，修改标题、作者名为你自己的信息，或者导入你自己想用的封面
2.  **编写正文**：
    *   在 `latex/` 目录下新建章节文件夹（如 `chapter6/`）和 `.tex` 文件。
    *   或者直接修改现有的 `latex/chapter1/1.tex` 等文件。
3.  **组织章节**：打开 `main.tex`，使用 `\include{latex/chapterX/filename}` 命令将你写好的章节文件引入到主文档中。
4.  **添加引用** (可选)：
    *   将参考文献信息（BibTeX 格式）复制到 `bib/ref.bib` 文件中。
    *   在正文中使用 `\cite{key}` 命令进行引用。

### 第三步：编译生成
1.  打开 `main.tex` 文件。
2.  点击 VS Code 左侧侧边栏的 LaTeX 图标，点击 "Build LaTeX project"。
3.  或者直接按 `Ctrl + S` (默认快捷键) 进行编译。
4.  编译完成后，点击右上角的预览按钮查看生成的 PDF。

---

## 📂 项目结构说明

本项目采用模块化结构，保持根目录整洁，便于管理长文档。

*   **`main.tex`**：**项目入口文件**。负责整体架构，包含文档类设置、引入配置文件、组织各个章节顺序。通常不需要在此处写大量正文。
*   **`latex/`**：**核心源码目录**。
    *   `config.tex`：**全局配置文件**。所有的宏包加载、页面设置、字体设置、命令定义都在这里。
    *   `cover/cover.tex`：**封面文件**。修改此文件以自定义封面内容（标题、作者、日期等）。
    *   `chapterX/` (如 `chapter1/`)：**章节内容文件夹**。建议将每一章的内容单独放在一个文件夹中，便于管理。
*   **`bib/`**：**参考文献目录**。
    *   `ref.bib`：参考文献数据库文件（BibTeX 格式）。
*   **`figures/`**：**图片资源目录**。建议将文档中用到的所有图片都存放在此目录下。
*   **`out/`** (编译后生成)：通常小白不需要在意此文件夹中的内容，里面存放编译过程中产生的中间文件（如 `.aux`, `.log`）和最终的 PDF 文件。
*   **`.vscode/`**：包含 VS Code 的项目配置文件 (`settings.json`)，用于配置 LaTeX 编译工具链和清理规则，实现开箱即用。

---

## 📏 模板格式说明

本模板基于 `ctexart` 文档类，预设了符合一般学术笔记或报告的排版格式。以下是详细的格式设置参数，方便您快速了解并根据需求在 `latex/config.tex` 中进行修改。

### 1.1 页面与字体
*   **纸张大小**：A4
*   **页边距**：上下左右均为 2.5cm
*   **正文字体**：
    *   中文：宋体 (SimSun)
    *   英文/数字：Times New Roman
    *   字号：小四 (12pt)
*   **行距**：固定行距 20pt

### 1.2 页眉页脚
*   **页眉**：居中，宋体小五号，显示当前章节标题，下划线宽 0.5pt。
*   **页脚**：居中，宋体小五号，显示页码。

### 1.3 章节标题格式
*   **一级标题 (Section)**：三号黑体，居中，段前 30pt，段后 20pt。
*   **二级标题 (Subsection)**：四号黑体，左对齐，段前 25pt，段后 12pt。
*   **三级标题 (Subsubsection)**：小四号黑体，左对齐，段前 12pt，段后 6pt。

### 1.4 目录格式
*   **标题**：“目    录”（中间空了两格）
*   **显示深度**：显示到二级标题 (Subsection)
*   **一级条目**：黑体小四号
*   **二级条目**：宋体小四号，缩进 2em
*   **引导线**：点状引导线

### 1.5 参考文献格式
*   **标准**：GB/T 7714-2015 (`gb7714-2015` 样式)
*   **排序**：按引用顺序排序 (`sorting=none`)
*   **字体**：宋体五号
*   **后端**：Biber

---

## 📮 联系作者

如果您在使用过程中遇到任何问题，或者有关于 LaTeX 排版的咨询，欢迎联系我：

*   **作者**：李春源 
*    **邮箱**：lichunyuan0117@gmail.com

开箱即用的 LaTeX 通用笔记模板 (基于 DJTU)

本模板专为 Visual Studio Code 用户打造，基于 ctexart 文档类，提供了一套零配置、模块化、自动化的 LaTeX 写作环境。

✨ 核心亮点

项目目录极致整洁：编译产生的 .aux, .log 等中间文件自动收纳至 out/ 目录，根目录只保留源码和最终 PDF。
双向同步定位 (SyncTeX)：支持 Ctrl + Alt + J (代码跳转 PDF) 和 Double Click (PDF 跳转代码)，写作校对更高效。

🛠️ 所需工具清单

在使用本模板之前，请确保您已安装以下工具：

1. Visual Studio Code

简介：VS Code 是一款轻量级但功能强大的源代码编辑器，支持丰富的扩展插件。
下载地址：https://code.visualstudio.com/

2. TeX Live（推荐）

简介：TeX Live 是一个完整的 LaTeX 发行版，包含了编译 LaTeX 文档所需的所有工具和宏包。
推荐理由：
- ✅ 完整跨平台：支持 Windows、macOS 和 Linux 系统
- ✅ 宏包强大：内置数千个常用宏包，满足各类排版需求
- ✅ 更新齐全：定期更新，保持与最新 LaTeX 标准同步
下载地址：
- 国外官网：https://www.tug.org/texlive/
- 国内清华镜像源（推荐，速度更快）：https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/

3. LaTeX Workshop 插件

简介：这是 VS Code 的一个强大插件，提供 LaTeX 文档的编写、编译、预览等一站式支持。
安装方法：
1. 打开 VS Code
2. 点击左侧活动栏的"扩展"图标（或按 Ctrl + Shift + X）
3. 搜索 "LaTeX Workshop"
4. 点击 "安装" 按钮
插件市场链接：LaTeX Workshop

🚀 快速上手指南 (从 0 开始)

第一步：环境准备

安装 TeX Live (推荐 2024 或更新版本)，设置环境变量。
安装 Visual Studio Code (VS Code)。
在 VS Code 中安装 LaTeX Workshop 插件。
应用项目配置 (任选一种方法)：
- 方法一：全局配置 (推荐)
  - 适合希望以后打开任何 LaTeX 项目都能自动应用此配置的用户。
  - 在 VS Code 中按下 Ctrl + Shift + P，输入 Preferences: Open User Settings (JSON) 并回车。
  - 打开本项目文件夹 .vscode/settings.json，将其中的内容复制，粘贴到刚才打开的全局 settings.json 文件的大括号 { ... } 中（注意合并 JSON 内容，不要破坏原有格式）。
- 方法二：项目独立配置 (已内置 - 开箱即用)
  - 本项目根目录已包含 .vscode 文件夹，内置了所有必要的编译和清理配置。
  - 您无需进行任何手动配置，直接打开项目即可开始写作和编译。
- 这一步非常重要，它包含了自动清理中间文件和正确编译中文文档的关键配置。

第二步：开始写作

修改封面：打开 latex/cover/cover.tex，修改标题、作者名为你自己的信息，或者导入你自己想用的封面
编写正文：
- 在 latex/ 目录下新建章节文件夹（如 chapter6/）和 .tex 文件。
- 或者直接修改现有的 latex/chapter1/1.tex 等文件。
组织章节：打开 main.tex，使用 \include{latex/chapterX/filename} 命令将你写好的章节文件引入到主文档中。
添加引用 (可选)：
- 将参考文献信息（BibTeX 格式）复制到 bib/ref.bib 文件中。
- 在正文中使用 \cite{key} 命令进行引用。

第三步：编译生成

打开 main.tex 文件。
点击 VS Code 左侧侧边栏的 LaTeX 图标，点击 "Build LaTeX project"。
或者直接按 Ctrl + S (默认快捷键) 进行编译。
编译完成后，点击右上角的预览按钮查看生成的 PDF。

📂 项目结构说明

本项目采用模块化结构，保持根目录整洁，便于管理长文档。

main.tex：项目入口文件。负责整体架构，包含文档类设置、引入配置文件、组织各个章节顺序。通常不需要在此处写大量正文。
latex/：核心源码目录。
- config.tex：全局配置文件。所有的宏包加载、页面设置、字体设置、命令定义都在这里。
- cover/cover.tex：封面文件。修改此文件以自定义封面内容（标题、作者、日期等）。
- chapterX/ (如 chapter1/)：章节内容文件夹。建议将每一章的内容单独放在一个文件夹中，便于管理。
bib/：参考文献目录。
- ref.bib：参考文献数据库文件（BibTeX 格式）。
figures/：图片资源目录。建议将文档中用到的所有图片都存放在此目录下。
out/ (编译后生成)：通常小白不需要在意此文件夹中的内容，里面存放编译过程中产生的中间文件（如 .aux, .log）和最终的 PDF 文件。
.vscode/：包含 VS Code 的项目配置文件 (settings.json)，用于配置 LaTeX 编译工具链和清理规则，实现开箱即用。

📏 模板格式说明

本模板基于 ctexart 文档类，预设了符合一般学术笔记或报告的排版格式。以下是详细的格式设置参数，方便您快速了解并根据需求在 latex/config.tex 中进行修改。

1.1 页面与字体

纸张大小：A4
页边距：上下左右均为 2.5cm
正文字体：
- 中文：宋体 (SimSun)
- 英文/数字：Times New Roman
- 字号：小四 (12pt)
行距：固定行距 20pt

1.2 页眉页脚

页眉：居中，宋体小五号，显示当前章节标题，下划线宽 0.5pt。
页脚：居中，宋体小五号，显示页码。

1.3 章节标题格式

一级标题 (Section)：三号黑体，居中，段前 30pt，段后 20pt。
二级标题 (Subsection)：四号黑体，左对齐，段前 25pt，段后 12pt。
三级标题 (Subsubsection)：小四号黑体，左对齐，段前 12pt，段后 6pt。

1.4 目录格式

标题：“目录”（中间空了两格）
显示深度：显示到二级标题 (Subsection)
一级条目：黑体小四号
二级条目：宋体小四号，缩进 2em
引导线：点状引导线

1.5 参考文献格式

标准：GB/T 7714-2015 (gb7714-2015 样式)
排序：按引用顺序排序 (sorting=none)
字体：宋体五号
后端：Biber

📮 联系作者

如果您在使用过程中遇到任何问题，或者有关于 LaTeX 排版的咨询，欢迎联系我：

作者：李春源
邮箱：lichunyuan0117@gmail.com