User Guide
A thesis is one entry point plus a directory of chapters. The class holds the layout; the author holds the text.
Metadata
Six commands in main.tex fill the cover and the PDF properties.
| Command | Sets |
|---|---|
\titlename{} | The institutional heading printed above the title |
\title{} | Thesis title; also the PDF title |
\school{} | School or department |
\class{} | Class information |
\author{} | Author; also the PDF author |
\supervisor{} | Supervisor |
Front matter
\maketitle produces the cover, the originality statement, and the copyright authorization
page. Section numbering is held back until it has run, so nothing before the first chapter is numbered
by accident. Abstract pages use Roman numerals; the body restarts in Arabic.
Abstracts and keywords
Two environments, one per language, each with its own keyword command. Both are bookmarked in the PDF
outline, and \keywords also writes the PDF keyword field.
\begin{abstract}
...
\keywords{Keyword One, Keyword Two}
\end{abstract}
\begin{enabstract}
...
\enkeywords{Keyword One, Keyword Two}
\end{enabstract}Chapters
Chapter files live in texs/ and are pulled in with \include, so each one starts
on a new page and can be compiled selectively. The repository ships numbered stubs; the numbering is
there so the directory listing reads in thesis order.
\include{texs/00_abstract}
\tableofcontents
\include{texs/01_intro}
\printbibliography
\include{texs/20_acknowledgement}
texs/30_appendices.tex starts with \appendix, after which sections are lettered
rather than numbered. The acknowledgement has its own environment and is added to the table of contents
without being numbered.
Bibliography
Entries go in references.bib, the database is declared with \bibliography{} in
main.tex, and \printbibliography places the list. The four-pass build in
Quick Start is what resolves the citations.
Theorem environments
Sixteen numbered environments are defined for mathematical and engineering theses:
theorem, lemma, corollary, proposition,
definition, axiom, assumption, conjecture,
principle, property, problem, example,
solution, proof, conclusion, remark.
Class options
| Option | Effect |
|---|---|
minimal | Drops the theorem environments and implies nobib |
nobib | Builds without the bibliography machinery |
heitipatch | Patches heiti handling for environments that need it |
Any other option is passed through to ctexart. The former noextrafonts option is
deprecated: the condition it covered is detected automatically, and the class says so at build time.
Adapting to an institution
Cover pages, declarations, margins, fonts, and heading rules are defined in zhthesis.cls,
which keeps every institutional requirement in one file instead of scattered through the chapters. The
class carries Chinese labels and declaration text because the documents it produces are Chinese; the
source and its comments are English.