ouc_latex_template/教材/教材.tex

%======================================================================
%  中国海洋大学 教材 模板（示例）
%
%  从《软件需求工程导论》(sre 仓库) 的版式抽取而来。
%  正文内容为占位示例，只用来展示版式，不含原书内容。
%
%  编译： xelatex 教材.tex
%         有参考文献时：xelatex → bibtex → xelatex → xelatex
%
%  ------------------------------------------------------------------
%  ⚠️⚠️ 前两行不能动、不能换序
%
%     第 1 行 \documentclass 必须含 chinesefont=nofont
%     第 2 行 \input{../fonts.tex} 接入仓库公共字体
%
%     写错任一处都会退回商业字体或系统字体，详见 ouctextbook.sty 第一节。
%  ------------------------------------------------------------------
%======================================================================
\documentclass[lang=cn,newtx,10pt,black,chinesefont=nofont]{elegantbook}
\input{../fonts.tex}
\usepackage{ouctextbook}

% ---- 书名信息 ----
\title{教材模板示例}
\subtitle{副标题写在这里}
\author{作者甲 \quad 作者乙 \quad 作者丙}
\institute{中国海洋大学}
\date{2026/11/1}
\version{第一版}
\extrainfo{出版社}

% ---- 封面图 ----
%  图片放在本目录，写 \cover{文件名}。
%  不写 \cover{} 则只出纯色带封面，不会报错。
\cover{cover.jpg}

% ---- 参考文献库（必须在 \begin{document} 之前）----
\addbibresource[location=local]{reference.bib}

\begin{document}

% ---- 标题页（elegantbook 自动生成，含书名/作者/机构/版本/日期）----
\maketitle

% ---- 前置部分：页码用罗马数字 ----
\frontmatter
\tableofcontents

%======================================================================
% 前言
%
%  ⚠️ 前言用 \chapter*（不进编号、不进目录），
%     与正文章节的 \chapter 区分。原教材如此。
%======================================================================
\chapter*{前言}
\markboth{前言}{前言}

这里写前言。教材前言通常包括：本书的写作背景与目的、读者对象、
全书结构安排、各章内容简介、使用建议（可作为哪些课程的教材、
需要哪些先修知识）、致谢、以及勘误联系方式。

\vspace{1.5em}

\hfill 编\quad 者\\
\hfill 2026 年 11 月

% ---- 正文部分：页码用阿拉伯数字，章从 1 开始 ----
\mainmatter

%======================================================================
% 正文示例章
%
%  ⚠️ 章的标准结构（原教材 13 章全部如此）：
%       \chapter{标题}
%       → 导语（3~5 段，概述本章要点与结构）
%       → \section 正文各节
%       → \section{本章小结}
%       → \section{习题}
%======================================================================
\chapter{章节标题示例}

本章导语。教材每章开篇先有一段到几段导语，说明本章要解决什么问题、
分几部分展开、与其他章的关系。这段文字通常在 3~5 段、200~400 字之间，
让读者在进入细节前建立整体框架。

导语的第二段继续交代本章的组织逻辑。例如「首先……接着……随后……
最后……」这样的行文，既是给读者的路线图，也是作者自查结构是否清晰的
工具。

\section{节标题}

正文段落。教材正文 10pt，行距由 elegantbook 设定为 1.2 倍。

行内可以用 \textbf{黑体强调}、\emph{楷体强调}，以及英文术语
Requirements Engineering 和缩写 SRE。

\subsection{小节标题}

更细一层的展开。

\subsubsection{小小节标题}

最细一层。注意编号最多到这里（1.1.1.1）。

\paragraph{第五级标题}
这一级不再进编号，改用「（1）（2）（3）」形式，避免编号过长。
新的一段从段首开始。

\paragraph{再一个第五级标题}
编号自动递增为（2）。

\section{列表与表格示例}

无序列表：

\begin{itemize}
  \item \textbf{项目软件。}由甲方委托开发，需求主要来自甲方。
  \item \textbf{产品软件。}面向普通用户，需求来自产品经理。
\end{itemize}

有序列表：

\begin{enumerate}
  \item \textbf{系统化方法：}使用可重复的过程与标准工具。
  \item \textbf{工程原则：}模块化、抽象、分而治之。
  \item \textbf{质量保证：}通过测试、审查与验证确保质量。
\end{enumerate}

表格示例（教材表格通常用三线表，见 \texttt{booktabs}；
这里演示最简的带框表格，与原教材一致）：

\begin{table}[htbp]
  \centering
  \caption{表格标题示例}
  \label{tab:example}
  \begin{tabular}{|l|l|}
    \hline
    \textbf{列标题一} & \textbf{列标题二} \\ \hline
    内容 A       & 15.9\%        \\ \hline
    内容 B       & 13.9\%        \\ \hline
  \end{tabular}
\end{table}

见表~\ref{tab:example} 可见表题在表上方。

\section{插图示例}

\begin{figure}[H]
  \centering
  % 有图时：\includegraphics[width=0.8\textwidth]{image/xxx.png}
  \fbox{\parbox[c][3cm][c]{0.6\textwidth}{\centering 图占位}}
  \caption{图标题示例}
  \label{fig:example}
\end{figure}

见图~\ref{fig:example}。图题在图下方，与表题相反，这是通行惯例。

\section{TikZ 绘图示例}

教材里的关系图、流程图多用 TikZ 直接画，好处是矢量、可改、不用外部图片：

\begin{figure}[H]
  \centering
  \begin{tikzpicture}[
    box/.style={draw, rounded corners, align=center,
                fill=blue!6, minimum width=3.2cm, minimum height=1.0cm},
    font=\small]
    \node[box] (a) at (0,1.6) {甲方\\（提目标）};
    \node[box] (b) at (0,-1.6) {用户\\（提需求）};
    \node[box] (c) at (5,0)   {开发团队};
    \draw[->, thick] (a) -- node[right]{业务需求} (c);
    \draw[->, thick] (b) -- node[above]{用户需求} (c);
  \end{tikzpicture}
  \caption{TikZ 绘图示例}
\end{figure}

% ---- 章节收尾（原教材每章固定这两节）----
\oucsummary

本章小结正文。原教材的小结通常是 1~2 段密集回顾，把本章的核心结论、
关键数据、与其他章的衔接一次交代清楚，不重复正文细节。

\oucexercises

\begin{enumerate}
  \item 习题一示例。
  \item 习题二示例。
\end{enumerate}

%======================================================================
% 附录
%
%  ⚠️ \appendix 之后章号自动变 A、B、C……
%     elegantbook 默认已是字母编号，但为保险显式重设一次
%     （原教材主文件也这么写）。
%======================================================================
\appendix
\renewcommand{\thechapter}{\Alph{chapter}}

\chapter{附录标题示例}

附录正文。常见附录内容：术语表、缩略语表、工具清单、
实验数据、参考规范全文等。

\chapter{另一个附录}

附录二正文。

%======================================================================
% 参考文献
%
%  ⚠️ 用 biblatex（elegantbook 已配好 biblatex + biber/bibtex 后端）
%     \addbibresource 在导言区、\printbibliography 在正文末尾。
%
%     本示例的 reference.bib 只有 2 条假条目，仅供演示格式。
%     实际使用时替换为真实文献。
%
%  ⚠️ \nocite{*} 表示"引用文献库里全部条目"，模板演示用。
%     正式写作应删掉它，只列实际引用的文献。
%======================================================================
\nocite{*}
\printbibliography[heading=bibintoc, title=\ebibname]

\end{document}