From 180abdc07de65f2344f3fd56f87e31b0a0db6ecf Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 4 Sep 2022 20:49:32 +0000 Subject: fduthesis (4sep22) git-svn-id: svn://tug.org/texlive/trunk@64288 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/fduthesis/README.md | 6 +- .../doc/latex/fduthesis/fdulogo-example.tex | 3 +- .../doc/latex/fduthesis/fduthesis-code.pdf | Bin 920850 -> 965673 bytes .../doc/latex/fduthesis/fduthesis-cover.tex | 3 +- .../doc/latex/fduthesis/fduthesis-en.pdf | Bin 155894 -> 162961 bytes .../doc/latex/fduthesis/fduthesis-en.tex | 356 +++++++++++-------- .../doc/latex/fduthesis/fduthesis-template.tex | 382 --------------------- .../texmf-dist/doc/latex/fduthesis/fduthesis.pdf | Bin 402649 -> 424983 bytes 8 files changed, 219 insertions(+), 531 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/fduthesis/fduthesis-template.tex (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/fduthesis/README.md b/Master/texmf-dist/doc/latex/fduthesis/README.md index 1a43d90b6a8..abbb1b2e8ea 100644 --- a/Master/texmf-dist/doc/latex/fduthesis/README.md +++ b/Master/texmf-dist/doc/latex/fduthesis/README.md @@ -1,7 +1,7 @@ The `fduthesis` Class ===================== -*LaTeX thesis template for Fudan University, v0.7e* +*LaTeX thesis template for Fudan University, v0.8* Overview -------- @@ -21,7 +21,7 @@ The documentation can be found in [fduthesis-en.pdf](http://mirrors.ctan.org/macros/latex/contrib/fduthesis/fduthesis-en.pdf) (in English). -GitHub re­pos­i­tory: . +GitHub repository: . Installation ------------ @@ -78,4 +78,4 @@ version. ----- -Copyright (C) 2017–2020 by Xiangdong Zeng . +Copyright (C) 2017–2022 by Xiangdong Zeng . diff --git a/Master/texmf-dist/doc/latex/fduthesis/fdulogo-example.tex b/Master/texmf-dist/doc/latex/fduthesis/fdulogo-example.tex index 71d041a0479..305f680578e 100644 --- a/Master/texmf-dist/doc/latex/fduthesis/fdulogo-example.tex +++ b/Master/texmf-dist/doc/latex/fduthesis/fdulogo-example.tex @@ -7,7 +7,7 @@ %% fduthesis.dtx (with options: `ex-logo') %% fduthesis-logo.dtx (with options: `ex-logo') %% -%% Copyright (C) 2017--2020 by Xiangdong Zeng +%% Copyright (C) 2017--2022 by Xiangdong Zeng %% %% This work may be distributed and/or modified under the %% conditions of the LaTeX Project Public License, either @@ -26,7 +26,6 @@ %% This work consists of the files fduthesis.dtx, %% fduthesis-doc.dtx, %% fduthesis-logo.dtx, -%% fduthesis-template.tex, %% and the derived files fduthesis.ins, %% fduthesis.cls, %% fduthesis-en.cls, diff --git a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-code.pdf b/Master/texmf-dist/doc/latex/fduthesis/fduthesis-code.pdf index 428fde6903f..65a33c48255 100644 Binary files a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-code.pdf and b/Master/texmf-dist/doc/latex/fduthesis/fduthesis-code.pdf differ diff --git a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-cover.tex b/Master/texmf-dist/doc/latex/fduthesis/fduthesis-cover.tex index a8b699c98a8..c0a69f45819 100644 --- a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-cover.tex +++ b/Master/texmf-dist/doc/latex/fduthesis/fduthesis-cover.tex @@ -7,7 +7,7 @@ %% fduthesis.dtx (with options: `cover') %% fduthesis-logo.dtx (with options: `cover') %% -%% Copyright (C) 2017--2020 by Xiangdong Zeng +%% Copyright (C) 2017--2022 by Xiangdong Zeng %% %% This work may be distributed and/or modified under the %% conditions of the LaTeX Project Public License, either @@ -26,7 +26,6 @@ %% This work consists of the files fduthesis.dtx, %% fduthesis-doc.dtx, %% fduthesis-logo.dtx, -%% fduthesis-template.tex, %% and the derived files fduthesis.ins, %% fduthesis.cls, %% fduthesis-en.cls, diff --git a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-en.pdf b/Master/texmf-dist/doc/latex/fduthesis/fduthesis-en.pdf index 2ee02030d2a..72fa0e8381f 100644 Binary files a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-en.pdf and b/Master/texmf-dist/doc/latex/fduthesis/fduthesis-en.pdf differ diff --git a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-en.tex b/Master/texmf-dist/doc/latex/fduthesis/fduthesis-en.tex index 1cb6b785782..12b8bad6893 100644 --- a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-en.tex +++ b/Master/texmf-dist/doc/latex/fduthesis/fduthesis-en.tex @@ -6,7 +6,7 @@ %% %% fduthesis.dtx %% -%% Copyright (C) 2017--2020 by Xiangdong Zeng +%% Copyright (C) 2017--2022 by Xiangdong Zeng %% %% This work may be distributed and/or modified under the %% conditions of the LaTeX Project Public License, either @@ -25,7 +25,6 @@ %% This work consists of the files fduthesis.dtx, %% fduthesis-doc.dtx, %% fduthesis-logo.dtx, -%% fduthesis-template.tex, %% and the derived files fduthesis.ins, %% fduthesis.cls, %% fduthesis-en.cls, @@ -59,7 +58,7 @@ \textbf{The \textsf{fduthesis} Class \\ \LaTeX{} Thesis Template for Fudan University}}} \author{Xiangdong Zeng} -\date{2020/08/30\quad v0.7e% +\date{2022/09/04\quad v0.8% \thanks{\url{https://github.com/stone-zeng/fduthesis}.}} \begin{document} @@ -135,11 +134,6 @@ divided into the following three types: you can use them in both Chinese and English templates. \end{itemize} -If you want to read the implementation part, please turn to the -Chinese version. Any issues or feature requests can be submitted -in the \href{https://github.com/stone-zeng/fduthesis/issues}% -{GitHub repository}. - \section{Installation} \subsection{Obtaining \cls{fduthesis}} @@ -169,49 +163,32 @@ manually, the recommended way is to use the TDS ZIP file: local TDS directory of \TeX{} distribution. \item Run \bashcmd{mktexlsr} to update the ls-R database. \end{itemize} -Although not recommended, you may generate the whole template -from source code as well: +\subsubsection{Development version} + +On CTAN, only the stable version of \cls{fduthesis} is provided, where new features and +bug fixes may not be included in time. To use the latest development version on GitHub, +you can use the install script: \begin{itemize} - \item Open the project's \href{https://github.com/stone-zeng/fduthesis}% - {homepage}, click ``Clone or download'' and choose - ``Download ZIP'' to download \file{fduthesis-master.zip}. - If you have git program on your computer, you can also - clone the repository directly: - \begin{shellexample}[gobble=5,alsoletter={.},% - morekeywords={git,clone}] + \item Open the project's \href{https://github.com/stone-zeng/fduthesis}{homepage}, click + ``Code'' button and choose ``Download ZIP'' to download \file{fduthesis-main.zip}. + If you have git program on your computer, you can also clone the repository directly: + \begin{shellexample}[gobble=5,alsoletter={.},morekeywords={git,clone}] git clone https://github.com/stone-zeng/fduthesis.git \end{shellexample} - \item Extract files, and get into the \file{source} directory. - Run the following command to generate all the components: - \begin{shellexample}[gobble=5,morekeywords={xetex}] - xetex fduthesis.dtx - \end{shellexample} - \item Copy the generated document classes (\file{.cls}), - packages (\file{.sty}) and configuration files (\file{.def}) - into \path{texmf-local/tex/latex/fduthesis/} under the local - TDS tree of \TeX{} distribution. Then run \bashcmd{mktexlsr} - to update the ls-R database. - \item When writing your thesis with \cls{fduthesis}, you need - to copy the file \file{fudan-name.pdf} (can be found in the - \file{testfiles/support} directory of the Git repository) to - your working directory, to make sure that the logo in the - cover can be displayed correctly. + \item Run \file{install-win.bat} (on Windows) or \file{install-linux.sh} (on Linux), + then all the necessary files will be found in the \file{thesis} folder. \end{itemize} -\subsubsection{\cls{fduthesis} on the fly} +\subsubsection{Overleaf} -If you don't want to install \cls{fduthesis} but need to use it -at once, you can try the installation scripts. Download the -repository from GitHub, run \file{install-win.bat} (on Windows) -or \file{install-linux.sh} (on Linux), then all the necessary -files will be found in the \file{thesis} folder. +\cls{fduthesis} also provides the \href{https://www.overleaf.com/latex/templates/fduthesis-latex-thesis-template-for-fudan-university/svtdhhstkmkt}{Overleaf version}. +You can follow the link and login to edit directly on the web. \subsection{Composition of the template} -There are several parts in \cls{fduthesis}, including kernel -template classes, configuration files, affiliated packages and -user's guides. More details are listed in table~% -\ref{tab:fduthesis-components}. +There are several parts in \cls{fduthesis}, including kernel template +classes, configuration files, affiliated packages and user's guides. +More details are listed in table~\ref{tab:fduthesis-components}. \begin{table}[ht] \caption{The main components of \cls{fduthesis}} @@ -219,24 +196,22 @@ user's guides. More details are listed in table~% \centering \begin{tabular}{lp{24em}} \toprule - \textbf{Files} & \textbf{Descriptions} \\ + \textbf{Files} & \textbf{Descriptions} \\ \midrule - \file{fduthesis.cls} & Document class for Chinese thesis. \\ - \file{fduthesis-en.cls} & Document class for English thesis.\\ - \file{fduthesis.def} & Configuration parameters file - for \cls{fduthesis}. Please do \emph{not} modify it. \\ - \file{fdudoc.cls} & Document class for user guides. \\ - \file{fdulogo.sty} & Fudan University's visual identity. \\ - \file{fudan-emblem.pdf} & University emblem. \\ - \file{fudan-emblem-new.pdf} & University emblem (revised version). \\ - \file{fudan-name.pdf} & Figure of university name. \\ - \file{README.md} & The brief introduction. \\ - \file{fduthesis.pdf} & User's guide in Chinese. \\ - \file{fduthesis-en.pdf} & User's guide in English (this - document). \\ - \file{fduthesis-code.pdf} & Code implementation. \\ - \file{fduthesis-template.tex} & An empty thesis template, and you can - write your thesis based on it. \\ + \file{fduthesis.cls} & Document class for Chinese thesis. \\ + \file{fduthesis-en.cls} & Document class for English thesis.\\ + \file{fduthesis.def} & Configuration parameters file + for \cls{fduthesis}. Please do \emph{not} modify it. \\ + \file{fdudoc.cls} & Document class for user guides. \\ + \file{fdulogo.sty} & Fudan University's visual identity. \\ + \file{fudan-emblem.pdf} & University emblem. \\ + \file{fudan-emblem-new.pdf} & University emblem (revised version). \\ + \file{fudan-name.pdf} & Figure of university name. \\ + \file{README.md} & The brief introduction. \\ + \file{fduthesis.pdf} & User's guide in Chinese. \\ + \file{fduthesis-en.pdf} & User's guide in English (this + document). \\ + \file{fduthesis-code.pdf} & Code implementation. \\ \bottomrule \end{tabular} \end{table} @@ -246,8 +221,8 @@ user's guides. More details are listed in table~% \subsection{Getting started} Here is a minimal \TeX{} file for \cls{fduthesis}: -\begin{latexexample}[gobble=1,deletetexcs={\documentclass},% - moretexcs={\chapter},morekeywords={\documentclass},% +\begin{latexexample}[gobble=1,deletetexcs={\documentclass}, + moretexcs={\chapter},morekeywords={\documentclass}, emph={[2]document}] % thesis.tex \documentclass{fduthesis} @@ -258,13 +233,13 @@ Here is a minimal \TeX{} file for \cls{fduthesis}: \end{document} \end{latexexample} -Compile this file under the instructions in subsection~% -\ref{subsec:compilation}, you will get a 5-page article. +Compile this file under the instructions in +subsection~\ref{subsec:compilation}, you will get a 5-page article. Of course, most of it will be blank, as you may predicate. The English version can be used in the same way: -\begin{latexexample}[gobble=1,deletetexcs={\documentclass},% - moretexcs={\chapter},morekeywords={\documentclass},% +\begin{latexexample}[gobble=1,deletetexcs={\documentclass}, + moretexcs={\chapter},morekeywords={\documentclass}, emph={[2]document}] % thesis-en.tex \documentclass{fduthesis-en} @@ -312,7 +287,7 @@ or You can specify some \emph{template options} when loading \cls{fduthesis}: -\begin{latexexample}[gobble=1,deletetexcs={\documentclass},% +\begin{latexexample}[gobble=1,deletetexcs={\documentclass}, morekeywords={\documentclass}] \documentclass(*\oarg{options}*){fduthesis} \documentclass(*\oarg{options}*){fduthesis-en} @@ -396,9 +371,9 @@ You may notice the following changes when using \opt{draft}: can be given via the general command \cs{fdusetup}. \end{function} -The argument of \cs{fdusetup} is a set of comma-separated option -list. The options usually have the form of \kvopt{\meta{key}}% -{\meta{value}} and in some cases \meta{value} can be omitted. +The argument of \cs{fdusetup} is a set of comma-separated option list. +The options usually have the form of \kvopt{\meta{key}}{\meta{value}} +and in some cases \meta{value} can be omitted. For the same option, the values given later will override the the previous ones. Default values are indicated in \textbf{boldface} in the following descriptions. @@ -414,7 +389,7 @@ can be abbreviated to \opt{\meta{option}} for boolean type. Some options, such as \opt{style} and \opt{info}, may have sub-options. They can be set by the following two equivalent methods: -\begin{latexexample}[gobble=1,morekeywords={\fdusetup},% +\begin{latexexample}[gobble=1,morekeywords={\fdusetup}, emph={[1]style,cjk-font,font-size,info,title,title*,author,author*,department}] \fdusetup{ style = {cjk-font = adobe, font-size = -4}, @@ -428,7 +403,7 @@ methods: } \end{latexexample} or -\begin{latexexample}[gobble=1,morekeywords={\fdusetup},% +\begin{latexexample}[gobble=1,morekeywords={\fdusetup}, emph={[1]style,cjk-font,font-size,info,title,title*,author,author*,department}] \fdusetup{ style/cjk-font = adobe, @@ -468,7 +443,7 @@ Note that you may \emph{not} put spaces around ``|/|''. \centering \begin{tabular}{ccccc} \toprule - & \strong{Roman} & \strong{Sans-serif} & \strong{Monospaced} & \strong{Math} \\ + & \textbf{Roman} & \textbf{Sans-serif} & \textbf{Monospaced} & \textbf{Math} \\ \midrule |garamond| & EB Garamond & Libertinus Sans & LM Mono\tnote{a} & Garamond Math \\ |libertinus| & Libertinus Serif & Libertinus Sans & LM Mono & Libertinus Math \\ @@ -500,7 +475,7 @@ Note that you may \emph{not} put spaces around ``|/|''. \centering \begin{tabular}{cccc} \toprule - & \strong{Roman (song)} & \strong{Sans-serif (hei)} & \strong{Monospaced (fang)} \\ + & \textbf{Roman (song)} & \textbf{Sans-serif (hei)} & \textbf{Monospaced (fang)} \\ \midrule |adobe| & Adobe Song Std & Adobe Heiti Std & Adobe Fangsong Std \\ |fandol| & FandolSong & FandolHei & FandolFang \\ @@ -555,9 +530,9 @@ will be helpful: \begin{function}{style/footnote-style} \begin{fdusyntax}[gobble=4,emph={[1]footnote-style}] footnote-style = (**) + ....\mbox{}~~~~~~~~~~~~~~~~~libertinus|libertinus*|libertinus-sans|\\ + ....\mbox{}~~~~~~~~~~~~~~~~~pifont|pifont*|pifont-sans|pifont-sans*|\\ + ....\mbox{}~~~~~~~~~~~~~~~~~xits|xits-sans|xits-sans*>*) \end{fdusyntax} Set the style of footnote numbers. Note that western fonts will affect its default value (see table~\ref{tab:footnote-font}), @@ -573,11 +548,11 @@ will be helpful: \centering \begin{tabular}{ccccc} \toprule - \textbf{Western fonts settings} & - |libertinus| & |lm| & |palatino| & |times| \\ + \textbf{Western fonts settings} & + |libertinus| & |lm| & |palatino| & |times| \\ \midrule - \textbf{Default value of footnote number style} & - |libertinus| & |pifont| & |pifont| & |xits| \\ + \textbf{Default value of footnote number style} & + |libertinus| & |pifont| & |pifont| & |xits| \\ \bottomrule \end{tabular} \end{table} @@ -592,10 +567,9 @@ will be helpful: the final document. \end{function} -\begin{function}[added=2017-08-13,updated=2017-12-08]{style/hyperlink-color} +\begin{function}[added=2017-08-13,updated=2021-12-27]{style/hyperlink-color} \begin{fdusyntax}[gobble=4,emph={[1]hyperlink-color}] - hyperlink-color = (*<(default)|classic|elegant|fantasy|material|\\ - XXXX\mbox{}~~~~~~~~~~~~~~~~~~business|science|summer|autumn|graylevel|prl>*) + hyperlink-color = (*<(default)|classic|material|graylevel|prl>*) \end{fdusyntax} Set the color of hyperlinks. It is invalid if \kvopt{hyperlink}{none}. The related colors can be found @@ -604,6 +578,7 @@ will be helpful: \begin{table}[ht] \centering +\small \newcommand\linkcolorexam[3]{% {\small Fig.~\textcolor[HTML]{#1}{1-2}, Eq.~(\textcolor[HTML]{#1}{3.4})} & @@ -615,32 +590,19 @@ will be helpful: \label{tab:hyperlink-color} \begin{tabular}{c*{3}{>{\hspace{0.2cm}}c<{\hspace{0.2cm}}}} \toprule - \textsf{Options} & \textsf{Cross references} & \textsf{URL} & \textsf{Citation} \\ + \textbf{Options} & \textbf{Cross references} & \textbf{URL} & \textbf{Citation} \\ \midrule - \opt{default} & \linkcolorexam{990000}{0000B2}{007F00} \\ - \opt{classic} & \linkcolorexam{FF0000}{0000FF}{00FF00} \\ - \opt{elegant}\tnote{a} & \linkcolorexam{961212}{C31818}{9B764F} \\ - \opt{fantasy}\tnote{b} & \linkcolorexam{FF4A19}{FF3F94}{934BA1} \\ - \opt{material}\tnote{c} & \linkcolorexam{E91E63}{009688}{4CAF50} \\ - \opt{business}\tnote{d} & \linkcolorexam{D14542}{295497}{1F6E43} \\ - \opt{science}\tnote{e} & \linkcolorexam{CA0619}{389F9D}{FF8920} \\ - \opt{summer}\tnote{f} & \linkcolorexam{00AFAF}{5F5FAF}{5F8700} \\ - \opt{autumn}\tnote{f} & \linkcolorexam{D70000}{D75F00}{AF8700} \\ - \opt{graylevel}\tnote{c} & \linkcolorexam{616161}{616161}{616161} \\ - \opt{prl}\tnote{g} & \linkcolorexam{2D3092}{2D3092}{2D3092} \\ + \opt{default} & \linkcolorexam{990000}{0000B2}{007F00} \\ + \opt{classic} & \linkcolorexam{FF0000}{0000FF}{00FF00} \\ + \opt{material}\tnote{a} & \linkcolorexam{E91E63}{009688}{4CAF50} \\ + \opt{graylevel}\tnote{a} & \linkcolorexam{616161}{616161}{616161} \\ + \opt{prl}\tnote{b} & \linkcolorexam{2D3092}{2D3092}{2D3092} \\ \bottomrule \end{tabular} \begin{tablenotes} - \item[a] From \href{https://tex.stackexchange.com/}% - {\TeX{} - \LaTeX{} Stack Exchange}. - \item[b] Adobe CC. - \item[c] Material Design color palette + \item[a] Material Design color palette (See \url{https://material.io/guidelines/style/color.html}). - \item[d] Microsoft Office 2016. - \item[e] From \href{https://www.wolfram.com/}{Wolfram Research website}. - \item[f] Solarized color palette - (See \url{http://ethanschoonover.com/solarized}). - \item[g] \textit{Physical Review Letter} magazine. + \item[b] \textit{Physical Review Letter} magazine. \end{tablenotes} \end{threeparttable} \end{table} @@ -655,8 +617,7 @@ will be helpful: if you choose \opt{biblatex}. \end{function} -\begin{function}[added=2017-10-28,updated=2018-01-25]% - {style/bib-style} +\begin{function}[added=2017-10-28,updated=2018-01-25]{style/bib-style} \begin{fdusyntax}[gobble=4,emph={[1]bib-style}] bib-style = (**) \end{fdusyntax} @@ -718,9 +679,17 @@ will be helpful: subsubsection~\ref{subsubsec:information}. \end{function} +\begin{function}[added=2021-09-21]{style/declaration-page} + \begin{fdusyntax}[gobble=4,emph={[1]declaration-page}] + declaration-page = (*\marg{file}*) + \end{fdusyntax} + Insert the scanned declaration page PDF file. If empty (default), + then the pre-defined declaration page will be inserted. +\end{function} + \begin{function}{\makecoveri,\makecoverii,\makecoveriii} For generating thesis cover, list of instructors and - declaration page manually. These commands cannot ensure + declaration page manually. These commands cannot guarantee the correct page numbers, hence you should always use the auto-generated thesis cover unless necessary. \end{function} @@ -750,7 +719,7 @@ will be helpful: title = (*\marg{title in Chinese}*) title* = (*\marg{title in English}*) \end{fdusyntax} - Title of your thesis. The line width is about \SI{30}{em} by + Title of your thesis. The line width is about \qty{30}{em} by default, but you may break it with |\\| manually. \end{function} @@ -857,6 +826,15 @@ serial number. Chinese Library Classification (CLC). \end{function} +\begin{function}[added=2021-09-16]{info/jel} + \begin{fdusyntax}[gobble=4,emph={[1]jel}] + jel = (*\marg{classification codes}*) + \end{fdusyntax} + \textit{Journal of Economic Literature} (JEL) Classification + Code. It's only mandatory for some departments. When specified, + CLC code in the English abstract will be replaced by it. +\end{function} + \subsection{Writing your thesis} \subsubsection{Front matter} @@ -901,7 +879,7 @@ main matter. \end{function} At the end of abstract (both Chinese and English, if available), -keywords list and CLC number will be shown. They can be +keywords list and CLC or JEL code will be shown. They can be specified via command \cs{fdusetup} and you may refer to subsubsection~\ref{subsubsec:information} for more details. @@ -918,7 +896,7 @@ subsubsection~\ref{subsubsec:information} for more details. The optional argument \meta{column format} is the same as in a standard \LaTeX{} table. The default value is ``|lp{7.5cm}|'', which means auto-width for the first column - and fix-width (\SI{7.5}{cm}) for the second; both columns will + and fix-width (\qty{7.5}{cm}) for the second; both columns will be left-aligned. \end{function} @@ -934,15 +912,129 @@ idea to split the source file into several parts. The page numbers in main matter are shown in arabic numerals. \begin{function}[updated=2018-01-15]{\footnote} - \begin{fdusyntax}[gobble=4,deletetexcs={\footnote},% - morekeywords={\footnote}] + \begin{fdusyntax}[gobble=4,deletetexcs={\footnote},morekeywords={\footnote}] \footnote(*\marg{text}*) \end{fdusyntax} Insert a footnote. The style of footnote numbers can be set - with option \opt{style/foot\-note\-style}. See subsubsection~% - \ref{subsubsec:style-and-format} for more details. + with option \opt{style/foot\-note\-style}. See + subsubsection~\ref{subsubsec:style-and-format} for more details. \end{function} +\begin{function}{\caption} + \begin{fdusyntax}[gobble=4,deletetexcs={\caption},morekeywords={\caption}] + \caption(*\marg{caption}*) + \caption(*\oarg{short caption}\marg{long caption}*) + \end{fdusyntax} + Insert the caption of figure or table. The optional argument + \meta{short caption} will be shown in the list of figures/tables. + In \meta{long caption}, you can write descriptions for several + paragraphs, but \meta{short caption} and the single + \meta{caption} will not allow multi-paragraph text (i.e.\ + text containing \tn{par}) inside. +\end{function} + +By convention, caption of a table is usually put \emph{before} +the table itself, while for figure it's the opposite. +In addition, command \tn{caption} must be put inside float +environments (e.g.\ \env{table} and \env{figure}). + +\paragraph{Citations} +\begin{function}{\cite} + \begin{fdusyntax}[gobble=4,deletetexcs={\cite},morekeywords={\cite}] + \cite(*\marg{bib key}*) + \cite(*\oarg{page number}\marg{bib key}*) + \end{fdusyntax} + Insert citations. The optional argument \meta{page number} can be + used to indicate the page number of the citation. The citation style + varies among different bibliography styles. More commands are also + provided to mark the citations, which can be found in + table~\ref{tab:citation-numerical} (numerical style) and + \ref{tab:citation-author-year} (author-year style). +\end{function} + +\NewDocumentCommand\verbcite{O{cite}om}{^^A + \IfNoValueTF{#2}{^^A + \texttt{\textbackslash#1\{#3\}}^^A + }{^^A + \texttt{\textbackslash#1[#2]\{#3\}}^^A + }} +\begin{table}[ht] + \caption{Citations in numerical style} \label{tab:citation-numerical} + \centering + \small + \def\C#1{\textcolor{MaterialGreen}{#1}} + \begin{tabularx}{\textwidth}{cCll} + \toprule + \textbf{Styles} & + \textbf{Results} & + \textbf{\kvopt{bib-backend}{bibtex}} & + \textbf{\kvopt{bib-backend}{biblatex}} \\ + \midrule + Single & + Text\textsuperscript{[\C1]} & + \verbcite{texbook} & + Same as left \\ + Multiple & + Text\textsuperscript{[\C1--\C2]} & + \verbcite{texbook,companion} & + Same as left \\ + With page & + Text\textsuperscript{[\C1]126--137} & + \verbcite[cite][126--137]{texbook} & + Same as left \\ + With author & + Knuth\textsuperscript{[\C1]} states & + \verbcite[citet]{texbook} & + \verbcite[authornumcite]{texbook} \\ + With page and author & + Knuth\textsuperscript{[\C1]42} states & + \verbcite[citet][42]{texbook} & + \verbcite[authornumcite][42]{texbook} \\ + No superscript & + Text [\C1] & + \verbcite[parencite]{texbook} & + Same as left \\ + \bottomrule + \end{tabularx} +\end{table} + +\begin{table}[ht] + \caption{Citations in author-year style} \label{tab:citation-author-year} + \centering + \small + \def\C#1{\textcolor{MaterialGreen}{#1}} + \begin{tabularx}{\textwidth}{cCll} + \toprule + \textbf{Styles} & + \textbf{Results} & + \textbf{\kvopt{bib-backend}{bibtex}} & + \textbf{\kvopt{bib-backend}{biblatex}} \\ + \midrule + Single & + (\C{Knuth}, \C{1986}) & + \verbcite[citep]{texbook} & + \verbcite{texbook} \\ + Multiple & + (\C{Knuth}, \C{1986}; \C{Mittelbach et al.}, \C{2004}) & + \verbcite[citep]{texbook,companion} & + \verbcite{texbook,companion} \\ + With page & + (\C{Knuth}, \C{1986})\textsuperscript{126--137} & + \verbcite[citep][126--137]{texbook} & + \verbcite[cite][126--137]{texbook} \\ + With author & + \C{Knuth} (\C{1986}) & + \verbcite[citet]{texbook} & + Same as left \\ + With page and author & + \C{Knuth} (\C{1986})\textsuperscript{42} & + \verbcite[citet][42]{texbook} & + Same as left \\ + \bottomrule + \end{tabularx} +\end{table} + +\paragraph{Theorem-like environments} \begin{function}{axiom,corollary,definition,example,lemma, proof,theorem} \begin{fdusyntax}[gobble=4,emph={[2]proof}] @@ -1036,24 +1128,6 @@ are described below. Note that you don't need to type in the This option is invalid for \cs{newtheorem*}. \end{function} -\begin{function}{\caption} - \begin{fdusyntax}[gobble=4,deletetexcs={\caption},morekeywords={\caption}] - \caption(*\marg{caption}*) - \caption(*\oarg{short caption}\marg{long caption}*) - \end{fdusyntax} - Insert the caption of figure or table. The optional argument - \meta{short caption} will be shown in the list of figures/tables. - In \meta{long caption}, you can write descriptions for several - paragraphs, but \meta{short caption} and the single - \meta{caption} will not allow multi-paragraph text (i.e.\ - text containing \tn{par}) inside. -\end{function} - -By convention, caption of a table is usually put \emph{before} -the table itself, while for figure it's the opposite. -In addition, command \tn{caption} must be put inside float -environments (e.g.\ \env{table} and \env{figure}). - \subsubsection{Back matter} \begin{function}{\backmatter} @@ -1068,13 +1142,12 @@ Back matter contains bibliography, declaration page, etc. \end{fdusyntax} Print the bibliography. When \kvopt{bib-backend}{bibtex}, then \meta{options} is invalid and this command is equivalent to - \tn{bibliography} \texttt{\marg{bib files}}, where - \meta{bib files} should be specified with option - \opt{style/bib-resource} (see subsubsection~% - \ref{subsubsec:style-and-format}). When \kvopt{bib-backend}% - {bibtex}, then \tn{printbibliography} is provided by - \pkg{biblatex} and the available options can be found in its - documentation. + \tn{bibliography} \texttt{\marg{bib files}}, where \meta{bib files} + should be specified with option \opt{style/bib-resource} (see + subsubsection~\ref{subsubsec:style-and-format}). When + \kvopt{bib-backend}{bibtex}, then \tn{printbibliography} is + provided by \pkg{biblatex} and the available options can be + found in its documentation. \end{function} \section{Packages dependencies} @@ -1085,9 +1158,8 @@ different packages dependency. Details are as follows: \item In any case, \cls{fduthesis} will load the following packages \emph{explicitly}: \begin{itemize} - \item \pkg{expl3}, \pkg{xparse}, \pkg{xtemplate} and - \pkg{l3keys2e}, belong to \pkg{l3kernel} and - \pkg{l3packages} bundles + \item \pkg{xtemplate} and \pkg{l3keys2e}, belong to + \pkg{l3packages} bundle \item \cls{ctexbook}, belongs to \CTeX{} bundle \item \pkg{amsmath}, belongs to \AmSLaTeX{} bundle \item \pkg{unicode-math} diff --git a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-template.tex b/Master/texmf-dist/doc/latex/fduthesis/fduthesis-template.tex deleted file mode 100644 index 3965d377b88..00000000000 --- a/Master/texmf-dist/doc/latex/fduthesis/fduthesis-template.tex +++ /dev/null @@ -1,382 +0,0 @@ -% \iffalse meta-comment -% -% Copyright (C) 2017--2020 by Xiangdong Zeng -% -% This work may be distributed and/or modified under the -% conditions of the LaTeX Project Public License, either -% version 1.3c of this license or (at your option) any later -% version. The latest version of this license is in: -% -% http://www.latex-project.org/lppl.txt -% -% and version 1.3 or later is part of all distributions of -% LaTeX version 2005/12/01 or later. -% -% This work has the LPPL maintenance status `maintained'. -% -% The Current Maintainer of this work is Xiangdong Zeng. -% -% \fi - -%********************************************************************* -% fduthesis: 复旦大学论文模板 -% 2020/08/30 v0.7e -% -% 重要提示: -% 1. 请确保使用 UTF-8 编码保存 -% 2. 请使用 XeLaTeX 或 LuaLaTeX 编译 -% 3. 请仔细阅读用户文档 -% 4. 修改、使用、发布本文档请务必遵循 LaTeX Project Public License -% 5. 不需要的注释可以尽情删除 -%********************************************************************* - -\documentclass{fduthesis} -% 模板选项: -% type = doctor|master|bachelor 论文类型,默认为本科论文 -% oneside|twoside 论文的单双面模式,默认为 twoside -% draft = true|false 是否开启草稿模式,默认关闭 -% 带选项的用法示例: -% \documentclass[oneside]{fduthesis} -% \documentclass[twoside, draft=true]{fduthesis} -% \documentclass[type=bachelor, twoside, draft=true]{fduthesis} - -\fdusetup{ - % 参数设置 - % 允许采用两种方式设置选项: - % 1. style/... = ... - % 2. style = { ... = ... } - % 注意事项: - % 1. 不要出现空行 - % 2. “=” 两侧的空格会被忽略 - % 3. “/” 两侧的空格不会被忽略 - % 4. 请使用英文逗号 “,” 分隔选项 - % - % style 类用于设置论文格式 - style = { - % font = times, - % 西文字体(包括数学字体) - % 允许选项: - % font = garamond|libertinus|lm|palatino|times|times*|none - % - % cjk-font = fandol, - % 中文字体 - % 允许选项: - % cjk-font = adobe|fandol|founder|mac|sinotype|sourcehan|windows|none - % - % 注意: - % 1. 中文字体设置高度依赖于系统。各系统建议方案: - % windows:cjk-font = windows - % mac: cjk-font = mac - % linux: cjk-font = fandol(默认值) - % 2. 除 fandol 和 sourcehan 外,其余字体均为商用字体,请注意版权问题 - % 3. 但 fandol 字体缺字比较严重,而 sourcehan 没有配备楷体和仿宋体 - % 4. 这里中西文字体设置均注释掉了,即使用默认设置: - % font = times - % cjk-font = fandol - % 5. 使用 font = none / cjk-font = none 关闭默认字体设置,需手动进行配置 - % - font-size = 5, - % 字号 - % 允许选项: - % font-size = -4|5 - % - % fullwidth-stop = catcode, - % 是否把全角实心句点 “.” 作为默认的句号形状 - % 允许选项: - % fullwidth-stop = catcode|mapping|false - % 说明: - % catcode 显式的 “。” 会被替换为 “.”(e.g. 不包括用宏定义保存的 “。”) - % mapping 所有的 “。” 会被替换为 “.”(使用 LuaLaTeX 编译则无效) - % false 不进行替换 - % - footnote-style = xits, - % 脚注编号样式 - % 允许选项: - % footnote-style = plain|libertinus|libertinus*|libertinus-sans| - % pifont|pifont*|pifont-sans|pifont-sans*| - % xits|xits-sans|xits-sans* - % - % hyperlink = color, - % 超链接样式 - % 允许选项: - % hyperlink = border|color|none - % - % hyperlink-color = default, - % 超链接颜色 - % 允许选项: - % hyperlink-color = default|classic|elegant|fantasy|material| - % business|science|summer|autumn|graylevel|prl - % 默认与西文字体保持一致 - % - bib-backend = bibtex, - % 参考文献支持方式 - % 允许选项: - % bib-backend = bibtex|biblatex - % - % bib-style = numerical, - % 参考文献样式 - % 允许选项: - % bib-style = author-year|numerical|<其他样式> - % 说明: - % author-year 著者—出版年制 - % numerical 顺序编码制 - % <其他样式> 使用其他 .bst(bibtex)或 .bbx(biblatex)格式文件 - % - % cite-style = {}, - % 引用样式 - % 默认为空,即与参考文献样式保持一致 - % 仅适用于 biblatex;如要填写,需保证相应的 .cbx 格式文件能被调用 - % - bib-resource = {fduthesis-template.bib}, - % 参考文献数据源 - % 可以是单个文件,也可以是用英文逗号 “,” 隔开的一组文件 - % 如果使用 biblatex,则必须明确给出 .bib 后缀名 - % - % logo = {fudan-name.pdf}, - % 封面中的校名图片 - % 模版已自带,通常不需要额外配置 - % - % logo-size = {0.5\textwidth}, % 只设置宽度 - % logo-size = {{}, 3cm}, % 只设置高度 - % logo-size = {8cm, 3cm}, % 设置宽度和高度 - % 设置校名图片的大小 - % 通常不需要调整 - % - % auto-make-cover = true - % 是否自动生成论文封面(封一)、指导小组成员名单(封二)和声明页(封三) - % 除非特殊需要(e.g. 不要封面),否则不建议设为 false - }, - % - % info 类用于录入论文信息 - info = { - title = {论文标题}, - % 中文标题 - % 长标题建议使用 “\\” 命令手动换行(不是指在源文件里输入回车符,当然 - % 源文件里适当的换行可以有助于代码清晰): - % title = {最高人民法院、最高人民检察院关于适用\\ - % 犯罪嫌疑人、被告人逃匿、死亡案件违法所得\\ - % 没收程序若干问题的规定}, - % - title* = {Thesis Title}, - % 英文标题 - % - author = {王二}, - % 作者姓名 - % - % author* = {Your name}, - % 作者姓名(英文 / 拼音) - % 目前不需要填写 - % - supervisor = {某某某\quad 教授}, - % 导师 - % 姓名与职称之间可以用 \quad 打印一个空格 - % - major = {物理学}, - % 专业 - % - degree = academic, - % 学位类型 - % 允许选项: - % degree = academic|professional - % 说明: - % academic 学术学位 - % professional 专业学位 - % - department = {物理系}, - % 院系 - % - student-id = {12300000000}, - % 作者学号 - % - % date = {2020 年 1 月 1 日}, - % 日期 - % 注释掉表示使用编译日期 - % - % secret-level = ii, - % 密级 - % 允许选项: - % secret-level = none|i|ii|iii - % 说明: - % none 不显示密级与保密年限 - % i 秘密 - % ii 机密 - % iii 绝密 - % - % secret-year = {五年}, - % 保密年限 - % secret-level = none 时该选项无效 - % - instructors = { - {张\quad 三 \quad 教\quad 授}, - {李\quad 四 \quad 教\quad 授}, - {王五六 \quad 研究员} - }, - % 指导小组成员 - % 使用英文逗号 “,” 分隔 - % 如有需要,可以用 \quad 手工对齐 - % - keywords = {不确定关系, 量子力学, 理论物理}, - % 中文关键字 - % 使用英文逗号 “,” 分隔 - % - keywords* = {Uncertainty principle, quantum mechanics, theoretical physics}, - % 英文关键字 - % 使用英文逗号 “,” 分隔 - % - clc = {O413.1} - % 中图分类号 - } -} - -% 需要的宏包可以自行调用 -\usepackage{physics} - -% 需要的命令可以自行定义 -\newcommand{\hilbertH}{\symcal{H}} -\newcommand{\ee}{\symrm{e}} -\newcommand{\ii}{\symrm{i}} - -\begin{document} - -% 这个命令用来关闭版心底部强制对齐,可以减少不必要的 underfull \vbox 提示,但会影响排版效果 -% \raggedbottom - -% 前置部分包含目录、中英文摘要以及符号表等 -\frontmatter - -% 目录 -\tableofcontents -% 插图目录 -\listoffigures -% 表格目录 -% \listoftables - -\begin{abstract} - 中文摘要 -\end{abstract} - -\begin{abstract*} - English abstract -\end{abstract*} - -% 符号表 -% 语法与 LaTeX 表格一致:列用 & 区分,行用 \\ 区分 -% 如需修改格式,可以使用可选参数: -% \begin{notation}[ll] -% $x$ & 坐标 \\ -% $p$ & 动量 -% \end{notation} -% 可选参数与 LaTeX 标准表格的列格式说明语法一致 -% 这里的 “ll” 表示两列均为自动宽度,并且左对齐 -\begin{notation}[ll] - $x$ & 坐标 \\ - $p$ & 动量 \\ - $\psi(x)$ & 波函数 \\ - $\bra{x}$ & 左矢(bra) \\ - $\ket{x}$ & 右矢(ket) \\ - $\ip{\alpha}{\beta}$ & 内积 \\ -\end{notation} - -% 主体部分是论文的核心 -\mainmatter - -% 建议采用多文件编译的方式 -% 比较好的做法是把每一章放进一个单独的 tex 文件里,并在这里用 \include 导入,例如 -% \include{chapter1} -% \include{chapter2} -% \include{chapter3} - -\chapter{介绍} - -\strong{量子力学}是物理学的分支学科。它主要描写微观的事物,与相对论一起被认为是现代物理学的两大 -基本支柱,许多物理学理论和科学,如原子物理学、固体物理学、核物理学和粒子物理学以及其它相关的学科, -都是以其为基础\cite{曾谨言2013量子力学,feynman2011feynman}。 - -\section{量子力学历史概要} - -\section{研究对象} - -\section{研究方法} - -\chapter{数学基础} - -\section{基础公设} - -整个量子力学的数学理论可以建立于五个基础公设。这些公设不能被严格推导出来的,而是从实验结果仔细分析 -归纳总结而得到的。从这五个公设,可以推导出整个量子力学。假若量子力学的理论结果不符合实验结果, -则必须将这些基础公设加以修改,直到没有任何不符合之处。至今为止,量子力学已被实验核对至极高准确度, -还没有找到任何与理论不符合的实验结果,虽然有些理论很难直觉地用经典物理的概念来理解,例如,波粒 -二象性、量子纠缠等等\cite{zurek2014quantum,cohen2013claude,zettili2003quantum}。 - -\begin{enumerate} - \item 量子态公设:量子系统在任意时刻的状态(量子态)可以由希尔伯特空间 $\hilbertH$ 中的态矢量 - $\ket{\psi}$ 来设定,这态矢量完备地给出了这量子系统的所有信息。这公设意味着量子系统遵守% - \emph{态叠加原理},假若 $\ket*{\psi_1}$、$\ket*{\psi_2}$ 属于希尔伯特空间 $\hilbertH$,则 - $c_1\ket*{\psi_1} + c_2\ket*{\psi_2}$ 也属于希尔伯特空间 $\hilbertH$。 - \item 时间演化公设: 态矢量为 $\ket{\psi(t)}$ 的量子系统,其动力学演化可以用薛定谔方程表示: - \begin{equation} - \ii\hbar \pdv{t} \ket{\psi(t)} = \hat{H} \ket{\psi(t)}. - \end{equation} - 其中,哈密顿算符 $\hat{H}$ 对应于量子系统的总能量,$\hbar$ 是约化普朗克常数。根据薛定谔方程, - 假设时间从 $t_0$ 变化到 $t$,则态矢量从 $\ket*{\psi(t_0)}$ 演化到 $\ket{\psi(t)}$,该过程以 - 方程表示为 - \begin{equation} - \ket{\psi(t)} = \hat{U}(t,\,t_0) \ket*{\psi(t_0)}. - \end{equation} - 其中 $\hat{U}(t,\,t_0) = \ee^{-\ii\hat{H}(t-t_0) / \hbar}$ 是时间演化算符。 - \item 可观察量公设:每个可观察量 $A$ 都有其对应的厄米算符 $\hat{A}$,而算符 $\hat{A}$ 的所有 - 本征矢量共同组成一个完备基底。 - \item 坍缩公设:对于量子系统测量某个可观察量 $A$ 的过程,可以数学表示为将对应的厄米算符 - $\hat{A}$ 作用于量子系统的态矢量 $\ket{\psi}$,测量值只能为厄米算符 $\hat{A}$ 的本征值。 - 在测量后,假设测量值为 $a_i$,则量子系统的量子态立刻会坍缩为对应于本征值 $a_i$ 的本征态 - $\ket*{e_i}$。 - \item 波恩公设:对于这测量,获得本征值 $a_i$ 的概率为量子态 $\ket{\psi}$ 处于本征态 $\ket*{e_i}$ - 的概率幅的绝对值平方。\footnote{% - 使用可观察量 $A$ 的基底 $\qty{e_1,\,e_2,\,\ldots,\,e_n}$,量子态 $\ket{\psi}$ 可以表示为 - $\ket{\psi} = \sum_j c_j \ket*{e_j}$,其中 $c_j$ 是量子态 $\ket{\psi}$ 处于本征态 - $\ket*{e_j}$ 的概率幅。根据波恩定则,对于此次测量,获得本征值 $a_i$ 的概率为 - $\abs*{\ip*{e_i}{\psi}}^2 = \abs*{c_i}^2$。} -\end{enumerate} - -\section{量子态与量子算符} - -量子态指的是量子系统的状态,态矢量可以用来抽象地表现量子态。采用狄拉克标记,态矢量表示为右矢 -$\ket{\psi}$;其中,在符号内部的希腊字母 $\psi$ 可以是任何符号、字母、数字,或单字。例如, -沿着磁场方向测量电子的自旋,得到的结果可以是上旋或是下旋,分别标记为 $\ket{\uparrow}$ 和 -$\ket{\downarrow}$。 - -\begin{figure}[htb] - \centering - \includegraphics[width=0.5\textwidth]{fduthesis-template-image.png} - \caption[施特恩—格拉赫实验]{% - 设定施特恩—格拉赫实验仪器的磁场方向为 $z$-轴,入射的银原子束可以被分裂成两道银原子束,每一道 - 银原子束代表一种量子态,上旋 $\ket{\uparrow}$ 或下旋 $\ket{\downarrow}$% - \cite{wikimedia:stern-gerlach-experiment}。} - \label{fig:stern-gerlach-experiment} -\end{figure} - -对量子态做操作定义,量子态可以从一系列制备程序来辨认,即这程序所制成的量子系统拥有这量子态。例如, -使用施特恩—格拉赫实验仪器,设定磁场朝着 $z$-轴方向,如图~\ref{fig:stern-gerlach-experiment} 所示, -可以将入射的银原子束,依照自旋的 $z$-分量分裂成两道,一道为上旋,量子态为 $\ket{\uparrow}$;另一道 -为下旋,量子态为 $\ket{\downarrow}$,这样,可以制备成量子态为 $\ket{\uparrow}$ 的银原子束,或量子态 -为 $\ket{\downarrow}$ 的银原子束。原本银原子束的态矢量可以按照态叠加原理表示为 -\begin{equation} - \ket{\psi} = \alpha \ket{\uparrow} + \beta \ket{\downarrow}. -\end{equation} -其中,$\alpha$、$\beta$ 是复值系数,$\abs{\alpha}^2$、$\abs{\beta}^2$ 分别为入射银原子束处于上旋、 -下旋的概率,且有 -\begin{equation} - \abs{\alpha}^2 + \abs{\beta}^2 = 1. -\end{equation} - -\section{动力学演化} - -\chapter{总结与展望} - -% 后置部分包含参考文献、声明页(自动生成)等 -\backmatter - -% 打印参考文献列表 -\printbibliography - -\end{document} diff --git a/Master/texmf-dist/doc/latex/fduthesis/fduthesis.pdf b/Master/texmf-dist/doc/latex/fduthesis/fduthesis.pdf index 37b0b8ebbfb..5d982b15aa1 100644 Binary files a/Master/texmf-dist/doc/latex/fduthesis/fduthesis.pdf and b/Master/texmf-dist/doc/latex/fduthesis/fduthesis.pdf differ -- cgit v1.2.3