API Reference

This page documents the advanced programmatic commands, internal macros, and environments provided by fduthesis and its accompanying visual identity package fdulogo. These tools are useful for power users who need to override default behaviors or create custom programmatic layouts.

Manual Cover Generation Commands

By default, fduthesis automatically injects the necessary covers based on your type (Doctor, Master, Bachelor) via the style/auto-make-cover = true option.

If you set auto-make-cover = false, you take manual control over the front matter. You can insert the covers anywhere using these commands:

  • \makecoveri: Generates the Front Cover (Title Page). Contains the logo, bilingual titles, candidate info, and date.
  • \makecoverii: Generates the Inside Front Cover (List of Instructors / Guiding Committee). Only renders if info/instructors is populated.
  • \makecoveriii: Generates the Inside Back Cover (Declaration of Originality and Authorization). If style/declaration-page is set to a PDF, this command will inject that PDF instead of generating the text.

Warning: Manually injecting covers can disrupt LaTeX's page counter and Roman numeral assignments in \frontmatter. Only do this if you have highly non-standard binding requirements.

Math and Theorem Environments

The template pre-defines standard mathematical environments out-of-the-box, utilizing the robust ntheorem backend. They are fully localized (Chinese or English depending on the document class).

Environment Chinese Header English Header Counter Behavior
axiom 公理 Axiom Bound to Chapter (e.g., Axiom 1.1)
corollary 推论 Corollary Bound to Chapter
definition 定义 Definition Bound to Chapter
example 例 Example Bound to Chapter
lemma 引理 Lemma Bound to Chapter
theorem 定理 Theorem Bound to Chapter
proof 证明 Proof Unnumbered

Usage Example: 

\begin{theorem}[Pythagoras]
  In a right-angled triangle, the square of the hypotenuse is equal to the sum of the squares of the other two sides.
\end{theorem}

The QED Symbol

The proof environment automatically appends a QED symbol ($\blacksquare$) at the end of the text.

Note: Due to how ntheorem calculates line endings, you may need to compile twice to position the QED symbol perfectly flush right. If an equation ends the proof, use \[ ... \vspace{-\baselineskip} \] to prevent the QED from dropping to an isolated new line.

Defining Custom Theorems

You can define your own theorem environments (e.g., "Hypothesis", "Assumption") using the enhanced \newtheorem and \newtheorem* macros provided by the template.

% Numbered environment
\newtheorem[<options>]{<env_name>}{<title>}

% Unnumbered environment (auto-adds QED symbol by default)
\newtheorem*[<options>]{<env_name>}{<title>}

Available Options: Passed as a comma-separated key-value list.

  • style: Overall layout style. Options: plain (inline header), margin (header in margin), break (header on new line), change (number before title).
  • header-font: Font declaration for the title (e.g., \sffamily\bfseries).
  • body-font: Font declaration for the body text (e.g., \itshape or \normalfont).
  • qed: The symbol to use at the end of the environment. (e.g., $\square$).
  • counter: The counter parent for numbering (default is chapter).

Example: Creating an "Assumption" Environment 

\newtheorem[style=break, header-font=\bfseries, body-font=\normalfont]{assumption}{Assumption}

\begin{assumption}
  Assume the system is linear and time-invariant (LTI).
\end{assumption}

The fdulogo Package

The fdulogo package is loaded automatically by the thesis class, but it can also be used standalone in presentations (e.g., Beamer) or posters. It provides TikZ-based commands to render Fudan University's official visual identity elements in vector format.

Available Commands

  • \fduname[<options>]: Draws the Fudan University name calligraphy.
  • \fduname: Standard version.
  • \fduname+: Revised typography version.
  • \fduname-: Original Mao Zedong calligraphy version.
  • \fduemblem[<options>]: Draws the circular university emblem.
  • \fduemblem: Standard emblem.
  • \fduemblem+: Revised modern emblem.
  • \fduemblem*: Reversed (white outline/text) version, useful for dark backgrounds.
  • \fdumotto[<options>]: Draws the university motto ("博学而笃志，切问而近思").

Official Colors

fdulogo defines two official palette colors ready for use with xcolor or TikZ:

  • FudanBlue: HTML 0E419C (Primary institutional color)
  • FudanRed: HTML C80000 (Accent color)

Styling Options

Because these macros generate TikZ paths, you can pass standard TikZ styling options (like color, scale, opacity, x, and y) into the optional argument.

Example: Generating a Blue Custom Emblem 

% Renders a large, Fudan Blue emblem
\fduemblem+[color=FudanBlue, x=1mm, y=1mm]

Example: Creating a Watermark Background 

\usepackage{eso-pic}
\AddToShipoutPictureBG{%
  \AtPageCenter{%
    \makebox[0pt]{\fduemblem+[color=gray!10, x=3cm, y=3cm]}
  }
}