Skip to content

elsa-lab/NTHUthesis

Repository files navigation

The NTHUthesis LaTeX Class

This README describes how to use the NTHUthesis class with LaTeX to produce high quality typeset theses that are suitable for submission to National Tsing Hua University (NTHU).

cover chinese-abstract english-abstract table-of-contents

Class Options

There are three class options that can be used to control the behavior of NTHUthesis. These are specified in the traditional LaTeX way. For example,

\documentclass[master]{NTHUthesis}

master, doctor

NTHUthesis offers two modes for typesetting theses. The master mode will produce theses for a master's degree. On the other hand, the doctor mode will produce doctoral theses.

nowatermark

By default, NTHUthesis produces theses with watermarking. However, the watermark can be omitted by specifying the nowatermark option. For example,

\documentclass[doctor,nowatermark]{NTHUthesis}

zhmode

NTHUthesis offers an additional mode for typesetting theses in Chinese by specifying the zhmode option. For example,

\documentclass[master,zhmode]{NTHUthesis}

When zhmode is enabled, a new command chref is provided, allowing the user to reference a chapter number in Chinese instead of Arabic. For example,

\chapter{chapter title}
\label{chap:title}

... 第\chref{chap:title}章 ...

Provided Commands

  • \makecover: Create a cover that is suitable for submission to NTHU.
  • \maketoc: Create a table of contents, including the list of figures and the list of tables.
  • Thesis information is specified in thesis_info.tex through the following commands:
    • \titleZH: Title in Chinese
    • \titleEN: Title in English
    • \instituteZH: Institute in Chinese
    • \studentID: Author's student ID
    • \studentZH: Author's name in Chinese
    • \studentEN: Author's name in English
    • \advisorZH: Advisor's name in Chinese
    • \advisorEN: Advisor's name in English
    • \yearZH: The year of the dissertation defense
    • \monthZH: The month of the dissertation defense

Provided Environments

  • abstractZH: Create a chapter of the abstract in Chinese.
  • abstractEN: Create a chapter of the abstract in English.
  • acknowledgementsZH: Create a chapter of acknowledgements in Chinese.
  • acknowledgementsEN: Create a chapter of acknowledgements in English.

Minimal Working Example

thesis_main.tex

This is a template for typesetting the main manuscript that is suitable for submission. One can access the output of this template through exmaples/thesis_main.pdf.

thesis_cover.tex

This is a template for typesetting the cover without watermarking. One can access the output of this template through exmaples/thesis_cover.pdf.

thesis_abstracts.tex

This is a template for typesetting the abstract of the main manuscript. One can access the output of this template through exmaples/thesis_abstracts.pdf.

Known Issues

Compilation Failed with microtype

The following two lines would cause compilation to fail when the package microtype is used.

\AtBeginDocument{\begin{CJK*}{UTF8}{bkai}}
\AtEndDocument{\end{CJK*}}

Please comment out them from NTHUthesis.cls and manually add them after \begin{document} and before \end{document} to resolve the issue. For example,

...
\begin{document}
\begin{CJK*}{UTF8}{bkai}
...
\end{CJK*}
\end{document}

Adjusting Watermark Opacity

Please note that the watermark opacity is set to 100% in 博碩士論文上傳說明. However, without reducing its opacity, the watermark may be indistinguishable from the foreground text and thus impede reading. After the discussion in the closed issue #2, we decided to leave the customization effort to the user who thinks reducing opacity is necessary. One possible modification can be done in NTHUthesis.cls as follows.

Origin:

% Watermark of NTHU
\ifdefined \nowatermark \else
    \RequirePackage{draftwatermark}
    \SetWatermarkAngle{0}
    \SetWatermarkText{\includegraphics[width=.5\paperwidth]{nthu-logo.pdf}}
\fi

Modification:

% Watermark of NTHU
\ifdefined \nowatermark \else
    \RequirePackage{draftwatermark}
    \RequirePackage{transparent}
    \SetWatermarkAngle{0}
    \SetWatermarkText{\transparent{0.5}\includegraphics[width=.5\paperwidth]{nthu-logo.pdf}}
\fi

Reference

About

Typesetting theses for members of National Tsing Hua University (NTHU), Hsinchu, Taiwan.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages