# Literature Translation To Tex

> 将“文献”文件夹下用户指定或选择的外文文献转换为广东工业大学 LaTeX 模板格式的“文献翻译”文档并翻译正文。用户要求做外文文献翻译、把文献/论文/PDF/Word/Markdown 转成文献翻译 LaTeX、生成“文献翻译.tex”、或需要按“外文文献译文/外文文献原文”结构整理时必须使用。本 skill 会读取文献原文、按自然段且每段不超过 500 字翻译、套用默认 GDUT 模板、替换为文献翻译封面，并输出到“文献”文件夹。

- Skill: `447662/literature-translation-to-tex` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add 447662/literature-translation-to-tex`
- Raw SKILL.md: https://api.skillmd.com/api/skills/447662/literature-translation-to-tex/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: 447662 (https://skillmd.com/u/447662)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/447662/literature-translation-to-tex

---


# 文献翻译转 LaTeX

把项目 `文献` 文件夹下用户选择的外文文献整理为基于 GDUT LaTeX 模板的文献翻译 `.tex` 文档。该 skill 负责选择文献、提取原文、按自然段翻译、套用固定目录结构、替换封面配置，并把最终文件生成在 `文献` 文件夹下。

## 固定路径

- 文献目录：项目根目录下的 `文献/`。
- 默认 LaTeX 模板：`/g:/My_code/Agent_atuo_graduation_project_of_GDUT/模板/GDUT-Undergraduate-Thesis-LaTeX-Template-main/模板.tex`。
- 文献翻译封面：`/g:/My_code/Agent_atuo_graduation_project_of_GDUT/模板/文献翻译封面.pdf`。
- 默认输出文件：`文献/文献翻译.tex`。

如果用户明确指定其他文献目录、模板或输出文件名，以用户指定为准；否则使用以上默认值。

## 触发后的启动流程

1. 定位项目根目录下的 `文献/` 文件夹。
2. 列出可用文献文件，让用户选择要翻译的文献；如果用户已经明确指定文件，直接使用该文件。
3. 确认输入文件类型并提取正文：
   - PDF：使用 PDF 读取/OCR 能力提取文本；扫描版或无法复制的 PDF 需要说明 OCR 可能有误。
   - 加密或权限受限 PDF：先尝试读取元数据；若正文无法提取，暂停并要求用户提供未加密版本、可复制文本、DOCX/TXT 版本或密码，不要编造译文和文献信息。
   - DOCX：使用 Word 文档读取能力提取段落。
   - Markdown/TXT/LaTeX：直接读取文本内容。
   - CAJ/其他不可直接读取格式：先提示需要转换为 PDF、DOCX、TXT 或提供可提取文本版本。
4. 读取默认 LaTeX 模板，保留模板导言区、宏包、版式配置和文档结构。
5. 将模板中的封面命令替换为文献翻译封面。
6. 按规定目录结构生成文献翻译内容。
7. 写入 `文献/文献翻译.tex`；若该文件已存在，不要无提示覆盖，先询问用户是否覆盖，或生成带后缀的新文件名。
8. 简要报告源文献、输出路径、是否有 OCR/格式/参考信息需要人工复查。

## 封面替换规则

默认模板里可能存在类似配置：

```latex
% 封面设置
% 封面设置（仅当封面文件存在时插入，避免编译因找不到文件失败）
\newcommand{\makecover}{%
      \IfFileExists{论文封面.pdf}{\includepdf[pages=-]{论文封面.pdf}}{}%
}
```

生成文献翻译 `.tex` 时，应将封面文件改为模板目录中的 `文献翻译封面.pdf`。优先使用相对路径，确保编译入口所在位置能找到该 PDF；如果输出文件在 `文献/` 下且直接编译该文件更方便，可使用可解析的相对路径或绝对路径。

推荐替换为：

```latex
% 封面设置
% 封面设置（仅当封面文件存在时插入，避免编译因找不到文件失败）
\newcommand{\makecover}{%
      \IfFileExists{/g:/My_code/Agent_atuo_graduation_project_of_GDUT/模板/文献翻译封面.pdf}{\includepdf[pages=-]{/g:/My_code/Agent_atuo_graduation_project_of_GDUT/模板/文献翻译封面.pdf}}{}%
}
```

如果当前 TeX 环境不支持 `/g:/...` 形式的绝对路径，则改用从输出文件到封面 PDF 的相对路径，并在完成说明中提示用户确认封面路径。

## 文档目录结构

最终正文必须使用以下一级和二级结构：

```text
1 外文文献译文（1）
1.1 译文信息
1.2 翻译正文
2 外文文献原文（1）
2.1 文献原文
```

LaTeX 中通常映射为：

```latex
\section{外文文献译文（1）}
\subsection{译文信息}
...
\subsection{翻译正文}
...
\section{外文文献原文（1）}
\subsection{文献原文}
...
```

不要把编号写进标题文本中，除非模板没有自动编号能力。优先让 LaTeX 自动编号。

## 译文信息

`1.1 译文信息` 应尽量包含可从文献中提取到的信息：

- 外文题名
- 中文译名
- 作者
- 来源/期刊/会议/出版社
- 年份
- DOI 或 URL（如有）

缺失信息不要编造；用“未在原文中明确给出”或省略该项，并在完成说明中列为需复查项。

## 翻译正文规则

- 按自然段翻译，不要按句子碎片化翻译。
- 每次处理一个自然段；如果原文自然段过长，应按语义边界拆分，单次翻译内容不超过 500 个中文字或约 500 个英文单词对应的内容。
- 保留原文的技术术语、变量名、算法名、模块名、公式编号、图表编号和引用编号。
- 专业术语第一次出现时可采用“中文译名（英文原词）”，后文保持译名一致。
- 不要扩写、改写或添加原文没有的信息；翻译以忠实、通顺、学术化为目标。
- 公式、代码、表格、图题、图注、参考文献编号应尽量保留原样，必要时转换为 LaTeX 可编译格式。
- 如果原文含图表但无法直接嵌入图片，可保留图题/图注并说明图片需人工补齐。

## 原文保留规则

`2.1 文献原文` 中应放入被翻译的外文原文。

- 保留原始段落顺序。
- 对 LaTeX 特殊字符进行转义，避免 `%`、`_`、`&`、`#`、`{}` 等破坏编译。
- 原文中的公式、引用编号、图表编号尽量保留。
- 如果输入来源是 PDF/OCR，应说明原文文本可能存在识别错误。

