From 56e4ae7a5ecbbf9bf7b858d20cb0c3e0d21edc8a Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 30 Jun 2015 21:25:49 +0000 Subject: pkuthss (30jun15) git-svn-id: svn://tug.org/texlive/trunk@37719 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/pkuthss/example.pdf | Bin 99959 -> 99959 bytes Master/texmf-dist/doc/latex/pkuthss/readme.pdf | Bin 398104 -> 398602 bytes .../doc/latex/pkuthss/readme/ChangeLog.txt | 9 + .../doc/latex/pkuthss/readme/chap/abstract.tex | 39 --- .../doc/latex/pkuthss/readme/chap/acknowledge.tex | 40 --- .../doc/latex/pkuthss/readme/chap/chap1.tex | 203 ----------- .../doc/latex/pkuthss/readme/chap/chap2.tex | 378 -------------------- .../doc/latex/pkuthss/readme/chap/chap3.tex | 150 -------- .../doc/latex/pkuthss/readme/chap/conclusion.tex | 35 -- .../doc/latex/pkuthss/readme/chap/copyright.tex | 49 --- .../doc/latex/pkuthss/readme/chap/encl1.tex | 45 --- .../doc/latex/pkuthss/readme/chap/introduction.tex | 70 ---- .../latex/pkuthss/readme/chap/pkuthss-abstract.tex | 39 +++ .../pkuthss/readme/chap/pkuthss-acknowledge.tex | 40 +++ .../latex/pkuthss/readme/chap/pkuthss-chap1.tex | 203 +++++++++++ .../latex/pkuthss/readme/chap/pkuthss-chap2.tex | 379 +++++++++++++++++++++ .../latex/pkuthss/readme/chap/pkuthss-chap3.tex | 150 ++++++++ .../pkuthss/readme/chap/pkuthss-conclusion.tex | 35 ++ .../pkuthss/readme/chap/pkuthss-copyright.tex | 49 +++ .../latex/pkuthss/readme/chap/pkuthss-encl1.tex | 45 +++ .../pkuthss/readme/chap/pkuthss-introduction.tex | 70 ++++ .../doc/latex/pkuthss/readme/pkuthss.tex | 38 +-- 22 files changed, 1038 insertions(+), 1028 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/abstract.tex delete mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/acknowledge.tex delete mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap1.tex delete mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap2.tex delete mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap3.tex delete mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/conclusion.tex delete mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/copyright.tex delete mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/encl1.tex delete mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/introduction.tex create mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-abstract.tex create mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-acknowledge.tex create mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap1.tex create mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap2.tex create mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap3.tex create mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-conclusion.tex create mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-copyright.tex create mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-encl1.tex create mode 100644 Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-introduction.tex (limited to 'Master/texmf-dist/doc/latex/pkuthss') diff --git a/Master/texmf-dist/doc/latex/pkuthss/example.pdf b/Master/texmf-dist/doc/latex/pkuthss/example.pdf index 7be74754a80..31fe9395a32 100644 Binary files a/Master/texmf-dist/doc/latex/pkuthss/example.pdf and b/Master/texmf-dist/doc/latex/pkuthss/example.pdf differ diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme.pdf b/Master/texmf-dist/doc/latex/pkuthss/readme.pdf index 5304c7af7f4..437091e6b69 100644 Binary files a/Master/texmf-dist/doc/latex/pkuthss/readme.pdf and b/Master/texmf-dist/doc/latex/pkuthss/readme.pdf differ diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/ChangeLog.txt b/Master/texmf-dist/doc/latex/pkuthss/readme/ChangeLog.txt index 53e9360b66b..71b0a7b1b94 100644 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/ChangeLog.txt +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/ChangeLog.txt @@ -1,3 +1,12 @@ +2015-06-30, v1.6.3 + + * Changes to documentation: + - Disambiguate file names wrt CTAN recommendation. + - pkuthss-chap2.tex: fix some minor details. + + * Misc: + - dist: reduce duplication in zipballs according to CTAN recommendation. + 2015-05-30, v1.6.2 * Changes to example template: diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/abstract.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/abstract.tex deleted file mode 100644 index 84d0cb64ef1..00000000000 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/abstract.tex +++ /dev/null @@ -1,39 +0,0 @@ -% vim:ts=4:sw=4 -% -% Documentation for pkuthss. -% -% Copyright (c) 2008-2009 solvethis -% Copyright (c) 2010-2014 Casper Ti. Vector -% -% This work may be distributed and/or modified under the conditions of the -% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. -% -% This work consists of the following files: -% pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex - -\begin{cabstract} - 本文介绍了 pkuthss 文档模版所提供的功能。 -\end{cabstract} - -\begin{eabstract} - This document describes the the functions provided by - the pkuthss document template. -\end{eabstract} - diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/acknowledge.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/acknowledge.tex deleted file mode 100644 index 39a388cfd66..00000000000 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/acknowledge.tex +++ /dev/null @@ -1,40 +0,0 @@ -% vim:ts=4:sw=4 -% -% Documentation for pkuthss. -% -% Copyright (c) 2008-2009 solvethis -% Copyright (c) 2010-2012,2015 Casper Ti. Vector -% -% This work may be distributed and/or modified under the conditions of the -% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. -% -% This work consists of the following files: -% pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex - -\chapter{致谢} - -感谢北大未名 BBS 上 MathTools 版和 Thesis 版诸位同学的支持。 -特别感谢 pkuthss 模版的最初创作者 solvethis 网友, -以及不断地对 Casper 提出的诸多问题予以解答的 cauchy 网友 :) - -此外还要感谢 \parencite{pku-thesisstyle} 的作者, -让我校在学位论文格式要求的繁复程度上离隔壁更近了一步, -同时还达成了用 \hologo{TeX} 排版出和 M\$ Word 一样审美水平论文的伟大成就。 - diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap1.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap1.tex deleted file mode 100644 index 2fc48cc968c..00000000000 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap1.tex +++ /dev/null @@ -1,203 +0,0 @@ -% vim:ts=4:sw=4 -% -% Documentation for pkuthss. -% -% Copyright (c) 2008-2009 solvethis -% Copyright (c) 2010-2015 Casper Ti. Vector -% -% This work may be distributed and/or modified under the conditions of the -% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. -% -% This work consists of the following files: -% pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex - -\chapter{使用介绍} - \section{系统要求}\label{sec:req} - - 正确编译需要以下几部分: - \begin{itemize} - \item 一个基本的 \hologo{TeX} 发行版。 - \item CJK 或 XeCJK(供 \hologo{XeLaTeX} 使用)宏包。 - \item ctex\supercite{ctex,ctex-faq} 宏包(提供了 ctexbook 文档类)。 - \item 中文字体。 - \item 如果要使用 biblatex 进行文献列表和引用的排版的话, - 还需要 biblatex\supercite{biblatex} 宏包; - \item 如果需要对中文文献进行按汉语拼音的排序的话, - 还需要 biber\supercite{biber} 程序。 - \item 如果使用默认的文献列表和引用样式的话, - 还需要作者编写的 biblatex 样式 - (biblatex-caspervector\supercite{biblatex-caspervector})。 - \item 如果需要使用 Makefile 来实现自动编译,还需要 Make 工具; - 但如果使用由批处理实现的伪“Makefile”就不用了。 - \end{itemize} - - \myemph{最新}的\myemph{完全版} \hologo{TeX} Live 系统(\myemph{% - 注: - 某些 Linux 发行版软件仓库中的 \hologo{TeX} Live 有问题, - 建议使用独立安装版的 \hologo{TeX} Live% - \unemph{\footnote{\url{http://www.tug.org/texlive/}.}}。% - })都已经包含除中文字体和 Make 之外所有要求的项目。% - \myemph{% - 为了获得最好的支持, - 我们建议用户使用最新、完全版的 \hologo{TeX} 系统和各宏包。% - } - - 中文字体需要用户自行获得。\myemph{% - 注: - 一些中文字体的字库不全, - 只有 GB2312 字符集内字符的字体信息。 - 这种情况通常会造成编译生成的 pdf 文件中缺少部分字符, - 其中一种典型症状是“〇”字显示不出来。 - 如果要使用中易公司的字体, - 则建议使用 Windows Vista 及其以后版本提供的% - 宋体、黑体、楷体和仿宋体, - 以及 Microsoft Office 2003 及其以后版本提供的隶书和幼圆体, - 这些字体是 GB18030 字符集的,不存在上述问题。% - } - - Linux 用户可以从软件源获得 GNU 的 make; - 其它类 UNIX 系统应该也会提供 make 工具,请参阅相应的文档以获得帮助。% - Windows 用户可以从以下地址下载 Windows 下的 GNU make 工具:\\ - \hspace*{\parindent}% - \url{http://gnuwin32.sourceforge.net/packages/make.htm} - - \section{模版文件}\label{sec:doc-dir} - - 在正确安装 pkuthss 文档模版之后,在终端/命令提示符中执行 -\begin{Verbatim}[frame = single] -texdoc pkuthss -\end{Verbatim} - 所打开的 pdf 文件所在的同一目录中包含两个子目录和相应的两个 pdf 文件, - 其中 \verb|readme/| 为说明文档(即本文档)的源代码,% - \verb|example/| 为文档模版的源代码,% - \verb|readme.pdf| 和 \verb|example.pdf| - 分别为说明文档和文档模版的 pdf 文件。 - - \verb|example/| 目录下的源代码使用的是 UTF-8 编码, - 在现在 \hologo{TeX} 用户常用的编辑器中均已经有了良好的支持。 - 用户可以将 \verb|example/| 中的所有内容复制到合适的目录, - 并在此目录中根据模版修改出自己的论文。 - - \myemph{% - 注意: - 在 1.4 rc4 之后版本的 pkuthss 文档模版中,除了 \texttt{Make.bat} 之外, - 所有文件均是 LF(\texttt{\string\n})换行。 - 在 Windows 下用“记事本”打开这些文件时, - 所有的换行会变成某个奇怪的字符,而所有文字会挤在一行上。 - 这是“记事本”的固有问题, - 因此 pkuthss 文档模版的作者建议用户 - 使用支持 LF 换行的文本编辑器编辑文件。% - } - - 模版中的重要文件有: - \begin{itemize} - \item \verb|Makefile|: - 被 Make 工具调用的 Makefile,用于使编译工作自动化。 - \item \verb|Make.bat|:% - Windows 下的伪“Makefile”,用 Windows 批处理实现。 - - \item \verb|chap/|:目录,包含各章节内容: - \begin{itemize} - \item \verb|copyright.tex|: - 版权声明部分。 - \item \verb|originauth.tex|: - 原创性声明和使用授权说明部分\supercite{pku-originauth}。 - \end{itemize} - \myemph{% - 注:% - pkuthss 文档模版支持排版学校要求的二维码, - 请参考 \texttt{copyright.tex} 和 - \texttt{originauth.tex} 中的相关注释。% - } - - \item \verb|misc/|: - 目录,目前包含比较常用的字体配置: - \begin{itemize} - \item \verb|ctexopts.cfg|、\verb|ctex-fontset-pkuthss.def|: - 适用于 2.0 及以后版本的 ctex\supercite{ctex} 宏包。 - \item \verb|ctex-xecjk-windows.def|: - 适用于 2.0 以前版本的 ctex 宏包。 - \end{itemize} - 使用时, - 请将和用户系统中 ctex 宏包版本相匹配的\myemph{所有}配置文件 - 复制到模板的主目录中。 - \end{itemize} - - \section{编译方式}\label{sec:compile} - - 首次编译前, - 请将 \verb|misc/| 目录中和 - 用户系统中 ctex 宏包版本相匹配的配置文件复制到模板的主目录中, - 详见第 \ref{sec:doc-dir} 节。 - - pkuthss 文档模版支持三种编译方式,即 - \begin{itemize} - \item \hologo{LaTeX} -- dvipdfmx 方式:\\ - 依次执行 \verb|latex|,\verb|biber|,% - \verb|latex|,\verb|latex| 和 \verb|dvipdfmx|。 - \item \hologo{pdfLaTeX} 方式:\\ - 依次执行 \verb|pdflatex|,\verb|biber|,% - \verb|pdflatex| 和 \verb|pdflatex|。 - \item \hologo{XeLaTeX} 方式:\\ - 依次执行 \verb|xelatex|,\verb|biber|,% - \verb|xelatex| 和 \verb|xelatex|。 - \end{itemize} - \myemph{% - 注意:\hologo{XeLaTeX} 对非 UTF-8 编码的支持不好, - 因此 \hologo{XeLaTeX} 方式的编译不支持 GBK 编码。% - } - - pkuthss 文档模版附带的 Makefile 中已经对这三种编译方式进行了完整的配置。 - 用户只需要在 Makefile 中通过设定变量 \verb|JOBNAME| 的值% - 指定被编译的主文件名, - 并通过设定变量 \verb|LATEX| 的值指定采用哪种编译方式, - 即可通过在主文件所在目录调用 Make 工具来实现自动编译: - 如果是在类 UNIX 环境下,则用户应该调用的命令名为 \verb|make|: -\begin{Verbatim}[frame = single] -cd /path/to/directory/with/thesis.tex -make -\end{Verbatim} - 而如果是在 Windows 环境下, - 则用户应该调用的命令名可能为 \verb|mingw32-make|: -\begin{Verbatim}[frame = single] -cd \path\to\directory\with\thesis.tex -mingw32-make -\end{Verbatim} - - 用户如果不想配置 Windows 下的 GNU Make, - 则也可以使用由 Windows 批处理实现的伪“Makefile”, - 通过在主文件所在目录调用 \verb|make|\footnote{% - Windows 将批处理文件作为可执行文件, - 调用时可以不显式地指出扩展名。% - }: -\begin{Verbatim}[frame = single] -cd \path\to\directory\with\thesis.tex -make -\end{Verbatim} - \myemph{% - 注意:% - Windows 批处理对于 LF(\texttt{\string\n})换行的批处理文件支持有问题。 - 在命令提示符(cmd)下执行这些批处理文件时没有问题, - 但双击文件图标执行时可能就会出错。 - \hologo{TeX} Live 中安装的 \texttt{Make.bat} 和 - CTAN 上提供的压缩包里的 \texttt{Make.bat} - 有可能是 LF(\texttt{\string\n})换行的。% - } - diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap2.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap2.tex deleted file mode 100644 index 7bff3bce6b6..00000000000 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap2.tex +++ /dev/null @@ -1,378 +0,0 @@ -% vim:ts=4:sw=4 -% -% Documentation for pkuthss. -% -% Copyright (c) 2008-2009 solvethis -% Copyright (c) 2010-2015 Casper Ti. Vector -% -% This work may be distributed and/or modified under the conditions of the -% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. -% -% This work consists of the following files: -% pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex - -\chapter{pkuthss 文档模版提供的功能} - \section{pkuthss 文档模版提供的文档类和宏包选项} - \subsection{pkuthss 文档类提供的选项}\label{ssec:options} - - \begin{itemize} - \item \textbf{\texttt{[no]extra}}: - 用于确定是否自动载入 pkuthss-extra 宏包。 - 在默认情况下,pkuthss 文档类将使用 \verb|extra| 选项。 - 用户如果不需要自动载入 pkuthss-extra 宏包, - 则需要在载入 pkuthss 时加上 \verb|noextra| 选项。 - - \item \textbf{\texttt{[no]uppermark}}: - 是否在页眉中将章节名中的小写字母转换为大写字母。 - 就目前而言, - 这样的转换存在着一些较为严重的缺陷\footnote{% - 准确地说是 \texttt{\string\MakeUppercase} 宏的问题: - 其在某些地方的转换不够健壮, - 例如 \texttt{\string\cite\string{ctex\string}} - 会被转换成 \texttt{\string\cite\string{CTEX\string}}。% - }, - 因此不建议使用。 - 基于上述考虑,\myemph{% - pkuthss 文档类默认启用 \texttt{nouppermark} 选项, - 即在不在页眉中使用大写的章节名% - }。 - - \item \textbf{pkuthss-extra 宏包提供的选项}: - 这些选项将被传递给 pkuthss-extra 宏包 - (用户需要启用 \verb|extra| 选项)。 - 具体说明参见第 \ref{ssec:extra} 小节。 - - \item \textbf{其余文档类选项}:% - pkuthss 文档类以 ctexbook 文档类为基础, - 其接受的其余所有文档类选项均被传递给 ctexbook。 - 其中可能最常用的选项是 \verb|GBK| 和 \verb|UTF8|: - 它们选择源代码使用的字符编码,默认使用 \verb|GBK|。 - \end{itemize} - - 例如,如果需要使用 UTF-8 编码撰写论文, - 则需要在载入 pkuthss 文档类时加上 \verb|UTF8| 选项: -\begin{Verbatim}[frame = single] -\documentclass[UTF8, ...]{pkuthss} % “...”代表其它的选项。 -\end{Verbatim} - - 又例如,文档默认情况下是双面模式,每章都从右页(奇数页)开始。 - 如果希望改成一章可以从任意页开始,可以这样设置: -\begin{Verbatim}[frame = single] -\documentclass[openany, ...]{pkuthss} % 每章从任意页开始。 -\end{Verbatim} - - \subsection{pkuthss-extra 宏包提供的选项}\label{ssec:extra} - - 除非特别说明, - 下面提到的选项中都是不带“\verb|no|”的版本被启用。 - - \begin{itemize} - \item \textbf{\texttt{[no]footfmt}}: - 是否根据学校对论文格式的要求\mbox{\supercite{pku-thesisstyle}}% - 修改和脚注相关的一些格式。 - 具体地说,启用 \verb|footfmt| 选项后会进行以下几项设置: - \begin{itemize} - \item 脚注参用带圈的编号。 - \item 页脚中脚注编号使用正文(而非上标)字体。 - \item 页脚中脚注编号和脚注文本之间默认间隔一个空格。 - \end{itemize} - - \item \textbf{\texttt{[no]pkuspace}}: - 是否根据学校对论文格式的要求\mbox{\supercite{pku-thesisstyle}}% - 修改排版中的一些间距及相关设置。 - 具体地说,启用 \verb|pkuspace| 选项后会按 - \parencite{pku-thesisstyle} 中的要求修改以下几项设置: - \begin{itemize} - \item 目录中条目的缩进方式。 - \item 图表标题的字号, - 以及标题中编号和标题文字之间的间隔方式 - (例如图 \ref{fig:example} 所示)。 - \end{itemize} - - \begin{figure}[htbp!] - \centering - \includegraphics[width = 0.5\textwidth]{pkuword} - \caption{示例插图}\label{fig:example} - \end{figure} - - \item \textbf{\texttt{[no]spacing}}\footnote{% - 因为代码重构的缘故, - 此选项同时提供 1.5.5 及以前版本 pkuthss-extra 宏包% - 中 \texttt{[no]tightlist} 选项所提供的功能。% - }: - 是否采用一些常用的调整间距的额外版式设定。 - 具体地说,启用 \verb|spacing| 选项后会进行以下几项设置: - \begin{itemize} - \item 自动忽略 CJK 文字之间的空白而% - 保留(CJK 文字与英文之间等的)其它空白。 - \item 调用 setspace 宏包以使某些细节处的空间安排更美观。 - \item 采用比 \hologo{LaTeX} 默认设定更加紧密的枚举环境% - \footnote{% - 在枚举环境(itemize、enumerate 和 description)中, - 每个条目的内容较少时,条目往往显得稀疏; - 在参考文献列表中也有类似的现象。 - 启用 \texttt{spacing} 选项后, - 将去掉这些环境中额外增加的(垂直)间隔。% - }。 - \end{itemize} - - \item \textbf{\texttt{[no]pdftoc}}\footnote{% - 此选项部分等价于 1.4 alpha2 及以前版本 pkuthss-extra 宏包% - 的 \texttt{[no]tocbibind} 选项。 - 因为 tocbibind 宏包和 biblatex 宏包冲突,% - pkuthss-extra 宏包不再调用 tocbibind 宏包。% - }: - 启用 \verb|pdftoc| 选项后, - 用 \verb|\tableofcontents| 命令生成目录时% - 会自动添加“目录”的 pdf 书签。 - - \item \textbf{\texttt{[no]spechap}}\footnote{% - “spechap”是“\textbf{spec}ial \textbf{chap}ter”的缩写。% - }: - 是否启用第 \ref{ssec:misc} 小节中介绍的 % - \verb|\specialchap| 命令。 - - \item \textbf{\texttt{[no]pdfprop}}: - 是否自动根据设定的论文文档信息(如作者、标题等) - 设置生成的 pdf 文档的相应属性。\myemph{% - 注意: - 该选项实际上是在 \texttt{\string\maketitle} 时生效的, - 这是因为考虑到% - 通常用户在调用 \texttt{\string\maketitle} 前% - 已经设置好所有的文档信息。 - 若用户不调用 \texttt{\string\maketitle}, - 则需在设定完文档信息之后自行调用% - 第 \ref{ssec:misc} 小节中介绍的 % - \texttt{\string\setpdfproperties} 命令以完成 - pdf 文档属性的设定。% - } - - \item \textbf{\texttt{[no]colorlinks}}\footnote{% - 此选项等价于 1.3 及以前版本 pkuthss-extra 宏包% - 的 \texttt{[no]linkcolor} 选项, - 但后来发现这会和 hyperref 宏包的一个同名选项冲突, - 故改为 \texttt{[no]colorlinks}。% - }: - 是否在生成的 pdf 文档中使用彩色的链接。 - \end{itemize} - - 例如,图书馆要求电子版论文的目录必须为黑色, - 且某些教务要求打印版论文的文字部分为纯黑而非灰度打印。 - 此时用户\myemph{% - 可以启用 pkuthss-extra 宏包的 \texttt{nocolorlinks} 选项, - 使所有的链接变为黑色,以免影响提交% - }: -\begin{Verbatim}[frame = single] -\documentclass[..., nocolorlinks]{pkuthss} % “...”代表其它的选项。 -\end{Verbatim} - - \section{pkuthss 文档模版提供的命令和环境} - \subsection{设定文档信息的命令} - - 这一类命令的语法为 -\begin{Verbatim}[frame = single] -\commandname{具体信息} % commandname 为具体命令的名称。 -\end{Verbatim} - - 这些命令总结如下: - \begin{itemize} - \item \texttt{\bfseries\string\ctitle}:设定论文中文标题; - \item \texttt{\bfseries\string\etitle}:设定论文英文标题; - \item \texttt{\bfseries\string\cauthor}:设定作者的中文名; - \item \texttt{\bfseries\string\eauthor}:设定作者的英文名; - \item \texttt{\bfseries\string\studentid}:设定作者的学号; - \item \texttt{\bfseries\string\date}:设定日期; - \item \texttt{\bfseries\string\school}:设定作者的学院名; - \item \texttt{\bfseries\string\cmajor}:设定作者专业的中文名; - \item \texttt{\bfseries\string\emajor}:设定作者专业的英文名; - \item \texttt{\bfseries\string\direction}:设定作者的研究方向; - \item \texttt{\bfseries\string\cmentor}:设定导师的中文名; - \item \texttt{\bfseries\string\ementor}:设定导师的英文名; - \item \texttt{\bfseries\string\ckeywords}:设定中文关键词; - \item \texttt{\bfseries\string\ekeywords}:设定英文关键词。 - \end{itemize} - - 例如,如果要设定专业为“化学”(“Chemistry”),则可以使用以下命令: -\begin{Verbatim}[frame = single] -\cmajor{化学} -\emajor{Chemistry} -\end{Verbatim} - - \subsection{自身存储文档信息的命令} - - 这一类命令的语法为 -\begin{Verbatim}[frame = single] -% commandname 为具体的命令名。 -\renewcommand{\commandname}{具体信息} -\end{Verbatim} - - 这些命令总结如下: - \begin{itemize} - \item \texttt{\bfseries\string\cuniversity}:大学的中文名。 - \item \texttt{\bfseries\string\euniversity}:大学的英文名。 - \item \texttt{\bfseries\string\cthesisname}:论文类别的中文名。 - \item \texttt{\bfseries\string\ethesisname}:论文类别的英文名。 - \item \texttt{\bfseries\string\cabstractname}:摘要的中文标题。 - \item \texttt{\bfseries\string\eabstractname}:摘要的英文标题。 - \end{itemize} - - 例如, - 如果要设定论文的类别为“本科生毕业论文”(“Undergraduate Thesis”), - 则可以使用以下命令: -\begin{Verbatim}[frame = single] -\renewcommand{\cthesisname}{本科生毕业论文} -\renewcommand{\ethesisname}{Undergraduate Thesis} -\end{Verbatim} - - \subsection{以“key = value”格式设置文档信息} - - 用户可以通过 \verb|\pkuthssinfo| 命令集中设定文档信息, - 其语法为: -\begin{Verbatim}[frame = single] -% key1、key2、value1、value2 等为具体文档信息的项目名和内容。 -\pkuthssinfo{key1 = value1, key2 = value2, ...} -\end{Verbatim} - 其中文档信息的项目名为前面提到的设定文档信息的命令名% - 或自身存储文档信息的命令名(不带反斜杠)。 - - 当文档信息的内容包含了逗号等有干扰的字符时, - 可以用大括号将这一项文档信息的全部内容括起来。\myemph{% - 我们建议用户总用大括号将文档信息的内容括起来, - 以避免很多不必要的麻烦。% - } - - 例如,前面提到的文档信息的设置可以集中地写成: -\begin{Verbatim}[frame = single, tabsize = 4] -\pkuthssinfo{ - ..., % “...”代表其它的设定。 - cthesisname = {本科生毕业论文}, - ethesisname = {Undergraduate Thesis}, - cmajor = {化学}, emajor = {Chemistry} -} -\end{Verbatim} - - \subsection{pkuthss 文档模版提供的其它命令和环境}\label{ssec:misc} - - \texttt{\bfseries cabstract} 和 \texttt{\bfseries eabstract} % - 环境用于编写中英文摘要。 - 用户只需要写摘要的正文;标题、作者、导师、专业等部分会自动生成。 - - \texttt{\bfseries\string\specialchap} 命令% - 用于开始不进行标号但计入目录的一章, - 并合理安排其页眉。\myemph{% - 注意: - 需要启用 pkuthss-extra 宏包的 \texttt{spechap} 选项% - 才能使用此命令。 - 另外,在此章内的节或小节等命令应使用带星号的版本, - 例如 \texttt{\string\section\string*} 等, - 以免造成章节编号混乱。% - }% - 例如,本文档中的“序言”一章就是用 \verb|\specialchap{序言}| % - 这条命令开始的。% - - \texttt{\bfseries\string\setpdfproperties} 命令% - 用于根据用户设定的文档信息自动设定生成的 pdf 文档的属性。 - 此命令会在用户调用 \verb|\maketitle| 命令时被自动调用, - 因此通常不需要用户自己使用; - 但用户有时可能不需要输出封面,从而不会调用 \verb|\maketitle| 命令, - 此时就需要在设定完文档信息之后调用 \verb|\setpdfproperties|。% - \myemph{% - 注意: - 需要启用 pkuthss-extra 宏包的 \texttt{pdfprop} 选项% - 才能使用此命令。% - } - - \subsection{从其它文档类和宏包继承的功能}\label{ssec:thirdparty} - - pkuthss 文档类建立在 ctexbook\supercite{ctex} 文档类之上, - 并调用了 CJKfntef、hyperref\supercite{hyperref}、% - geometry\supercite{geometry}、fancyhdr\supercite{fancyhdr} % - 和 graphicx\supercite{graphicx} 等几个宏包; - 使用 \hologo{pdfLaTeX} 方式编译 GBK 编码的源文件时还会调用 - xCJK2uni\supercite{xCJK2uni} 宏包\footnote{\ % - ctex 2.x 会自行调用 xCJK2uni 宏包, - 不用在 pkuthss 文档类中重复调用; - 这里调用 xCJK2un 是为了兼容 ctex 1.x 而进行的设定, - 该设定将在 2017 年被去除。% - }。 - 因此,ctexbook 文档类和这些宏包所提供的功能均可以使用。 - - 例如,用户如果想将目录的标题改为“目{\quad\quad}录”, - 则可以使用 ctexbook 文档类提供的 \verb|\CTEXoptions| 命令: -\begin{Verbatim}[frame = single] -\CTEXoptions[contentsname = {目{\quad\quad}录}] -\end{Verbatim} - - 在默认的配置下,% - pkuthss 文档模版使用作者编写的 biblatex\supercite{biblatex} 样式% - \mbox{\supercite{biblatex-caspervector}}% - 进行参考文献和引用的排版, - 用户可以使用它以及 biblatex 本身所提供的功能。 - 例如, - 用户可以分别使用 \verb|\cite|、\verb|\parencite| 和 \verb|\supercite| % - 生成未格式化的、带方括号的和上标且带方括号的引用标记: -\begin{Verbatim}[frame = single] -\cite{ctex},\parencite{ctex},\supercite{ctex} -\end{Verbatim} - 在本文中将产生“\cite{ctex},\parencite{ctex},\supercite{ctex}”。 - - 就目前而言,在 biblatex 2.x 中,通过更复杂的设置, - 还可以满足例如被引用的文献按照引用顺序排序, - 而未引用的文献按照英文文献在前、中文文献在后排序这样的需求, - 详见 biblatex-caspervector 的文档\supercite{biblatex-caspervector}。 - - pkuthss-extra 宏包可能调用以下这些宏包: - \begin{itemize} - \item 启用 \verb|footfmt| 选项时会调用 % - tikz\supercite{tikz} 和 scrextend\supercite{scrextend} 宏包。 - \item 启用 \verb|pkuspace| 选项时会调用 % - tocloft\supercite{tocloft}、subfig\supercite{subfig} 和 % - caption\supercite{caption} 宏包。 - \item 启用 \verb|spacing| 选项时会调用 setspace 和 % - enumitem\supercite{enumitem} 宏包。 - \end{itemize} - 因此在启用相应选项时,用户可以使用对应宏包所提供的功能。 - - \section{高级设置}\label{sec:advanced} - - pkuthss 文档模版的实现是简洁、清晰、灵活的。 - 当一些细节的自定义无法通过模版提供的外部接口实现时, - 我们鼓励用户(在适当理解相关部分代码的前提下)通过修改模版进行自定义。 - - 一个常见的需求是封面中部分内容(特别是论文的标题、专业和研究方向)太长, - 超出了在预设的空间。 - 此时, - 用户可以修改 \verb|pkuthss.cls| 里 \verb|\maketitle| 定义中 - \verb|\pkuthss@int@fillinblank| 宏的参数来改变 - 带下划线的空白的行数和行宽,其语法为: -\begin{Verbatim}[frame = single] -\pkuthss@int@fillinblank{行数}{行宽}{内容} -\end{Verbatim} - 例如,如果“研究方向”一栏需要两行的空白, - 可以将 \verb|pkuthss.cls| 里的 -\begin{Verbatim}[frame = single] -\pkuthss@int@fillinblank{1}{\pkuthss@tmp@len}{\kaishu\@direction} -\end{Verbatim} - 改为 -\begin{Verbatim}[frame = single] -\pkuthss@int@fillinblank{2}{\pkuthss@tmp@len}{\kaishu\@direction} -\end{Verbatim} - 当然,为了美观,可以将多于一行的部分移到封面中作者信息部分的最下方。 - diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap3.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap3.tex deleted file mode 100644 index 10252d661cc..00000000000 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/chap3.tex +++ /dev/null @@ -1,150 +0,0 @@ -% vim:ts=4:sw=4 -% -% Documentation for pkuthss. -% -% Copyright (c) 2008-2009 solvethis -% Copyright (c) 2010-2015 Casper Ti. Vector -% -% This work may be distributed and/or modified under the conditions of the -% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. -% -% This work consists of the following files: -% pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex - -\chapter{问题及其解决} - \section{文档中已经提到的常见问题(按重要性排序)} - - 文档默认情况下是双面模式,章末可能产生空白页,详见第 \ref{ssec:options} 小节。 - 最终打印和提交论文前,需使用 pkuthss-extra 宏包的 \verb|nocolorlinks| 选项。 - 解决方式见第 \ref{ssec:extra} 小节。 - - 通过一些设置,还可以满足例如被引用的文献按照引用顺序排序, - 而未引用的文献按照英文文献在前、中文文献在后排序这样的需求, - 见第 \ref{ssec:thirdparty} 小节。 - - 一些高级设置, - 如封面中部分内容长度超过预设空间容量时的设置, - 见第 \ref{sec:advanced} 节。 - - 中文字体字库不全(只包含 GB2312 字符集内字符)时, - 生成的 pdf 文档中可能缺少部分字符, - 解决方式见第 \ref{sec:req} 节。 - 使用过旧的 \hologo{TeX} 系统和各宏包, - 或使用某些 Linux 发行版软件仓库所提供的 \hologo{TeX} Live 时, - 可能引起一些问题, - 详见第 \ref{sec:req} 节。 - - Windows 批处理对于 LF(\texttt{\string\n})换行的批处理文件支持有问题, - 解决方式见第 \ref{sec:compile} 节。 - Windows 的“记事本”程序在查看 LF(\texttt{\string\n}) - 换行的文本文件时存在着一些问题, - 因此建议用户使用支持 LF 换行的文本编辑器编辑文件, - 详见第 \ref{sec:doc-dir} 节。 - - \section{上游宏包可能引起的问题} - - biblatex\supercite{biblatex} 宏包会自行设定 \verb|\bibname|, - 故会覆盖通过 \verb|\CTEXoptions| 设定的参考文献列表标题。 - 使用 biblatex 的用户可以使用 \verb|\printbibliography| 的 - \verb|title| 选项来手动设定参考文献列表的标题,例如: -\begin{Verbatim}[frame = single] -\printbibliography[title = {文献}, ...] % “...”为其它选项。 -\end{Verbatim} - - hyperref\supercite{hyperref} 宏包和一些宏包可能发生冲突。 - 关于如何避免这些冲突, - 可以参考 hyperref 宏包的 README 文件中的“Package Compatibility”一节。 - 此文件通常和执行 \verb|texdoc hyperref| % - 时打开的 pdf 文件位于同一目录中。 - - 使用 \hologo{XeLaTeX} 的用户可能在已经安装字体的情况下遇到形如(其中 - \verb|xxxxxxxx| 为具体字体名) -\begin{Verbatim}[frame = single, fontsize = {\small}] -! fontspec error: "font-not-found" -! The font "xxxxxxxx" cannot be found. -! See the fontspec documentation for further information. -! For immediate help type H . -\end{Verbatim} - 的错误。 - 这种错误一般是(主要是非 Windows 平台的)用户采用了自定义的(包括大小写 - 不同于原文件的)字体文件名, - 并改动 \verb|ctex.cfg| 等配置文件之后没有在调用 % - pkuthss 文档类时加入 \verb|nofonts| 选项, - 又使用 \verb|xelatex| 编译造成的,使用 -\begin{Verbatim}[frame = single] -\documentclass[nofonts, ...]{pkuthss} % “...”代表其它的选项。 -\end{Verbatim} - 即可解决此问题。 - - biber 运行时有一定概率出现形如(目录名可能稍有不同) -\begin{Verbatim}[frame = single, fontsize = {\small}] -data source .../par-xxxxxxxx/cache-xxxxxxxx/ - inc/lib/Biber/LaTeX/recode_data.xml not found in . -\end{Verbatim} - 的错误。 - 这种错误一般是 biber 在自解压阶段被终止之后, - 未删除 \verb|.../par-xxxxxxxx/| 这个临时目录就重新运行 biber 时出现。 - 遇到这种情况时,删除掉上述临时目录及其所有内容, - 再重新运行 biber 通常便可解决问题。 - - caption\supercite{caption} 宏包对于其不认识的宏包均会提示 -\begin{Verbatim}[frame = single, fontsize = {\small}] -Package caption Warning: Unsupported document class (or package) detected, -(caption) usage of the caption package is not recommended. -See the caption package documentation for explanation. -\end{Verbatim} - pkuthss 文档模版基于 ctexbook 文档类, - 而后者基于标准的 book 文档类。 - 因此,这个警告并不影响用户正常使用\footnote{% - \url{http://bbs.ctex.org/forum.php?mod=redirect&goto=findpost&ptid=63117&pid=402145}.% - }。 - - \section{文档格式可能存在的问题} - - 学校对学位论文格式的规定\mbox{\supercite{pku-thesisstyle}}% - 显然没有考虑到非 MS Word 类排版工具的工作方式, - 因此 pkuthss 文档模板只是对其要求的格式进行模仿, - 而在一些小的细节上可能有所出入。 - - biblatex-caspervector\supercite{biblatex-caspervector} 所实现的格式和 % - \parencite{pku-thesisstyle} 的规定并不一致, - 但其作者暂时没有精力也不愿意去实现后者所规定的比原格式更丑陋得多的格式。 - - \section{反馈意见和建议} - - 关于 pkuthss 文档模版的意见和建议, - 请在北大未名 BBS 的 MathTools 版或 % - pkuthss 项目主页的 issue tracker% - \footnote{\url{https://github.com/CasperVector/pkuthss/issues}.}% - 上提出, - 或通过电子邮件\footnote% - {\href{mailto:CasperVector@gmail.com}{\texttt{CasperVector@gmail.com}}.}% - 告知模版维护者。 - 上述三种反馈方法中,建议用户尽量采用靠前的方法。 - - 在进行反馈时,请尽量确保已经仔细阅读本文档中的说明。 - 如果是通过 BBS 或电子邮件进行反馈, - 请在标题中说明是关于 pkuthss 文档模版的反馈; - 如果是错误报告, - 请说明所使用 pkuthss 模版的版本、 - 自己使用的操作系统和 \hologo{TeX} 系统的类型和版本; - 同时强烈建议附上一个出错的最小例子及其相应的编译日志(\verb|.log| 文件), - 在文件较长时请使用附件。 - diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/conclusion.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/conclusion.tex deleted file mode 100644 index 50d93d09641..00000000000 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/conclusion.tex +++ /dev/null @@ -1,35 +0,0 @@ -% vim:ts=4:sw=4 -% -% Documentation for pkuthss. -% -% Copyright (c) 2008-2009 solvethis -% Copyright (c) 2010-2012 Casper Ti. Vector -% -% This work may be distributed and/or modified under the conditions of the -% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. -% -% This work consists of the following files: -% pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex - -\specialchap{结论} - -pkuthss 文档模版结构较为简洁、清晰、灵活,较为易于学习和使用。 -希望它能为各位需要使用 \hologo{LaTeX} 撰写学位论文的同学提供一些帮助。 - diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/copyright.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/copyright.tex deleted file mode 100644 index 1774784d248..00000000000 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/copyright.tex +++ /dev/null @@ -1,49 +0,0 @@ -% vim:ts=4:sw=4 -% -% Documentation for pkuthss. -% -% Copyright (c) 2008-2009 solvethis -% Copyright (c) 2010-2015 Casper Ti. Vector -% -% This work may be distributed and/or modified under the conditions of the -% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. -% -% This work consists of the following files: -% pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex - -\chapter*{版权声明} -\markboth{版权声明}{} - -版权所有 \copyright\ 2008--2009 solvethis -\par -版权所有 \copyright\ 2010--2015 Casper Ti. Vector -\vskip 1em - -pkuthss 文档类、pkuthss-extra 宏包及其说明文档均以 % -\hologo{LaTeX} Project Public License 发布。 -随 pkuthss 提供的模版源代码中,除以下文件 -\begin{itemize} - \item \verb|chap/copyright.tex| - \item \verb|chap/originauth.tex| -\end{itemize} -以 New BSD License 发布, -以及参考文献和引用使用的样式文件版权声明见相应文件中说明以外, -其余所有文件发布在公有领域(public domain)。 - diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/encl1.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/encl1.tex deleted file mode 100644 index ea0e17a7db4..00000000000 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/encl1.tex +++ /dev/null @@ -1,45 +0,0 @@ -% vim:ts=4:sw=4 -% -% Documentation for pkuthss. -% -% Copyright (c) 2008-2009 solvethis -% Copyright (c) 2010-2012,2014 Casper Ti. Vector -% -% This work may be distributed and/or modified under the conditions of the -% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. -% -% This work consists of the following files: -% pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex - -\chapter{更新记录} -\raggedbottom - -\section{1.3 版以后的更新记录} -\VerbatimInput[ - tabsize = 4, fontsize = {\small}, baselinestretch = 1 -]{ChangeLog.txt} - -\section{1.3 及其以前版本的更新记录} -\VerbatimInput[ - tabsize = 4, fontsize = {\small}, baselinestretch = 1.1 -]{ChangeLog-upto-1.3.txt} - -\flushbottom - diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/introduction.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/introduction.tex deleted file mode 100644 index 36406bf08b6..00000000000 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/introduction.tex +++ /dev/null @@ -1,70 +0,0 @@ -% vim:ts=4:sw=4 -% -% Documentation for pkuthss. -% -% Copyright (c) 2008-2009 solvethis -% Copyright (c) 2010-2012,2014-2015 Casper Ti. Vector -% -% This work may be distributed and/or modified under the conditions of the -% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. -% -% This work consists of the following files: -% pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex - -\specialchap{序言} - -本文档是北京大学论文文档模版 pkuthss 的说明文档。 - -pkuthss 文档模版由四部分构成: -\begin{itemize} - \item \textbf{pkuthss 文档类}: - 其中进行了学位论文所需要的一些最基本的设定, - 主要包括对基本排版格式的设定和提供设置论文信息的命令。 - \item \textbf{pkuthss-extra 宏包}: - 其中实现了学校的学位论文格式规范\mbox{\supercite{pku-thesisstyle}}% - 中需要借助一些非最常见宏包来实现的需求; - 此外也实现了学位论文中用户可能较多用到的一些额外功能, - 例如自动在目录中加入参考文献和索引的条目和% - 自动根据用户设定的文档信息对所生成 pdf 的作者、标题等属性进行设置等。 - \item \textbf{说明文档}: - 说明文档即本文档, - 在安装(见第 \ref{sec:req} 节)之后应该可以用 \hologo{TeX} 系统提供的 - \verb|texdoc| 命令调出: -\begin{Verbatim}[frame = single] -texdoc pkuthss -\end{Verbatim} - \item \textbf{文档模版}: - 模版的源代码(及由此生成的 pdf 文档) - 和本文档的 pdf 文件处于同一目录下。 - 用户只需按照模版中的框架修改代码,即可写出自己的论文。 -\end{itemize} - -在此之前,包括 dypang\supercite{dypang}、FerretL\supercite{FerretL}、% -lwolf\supercite{lwolf}、Langpku\supercite{Langpku}、% -solvethis\supercite{solvethis} 等的数位网友均做过学位论文模版的工作。 -本论文模版是 solvethis 的 pkuthss 模版的更新版本, -更新的重点是重构和对新文档类、宏包的支持。 - -pkuthss 文档模版现在的维护者是 Casper Ti. Vector\footnote% -{\href{mailto:CasperVector@gmail.com}{\texttt{CasperVector@gmail.com}}}。% -pkuthss 文档模版目前托管在 GitHub 上, -其项目主页是:\\ -\hspace*{\parindent}\url{https://github.com/CasperVector/pkuthss} - diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-abstract.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-abstract.tex new file mode 100644 index 00000000000..cdecf891d9c --- /dev/null +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-abstract.tex @@ -0,0 +1,39 @@ +% vim:ts=4:sw=4 +% +% Documentation for pkuthss. +% +% Copyright (c) 2008-2009 solvethis +% Copyright (c) 2010-2014 Casper Ti. Vector +% +% This work may be distributed and/or modified under the conditions of the +% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. +% +% This work consists of the following files: +% pkuthss.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex + +\begin{cabstract} + 本文介绍了 pkuthss 文档模版所提供的功能。 +\end{cabstract} + +\begin{eabstract} + This document describes the the functions provided by + the pkuthss document template. +\end{eabstract} + diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-acknowledge.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-acknowledge.tex new file mode 100644 index 00000000000..77ad708b1b9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-acknowledge.tex @@ -0,0 +1,40 @@ +% vim:ts=4:sw=4 +% +% Documentation for pkuthss. +% +% Copyright (c) 2008-2009 solvethis +% Copyright (c) 2010-2012,2015 Casper Ti. Vector +% +% This work may be distributed and/or modified under the conditions of the +% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. +% +% This work consists of the following files: +% pkuthss.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex + +\chapter{致谢} + +感谢北大未名 BBS 上 MathTools 版和 Thesis 版诸位同学的支持。 +特别感谢 pkuthss 模版的最初创作者 solvethis 网友, +以及不断地对 Casper 提出的诸多问题予以解答的 cauchy 网友 :) + +此外还要感谢 \parencite{pku-thesisstyle} 的作者, +让我校在学位论文格式要求的繁复程度上离隔壁更近了一步, +同时还达成了用 \hologo{TeX} 排版出和 M\$ Word 一样审美水平论文的伟大成就。 + diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap1.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap1.tex new file mode 100644 index 00000000000..1a9552d368c --- /dev/null +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap1.tex @@ -0,0 +1,203 @@ +% vim:ts=4:sw=4 +% +% Documentation for pkuthss. +% +% Copyright (c) 2008-2009 solvethis +% Copyright (c) 2010-2015 Casper Ti. Vector +% +% This work may be distributed and/or modified under the conditions of the +% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. +% +% This work consists of the following files: +% pkuthss.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex + +\chapter{使用介绍} + \section{系统要求}\label{sec:req} + + 正确编译需要以下几部分: + \begin{itemize} + \item 一个基本的 \hologo{TeX} 发行版。 + \item CJK 或 XeCJK(供 \hologo{XeLaTeX} 使用)宏包。 + \item ctex\supercite{ctex,ctex-faq} 宏包(提供了 ctexbook 文档类)。 + \item 中文字体。 + \item 如果要使用 biblatex 进行文献列表和引用的排版的话, + 还需要 biblatex\supercite{biblatex} 宏包; + \item 如果需要对中文文献进行按汉语拼音的排序的话, + 还需要 biber\supercite{biber} 程序。 + \item 如果使用默认的文献列表和引用样式的话, + 还需要作者编写的 biblatex 样式 + (biblatex-caspervector\supercite{biblatex-caspervector})。 + \item 如果需要使用 Makefile 来实现自动编译,还需要 Make 工具; + 但如果使用由批处理实现的伪“Makefile”就不用了。 + \end{itemize} + + \myemph{最新}的\myemph{完全版} \hologo{TeX} Live 系统(\myemph{% + 注: + 某些 Linux 发行版软件仓库中的 \hologo{TeX} Live 有问题, + 建议使用独立安装版的 \hologo{TeX} Live% + \unemph{\footnote{\url{http://www.tug.org/texlive/}.}}。% + })都已经包含除中文字体和 Make 之外所有要求的项目。% + \myemph{% + 为了获得最好的支持, + 我们建议用户使用最新、完全版的 \hologo{TeX} 系统和各宏包。% + } + + 中文字体需要用户自行获得。\myemph{% + 注: + 一些中文字体的字库不全, + 只有 GB2312 字符集内字符的字体信息。 + 这种情况通常会造成编译生成的 pdf 文件中缺少部分字符, + 其中一种典型症状是“〇”字显示不出来。 + 如果要使用中易公司的字体, + 则建议使用 Windows Vista 及其以后版本提供的% + 宋体、黑体、楷体和仿宋体, + 以及 Microsoft Office 2003 及其以后版本提供的隶书和幼圆体, + 这些字体是 GB18030 字符集的,不存在上述问题。% + } + + Linux 用户可以从软件源获得 GNU 的 make; + 其它类 UNIX 系统应该也会提供 make 工具,请参阅相应的文档以获得帮助。% + Windows 用户可以从以下地址下载 Windows 下的 GNU make 工具:\\ + \hspace*{\parindent}% + \url{http://gnuwin32.sourceforge.net/packages/make.htm} + + \section{模版文件}\label{sec:doc-dir} + + 在正确安装 pkuthss 文档模版之后,在终端/命令提示符中执行 +\begin{Verbatim}[frame = single] +texdoc pkuthss +\end{Verbatim} + 所打开的 pdf 文件所在的同一目录中包含两个子目录和相应的两个 pdf 文件, + 其中 \verb|readme/| 为说明文档(即本文档)的源代码,% + \verb|example/| 为文档模版的源代码,% + \verb|readme.pdf| 和 \verb|example.pdf| + 分别为说明文档和文档模版的 pdf 文件。 + + \verb|example/| 目录下的源代码使用的是 UTF-8 编码, + 在现在 \hologo{TeX} 用户常用的编辑器中均已经有了良好的支持。 + 用户可以将 \verb|example/| 中的所有内容复制到合适的目录, + 并在此目录中根据模版修改出自己的论文。 + + \myemph{% + 注意: + 在 1.4 rc4 之后版本的 pkuthss 文档模版中,除了 \texttt{Make.bat} 之外, + 所有文件均是 LF(\texttt{\string\n})换行。 + 在 Windows 下用“记事本”打开这些文件时, + 所有的换行会变成某个奇怪的字符,而所有文字会挤在一行上。 + 这是“记事本”的固有问题, + 因此 pkuthss 文档模版的作者建议用户 + 使用支持 LF 换行的文本编辑器编辑文件。% + } + + 模版中的重要文件有: + \begin{itemize} + \item \verb|Makefile|: + 被 Make 工具调用的 Makefile,用于使编译工作自动化。 + \item \verb|Make.bat|:% + Windows 下的伪“Makefile”,用 Windows 批处理实现。 + + \item \verb|chap/|:目录,包含各章节内容: + \begin{itemize} + \item \verb|copyright.tex|: + 版权声明部分。 + \item \verb|originauth.tex|: + 原创性声明和使用授权说明部分\supercite{pku-originauth}。 + \end{itemize} + \myemph{% + 注:% + pkuthss 文档模版支持排版学校要求的二维码, + 请参考 \texttt{copyright.tex} 和 + \texttt{originauth.tex} 中的相关注释。% + } + + \item \verb|misc/|: + 目录,目前包含比较常用的字体配置: + \begin{itemize} + \item \verb|ctexopts.cfg|、\verb|ctex-fontset-pkuthss.def|: + 适用于 2.0 及以后版本的 ctex\supercite{ctex} 宏包。 + \item \verb|ctex-xecjk-windows.def|: + 适用于 2.0 以前版本的 ctex 宏包。 + \end{itemize} + 使用时, + 请将和用户系统中 ctex 宏包版本相匹配的\myemph{所有}配置文件 + 复制到模板的主目录中。 + \end{itemize} + + \section{编译方式}\label{sec:compile} + + 首次编译前, + 请将 \verb|misc/| 目录中和 + 用户系统中 ctex 宏包版本相匹配的配置文件复制到模板的主目录中, + 详见第 \ref{sec:doc-dir} 节。 + + pkuthss 文档模版支持三种编译方式,即 + \begin{itemize} + \item \hologo{LaTeX} -- dvipdfmx 方式:\\ + 依次执行 \verb|latex|,\verb|biber|,% + \verb|latex|,\verb|latex| 和 \verb|dvipdfmx|。 + \item \hologo{pdfLaTeX} 方式:\\ + 依次执行 \verb|pdflatex|,\verb|biber|,% + \verb|pdflatex| 和 \verb|pdflatex|。 + \item \hologo{XeLaTeX} 方式:\\ + 依次执行 \verb|xelatex|,\verb|biber|,% + \verb|xelatex| 和 \verb|xelatex|。 + \end{itemize} + \myemph{% + 注意:\hologo{XeLaTeX} 对非 UTF-8 编码的支持不好, + 因此 \hologo{XeLaTeX} 方式的编译不支持 GBK 编码。% + } + + pkuthss 文档模版附带的 Makefile 中已经对这三种编译方式进行了完整的配置。 + 用户只需要在 Makefile 中通过设定变量 \verb|JOBNAME| 的值% + 指定被编译的主文件名, + 并通过设定变量 \verb|LATEX| 的值指定采用哪种编译方式, + 即可通过在主文件所在目录调用 Make 工具来实现自动编译: + 如果是在类 UNIX 环境下,则用户应该调用的命令名为 \verb|make|: +\begin{Verbatim}[frame = single] +cd /path/to/directory/with/thesis.tex +make +\end{Verbatim} + 而如果是在 Windows 环境下, + 则用户应该调用的命令名可能为 \verb|mingw32-make|: +\begin{Verbatim}[frame = single] +cd \path\to\directory\with\thesis.tex +mingw32-make +\end{Verbatim} + + 用户如果不想配置 Windows 下的 GNU Make, + 则也可以使用由 Windows 批处理实现的伪“Makefile”, + 通过在主文件所在目录调用 \verb|make|\footnote{% + Windows 将批处理文件作为可执行文件, + 调用时可以不显式地指出扩展名。% + }: +\begin{Verbatim}[frame = single] +cd \path\to\directory\with\thesis.tex +make +\end{Verbatim} + \myemph{% + 注意:% + Windows 批处理对于 LF(\texttt{\string\n})换行的批处理文件支持有问题。 + 在命令提示符(cmd)下执行这些批处理文件时没有问题, + 但双击文件图标执行时可能就会出错。 + \hologo{TeX} Live 中安装的 \texttt{Make.bat} 和 + CTAN 上提供的压缩包里的 \texttt{Make.bat} + 有可能是 LF(\texttt{\string\n})换行的。% + } + diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap2.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap2.tex new file mode 100644 index 00000000000..ba3bed4e104 --- /dev/null +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap2.tex @@ -0,0 +1,379 @@ +% vim:ts=4:sw=4 +% +% Documentation for pkuthss. +% +% Copyright (c) 2008-2009 solvethis +% Copyright (c) 2010-2015 Casper Ti. Vector +% +% This work may be distributed and/or modified under the conditions of the +% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. +% +% This work consists of the following files: +% pkuthss.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex + +\chapter{pkuthss 文档模版提供的功能} + \section{pkuthss 文档模版提供的文档类和宏包选项} + \subsection{pkuthss 文档类提供的选项}\label{ssec:options} + + \begin{itemize} + \item \textbf{\texttt{[no]extra}}: + 用于确定是否自动载入 pkuthss-extra 宏包。 + 在默认情况下,pkuthss 文档类将使用 \verb|extra| 选项。 + 用户如果不需要自动载入 pkuthss-extra 宏包, + 则需要在载入 pkuthss 时加上 \verb|noextra| 选项。 + + \item \textbf{\texttt{[no]uppermark}}: + 是否在页眉中将章节名中的小写字母转换为大写字母。 + 就目前而言, + 这样的转换存在着一些较为严重的缺陷\footnote{% + 准确地说是 \texttt{\string\MakeUppercase} 宏的问题: + 其在某些地方的转换不够健壮, + 例如 \texttt{\string\cite\string{ctex\string}} + 会被转换成 \texttt{\string\cite\string{CTEX\string}}。% + }, + 因此不建议使用。 + 基于上述考虑,\myemph{% + pkuthss 文档类默认启用 \texttt{nouppermark} 选项, + 即在不在页眉中使用大写的章节名% + }。 + + \item \textbf{pkuthss-extra 宏包提供的选项}: + 这些选项将被传递给 pkuthss-extra 宏包 + (用户需要启用 \verb|extra| 选项)。 + 具体说明参见第 \ref{ssec:extra} 小节。 + + \item \textbf{其余文档类选项}:% + pkuthss 文档类以 ctexbook 文档类为基础, + 其接受的其余所有文档类选项均被传递给 ctexbook。 + 其中可能最常用的选项是 \verb|GBK| 和 \verb|UTF8|: + 它们选择源代码使用的字符编码,默认使用 \verb|GBK|。 + \end{itemize} + + 例如,如果需要使用 UTF-8 编码撰写论文, + 则需要在载入 pkuthss 文档类时加上 \verb|UTF8| 选项: +\begin{Verbatim}[frame = single] +\documentclass[UTF8, ...]{pkuthss} % “...”代表其它的选项。 +\end{Verbatim} + + 又例如,文档默认情况下是双面模式,每章都从右页(奇数页)开始。 + 如果希望改成一章可以从任意页开始,可以这样设置: +\begin{Verbatim}[frame = single] +\documentclass[openany, ...]{pkuthss} % 每章从任意页开始。 +\end{Verbatim} + + \subsection{pkuthss-extra 宏包提供的选项}\label{ssec:extra} + + 除非特别说明, + 下面提到的选项中都是不带“\verb|no|”的版本被启用。 + + \begin{itemize} + \item \textbf{\texttt{[no]footfmt}}: + 是否根据学校对论文格式的要求\mbox{\supercite{pku-thesisstyle}}% + 修改和脚注相关的一些格式。 + 具体地说,启用 \verb|footfmt| 选项后会进行以下几项设置: + \begin{itemize} + \item 脚注参用带圈的编号。 + \item 页脚中脚注编号使用正文(而非上标)字体。 + \item 页脚中脚注编号和脚注文本之间默认间隔一个空格。 + \end{itemize} + + \item \textbf{\texttt{[no]pkuspace}}: + 是否根据学校对论文格式的要求\mbox{\supercite{pku-thesisstyle}}% + 修改排版中的一些间距及相关设置。 + 具体地说,启用 \verb|pkuspace| 选项后会按 + \parencite{pku-thesisstyle} 中的要求修改以下几项设置: + \begin{itemize} + \item 正文的行距。 + \item 目录中条目的缩进方式。 + \item 图表标题的字号, + 以及标题中编号和标题文字之间的间隔方式 + (例如图 \ref{fig:example} 所示)。 + \end{itemize} + + \begin{figure}[htbp!] + \centering + \includegraphics[width = 0.5\textwidth]{pkuword} + \caption{示例插图}\label{fig:example} + \end{figure} + + \item \textbf{\texttt{[no]spacing}}\footnote{% + 因为代码重构的缘故, + 此选项同时提供 1.5.5 及以前版本 pkuthss-extra 宏包% + 中 \texttt{[no]tightlist} 选项所提供的功能。% + }: + 是否采用一些常用的调整间距的额外版式设定。 + 具体地说,启用 \verb|spacing| 选项后会进行以下几项设置: + \begin{itemize} + \item 自动忽略 CJK 文字之间的空白而% + 保留(CJK 文字与英文之间等的)其它空白。 + \item 调用 setspace 宏包以使某些细节处的空间安排更美观。 + \item 采用比 \hologo{LaTeX} 默认设定更加紧密的枚举环境% + \footnote{% + 在枚举环境(itemize、enumerate 和 description)中, + 每个条目的内容较少时,条目往往显得稀疏; + 在参考文献列表中也有类似的现象。 + 启用 \texttt{spacing} 选项后, + 将去掉这些环境中额外增加的(垂直)间隔。% + }。 + \end{itemize} + + \item \textbf{\texttt{[no]pdftoc}}\footnote{% + 此选项部分等价于 1.4 alpha2 及以前版本 pkuthss-extra 宏包% + 的 \texttt{[no]tocbibind} 选项。 + 因为 tocbibind 宏包和 biblatex 宏包冲突,% + pkuthss-extra 宏包不再调用 tocbibind 宏包。% + }: + 启用 \verb|pdftoc| 选项后, + 用 \verb|\tableofcontents| 命令生成目录时% + 会自动添加“目录”的 pdf 书签。 + + \item \textbf{\texttt{[no]spechap}}\footnote{% + “spechap”是“\textbf{spec}ial \textbf{chap}ter”的缩写。% + }: + 是否启用第 \ref{ssec:misc} 小节中介绍的 % + \verb|\specialchap| 命令。 + + \item \textbf{\texttt{[no]pdfprop}}: + 是否自动根据设定的论文文档信息(如作者、标题等) + 设置生成的 pdf 文档的相应属性。\myemph{% + 注意: + 该选项实际上是在 \texttt{\string\maketitle} 时生效的, + 这是因为考虑到% + 通常用户在调用 \texttt{\string\maketitle} 前% + 已经设置好所有的文档信息。 + 若用户不调用 \texttt{\string\maketitle}, + 则需在设定完文档信息之后自行调用% + 第 \ref{ssec:misc} 小节中介绍的 % + \texttt{\string\setpdfproperties} 命令以完成 + pdf 文档属性的设定。% + } + + \item \textbf{\texttt{[no]colorlinks}}\footnote{% + 此选项等价于 1.3 及以前版本 pkuthss-extra 宏包% + 的 \texttt{[no]linkcolor} 选项, + 但后来发现这会和 hyperref 宏包的一个同名选项冲突, + 故改为 \texttt{[no]colorlinks}。% + }: + 是否在生成的 pdf 文档中使用彩色的链接。 + \end{itemize} + + 例如,图书馆要求电子版论文的目录必须为黑色, + 且某些教务要求打印版论文的文字部分为纯黑而非灰度打印。 + 此时用户\myemph{% + 可以启用 pkuthss-extra 宏包的 \texttt{nocolorlinks} 选项, + 使所有的链接变为黑色,以免影响提交% + }: +\begin{Verbatim}[frame = single] +\documentclass[..., nocolorlinks]{pkuthss} % “...”代表其它的选项。 +\end{Verbatim} + + \section{pkuthss 文档模版提供的命令和环境} + \subsection{设定文档信息的命令} + + 这一类命令的语法为 +\begin{Verbatim}[frame = single] +\commandname{具体信息} % commandname 为具体命令的名称。 +\end{Verbatim} + + 这些命令总结如下: + \begin{itemize} + \item \texttt{\bfseries\string\ctitle}:设定论文中文标题; + \item \texttt{\bfseries\string\etitle}:设定论文英文标题; + \item \texttt{\bfseries\string\cauthor}:设定作者的中文名; + \item \texttt{\bfseries\string\eauthor}:设定作者的英文名; + \item \texttt{\bfseries\string\studentid}:设定作者的学号; + \item \texttt{\bfseries\string\date}:设定日期; + \item \texttt{\bfseries\string\school}:设定作者的学院名; + \item \texttt{\bfseries\string\cmajor}:设定作者专业的中文名; + \item \texttt{\bfseries\string\emajor}:设定作者专业的英文名; + \item \texttt{\bfseries\string\direction}:设定作者的研究方向; + \item \texttt{\bfseries\string\cmentor}:设定导师的中文名; + \item \texttt{\bfseries\string\ementor}:设定导师的英文名; + \item \texttt{\bfseries\string\ckeywords}:设定中文关键词; + \item \texttt{\bfseries\string\ekeywords}:设定英文关键词。 + \end{itemize} + + 例如,如果要设定专业为“化学”(“Chemistry”),则可以使用以下命令: +\begin{Verbatim}[frame = single] +\cmajor{化学} +\emajor{Chemistry} +\end{Verbatim} + + \subsection{自身存储文档信息的命令} + + 这一类命令的语法为 +\begin{Verbatim}[frame = single] +% commandname 为具体的命令名。 +\renewcommand{\commandname}{具体信息} +\end{Verbatim} + + 这些命令总结如下: + \begin{itemize} + \item \texttt{\bfseries\string\cuniversity}:大学的中文名。 + \item \texttt{\bfseries\string\euniversity}:大学的英文名。 + \item \texttt{\bfseries\string\cthesisname}:论文类别的中文名。 + \item \texttt{\bfseries\string\ethesisname}:论文类别的英文名。 + \item \texttt{\bfseries\string\cabstractname}:摘要的中文标题。 + \item \texttt{\bfseries\string\eabstractname}:摘要的英文标题。 + \end{itemize} + + 例如, + 如果要设定论文的类别为“本科生毕业论文”(“Undergraduate Thesis”), + 则可以使用以下命令: +\begin{Verbatim}[frame = single] +\renewcommand{\cthesisname}{本科生毕业论文} +\renewcommand{\ethesisname}{Undergraduate Thesis} +\end{Verbatim} + + \subsection{以“key = value”格式设置文档信息} + + 用户可以通过 \verb|\pkuthssinfo| 命令集中设定文档信息, + 其语法为: +\begin{Verbatim}[frame = single] +% key1、key2、value1、value2 等为具体文档信息的项目名和内容。 +\pkuthssinfo{key1 = value1, key2 = value2, ...} +\end{Verbatim} + 其中文档信息的项目名为前面提到的设定文档信息的命令名% + 或自身存储文档信息的命令名(不带反斜杠)。 + + 当文档信息的内容包含了逗号等有干扰的字符时, + 可以用大括号将这一项文档信息的全部内容括起来。\myemph{% + 我们建议用户总用大括号将文档信息的内容括起来, + 以避免很多不必要的麻烦。% + } + + 例如,前面提到的文档信息的设置可以集中地写成: +\begin{Verbatim}[frame = single, tabsize = 4] +\pkuthssinfo{ + ..., % “...”代表其它的设定。 + cthesisname = {本科生毕业论文}, + ethesisname = {Undergraduate Thesis}, + cmajor = {化学}, emajor = {Chemistry} +} +\end{Verbatim} + + \subsection{pkuthss 文档模版提供的其它命令和环境}\label{ssec:misc} + + \texttt{\bfseries cabstract} 和 \texttt{\bfseries eabstract} % + 环境用于编写中英文摘要。 + 用户只需要写摘要的正文;标题、作者、导师、专业等部分会自动生成。 + + \texttt{\bfseries\string\specialchap} 命令% + 用于开始不进行标号但计入目录的一章, + 并合理安排其页眉。\myemph{% + 注意: + 需要启用 pkuthss-extra 宏包的 \texttt{spechap} 选项% + 才能使用此命令。 + 另外,在此章内的节或小节等命令应使用带星号的版本, + 例如 \texttt{\string\section\string*} 等, + 以免造成章节编号混乱。% + }% + 例如,本文档中的“序言”一章就是用 \verb|\specialchap{序言}| % + 这条命令开始的。% + + \texttt{\bfseries\string\setpdfproperties} 命令% + 用于根据用户设定的文档信息自动设定生成的 pdf 文档的属性。 + 此命令会在用户调用 \verb|\maketitle| 命令时被自动调用, + 因此通常不需要用户自己使用; + 但用户有时可能不需要输出封面,从而不会调用 \verb|\maketitle| 命令, + 此时就需要在设定完文档信息之后调用 \verb|\setpdfproperties|。% + \myemph{% + 注意: + 需要启用 pkuthss-extra 宏包的 \texttt{pdfprop} 选项% + 才能使用此命令。% + } + + \subsection{从其它文档类和宏包继承的功能}\label{ssec:thirdparty} + + pkuthss 文档类建立在 ctexbook\supercite{ctex} 文档类之上, + 并调用了 CJKfntef、hyperref\supercite{hyperref}、% + geometry\supercite{geometry}、fancyhdr\supercite{fancyhdr} % + 和 graphicx\supercite{graphicx} 等几个宏包; + 使用 \hologo{pdfLaTeX} 方式编译 GBK 编码的源文件时还会调用 + xCJK2uni\supercite{xCJK2uni} 宏包\footnote{\ % + ctex 2.x 会自行调用 xCJK2uni 宏包, + 不用在 pkuthss 文档类中重复调用; + 这里调用 xCJK2un 是为了兼容 ctex 1.x 而进行的设定, + 该设定将在 2017 年被去除。% + }。 + 因此,ctexbook 文档类和这些宏包所提供的功能均可以使用。 + + 例如,用户如果想将目录的标题改为“目{\quad\quad}录”, + 则可以使用 ctexbook 文档类提供的 \verb|\CTEXoptions| 命令: +\begin{Verbatim}[frame = single] +\CTEXoptions[contentsname = {目{\quad\quad}录}] +\end{Verbatim} + + 在默认的配置下,% + pkuthss 文档模版使用作者编写的 biblatex\supercite{biblatex} 样式% + \mbox{\supercite{biblatex-caspervector}}% + 进行参考文献和引用的排版, + 用户可以使用它以及 biblatex 本身所提供的功能。 + 例如, + 用户可以分别使用 \verb|\cite|、\verb|\parencite| 和 \verb|\supercite| % + 生成未格式化的、带方括号的和上标且带方括号的引用标记: +\begin{Verbatim}[frame = single] +\cite{ctex},\parencite{ctex},\supercite{ctex} +\end{Verbatim} + 在本文中将产生“\cite{ctex},\parencite{ctex},\supercite{ctex}”。 + + 就目前而言,在 biblatex 2.x(\myemph{即不含 biblatex 3.0})中, + 通过更复杂的设置,还可以满足例如被引用的文献按照引用顺序排序, + 而未引用的文献按照英文文献在前、中文文献在后排序这样的需求, + 详见 biblatex-caspervector 的文档\supercite{biblatex-caspervector}。 + + pkuthss-extra 宏包可能调用以下这些宏包: + \begin{itemize} + \item 启用 \verb|footfmt| 选项时会调用 % + tikz\supercite{tikz} 和 scrextend\supercite{scrextend} 宏包。 + \item 启用 \verb|pkuspace| 选项时会调用 % + tocloft\supercite{tocloft}、subfig\supercite{subfig} 和 % + caption\supercite{caption} 宏包。 + \item 启用 \verb|spacing| 选项时会调用 setspace 和 % + enumitem\supercite{enumitem} 宏包。 + \end{itemize} + 因此在启用相应选项时,用户可以使用对应宏包所提供的功能。 + + \section{高级设置}\label{sec:advanced} + + pkuthss 文档模版的实现是简洁、清晰、灵活的。 + 当一些细节的自定义无法通过模版提供的外部接口实现时, + 我们鼓励用户(在适当理解相关部分代码的前提下)通过修改模版进行自定义。 + + 一个常见的需求是封面中部分内容(特别是论文的标题、专业和研究方向)太长, + 超出了在预设的空间。 + 此时, + 用户可以修改 \verb|pkuthss.cls| 里 \verb|\maketitle| 定义中 + \verb|\pkuthss@int@fillinblank| 宏的参数来改变 + 带下划线的空白的行数和行宽,其语法为: +\begin{Verbatim}[frame = single] +\pkuthss@int@fillinblank{行数}{行宽}{内容} +\end{Verbatim} + 例如,如果“研究方向”一栏需要两行的空白, + 可以将 \verb|pkuthss.cls| 里的 +\begin{Verbatim}[frame = single] +\pkuthss@int@fillinblank{1}{\pkuthss@tmp@len}{\kaishu\@direction} +\end{Verbatim} + 改为 +\begin{Verbatim}[frame = single] +\pkuthss@int@fillinblank{2}{\pkuthss@tmp@len}{\kaishu\@direction} +\end{Verbatim} + 当然,为了美观,可以将多于一行的部分移到封面中作者信息部分的最下方。 + diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap3.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap3.tex new file mode 100644 index 00000000000..927a4fff142 --- /dev/null +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-chap3.tex @@ -0,0 +1,150 @@ +% vim:ts=4:sw=4 +% +% Documentation for pkuthss. +% +% Copyright (c) 2008-2009 solvethis +% Copyright (c) 2010-2015 Casper Ti. Vector +% +% This work may be distributed and/or modified under the conditions of the +% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. +% +% This work consists of the following files: +% pkuthss.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex + +\chapter{问题及其解决} + \section{文档中已经提到的常见问题(按重要性排序)} + + 文档默认情况下是双面模式,章末可能产生空白页,详见第 \ref{ssec:options} 小节。 + 最终打印和提交论文前,需使用 pkuthss-extra 宏包的 \verb|nocolorlinks| 选项。 + 解决方式见第 \ref{ssec:extra} 小节。 + + 通过一些设置,还可以满足例如被引用的文献按照引用顺序排序, + 而未引用的文献按照英文文献在前、中文文献在后排序这样的需求, + 见第 \ref{ssec:thirdparty} 小节。 + + 一些高级设置, + 如封面中部分内容长度超过预设空间容量时的设置, + 见第 \ref{sec:advanced} 节。 + + 中文字体字库不全(只包含 GB2312 字符集内字符)时, + 生成的 pdf 文档中可能缺少部分字符, + 解决方式见第 \ref{sec:req} 节。 + 使用过旧的 \hologo{TeX} 系统和各宏包, + 或使用某些 Linux 发行版软件仓库所提供的 \hologo{TeX} Live 时, + 可能引起一些问题, + 详见第 \ref{sec:req} 节。 + + Windows 批处理对于 LF(\texttt{\string\n})换行的批处理文件支持有问题, + 解决方式见第 \ref{sec:compile} 节。 + Windows 的“记事本”程序在查看 LF(\texttt{\string\n}) + 换行的文本文件时存在着一些问题, + 因此建议用户使用支持 LF 换行的文本编辑器编辑文件, + 详见第 \ref{sec:doc-dir} 节。 + + \section{上游宏包可能引起的问题} + + biblatex\supercite{biblatex} 宏包会自行设定 \verb|\bibname|, + 故会覆盖通过 \verb|\CTEXoptions| 设定的参考文献列表标题。 + 使用 biblatex 的用户可以使用 \verb|\printbibliography| 的 + \verb|title| 选项来手动设定参考文献列表的标题,例如: +\begin{Verbatim}[frame = single] +\printbibliography[title = {文献}, ...] % “...”为其它选项。 +\end{Verbatim} + + hyperref\supercite{hyperref} 宏包和一些宏包可能发生冲突。 + 关于如何避免这些冲突, + 可以参考 hyperref 宏包的 README 文件中的“Package Compatibility”一节。 + 此文件通常和执行 \verb|texdoc hyperref| % + 时打开的 pdf 文件位于同一目录中。 + + 使用 \hologo{XeLaTeX} 的用户可能在已经安装字体的情况下遇到形如(其中 + \verb|xxxxxxxx| 为具体字体名) +\begin{Verbatim}[frame = single, fontsize = {\small}] +! fontspec error: "font-not-found" +! The font "xxxxxxxx" cannot be found. +! See the fontspec documentation for further information. +! For immediate help type H . +\end{Verbatim} + 的错误。 + 这种错误一般是(主要是非 Windows 平台的)用户采用了自定义的(包括大小写 + 不同于原文件的)字体文件名, + 并改动 \verb|ctex.cfg| 等配置文件之后没有在调用 % + pkuthss 文档类时加入 \verb|nofonts| 选项, + 又使用 \verb|xelatex| 编译造成的,使用 +\begin{Verbatim}[frame = single] +\documentclass[nofonts, ...]{pkuthss} % “...”代表其它的选项。 +\end{Verbatim} + 即可解决此问题。 + + biber 运行时有一定概率出现形如(目录名可能稍有不同) +\begin{Verbatim}[frame = single, fontsize = {\small}] +data source .../par-xxxxxxxx/cache-xxxxxxxx/ + inc/lib/Biber/LaTeX/recode_data.xml not found in . +\end{Verbatim} + 的错误。 + 这种错误一般是 biber 在自解压阶段被终止之后, + 未删除 \verb|.../par-xxxxxxxx/| 这个临时目录就重新运行 biber 时出现。 + 遇到这种情况时,删除掉上述临时目录及其所有内容, + 再重新运行 biber 通常便可解决问题。 + + caption\supercite{caption} 宏包对于其不认识的宏包均会提示 +\begin{Verbatim}[frame = single, fontsize = {\small}] +Package caption Warning: Unsupported document class (or package) detected, +(caption) usage of the caption package is not recommended. +See the caption package documentation for explanation. +\end{Verbatim} + pkuthss 文档模版基于 ctexbook 文档类, + 而后者基于标准的 book 文档类。 + 因此,这个警告并不影响用户正常使用\footnote{% + \url{http://bbs.ctex.org/forum.php?mod=redirect&goto=findpost&ptid=63117&pid=402145}.% + }。 + + \section{文档格式可能存在的问题} + + 学校对学位论文格式的规定\mbox{\supercite{pku-thesisstyle}}% + 显然没有考虑到非 MS Word 类排版工具的工作方式, + 因此 pkuthss 文档模板只是对其要求的格式进行模仿, + 而在一些小的细节上可能有所出入。 + + biblatex-caspervector\supercite{biblatex-caspervector} 所实现的格式和 % + \parencite{pku-thesisstyle} 的规定并不一致, + 但其作者暂时没有精力也不愿意去实现后者所规定的比原格式更丑陋得多的格式。 + + \section{反馈意见和建议} + + 关于 pkuthss 文档模版的意见和建议, + 请在北大未名 BBS 的 MathTools 版或 % + pkuthss 项目主页的 issue tracker% + \footnote{\url{https://github.com/CasperVector/pkuthss/issues}.}% + 上提出, + 或通过电子邮件\footnote% + {\href{mailto:CasperVector@gmail.com}{\texttt{CasperVector@gmail.com}}.}% + 告知模版维护者。 + 上述三种反馈方法中,建议用户尽量采用靠前的方法。 + + 在进行反馈时,请尽量确保已经仔细阅读本文档中的说明。 + 如果是通过 BBS 或电子邮件进行反馈, + 请在标题中说明是关于 pkuthss 文档模版的反馈; + 如果是错误报告, + 请说明所使用 pkuthss 模版的版本、 + 自己使用的操作系统和 \hologo{TeX} 系统的类型和版本; + 同时强烈建议附上一个出错的最小例子及其相应的编译日志(\verb|.log| 文件), + 在文件较长时请使用附件。 + diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-conclusion.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-conclusion.tex new file mode 100644 index 00000000000..e462c82a642 --- /dev/null +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-conclusion.tex @@ -0,0 +1,35 @@ +% vim:ts=4:sw=4 +% +% Documentation for pkuthss. +% +% Copyright (c) 2008-2009 solvethis +% Copyright (c) 2010-2012 Casper Ti. Vector +% +% This work may be distributed and/or modified under the conditions of the +% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. +% +% This work consists of the following files: +% pkuthss.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex + +\specialchap{结论} + +pkuthss 文档模版结构较为简洁、清晰、灵活,较为易于学习和使用。 +希望它能为各位需要使用 \hologo{LaTeX} 撰写学位论文的同学提供一些帮助。 + diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-copyright.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-copyright.tex new file mode 100644 index 00000000000..b787f061e0e --- /dev/null +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-copyright.tex @@ -0,0 +1,49 @@ +% vim:ts=4:sw=4 +% +% Documentation for pkuthss. +% +% Copyright (c) 2008-2009 solvethis +% Copyright (c) 2010-2015 Casper Ti. Vector +% +% This work may be distributed and/or modified under the conditions of the +% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. +% +% This work consists of the following files: +% pkuthss.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex + +\chapter*{版权声明} +\markboth{版权声明}{} + +版权所有 \copyright\ 2008--2009 solvethis +\par +版权所有 \copyright\ 2010--2015 Casper Ti. Vector +\vskip 1em + +pkuthss 文档类、pkuthss-extra 宏包及其说明文档均以 % +\hologo{LaTeX} Project Public License 发布。 +随 pkuthss 提供的模版源代码中,除以下文件 +\begin{itemize} + \item \verb|chap/copyright.tex| + \item \verb|chap/originauth.tex| +\end{itemize} +以 New BSD License 发布, +以及参考文献和引用使用的样式文件版权声明见相应文件中说明以外, +其余所有文件发布在公有领域(public domain)。 + diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-encl1.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-encl1.tex new file mode 100644 index 00000000000..c4fe8be1e68 --- /dev/null +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-encl1.tex @@ -0,0 +1,45 @@ +% vim:ts=4:sw=4 +% +% Documentation for pkuthss. +% +% Copyright (c) 2008-2009 solvethis +% Copyright (c) 2010-2012,2014 Casper Ti. Vector +% +% This work may be distributed and/or modified under the conditions of the +% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. +% +% This work consists of the following files: +% pkuthss.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex + +\chapter{更新记录} +\raggedbottom + +\section{1.3 版以后的更新记录} +\VerbatimInput[ + tabsize = 4, fontsize = {\small}, baselinestretch = 1 +]{ChangeLog.txt} + +\section{1.3 及其以前版本的更新记录} +\VerbatimInput[ + tabsize = 4, fontsize = {\small}, baselinestretch = 1.1 +]{ChangeLog-upto-1.3.txt} + +\flushbottom + diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-introduction.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-introduction.tex new file mode 100644 index 00000000000..f86dc396ddb --- /dev/null +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/chap/pkuthss-introduction.tex @@ -0,0 +1,70 @@ +% vim:ts=4:sw=4 +% +% Documentation for pkuthss. +% +% Copyright (c) 2008-2009 solvethis +% Copyright (c) 2010-2012,2014-2015 Casper Ti. Vector +% +% This work may be distributed and/or modified under the conditions of the +% LaTeX Project Public License, either version 1.3 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 Casper Ti. Vector. +% +% This work consists of the following files: +% pkuthss.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex + +\specialchap{序言} + +本文档是北京大学论文文档模版 pkuthss 的说明文档。 + +pkuthss 文档模版由四部分构成: +\begin{itemize} + \item \textbf{pkuthss 文档类}: + 其中进行了学位论文所需要的一些最基本的设定, + 主要包括对基本排版格式的设定和提供设置论文信息的命令。 + \item \textbf{pkuthss-extra 宏包}: + 其中实现了学校的学位论文格式规范\mbox{\supercite{pku-thesisstyle}}% + 中需要借助一些非最常见宏包来实现的需求; + 此外也实现了学位论文中用户可能较多用到的一些额外功能, + 例如自动在目录中加入参考文献和索引的条目和% + 自动根据用户设定的文档信息对所生成 pdf 的作者、标题等属性进行设置等。 + \item \textbf{说明文档}: + 说明文档即本文档, + 在安装(见第 \ref{sec:req} 节)之后应该可以用 \hologo{TeX} 系统提供的 + \verb|texdoc| 命令调出: +\begin{Verbatim}[frame = single] +texdoc pkuthss +\end{Verbatim} + \item \textbf{文档模版}: + 模版的源代码(及由此生成的 pdf 文档) + 和本文档的 pdf 文件处于同一目录下。 + 用户只需按照模版中的框架修改代码,即可写出自己的论文。 +\end{itemize} + +在此之前,包括 dypang\supercite{dypang}、FerretL\supercite{FerretL}、% +lwolf\supercite{lwolf}、Langpku\supercite{Langpku}、% +solvethis\supercite{solvethis} 等的数位网友均做过学位论文模版的工作。 +本论文模版是 solvethis 的 pkuthss 模版的更新版本, +更新的重点是重构和对新文档类、宏包的支持。 + +pkuthss 文档模版现在的维护者是 Casper Ti. Vector\footnote% +{\href{mailto:CasperVector@gmail.com}{\texttt{CasperVector@gmail.com}}}。% +pkuthss 文档模版目前托管在 GitHub 上, +其项目主页是:\\ +\hspace*{\parindent}\url{https://github.com/CasperVector/pkuthss} + diff --git a/Master/texmf-dist/doc/latex/pkuthss/readme/pkuthss.tex b/Master/texmf-dist/doc/latex/pkuthss/readme/pkuthss.tex index 7d5a38852d3..e3daa269ebc 100644 --- a/Master/texmf-dist/doc/latex/pkuthss/readme/pkuthss.tex +++ b/Master/texmf-dist/doc/latex/pkuthss/readme/pkuthss.tex @@ -18,15 +18,15 @@ % % This work consists of the following files: % pkuthss.tex -% chap/copyright.tex -% chap/abstract.tex -% chap/introduction.tex -% chap/chap1.tex -% chap/chap2.tex -% chap/chap3.tex -% chap/conclusion.tex -% chap/encl1.tex -% chap/acknowledge.tex +% chap/pkuthss-copyright.tex +% chap/pkuthss-abstract.tex +% chap/pkuthss-introduction.tex +% chap/pkuthss-chap1.tex +% chap/pkuthss-chap2.tex +% chap/pkuthss-chap3.tex +% chap/pkuthss-conclusion.tex +% chap/pkuthss-encl1.tex +% chap/pkuthss-acknowledge.tex \documentclass[UTF8, colorlinks]{pkuthss} @@ -44,7 +44,7 @@ \newcommand{\myemph}[1]{\emph{\textcolor{red}{#1}}} \newcommand{\unemph}[1]{\textup{\textcolor{black}{#1}}} -\newcommand{\docversion}{v1.6.2} +\newcommand{\docversion}{v1.6.3} \pkuthssinfo{ cthesisname = {本科生毕业论文}, ethesisname = {Undergraduate Thesis}, @@ -76,23 +76,23 @@ \setcounter{page}{0} \pagenumbering{Roman} - \include{chap/copyright} - \include{chap/abstract} + \include{chap/pkuthss-copyright} + \include{chap/pkuthss-abstract} \tableofcontents \mainmatter - \include{chap/introduction} - \include{chap/chap1} - \include{chap/chap2} - \include{chap/chap3} - \include{chap/conclusion} + \include{chap/pkuthss-introduction} + \include{chap/pkuthss-chap1} + \include{chap/pkuthss-chap2} + \include{chap/pkuthss-chap3} + \include{chap/pkuthss-conclusion} \appendix \printbibliography[heading = bibintoc, sorting = ecnty] - \include{chap/encl1} + \include{chap/pkuthss-encl1} \backmatter - \include{chap/acknowledge} + \include{chap/pkuthss-acknowledge} \include{chap/originauth} \end{document} -- cgit v1.2.3