diff options
Diffstat (limited to 'Master/texmf-dist/source')
| -rw-r--r-- | Master/texmf-dist/source/latex/njurepo/njurepo.dtx | 170 |
1 files changed, 92 insertions, 78 deletions
diff --git a/Master/texmf-dist/source/latex/njurepo/njurepo.dtx b/Master/texmf-dist/source/latex/njurepo/njurepo.dtx index e9824383e40..a5256d3bab7 100644 --- a/Master/texmf-dist/source/latex/njurepo/njurepo.dtx +++ b/Master/texmf-dist/source/latex/njurepo/njurepo.dtx @@ -16,7 +16,7 @@ % % \iffalse %<*driver> -\ProvidesFile{njurepo.dtx}[2019/01/29 1.0.1 Nanjing University Report Template] +\ProvidesFile{njurepo.dtx}[2019/01/29 1.1.2 Nanjing University Report Template] \documentclass{ltxdoc} \usepackage{dtx-style} \EnableCrossrefs @@ -72,6 +72,8 @@ % \changes{v1.0.0}{2019/01/22}{Initial version} % \changes{v1.0.1}{2019/01/29}{Add more ability} % \changes{v1.1.0}{2019/01/29}{Stable version} +% \changes{v1.1.1}{2019/02/20}{Fix little bugs} +% \changes{v1.1.2}{2019/03/20}{Fix some typo and add more predined macro. Polish manual} % % \GetFileInfo{\jobname.dtx} % @@ -80,7 +82,7 @@ % \IndexPrologue{\section{\indexname}} % \GlossaryPrologue{\section{\glossaryname}} -% \title{\bfseries\color{violet}\njurepo： 南京大学本科生范用报告} +% \title{\bfseries\color{violet}\njurepo： 南京大学本科生泛用报告} % \author{郑奘巍 \\[5pt]\texttt{zhengzangw@gmail.com}} % \date{\fileversion\ (\filedate)} % \maketitle\thispagestyle{empty} @@ -98,7 +100,7 @@ % \item 本模板的发布遵守 \LaTeX\ Project Public License，使用前请认真阅读协议内 % 容。 % \item \textbf{本模板为作者自己通常使用的报告模板，与南京大学官方没有任何关系}。任何使用该宏包进行实验报告制作时，请\textbf{务必根据课程要求进行写作}。由于使用本模板而引起的作业验收问题，均与本模板作者无关。 -% \item 本模板借鉴\thuthesis{}宏包的大量内容，需要稳定模板的同学也可以选择使用清华大学的\thuthesis{}宏包并自己进行配置。 +% \item 本模板借鉴\thuthesis{}宏包的许多内容，需要稳定模板的同学也可以选择使用清华大学的\thuthesis{}宏包并自己进行配置。 % \item 任何个人或组织以本模板为基础进行修改、扩展而生成的新的专用模板，请严格遵 % 守 \LaTeX\ Project Public License 协议。由于违犯协议而引起的任何纠纷争端均与 % 本模板作者无关。 @@ -115,16 +117,24 @@ % \clearpage % % \section{模板介绍} -% \njurepo\ (\textbf{N}an\textbf{jing} \textbf{U}niversity \LaTeX\ Versatile \textbf{Repo}rt Template)是根据作者用\LaTeX{}制作南京大学课程实验报告的模板文件，可帮助本科生快速的制作实验报告和作业。 +% \njurepo\ (\textbf{N}an\textbf{jing} \textbf{U}niversity \LaTeX\ Versatile \textbf{Repo}rt Template)是为南京大学本科生设计的一个免于配置的作业、实验报告模板。希望它可以使你的作业/实验报告不会因形式上的缺陷导致评分的下降。 +% +% 该文档格式基于 ctexbook, 主要完成了除了主体内容以外的几乎\textbf{全部}工作。同时，通过使用 Github 版本宏包，你还可以更好的管理自己的 $\LaTeX$ 文档。 +% % 本文档将尽量完整的介绍模板的使用方法，如有不清楚之处可以参考示例文档或者根据第 3.1 节说明提问，有兴趣者都可以参与完善此手册，也非常欢迎对代码的贡献。 % % \section{安装} % \label{sec:installation} -% \njurepo 开发版需要自行前往github主页：\\ -% https://github.com/zhengzangw/njurepo下载。 +% \subsection{CTAN} +% 本宏包已被收纳于 CTAN 中，凡安装完整版 Texlive 用户可直接使用： +% \begin{latex} +% \usepackage{njurepo} +% \end{latex} % -% \subsection{字体安装} -% 字体存放在font文件夹中，使用模板前先自行安装。 +% \subsection{Github} +% 想获得最新版本的 \njurepo 请前往 Github 主页下载：https://github.com/zhengzangw/njurepo +% +% 同时，面向 Github 版本的说明主要在 README.md 中，如果使用的是 Github 版本，请阅读 README.md % % \subsection{模板的组成} % 下表列出了\njurepo 的主要文件及其功能介绍： @@ -140,15 +150,15 @@ % \endlastfoot % njurepo.ins & \textsc{DocStrip} 驱动文件（开发用） \\ % njurepo.dtx & \textsc{DocStrip} 源文件（开发用）\\\midrule -% example.pdf & 实例文档\\ -% main.tex & 主文件\\ -% figs/ & 图片路径\\ -% figs/logos/ & 示例文档图片路径\\ -% fonts/ & 字体\\ +% resources/ & 资源路径\\ +% resources/logos/ & 示例文档资源路径\\ % parts/ & 具体内容\\ -% parts/examples & 示例文档具体内容\\ +% parts/examples/ & 示例文档具体内容\\ % ref/ & 参考文献和参考文献样式文件\\ % njurepo.cls & 模板类文件\\ +% Makefile & 自动运行脚本 \\ +% util.py & 实用管理工具 \\ +% README.md & 说明文件 \\ % \textbf{njurepo.pdf} & 用户手册（本文档）\\ \bottomrule % \end{longtable} % @@ -156,27 +166,21 @@ % 使用Makefile或\XeLaTeX 生成模板文件 % \begin{shell} % make cls -% xelatex njurepo.dtx # 两句选一句即可 % \end{shell} +% % \subsection{生成论文} % \subsubsection{latexmk} % latexmk 命令支持全自动生成\LaTeX{}编写的文档，并且支持使用不同的工具链来进行生成，它会自动运行多次工具直到交叉引用都被解决。下面给出了一个用 latexmk 调用 xelatex 生成最终文档的示例: % \begin{shell} % latexmk -xelatex main % \end{shell} -% \subsubsection{make} -% \njurepo{}提供了一个Makefile： -% \begin{shell} -% make clean -% make cls # 生成 njurepo.cls -% make doc # 生成说明文档 njurepo.pdf -% make main # 生成示例文档main.pdf -% \end{shell} +% % \subsection{升级} % 在github上下载最新版，运行: % \begin{shell} % make cls % \end{shell} +% % 生成新的类文件和配置文件即可。也可以直接拷贝 njurepo.cls，免去上面命令的执行。 % % @@ -209,8 +213,9 @@ % \bibliographystyle{ref/numeric} % ref/numeric,ref/author-year,plainnat,IEEEtran % \bibliography{ref/refs} % \include{parts/examples/ack} +% %% 附录 % \begin{appendix} -% \input{parts/examples/appendix01} + % \input{parts/examples/appendix01} % \end{appendix} % \end{document} % \end{latex} @@ -224,8 +229,8 @@ % 提交的作业如果是电子稿的话，可以使用连续页，即使用\option{any} % \DescribeOption{wide} % 是否使用宽页面。如果生成作业的话，宽页面或许好看。 -% \DescribeOption{awesomefont} -% 是否使用awesomefont图标。 +% \DescribeOption{draft} +% 是否生成水印。生成的水印为 Draft 表示此文档尚为草稿 % % \subsection{字体配置} % \label{sec:font-config} @@ -256,28 +261,31 @@ % 使用方法为：\cs{command}\oarg{num}，其中 command 为字号命令，num 为行距。比 % 如 \cs{xiaosi}[1.5] 表示选择小四字体，行距 1.5 倍。写作指南要求表格中的字体 % 是 \cs{dawu}，模板已经设置好了。 -% 对于英文，开发版中smallcaps默认使用了spinweradC字体。可以使用\cs{setmainfont}进行重新定义。 % % \subsection{封面信息} % 仿照parts/examples/cover.tex 进行设置 -% \subsection{问求} -% 为问求特制了一些宏，具体可见parts/examples/problemsolving.tex % \subsection{表格} +% \DescribeMacro{\figoptadd} +% \DescribeMacro{\figoptaddcap} +% 定义了两个简单的表格命令 % \begin{latex} -% \figpf{parameter}{filename} -% \figpfc{parameter}{filename}{caption} +% \figoptadd{option}{address} +% \figoptaddcap{option}{address}{caption} % \end{latex} % \subsection{图片} +% \DescribeMacro{\tabncc} +% \DescribeMacro{\tabnc} +% 定义了两个简单的图片命令 % \begin{latex} -% \tabncc{number per row}{content}{caption} -% \tabnc{number per row}{content} +% \tabncc{number-of-columns}{content}{caption} +% \tabnc{number-of-columns}{content} % \end{latex} % \subsection{代码} -%预设了如下的lstlisting环境 +% \njurepo 预设了如下的代码环境 % \begin{longtable}{ccccc} % \toprule -% code & codedisplay & cplus & shell & commandshell \\ -% verilog & python & & &\\ +% code & cpseudo & cplus & shell & commandshell \\ +% verilog & python & latex & &\\ % \bottomrule % \end{longtable} % \subsection{文字} @@ -286,14 +294,13 @@ % \magenta{品红色字} % \CJKunderline{下划线字} % \end{latex} -% 更多的预置宏包，可见\ref{sec:loadpkg} +% 更多关于预置宏包的内容，可见 README.md 以及 \ref{sec:loadpkg} % % % \section{致谢} -% 感谢以下宏包的作者为本宏包提供了借鉴： +% 感谢以下宏包的作者，本宏包从中使用了部分代码和借鉴： % \begin{itemize} % \item 清华大学\thuthesis https://github.com/xueruini/thuthesis -% \item 南京大学 NJUBachelor https://github.com/ZLCao/NJUBachelor % \end{itemize} % % \StopEventually{} @@ -313,7 +320,7 @@ \hyphenation{NJU-repo} \def\njurepo{\textsc{NJU}\-\textsc{repo}} \def\thuthesis{\textsc{Thu}\-\textsc{Thesis}} -\def\version{1.0.1} +\def\version{1.1.2} \RequirePackage{kvoptions} \SetupKeyvalOptions{ family=nju, @@ -325,7 +332,6 @@ \DeclareBoolOption{wide} \DeclareBoolOption{color} \DeclareBoolOption{draft} -\DeclareBoolOption{awesomefont} \DeclareDefaultOption{\PassOptionsToClass{\CurrentOption}{ctexbook}} \ProcessKeyvalOptions* @@ -364,12 +370,12 @@ % 用于图片的宏包 % \begin{macrocode} \RequirePackage{graphicx} -\graphicspath{{figs/}} -\graphicspath{{figs/logo/}} +\graphicspath{{resources/}} +\graphicspath{{resources/logo/}} \RequirePackage[labelformat=simple]{subcaption} \RequirePackage{pdfpages} \includepdfset{fitpaper=true} -\RequirePackage{tikz,tikzducks} +\RequirePackage{tikz} \usetikzlibrary{decorations.pathmorphing,graphs,calc} \RequirePackage{dirtree} % \end{macrocode} @@ -379,18 +385,19 @@ \RequirePackage{longtable} \RequirePackage{booktabs} \RequirePackage{multirow} -\RequirePackage{bbding,stmaryrd} \RequirePackage{tabularx} \RequirePackage{diagbox} \RequirePackage{makecell} \RequirePackage{float} % \end{macrocode} -% 用于数学的宏包 +% 用于符号或数学的宏包 % \begin{macrocode} \RequirePackage{CJKfntef} \RequirePackage{amsmath} \RequirePackage[amsmath, thmmarks, hyperref]{ntheorem} \RequirePackage{physics} +\RequirePackage{bbding,stmaryrd} +%\RequirePackage{fontawesome} % \end{macrocode} % 其它宏包 % \begin{macrocode} @@ -917,10 +924,10 @@ \theoremheaderfont{\normalfont\heiti} \theoremsymbol{\ensuremath{\square}} \newtheorem*{proof}{证明} -\theoremstyle{plain} \theoremsymbol{} \theoremseparator{：} \ifnju@chinese + \theoremstyle{plain} \newcommand\nju@assumption@name{假设} \newcommand\nju@definition@name{定义} \newcommand\nju@proposition@name{命题} @@ -931,10 +938,12 @@ \newcommand\nju@exercise@name{练习} \newcommand\nju@example@name{例} \newcommand\nju@remark@name{注释} - \newcommand\nju@problem@name{问题} \newcommand\nju@conjecture@name{猜想} + \theoremstyle{break} + \newcommand\nju@problem@name{问题} \newcommand\nju@solution@name{解} \else + \theoremstyle{plain} \newcommand\nju@assumption@name{Assumption} \newcommand\nju@definition@name{Definition} \newcommand\nju@proposition@name{Proposition} @@ -945,24 +954,25 @@ \newcommand\nju@exercise@name{Exercise} \newcommand\nju@example@name{Example} \newcommand\nju@remark@name{Remark} - \newcommand\nju@problem@name{Problem} \newcommand\nju@conjecture@name{Conjecture} + \theoremstyle{break} + \newcommand\nju@problem@name{Problem} \newcommand\nju@solution@name{Solution} \fi \theoremheaderfont{\bfseries} -\newtheorem{assumption}{\nju@assumption@name}[chapter] -\newtheorem{definition}{\nju@definition@name}[chapter] -\newtheorem{proposition}{\nju@proposition@name}[chapter] -\newtheorem{lemma}{\nju@lemma@name}[chapter] -\newtheorem{theorem}{\nju@theorem@name}[chapter] -\newtheorem{axiom}{\nju@axiom@name}[chapter] -\newtheorem{corollary}{\nju@corollary@name}[chapter] -\newtheorem{exercise}{\nju@exercise@name}[chapter] -\newtheorem{example}{\nju@example@name}[chapter] -\newtheorem{remark}{\nju@remark@name}[chapter] -\newtheorem{problem}{\nju@problem@name}[chapter] -\newtheorem{conjecture}{\nju@conjecture@name}[chapter] -\newtheorem{solution}{\nju@solution@name}[chapter] +\newtheorem{assumption}{\nju@assumption@name}[section] +\newtheorem{definition}{\nju@definition@name}[section] +\newtheorem{proposition}{\nju@proposition@name}[section] +\newtheorem{lemma}{\nju@lemma@name}[section] +\newtheorem{theorem}{\nju@theorem@name}[section] +\newtheorem{axiom}{\nju@axiom@name}[section] +\newtheorem{corollary}{\nju@corollary@name}[section] +\newtheorem{exercise}{\nju@exercise@name}[section] +\newtheorem{example}{\nju@example@name}[section] +\newtheorem{remark}{\nju@remark@name}[section] +\newtheorem{problem}{\nju@problem@name}[section] +\newtheorem{conjecture}{\nju@conjecture@name}[section] +\newtheorem{solution}{\nju@solution@name}[section] %\RequirePackage{microtype} \ifnju@chinese @@ -970,25 +980,20 @@ \else \newcommand{\promisewords}{I promise this work is done on my own with no plagiarism.} \fi -\newcommand{\pshw}{\section*{\scshape Part I\ \ \ Homework}} -\newcommand{\pscr}{\section*{\scshape Part II\ \ \ Correction}} -\newcommand{\psfb}{\section*{\scshape Part III\ \ \ Feedback}} \newcommand{\Hrule}{\noindent\rule{\linewidth}{0.5mm}} -\ifnju@awesomefont -\RequirePackage{awesomefont} -\fi - \theorempostwork{\vspace{-0.5cm}\Hrule} -\newtheorem*{pssolution}{\ifnju@awesomefont\faPencilSquareO\ \fi\nju@solution@name} +\newtheorem*{csolution}{\PencilRightDown\nju@solution@name} +\newtheorem*{nsolution}{\PencilRightDown\nju@solution@name} \RequirePackage[listings]{tcolorbox} \newtcolorbox{ps@problem}[1]{fonttitle=\bfseries,title=#1,before skip=0.5cm, after skip=-0.5cm} -\newenvironment{psproblem}[1][]{ - \begin{ps@problem}{\ifnju@awesomefont\faQuestionCircle\ \fi\nju@problem@name\ #1} +\newenvironment{cproblem}[1][]{ + \begin{ps@problem}{\Checkmark\ \nju@problem@name\ #1} }{ \end{ps@problem} } -% +\theoremstyle{plain} +\newtheorem*{nproblem}{\Checkmark\nju@problem@name}[section] % \subsubsection{浮动对象} % \label{sec:float} % 设置浮动对象和文字之间的距离 @@ -1116,7 +1121,7 @@ % % 各级标题格式设置。 % \begin{description} -% \item[chapter] 章序号与章名之间空一个汉字符 黑体三号字，居中书写，单倍行距，段 +% \item[section] 章序号与章名之间空一个汉字符 黑体三号字，居中书写，单倍行距，段 % 前空 24 磅，段后空 18 磅。本科要求：段前段后间距 30/20 pt，行距 20pt。但正文 % 章节 30pt 的话和样例效果不一致。 % \item[section] 一级节标题，例如：\fbox{2.1 实验装置与实验方法}。节标题序号与标 @@ -1468,7 +1473,8 @@ \parbox[b][2.4cm][t]{\textwidth}{% \rule{1cm}{0cm}} \vskip0.65cm - \par\vskip2cm + {\includegraphics[width=0.3\textwidth]{njuname0.pdf}} + \par\vskip1.5cm {\xiaochu\heiti\ziju{0.5}\textbf\nju@csubtitle} \vskip2.2cm\hskip0.8cm \noindent\heiti\xiaoer\nju@title@pre @@ -2072,7 +2078,7 @@ every listing line={\textcolor{red}{\small\ttfamily\bfseries \$>}}} % % \subsection{快速插入图片或图表} % \begin{macrocode} -\newcommand{\figpf}[2]{ +\newcommand{\figoptadd}[2]{ \begin{figure}[H] \centering \includegraphics[#1]{figs/#2} @@ -2080,8 +2086,8 @@ every listing line={\textcolor{red}{\small\ttfamily\bfseries \$>}}} } %%%%%%%%%%%%%%%%%%%% -\newcommand{\figpfc}[3]{ - \begin{figure}[htbp] +\newcommand{\figoptaddcap}[3]{ + \begin{figure}[H] \centering \includegraphics[#1]{figs/#2} \caption{#3} @@ -2150,6 +2156,14 @@ every listing line={\textcolor{red}{\small\ttfamily\bfseries \$>}}} } \fi % \end{macrocode} +% 补丁 +% \begin{macrocode} +\renewcommand{\thesection}{\arabic{section}} +\newcommand{\nchapter}[1]{ + {\let\clearpage\relax\par\vspace{1cm} \chapter*{\LARGE#1}} +} +\newcommand*{\rom}[1]{\expandafter\@slowromancap\romannumeral #1@} +% \end{macrocode} % % \subsection{自定义代码} % \begin{macrocode} |