用途
本技能用于搭建和排查面向 AEC/工程类学术场合的 LaTeX 稿件,帮助作者按目标期刊或会议的要求组织论文与学位论文。随附一份起始模板 article-template.tex(与本文件同目录,可用 ${CLAUDE_PLUGIN_ROOT} 引用,或复制给用户使用)。
主要能力
1. 选择合适的文档类(匹配投稿场合)
- Elsevier(如 Automation in Construction、Energy and Buildings 等):elsarticle,例如 \documentclass[review,3p,times]{elsarticle};参考文献样式使用 model5-names 或 elsarticle-num。
- IEEE:IEEEtran,例如 \documentclass[journal]{IEEEtran} 或 [conference]。
- ASCE:ascelike-new 类,例如 \documentclass[Journal]{ascelike-new},配合 ASCE 参考文献样式。
- Springer:sn-jnl(Springer Nature)或旧版 svjour3。
- ACM:acmart。
- 通用/学位论文:article/report/book 或院校论文类;需要更强控制时可用 memoir/koma-script。
建议先下载目标场合的官方模板,不要自行重造文档类已经提供的格式。
2. 最小文档结构
\documentclass[11pt]{article}
\usepackage[utf8]{inputenc} % (modern: use lualatex/xelatex + fontspec)
\usepackage[T1]{fontenc}
\usepackage{graphicx,booktabs,siunitx,amsmath,amssymb}
\usepackage[hidelinks]{hyperref}
\usepackage[capitalise]{cleveref}
\title{...}\author{...}\date{}
\begin{document}\maketitle
\begin{abstract}...\end{abstract}
\section{Introduction}...
\bibliographystyle{elsarticle-num}\bibliography{references}
\end{document}
3. 参考文献(两条路线,不要混用)
- BibTeX + natbib(经典方案,多数出版商样式采用):\usepackage[numbers]{natbib}(或 author-year),\bibliographystyle{<style>.bst},\bibliography{references};引用用 \citep{}/\citet{}。
- BibLaTeX + biber(现代、灵活):\usepackage[style=ieee,backend=biber]{biblatex},\addbibresource{references.bib};引用用 \autocite{}/\textcite{},输出用 \printbibliography。
保持单一 references.bib(条目规范参见 citation-formats:缩写加花括号如 {BIM}、页码范围用 --、doi 不加前缀)。BibTeX 编译顺序:pdflatex → bibtex → pdflatex → pdflatex。
4. 图表(出版质量)
\begin{figure}[t]
\centering
\includegraphics[width=.8\linewidth]{figs/workflow.pdf} % vector PDF/EPS for diagrams
\caption{Research workflow.}\label{fig:workflow}
\end{figure}
示意图/曲线图使用矢量格式(PDF/EPS/SVG→PDF),照片使用高 DPI。引用时用 \cref{fig:workflow}。表格使用 booktabs(\toprule\midrule\bottomrule),不加竖线;表题在表格上方,图题在图下方。siunitx 的 S 列可按小数点对齐数字。子图使用 subcaption(\begin{subfigure}),不要用已过时的 subfigure 宏包。
5. 数学与单位
公式使用 equation/align(amsmath),不要用 eqnarray;引用用 \eqref{}。单位与量使用 siunitx:\qty{2.5}{\kilo\watt\hour\per\meter\squared}、\num{1.2e-3}、\SI(旧写法)。保持有效数字一致,单位间距由宏包自动处理。行内公式可用 (...);符号定义只写一次。
6. 交叉引用与良好实践
cleveref(\cref、\Cref)会自动加上“Fig./Table/Eq./Sec.”前缀并处理范围——为所有对象加标签(fig:、tab:、eq:、sec: 前缀),不要硬编码编号。hyperref 放在最后(或遵循宏包加载顺序规则;cleveref 在 hyperref 之后加载)。源码中每行一句,便于协作时查看 git diff。起草阶段注释而非删除内容;用 \todo{}(todonotes)记录审阅意见。
7. Overleaf 与协作
Overleaf 支持实时共同撰写;需设置编译器(pdfLaTeX 与 XeLaTeX/LuaLaTeX——后者用于自定义字体/Unicode)和与模板匹配的 TeX Live 版本。使用 Git/Overleaf-Git 集成做版本控制;将 figs/ 与 references.bib 纳入仓库。大型学位论文可按章使用 \input/\include,用 latexmk 构建,用 glossaries 管理缩写。
8. 常见问题速查
- “Undefined control sequence” → 缺少 \usepackage。
- 引用显示为 [?] → 运行 BibTeX/biber,再重跑 LaTeX 两次;检查 .bib 键与样式。
- “Overfull \hbox” → 长 URL/单词;可用 \sloppy、microtype,或用 url/\url{} 断行。
- 浮动体位置混乱 → 用 [t]/[b]、\clearpage,或 placeins/\FloatBarrier;除个别情况外不要用 [H](float 宏包)硬顶。
- 参考文献样式不对 → 用错了 .bst/biblatex 样式;需匹配投稿场合。
- pdfLaTeX 报 Unicode 错误 → 改用 LuaLaTeX/XeLaTeX,或转义字符。
使用方式
按上述章节顺序操作:先确定文档类,再搭建最小结构,选择一种参考文献方案,处理图表、公式与交叉引用,最后在 Overleaf 或本地(latexmk)编译并排查报错。可直接参考随附的 article-template.tex 作为带注释的起点。
适用场景
AEC/工程类期刊与会议论文、学位论文的 LaTeX 写作与排版,尤其是需要匹配 Elsevier、IEEE、ASCE、Springer、ACM 等出版商模板的稿件。
限制
资料未提供该技能的具体安装方式、依赖版本要求、收费信息或平台支持范围,暂未提供。