## 加密或无法提取文本的文献

如果 PDF 加密、受权限限制、扫描质量过差或工具无法提取正文：

- 不要继续生成看似完整的译文；这会造成虚构内容风险。
- 可以生成一个流程测试或占位文件，但必须明确标注“未能提取原文，不能作为正式译文”。
- 正式任务中应暂停并请求用户提供未加密 PDF、密码、可复制文本、DOCX/TXT 版本，或允许改用 OCR。
- 只能使用文件名、PDF 元数据或用户明确提供的信息填写译文信息；无法确认的作者、来源、年份、DOI 不要猜测。

## LaTeX 整合要求

- 保留模板的文档类、宏包、页眉页脚、目录、封面命令和编译配置。
- 仅替换或插入正文区域；不要随意删除模板依赖资源。
- 如果模板包含摘要、致谢、参考文献等毕业论文专用部分，而文献翻译不需要，应优先移除或注释这些与文献翻译无关的正文内容，同时保留必要导言区。
- 中文内容应使用模板已配置的中文支持，不要额外引入冲突宏包。
- 生成后检查：标题层级、封面路径、特殊字符、长表格、公式、图片路径、未闭合环境。

## 文件命名和覆盖

默认输出为 `文献/文献翻译.tex`。

- 如果文件不存在，直接写入。
- 如果文件已存在，先询问用户是否覆盖。
- 如果用户不想覆盖，使用 `文献翻译_1.tex`、`文献翻译_2.tex` 等递增命名。

## 完成回复格式

转换完成后，用简短清单说明：

```text
文献翻译 LaTeX 已生成：
- 源文献：...
- 输出文件：文献/文献翻译.tex
- 使用模板：...
- 使用封面：...
- 需人工复查：...
```

若未能完成，说明卡在哪一步以及用户需要补充什么文件或确认什么选择。