summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/hitreport
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/hitreport')
-rw-r--r--macros/latex/contrib/hitreport/LICENSE416
-rw-r--r--macros/latex/contrib/hitreport/Makefile63
-rw-r--r--macros/latex/contrib/hitreport/README.md150
-rw-r--r--macros/latex/contrib/hitreport/data/abstract.tex22
-rw-r--r--macros/latex/contrib/hitreport/data/appendix.tex48
-rw-r--r--macros/latex/contrib/hitreport/data/chap01.tex78
-rw-r--r--macros/latex/contrib/hitreport/data/chap02.tex153
-rw-r--r--macros/latex/contrib/hitreport/data/chap03.tex71
-rw-r--r--macros/latex/contrib/hitreport/figures/example-image-a.pdfbin0 -> 12160 bytes
-rw-r--r--macros/latex/contrib/hitreport/figures/example-image-b.pdfbin0 -> 17201 bytes
-rw-r--r--macros/latex/contrib/hitreport/figures/scan-copyright.pdfbin0 -> 35716 bytes
-rw-r--r--macros/latex/contrib/hitreport/figures/scan-record.pdfbin0 -> 108783 bytes
-rw-r--r--macros/latex/contrib/hitreport/figures/scan-statement.pdfbin0 -> 31558 bytes
-rw-r--r--macros/latex/contrib/hitreport/hitreport-example.pdfbin0 -> 416027 bytes
-rw-r--r--macros/latex/contrib/hitreport/hitreport-example.tex42
-rw-r--r--macros/latex/contrib/hitreport/hitreport.dtx3191
-rw-r--r--macros/latex/contrib/hitreport/hitreport.ins54
-rw-r--r--macros/latex/contrib/hitreport/hitreport.pdfbin0 -> 485273 bytes
-rw-r--r--macros/latex/contrib/hitreport/hitsetup.tex109
-rw-r--r--macros/latex/contrib/hitreport/latexmkrc18
-rw-r--r--macros/latex/contrib/hitreport/photo/hithrb.pdfbin0 -> 156229 bytes
-rw-r--r--macros/latex/contrib/hitreport/photo/hitsz.pdfbin0 -> 136064 bytes
-rw-r--r--macros/latex/contrib/hitreport/photo/hitwh.pdfbin0 -> 200504 bytes
-rw-r--r--macros/latex/contrib/hitreport/ref/appendix.bib14
-rw-r--r--macros/latex/contrib/hitreport/ref/refs.bib331
25 files changed, 4760 insertions, 0 deletions
diff --git a/macros/latex/contrib/hitreport/LICENSE b/macros/latex/contrib/hitreport/LICENSE
new file mode 100644
index 0000000000..2244313901
--- /dev/null
+++ b/macros/latex/contrib/hitreport/LICENSE
@@ -0,0 +1,416 @@
+The LaTeX Project Public License
+=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
+
+LPPL Version 1.3c 2008-05-04
+
+Copyright 1999 2002-2008 LaTeX3 Project
+ Everyone is allowed to distribute verbatim copies of this
+ license document, but modification of it is not allowed.
+
+
+PREAMBLE
+========
+
+The LaTeX Project Public License (LPPL) is the primary license under
+which the LaTeX kernel and the base LaTeX packages are distributed.
+
+You may use this license for any work of which you hold the copyright
+and which you wish to distribute. This license may be particularly
+suitable if your work is TeX-related (such as a LaTeX package), but
+it is written in such a way that you can use it even if your work is
+unrelated to TeX.
+
+The section `WHETHER AND HOW TO DISTRIBUTE WORKS UNDER THIS LICENSE',
+below, gives instructions, examples, and recommendations for authors
+who are considering distributing their works under this license.
+
+This license gives conditions under which a work may be distributed
+and modified, as well as conditions under which modified versions of
+that work may be distributed.
+
+We, the LaTeX3 Project, believe that the conditions below give you
+the freedom to make and distribute modified versions of your work
+that conform with whatever technical specifications you wish while
+maintaining the availability, integrity, and reliability of
+that work. If you do not see how to achieve your goal while
+meeting these conditions, then read the document `cfgguide.tex'
+and `modguide.tex' in the base LaTeX distribution for suggestions.
+
+
+DEFINITIONS
+===========
+
+In this license document the following terms are used:
+
+ `Work'
+ Any work being distributed under this License.
+
+ `Derived Work'
+ Any work that under any applicable law is derived from the Work.
+
+ `Modification'
+ Any procedure that produces a Derived Work under any applicable
+ law -- for example, the production of a file containing an
+ original file associated with the Work or a significant portion of
+ such a file, either verbatim or with modifications and/or
+ translated into another language.
+
+ `Modify'
+ To apply any procedure that produces a Derived Work under any
+ applicable law.
+
+ `Distribution'
+ Making copies of the Work available from one person to another, in
+ whole or in part. Distribution includes (but is not limited to)
+ making any electronic components of the Work accessible by
+ file transfer protocols such as FTP or HTTP or by shared file
+ systems such as Sun's Network File System (NFS).
+
+ `Compiled Work'
+ A version of the Work that has been processed into a form where it
+ is directly usable on a computer system. This processing may
+ include using installation facilities provided by the Work,
+ transformations of the Work, copying of components of the Work, or
+ other activities. Note that modification of any installation
+ facilities provided by the Work constitutes modification of the Work.
+
+ `Current Maintainer'
+ A person or persons nominated as such within the Work. If there is
+ no such explicit nomination then it is the `Copyright Holder' under
+ any applicable law.
+
+ `Base Interpreter'
+ A program or process that is normally needed for running or
+ interpreting a part or the whole of the Work.
+
+ A Base Interpreter may depend on external components but these
+ are not considered part of the Base Interpreter provided that each
+ external component clearly identifies itself whenever it is used
+ interactively. Unless explicitly specified when applying the
+ license to the Work, the only applicable Base Interpreter is a
+ `LaTeX-Format' or in the case of files belonging to the
+ `LaTeX-format' a program implementing the `TeX language'.
+
+
+
+CONDITIONS ON DISTRIBUTION AND MODIFICATION
+===========================================
+
+1. Activities other than distribution and/or modification of the Work
+are not covered by this license; they are outside its scope. In
+particular, the act of running the Work is not restricted and no
+requirements are made concerning any offers of support for the Work.
+
+2. You may distribute a complete, unmodified copy of the Work as you
+received it. Distribution of only part of the Work is considered
+modification of the Work, and no right to distribute such a Derived
+Work may be assumed under the terms of this clause.
+
+3. You may distribute a Compiled Work that has been generated from a
+complete, unmodified copy of the Work as distributed under Clause 2
+above, as long as that Compiled Work is distributed in such a way that
+the recipients may install the Compiled Work on their system exactly
+as it would have been installed if they generated a Compiled Work
+directly from the Work.
+
+4. If you are the Current Maintainer of the Work, you may, without
+restriction, modify the Work, thus creating a Derived Work. You may
+also distribute the Derived Work without restriction, including
+Compiled Works generated from the Derived Work. Derived Works
+distributed in this manner by the Current Maintainer are considered to
+be updated versions of the Work.
+
+5. If you are not the Current Maintainer of the Work, you may modify
+your copy of the Work, thus creating a Derived Work based on the Work,
+and compile this Derived Work, thus creating a Compiled Work based on
+the Derived Work.
+
+6. If you are not the Current Maintainer of the Work, you may
+distribute a Derived Work provided the following conditions are met
+for every component of the Work unless that component clearly states
+in the copyright notice that it is exempt from that condition. Only
+the Current Maintainer is allowed to add such statements of exemption
+to a component of the Work.
+
+ a. If a component of this Derived Work can be a direct replacement
+ for a component of the Work when that component is used with the
+ Base Interpreter, then, wherever this component of the Work
+ identifies itself to the user when used interactively with that
+ Base Interpreter, the replacement component of this Derived Work
+ clearly and unambiguously identifies itself as a modified version
+ of this component to the user when used interactively with that
+ Base Interpreter.
+
+ b. Every component of the Derived Work contains prominent notices
+ detailing the nature of the changes to that component, or a
+ prominent reference to another file that is distributed as part
+ of the Derived Work and that contains a complete and accurate log
+ of the changes.
+
+ c. No information in the Derived Work implies that any persons,
+ including (but not limited to) the authors of the original version
+ of the Work, provide any support, including (but not limited to)
+ the reporting and handling of errors, to recipients of the
+ Derived Work unless those persons have stated explicitly that
+ they do provide such support for the Derived Work.
+
+ d. You distribute at least one of the following with the Derived Work:
+
+ 1. A complete, unmodified copy of the Work;
+ if your distribution of a modified component is made by
+ offering access to copy the modified component from a
+ designated place, then offering equivalent access to copy
+ the Work from the same or some similar place meets this
+ condition, even though third parties are not compelled to
+ copy the Work along with the modified component;
+
+ 2. Information that is sufficient to obtain a complete,
+ unmodified copy of the Work.
+
+7. If you are not the Current Maintainer of the Work, you may
+distribute a Compiled Work generated from a Derived Work, as long as
+the Derived Work is distributed to all recipients of the Compiled
+Work, and as long as the conditions of Clause 6, above, are met with
+regard to the Derived Work.
+
+8. The conditions above are not intended to prohibit, and hence do not
+apply to, the modification, by any method, of any component so that it
+becomes identical to an updated version of that component of the Work as
+it is distributed by the Current Maintainer under Clause 4, above.
+
+9. Distribution of the Work or any Derived Work in an alternative
+format, where the Work or that Derived Work (in whole or in part) is
+then produced by applying some process to that format, does not relax or
+nullify any sections of this license as they pertain to the results of
+applying that process.
+
+10. a. A Derived Work may be distributed under a different license
+ provided that license itself honors the conditions listed in
+ Clause 6 above, in regard to the Work, though it does not have
+ to honor the rest of the conditions in this license.
+
+ b. If a Derived Work is distributed under a different license, that
+ Derived Work must provide sufficient documentation as part of
+ itself to allow each recipient of that Derived Work to honor the
+ restrictions in Clause 6 above, concerning changes from the Work.
+
+11. This license places no restrictions on works that are unrelated to
+the Work, nor does this license place any restrictions on aggregating
+such works with the Work by any means.
+
+12. Nothing in this license is intended to, or may be used to, prevent
+complete compliance by all parties with all applicable laws.
+
+
+NO WARRANTY
+===========
+
+There is no warranty for the Work. Except when otherwise stated in
+writing, the Copyright Holder provides the Work `as is', without
+warranty of any kind, either expressed or implied, including, but not
+limited to, the implied warranties of merchantability and fitness for a
+particular purpose. The entire risk as to the quality and performance
+of the Work is with you. Should the Work prove defective, you assume
+the cost of all necessary servicing, repair, or correction.
+
+In no event unless required by applicable law or agreed to in writing
+will The Copyright Holder, or any author named in the components of the
+Work, or any other party who may distribute and/or modify the Work as
+permitted above, be liable to you for damages, including any general,
+special, incidental or consequential damages arising out of any use of
+the Work or out of inability to use the Work (including, but not limited
+to, loss of data, data being rendered inaccurate, or losses sustained by
+anyone as a result of any failure of the Work to operate with any other
+programs), even if the Copyright Holder or said author or said other
+party has been advised of the possibility of such damages.
+
+
+MAINTENANCE OF THE WORK
+=======================
+
+The Work has the status `author-maintained' if the Copyright Holder
+explicitly and prominently states near the primary copyright notice in
+the Work that the Work can only be maintained by the Copyright Holder
+or simply that it is `author-maintained'.
+
+The Work has the status `maintained' if there is a Current Maintainer
+who has indicated in the Work that they are willing to receive error
+reports for the Work (for example, by supplying a valid e-mail
+address). It is not required for the Current Maintainer to acknowledge
+or act upon these error reports.
+
+The Work changes from status `maintained' to `unmaintained' if there
+is no Current Maintainer, or the person stated to be Current
+Maintainer of the work cannot be reached through the indicated means
+of communication for a period of six months, and there are no other
+significant signs of active maintenance.
+
+You can become the Current Maintainer of the Work by agreement with
+any existing Current Maintainer to take over this role.
+
+If the Work is unmaintained, you can become the Current Maintainer of
+the Work through the following steps:
+
+ 1. Make a reasonable attempt to trace the Current Maintainer (and
+ the Copyright Holder, if the two differ) through the means of
+ an Internet or similar search.
+
+ 2. If this search is successful, then enquire whether the Work
+ is still maintained.
+
+ a. If it is being maintained, then ask the Current Maintainer
+ to update their communication data within one month.
+
+ b. If the search is unsuccessful or no action to resume active
+ maintenance is taken by the Current Maintainer, then announce
+ within the pertinent community your intention to take over
+ maintenance. (If the Work is a LaTeX work, this could be
+ done, for example, by posting to comp.text.tex.)
+
+ 3a. If the Current Maintainer is reachable and agrees to pass
+ maintenance of the Work to you, then this takes effect
+ immediately upon announcement.
+
+ b. If the Current Maintainer is not reachable and the Copyright
+ Holder agrees that maintenance of the Work be passed to you,
+ then this takes effect immediately upon announcement.
+
+ 4. If you make an `intention announcement' as described in 2b. above
+ and after three months your intention is challenged neither by
+ the Current Maintainer nor by the Copyright Holder nor by other
+ people, then you may arrange for the Work to be changed so as
+ to name you as the (new) Current Maintainer.
+
+ 5. If the previously unreachable Current Maintainer becomes
+ reachable once more within three months of a change completed
+ under the terms of 3b) or 4), then that Current Maintainer must
+ become or remain the Current Maintainer upon request provided
+ they then update their communication data within one month.
+
+A change in the Current Maintainer does not, of itself, alter the fact
+that the Work is distributed under the LPPL license.
+
+If you become the Current Maintainer of the Work, you should
+immediately provide, within the Work, a prominent and unambiguous
+statement of your status as Current Maintainer. You should also
+announce your new status to the same pertinent community as
+in 2b) above.
+
+
+WHETHER AND HOW TO DISTRIBUTE WORKS UNDER THIS LICENSE
+======================================================
+
+This section contains important instructions, examples, and
+recommendations for authors who are considering distributing their
+works under this license. These authors are addressed as `you' in
+this section.
+
+Choosing This License or Another License
+----------------------------------------
+
+If for any part of your work you want or need to use *distribution*
+conditions that differ significantly from those in this license, then
+do not refer to this license anywhere in your work but, instead,
+distribute your work under a different license. You may use the text
+of this license as a model for your own license, but your license
+should not refer to the LPPL or otherwise give the impression that
+your work is distributed under the LPPL.
+
+The document `modguide.tex' in the base LaTeX distribution explains
+the motivation behind the conditions of this license. It explains,
+for example, why distributing LaTeX under the GNU General Public
+License (GPL) was considered inappropriate. Even if your work is
+unrelated to LaTeX, the discussion in `modguide.tex' may still be
+relevant, and authors intending to distribute their works under any
+license are encouraged to read it.
+
+A Recommendation on Modification Without Distribution
+-----------------------------------------------------
+
+It is wise never to modify a component of the Work, even for your own
+personal use, without also meeting the above conditions for
+distributing the modified component. While you might intend that such
+modifications will never be distributed, often this will happen by
+accident -- you may forget that you have modified that component; or
+it may not occur to you when allowing others to access the modified
+version that you are thus distributing it and violating the conditions
+of this license in ways that could have legal implications and, worse,
+cause problems for the community. It is therefore usually in your
+best interest to keep your copy of the Work identical with the public
+one. Many works provide ways to control the behavior of that work
+without altering any of its licensed components.
+
+How to Use This License
+-----------------------
+
+To use this license, place in each of the components of your work both
+an explicit copyright notice including your name and the year the work
+was authored and/or last substantially modified. Include also a
+statement that the distribution and/or modification of that
+component is constrained by the conditions in this license.
+
+Here is an example of such a notice and statement:
+
+ %% pig.dtx
+ %% Copyright 2005 M. Y. Name
+ %
+ % 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 M. Y. Name.
+ %
+ % This work consists of the files pig.dtx and pig.ins
+ % and the derived file pig.sty.
+
+Given such a notice and statement in a file, the conditions
+given in this license document would apply, with the `Work' referring
+to the three files `pig.dtx', `pig.ins', and `pig.sty' (the last being
+generated from `pig.dtx' using `pig.ins'), the `Base Interpreter'
+referring to any `LaTeX-Format', and both `Copyright Holder' and
+`Current Maintainer' referring to the person `M. Y. Name'.
+
+If you do not want the Maintenance section of LPPL to apply to your
+Work, change `maintained' above into `author-maintained'.
+However, we recommend that you use `maintained', as the Maintenance
+section was added in order to ensure that your Work remains useful to
+the community even when you can no longer maintain and support it
+yourself.
+
+Derived Works That Are Not Replacements
+---------------------------------------
+
+Several clauses of the LPPL specify means to provide reliability and
+stability for the user community. They therefore concern themselves
+with the case that a Derived Work is intended to be used as a
+(compatible or incompatible) replacement of the original Work. If
+this is not the case (e.g., if a few lines of code are reused for a
+completely different task), then clauses 6b and 6d shall not apply.
+
+
+Important Recommendations
+-------------------------
+
+ Defining What Constitutes the Work
+
+ The LPPL requires that distributions of the Work contain all the
+ files of the Work. It is therefore important that you provide a
+ way for the licensee to determine which files constitute the Work.
+ This could, for example, be achieved by explicitly listing all the
+ files of the Work near the copyright notice of each file or by
+ using a line such as:
+
+ % This work consists of all files listed in manifest.txt.
+
+ in that place. In the absence of an unequivocal list it might be
+ impossible for the licensee to determine what is considered by you
+ to comprise the Work and, in such a case, the licensee would be
+ entitled to make reasonable conjectures as to which files comprise
+ the Work.
+
diff --git a/macros/latex/contrib/hitreport/Makefile b/macros/latex/contrib/hitreport/Makefile
new file mode 100644
index 0000000000..08b80f62f9
--- /dev/null
+++ b/macros/latex/contrib/hitreport/Makefile
@@ -0,0 +1,63 @@
+# Makefile for HITReport
+
+PACKAGE = hitreport
+REPORT = hitreport-example
+
+SOURCES = $(PACKAGE).ins $(PACKAGE).dtx
+CLSFILE = dtx-style.sty $(PACKAGE).cls
+
+LATEXMK = latexmk
+SHELL := /bin/bash
+NPM ?= npm
+
+# make deletion work on Windows
+ifdef SystemRoot
+ RM = del /Q
+else
+ RM = rm -f
+endif
+
+.PHONY: all all-dev clean distclean dist report viewreport spine viewspine doc viewdoc cls check save savepdf test FORCE_MAKE
+
+report: $(REPORT).pdf
+
+all: report
+
+all-dev: doc all
+
+cls: $(CLSFILE)
+
+$(CLSFILE): $(SOURCES)
+ xetex $(PACKAGE).ins
+
+doc: $(PACKAGE).pdf
+
+$(PACKAGE).pdf: cls FORCE_MAKE
+ $(LATEXMK) $(PACKAGE).dtx
+
+$(REPORT).pdf: cls FORCE_MAKE
+ $(LATEXMK) $(REPORT)
+
+viewdoc: doc
+ $(LATEXMK) -pv $(PACKAGE).dtx
+
+viewreport: report
+ $(LATEXMK) -pv $(REPORT)
+
+
+clean:
+ $(LATEXMK) -c $(PACKAGE).dtx $(REPORT)
+
+cleanall: clean
+ -@$(RM) $(PACKAGE).pdf $(REPORT).pdf
+
+distclean: cleanall
+ -@$(RM) $(CLSFILE)
+ -@$(RM) -r dist
+
+
+dist: check all-dev
+ # use l3build for CTAN release (zip with .tds.zip)
+ l3build ctan --config build-ctan
+ # use gulp for GitHub release (zip with generated file)
+ $(NPM) run build -- --version=$(version)
diff --git a/macros/latex/contrib/hitreport/README.md b/macros/latex/contrib/hitreport/README.md
new file mode 100644
index 0000000000..86c012fea8
--- /dev/null
+++ b/macros/latex/contrib/hitreport/README.md
@@ -0,0 +1,150 @@
+[![Test](https://github.com/DemerzelSun12/hitreport/actions/workflows/test.yml/badge.svg)](https://github.com/DemerzelSun12/hitreport/actions/workflows/test.yml)
+[![GitHub release](https://img.shields.io/github/v/release/demerzelsun12/hitreport)](https://github.com/demerzelsun12/hitreport/releases/latest)
+
+# hitreport
+
+Scroll down for the English version of README.
+
+# What's hitreport
+
+**hitreport** stands for **H**arbin **I**nstitute of **T**echnology **Report** LaTeX Template.
+
+hitreport是为哈尔滨工业大学一校三区本科生设计的一个免于配置的作业、实验报告模板。希望它可以使你的作业/实验报告不会因形式上的缺陷导致评分的下降。
+
+该文档主要完成了除了主体内容以外的几乎**全部**工作。同时,通过使用 Github 版本宏包,你还可以更好的管理自己的 LaTeX 文档。
+
+## 安装方法
+
+推荐下载**发布版**模板,里面包括具体使用说明以及示例文档:
+
+* 模板使用说明 (hitreport.pdf)
+* 示例文档 (hitreport-example.pdf)
+
+为方便对 LaTeX 不熟悉的用户使用本模板,本模板的发布版也提供预生成的 `cls` 文件、文档和源码。如需使用稳定版本,请从 CTAN 下载(虽然还在申请中)。
+
+下载途径:
+
+* 发布版:
+ * CTAN:暂无,在申请中。
+ * [GitHub Releases](https://github.com/demerzelsun12/hitreport/releases):最新版的及时发布途径之一。
+ * [Gitee Releases](https://gitee.com/demerzel/hitreport/releases):最新版的及时发布途径之二。
+
+## 升级
+
+### 自动更新
+
+通过 TeX 发行版工具(如 `tlmgr`)自动从 [CTAN](https://www.ctan.org/pkg/hitreport) 更新。
+
+### 手动更新
+
+#### 发布版
+
+下载发布版的的 zip 包,使用其中的 `hitreport.cls` 等文件覆盖原有的即可,无须额外操作。
+
+#### 开发版
+
+从 GitHub clone 项目源码或者下载源码 zip 包,执行命令(Windows 用户在文件夹空白处按 `Shift + 鼠标右键`,点击“在此处打开命令行窗口”):
+
+```shell
+xetex hitreport.ins
+```
+
+即可得到 `hitreport.cls` 等模板文件。
+
+## 提问
+
+请在 Github Issues 上提出问题:
+
+* [GitHub Issues](https://github.com/demerzelsun12/hitreport/issues)
+
+## Makefile的用法
+
+```shell
+make [{report|doc|clean|cleanall|distclean}]
+```
+
+### 目标
+
+* `make report` 生成报告 hitreport-example.pdf;
+* `make doc` 生成模板使用说明书 hitreport.pdf;
+* `make clean` 删除示例文件的中间文件(不含 hitreport-example.pdf);
+* `make cleanall` 删除示例文件的中间文件和 hitreport-example.pdf;
+* `make distclean` 删除示例文件和模板的所有中间文件和 PDF。
+
+---
+
+## Contact
+
+如果你使用时发现任何 bug 或得不到的格式,可以联系我或开 issue
+如果你有更好的作业/报告格式,欢迎添加或联系我帮忙添加
+
+## License
+
+LaTeX Project Public License, Version 1.3c (LPPL-1.3c).
+
+# hitreport?
+
+**hitreport** stands for **H**arbin **I**nstitute of **T**echnology **Report** LaTeX Template.
+
+hitreport is an assignment and experiment report template free of configuration designed for undergraduates in the three campus of Harbin Institute of Technology. I hope it can prevent your homework/experiment report from falling down due to formal defects.
+
+This document mainly completes almost **all** work except the main document. At the same time, by using the Github version macro package, you can better manage your own LaTeX documents. An English translation of this README follows the Chinese below.
+
+**This template is subject to frequent changes. Please make sure you have read the usage documentation and example code completely and carefully before using and asking questions.**
+
+## Downloads
+
+**Publish versions** are recommended. Specific usage documentation and examples can be found in the archive. At present, these documents are <b>only available in Chinese</b>:
+
+* Template usage documentation (hitreport.pdf)
+* Template example (hitreport-example.pdf)
+
+For the convenience of users who are not familiar with latex to use this template all versions contain source code, pre-comlied `cls` file and documentations. No warranties are provided.
+
+* Published versions:
+ * CTAN:in application...
+ * [Github Releases](https://github.com/demerzelsun12/hitreport/releases) :
+ * [GitHub Releases](https://github.com/demerzelsun12/hitreport/releases):One of the methods for timely release of the latest version.
+ * [Gitee Releases](https://gitee.com/demerzel/hitreport/releases):Another method for timely release of the latest version.
+
+## Updates
+
+### Automic
+
+Get the most up-to-date published version with your TeX distribution from [CTAN](https://www.ctan.org/pkg/hitreport).
+
+### Manual
+
+#### Published
+
+Download the published zip files, extract `hitreport.cls` and other files (if needed) and override the existing ones in your report.
+
+#### Developer versions
+
+Download the source code package and unzip to the root dictionary of your report (or clone this project), then execute the command (Windows users `Shift + right click` white area in the file window and click "Open command line window here" from the popup menu):
+
+```shell
+xetex hitreport.ins
+```
+
+you'll get `hitreport.cls` along with other template files.
+
+## Reporting Issues
+
+Please report your issues on Github Issues:
+
+* [Github Issues](https://github.com/demerzelsun12/hitreport/issues)
+
+## Makefile Usage
+
+```shell
+make [{report|doc|clean|cleanall|distclean}]
+```
+
+### Targets
+
+* `make report` generate report
+* `make doc` generate template documentation
+* `make clean` delete all examples' files (excluding hitreport-example.pdf)
+* `make cleanall` delete all examples' files and hitreport-example.pdf
+* `make distclean` delete all examples' and templates' files and PDFs.
diff --git a/macros/latex/contrib/hitreport/data/abstract.tex b/macros/latex/contrib/hitreport/data/abstract.tex
new file mode 100644
index 0000000000..11770a0edd
--- /dev/null
+++ b/macros/latex/contrib/hitreport/data/abstract.tex
@@ -0,0 +1,22 @@
+% !TeX root = ../hitreport-example.tex
+
+% 中英文摘要和关键字
+
+\begin{abstract}
+ 论文的摘要是对论文研究内容和成果的高度概括。
+ 摘要应对论文所研究的问题及其研究目的进行描述,对研究方法和过程进行简单介绍,对研究成果和所得结论进行概括。
+ 摘要应具有独立性和自明性,其内容应包含与论文全文同等量的主要信息。
+ 使读者即使不阅读全文,通过摘要就能了解论文的总体内容和主要成果。
+
+ 论文摘要的书写应力求精确、简明。
+ 切忌写成对论文书写内容进行提要的形式,尤其要避免“第 1 章……;第 2 章……;……”这种或类似的陈述方式。
+
+ 关键词是为了文献标引工作、用以表示全文主要内容信息的单词或术语。
+ 关键词不超过 5 个,每个关键词中间用分号分隔。
+
+ % 关键词用“英文逗号”分隔,输出时会自动处理为正确的分隔符
+ \hitsetup{
+ keywords = {关键词 1, 关键词 2, 关键词 3, 关键词 4, 关键词 5},
+ }
+\end{abstract}
+
diff --git a/macros/latex/contrib/hitreport/data/appendix.tex b/macros/latex/contrib/hitreport/data/appendix.tex
new file mode 100644
index 0000000000..4c2ec5dd20
--- /dev/null
+++ b/macros/latex/contrib/hitreport/data/appendix.tex
@@ -0,0 +1,48 @@
+\chapter{附录}
+
+附录是与论文内容密切相关、但编入正文又影响整篇论文编排的条理和逻辑性的资料,例如某些重要的数据表格、计算程序、统计表等,是论文主体的补充内容,可根据需要设置。
+
+
+\section{图表示例}
+
+\subsection{图}
+
+附录中的图片示例(图~\ref{fig:appendix-figure})。
+
+\begin{figure}
+ \centering
+ \includegraphics[width=0.6\linewidth]{example-image-a.pdf}
+ \caption{附录中的图片示例}
+ \label{fig:appendix-figure}
+\end{figure}
+
+
+\subsection{表格}
+
+附录中的表格示例(表~\ref{tab:appendix-table})。
+
+\begin{table}
+ \centering
+ \caption{附录中的表格示例}
+ \begin{tabular}{ll}
+ \toprule
+ 文件名 & 描述 \\
+ \midrule
+ thuthesis.dtx & 模板的源文件,包括文档和注释 \\
+ thuthesis.cls & 模板文件 \\
+ thuthesis-*.bst & BibTeX 参考文献表样式文件 \\
+ thuthesis-*.bbx & BibLaTeX 参考文献表样式文件 \\
+ thuthesis-*.cbx & BibLaTeX 引用样式文件 \\
+ \bottomrule
+ \end{tabular}
+ \label{tab:appendix-table}
+\end{table}
+
+
+\section{数学公式}
+
+附录中的数学公式示例(公式~\eqref{eq:appendix-equation})。
+\begin{equation}
+ \frac{1}{2 \symup{\pi} \symup{i}} \int_\gamma f = \sum_{k=1}^m n(\gamma; a_k) \mathscr{R}(f; a_k)
+ \label{eq:appendix-equation}
+\end{equation}
diff --git a/macros/latex/contrib/hitreport/data/chap01.tex b/macros/latex/contrib/hitreport/data/chap01.tex
new file mode 100644
index 0000000000..505a882a9f
--- /dev/null
+++ b/macros/latex/contrib/hitreport/data/chap01.tex
@@ -0,0 +1,78 @@
+% !TeX root = ../hitreport-example.tex
+
+\chapter{论文主要部分的写法}
+
+研究生学位论文撰写,除表达形式上需要符合一定的格式要求外,内容方面上也要遵循一些共性原则。
+
+通常研究生学位论文只能有一个主题(不能是几块工作拼凑在一起),该主题应针对某学科领域中的一个具体问题展开深入、系统的研究,并得出有价值的研究结论。
+学位论文的研究主题切忌过大,例如,“中国国有企业改制问题研究”这样的研究主题过大,因为“国企改制”涉及的问题范围太广,很难在一本研究生学位论文中完全研究透彻。
+
+
+
+\section{论文的语言及表述}
+
+除国际研究生外,学位论文一律须用汉语书写。
+学位论文应当用规范汉字进行撰写,除古汉语研究中涉及的古文字和参考文献中引用的外文文献之外,均采用简体汉字撰写。
+
+国际研究生一般应以中文或英文书写学位论文,格式要求同上。
+论文须用中文封面。
+
+研究生学位论文是学术作品,因此其表述要严谨简明,重点突出,专业常识应简写或不写,做到立论正确、数据可靠、说明透彻、推理严谨、文字凝练、层次分明,避免使用文学性质的或带感情色彩的非学术性语言。
+
+论文中如出现一个非通用性的新名词、新术语或新概念,需随即解释清楚。
+
+
+
+\section{论文题目的写法}
+
+论文题目应简明扼要地反映论文工作的主要内容,力求精炼、准确,切忌笼统。
+论文题目是对研究对象的准确、具体描述,一般要在一定程度上体现研究结论,因此,论文题目不仅应告诉读者这本论文研究了什么问题,更要告诉读者这个研究得出的结论。
+例如:“在事实与虚构之间:梅乐、卡彭特、沃尔夫的新闻观”就比“三个美国作家的新闻观研究”更专业、更准确。
+
+
+
+\section{摘要的写法}
+
+论文摘要是对论文研究内容的高度概括,应具有独立性和自含性,即应是 一篇简短但意义完整的文章。
+通过阅读论文摘要,读者应该能够对论文的研究 方法及结论有一个整体性的了解,因此摘要的写法应力求精确简明。
+论文摘要 应包括对问题及研究目的的描述、对使用的方法和研究过程进行的简要介绍、 对研究结论的高度凝练等,重点是结果和结论。
+
+论文摘要切忌写成全文的提纲,尤其要避免“第 1 章……;第 2 章……;……”这样的陈述方式。
+
+
+
+\section{引言的写法}
+
+一篇学位论文的引言大致包含如下几个部分:
+1、问题的提出;
+2、选题背 景及意义;
+3、文献综述;
+4、研究方法;
+5、论文结构安排。
+\begin{itemize}
+ \item 问题的提出:要清晰地阐述所要研究的问题“是什么”。
+ \footnote{选题时切记要有“问题意识”,不要选不是问题的问题来研究。}
+ \item 选题背景及意义:论述清楚为什么选择这个题目来研究,即阐述该研究对学科发展的贡献、对国计民生的理论与现实意义等。
+ \item 文献综述:对本研究主题范围内的文献进行详尽的综合述评,“述”的同时一定要有“评”,指出现有研究状态,仍存在哪些尚待解决的问题,讲出自己的研究有哪些探索性内容。
+ \item 研究方法:讲清论文所使用的学术研究方法。
+ \item 论文结构安排:介绍本论文的写作结构安排。
+\end{itemize}
+
+
+
+\section{正文的写法}
+
+本部分是论文作者的研究内容,不能将他人研究成果不加区分地掺和进来。
+已经在引言的文献综述部分讲过的内容,这里不需要再重复。
+各章之间要存在有机联系,符合逻辑顺序。
+
+
+
+\section{结论的写法}
+
+结论是对论文主要研究结果、论点的提炼与概括,应精炼、准确、完整,使读者看后能全面了解论文的意义、目的和工作内容。
+结论是最终的、总体的结论,不是正文各章小结的简单重复。
+结论应包括论文的核心观点,主要阐述作者的创造性工作及所取得的研究成果在本领域中的地位、作用和意义,交代研究工作的局限,提出未来工作的意见或建议。
+同时,要严格区分自己取得的成果与指导教师及他人的学术成果。
+
+在评价自己的研究工作成果时,要实事求是,除非有足够的证据表明自己的研究是“首次”、“领先”、“填补空白”的,否则应避免使用这些或类似词语。
diff --git a/macros/latex/contrib/hitreport/data/chap02.tex b/macros/latex/contrib/hitreport/data/chap02.tex
new file mode 100644
index 0000000000..834789e384
--- /dev/null
+++ b/macros/latex/contrib/hitreport/data/chap02.tex
@@ -0,0 +1,153 @@
+% !TeX root = ../hitreport-example.tex
+
+\chapter{图表示例}
+
+\section{插图}
+
+图片通常在 {figure} 环境中使用 {includegraphics} 插入,如图~\ref{fig:example} 的源代码。
+建议矢量图片使用 PDF 格式,比如数据可视化的绘图;
+照片应使用 JPG 格式;
+其他的栅格图应使用无损的 PNG 格式。
+注意,LaTeX 不支持 TIFF 格式;EPS 格式已经过时。
+
+\begin{figure}
+ \centering
+ \includegraphics[width=0.6\linewidth]{example-image-a.pdf}
+ \caption{示例图片}
+ \label{fig:example}
+\end{figure}
+
+若图或表中有附注,采用英文小写字母顺序编号,附注写在图或表的下方。
+% LaTeX 传统上一般将附注的内容同图表的标题写在一起,形成很长的一段文字。
+
+如果一个图由两个或两个以上分图组成时,各分图分别以(a)、(b)、(c)...... 作为图序,并须有分图题。
+推荐使用 {subcaption} 宏包来处理, 比如图~\ref{fig:subfig-a} 和图~\ref{fig:subfig-b}。
+
+\begin{figure}
+ \centering
+ \subcaptionbox{分图 A\label{fig:subfig-a}}
+ {\includegraphics[width=0.45\linewidth]{example-image-a.pdf}}
+ \subcaptionbox{分图 B\label{fig:subfig-b}}
+ {\includegraphics[width=0.45\linewidth]{example-image-b.pdf}}
+ \caption{多个分图的示例}
+ \label{fig:multi-image}
+\end{figure}
+
+
+
+\section{表格}
+
+表应具有自明性。为使表格简洁易读,尽可能采用三线表,如表~\ref{tab:three-line}。
+三条线可以使用 {booktabs} 宏包提供的命令生成。
+
+\begin{table}
+ \centering
+ \caption{三线表示例}
+ \begin{tabular}{ll}
+ \toprule
+ 文件名 & 描述 \\
+ \midrule
+ thuthesis.dtx & 模板的源文件,包括文档和注释 \\
+ thuthesis.cls & 模板文件 \\
+ thuthesis-*.bst & BibTeX 参考文献表样式文件 \\
+ thuthesis-*.bbx & BibLaTeX 参考文献表样式文件 \\
+ thuthesis-*.cbx & BibLaTeX 引用样式文件 \\
+ \bottomrule
+ \end{tabular}
+ \label{tab:three-line}
+\end{table}
+
+表格如果有附注,尤其是需要在表格中进行标注时,可以使用 {threeparttable} 宏包。
+研究生要求使用英文小写字母 a、b、c……顺序编号,本科生使用圈码 ①、②、③……编号。
+
+\begin{table}
+ \centering
+ \begin{threeparttable}[c]
+ \caption{带附注的表格示例}
+ \label{tab:three-part-table}
+ \begin{tabular}{ll}
+ \toprule
+ 文件名 & 描述 \\
+ \midrule
+ thuthesis.dtx\tnote{a} & 模板的源文件,包括文档和注释 \\
+ thuthesis.cls\tnote{b} & 模板文件 \\
+ thuthesis-*.bst & BibTeX 参考文献表样式文件 \\
+ thuthesis-*.bbx & BibLaTeX 参考文献表样式文件 \\
+ thuthesis-*.cbx & BibLaTeX 引用样式文件 \\
+ \bottomrule
+ \end{tabular}
+ \begin{tablenotes}
+ \item [a] 可以通过 xelatex 编译生成模板的使用说明文档;
+ 使用 xetex 编译 {thuthesis.ins} 时则会从 {.dtx} 中去除掉文档和注释,得到精简的 {.cls} 文件。
+ \item [b] 更新模板时,一定要记得编译生成 {.cls} 文件,否则编译论文时载入的依然是旧版的模板。
+ \end{tablenotes}
+ \end{threeparttable}
+\end{table}
+
+如某个表需要转页接排,可以使用 {longtable} 宏包,需要在随后的各页上重复表的编号。
+编号后跟表题(可省略)和“(续)”,置于表上方。续表均应重复表头。
+
+\begin{longtable}{cccc}
+ \caption{跨页长表格的表题} \\
+ \toprule
+ 表头 1 & 表头 2 & 表头 3 & 表头 4 \\
+ \midrule
+ \endfirsthead
+ \caption[]{跨页长表格的表题(续)} \\
+ \toprule
+ 表头 1 & 表头 2 & 表头 3 & 表头 4 \\
+ \midrule
+ \endhead
+ \bottomrule
+ \endfoot
+ Row 1 & & & \\
+ Row 2 & & & \\
+ Row 3 & & & \\
+ Row 4 & & & \\
+ Row 5 & & & \\
+ Row 6 & & & \\
+ Row 7 & & & \\
+ Row 8 & & & \\
+ Row 9 & & & \\
+ Row 10 & & & \\
+ Row 11 & & & \\
+ Row 12 & & & \\
+ Row 13 & & & \\
+ Row 14 & & & \\
+ Row 15 & & & \\
+ Row 16 & & & \\
+ Row 17 & & & \\
+ Row 18 & & & \\
+ Row 19 & & & \\
+ Row 20 & & & \\
+ Row 21 & & & \\
+ Row 22 & & & \\
+ Row 23 & & & \\
+ Row 24 & & & \\
+ Row 25 & & & \\
+ Row 26 & & & \\
+ Row 27 & & & \\
+ Row 28 & & & \\
+ Row 29 & & & \\
+ Row 30 & & & \\
+ Row 31 & & & \\
+ Row 32 & & & \\
+ Row 33 & & & \\
+ Row 34 & & & \\
+ Row 35 & & & \\
+ Row 36 & & & \\
+ Row 37 & & & \\
+ Row 38 & & & \\
+ Row 39 & & & \\
+ Row 40 & & & \\
+ Row 41 & & & \\
+ Row 42 & & & \\
+ Row 43 & & & \\
+ Row 44 & & & \\
+ Row 45 & & & \\
+ Row 46 & & & \\
+ Row 47 & & & \\
+ Row 48 & & & \\
+ Row 49 & & & \\
+ Row 50 & & & \\
+\end{longtable}
diff --git a/macros/latex/contrib/hitreport/data/chap03.tex b/macros/latex/contrib/hitreport/data/chap03.tex
new file mode 100644
index 0000000000..fff827b9d4
--- /dev/null
+++ b/macros/latex/contrib/hitreport/data/chap03.tex
@@ -0,0 +1,71 @@
+% !TeX root = ../hitreport-example.tex
+
+\chapter{数学符号和公式}
+
+\section{数学符号}
+
+中文论文的数学符号默认采用 GB/T 3102.11—1993《物理科学和技术中使用的数学符号》。
+该标准参照采纳 ISO 31-11:1992(目前最新版为 ISO 80000-2:2019),
+但是与 \TeX{} 默认的英美国家的符号习惯有许多差异,主要有:
+\begin{enumerate}
+ \item 大写希腊字母默认为斜体,如 $\Delta$、$\Sigma$,
+ 有限增量符号 $\increment$({increment})固定使用正体。
+ \item 数学常数和特殊函数名用正体,如 $\symup{\pi} = 3.14\dots$;$\symup{e} = 2.718\dots$。
+ \item 微分号使用正体,比如 $\dif y / \dif x$。
+ \item 向量、矩阵和张量用粗斜体({symbf}),如 $\symbf{x}$、$\symbf{\Sigma}$。
+ \item 省略号按照中文的习惯固定居中,如 $1, 2, \dots, n$。
+\end{enumerate}
+
+英文论文的数学符号使用 \TeX{} 默认的样式。
+如果有必要,也可以通过设置 \verb|math-style| 选择数学符号样式。
+
+关于量和单位推荐使用
+\href{http://mirrors.ctan.org/macros/latex/contrib/siunitx/siunitx.pdf}{{siunitx}}
+宏包,
+可以方便地处理希腊字母以及数字与单位之间的空白,
+比如:
+\SI{6.4e6}{m},
+\SI{9}{\micro\meter},
+\si{kg.m.s^{-1}},
+\SIrange{10}{20}{\degreeCelsius}。
+
+
+
+\section{数学公式}
+
+数学公式可以使用 {equation} 和 {equation*} 环境。
+注意数学公式的引用应前后带括号,建议使用 {eqref} 命令,比如式 \eqref{eq:example}。
+\begin{equation}
+ \frac{1}{2 \symup{\pi} \symup{i}} \int_\gamma f = \sum_{k=1}^m n(\gamma; a_k) \mathscr{R}(f; a_k)
+ \label{eq:example}
+\end{equation}
+注意公式编号的引用应含有圆括号,可以使用 {eqref} 命令。
+
+多行公式尽可能在“=”处对齐,推荐使用 {align} 环境。
+\begin{align}
+ a & = b + c + d + e \\
+ & = f + g
+\end{align}
+
+
+
+\section{数学定理}
+
+定理环境的格式可以使用 {amsthm} 或者 {ntheorem} 宏包配置。
+用户在导言区载入这两者之一后,模板会自动配置 {thoerem}、{proof} 等环境。
+
+\begin{theorem}[Lindeberg--Lévy 中心极限定理]
+ 设随机变量 $X_1, X_2, \dots, X_n$ 独立同分布, 且具有期望 $\mu$ 和有限的方差 $\sigma^2 \ne 0$,
+ 记 $\bar{X}_n = \frac{1}{n} \sum_{i+1}^n X_i$,则
+ \begin{equation}
+ \lim_{n \to \infty} P \left(\frac{\sqrt{n} \left( \bar{X}_n - \mu \right)}{\sigma} \le z \right) = \Phi(z),
+ \end{equation}
+ 其中 $\Phi(z)$ 是标准正态分布的分布函数。
+\end{theorem}
+%\begin{proof}
+% Trivial.
+%\end{proof}
+
+%同时模板还提供了 \env{assumption}、\env{definition}、\env{proposition}、
+%\env{lemma}、\env{theorem}、\env{axiom}、\env{corollary}、\env{exercise}、
+%\env{example}、\env{remar}、\env{problem}、\env{conjecture} 这些相关的环境。
diff --git a/macros/latex/contrib/hitreport/figures/example-image-a.pdf b/macros/latex/contrib/hitreport/figures/example-image-a.pdf
new file mode 100644
index 0000000000..6d7ecb88a0
--- /dev/null
+++ b/macros/latex/contrib/hitreport/figures/example-image-a.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/figures/example-image-b.pdf b/macros/latex/contrib/hitreport/figures/example-image-b.pdf
new file mode 100644
index 0000000000..7b404afa22
--- /dev/null
+++ b/macros/latex/contrib/hitreport/figures/example-image-b.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/figures/scan-copyright.pdf b/macros/latex/contrib/hitreport/figures/scan-copyright.pdf
new file mode 100644
index 0000000000..9d5c5a5665
--- /dev/null
+++ b/macros/latex/contrib/hitreport/figures/scan-copyright.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/figures/scan-record.pdf b/macros/latex/contrib/hitreport/figures/scan-record.pdf
new file mode 100644
index 0000000000..db0dcef7b2
--- /dev/null
+++ b/macros/latex/contrib/hitreport/figures/scan-record.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/figures/scan-statement.pdf b/macros/latex/contrib/hitreport/figures/scan-statement.pdf
new file mode 100644
index 0000000000..25e1494d7a
--- /dev/null
+++ b/macros/latex/contrib/hitreport/figures/scan-statement.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/hitreport-example.pdf b/macros/latex/contrib/hitreport/hitreport-example.pdf
new file mode 100644
index 0000000000..669dc242a1
--- /dev/null
+++ b/macros/latex/contrib/hitreport/hitreport-example.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/hitreport-example.tex b/macros/latex/contrib/hitreport/hitreport-example.tex
new file mode 100644
index 0000000000..9e28cf8fe0
--- /dev/null
+++ b/macros/latex/contrib/hitreport/hitreport-example.tex
@@ -0,0 +1,42 @@
+% !TeX encoding = UTF-8
+% !TeX program = xelatex
+
+\documentclass{hitreport}
+
+
+% 报告基本配置,加载宏包等全局配置
+\input{hitsetup}
+
+
+\begin{document}
+
+% 封面
+\maketitle
+
+\frontmatter
+\input{data/abstract}
+
+% 目录
+\tableofcontents
+
+
+% 正文部分
+\mainmatter
+\input{data/chap01}
+\input{data/chap02}
+\input{data/chap03}
+
+
+% 其他部分
+\backmatter
+
+% 参考文献
+%\bibliography{ref/refs} % 参考文献使用 BibTeX 编译
+% \printbibliography % 参考文献使用 BibLaTeX 编译
+
+% 附录
+\appendix
+\input{data/appendix}
+
+
+\end{document}
diff --git a/macros/latex/contrib/hitreport/hitreport.dtx b/macros/latex/contrib/hitreport/hitreport.dtx
new file mode 100644
index 0000000000..326147d327
--- /dev/null
+++ b/macros/latex/contrib/hitreport/hitreport.dtx
@@ -0,0 +1,3191 @@
+% \iffalse meta-comment
+%
+% Copyright (C) 2021 by Xiao Sun <demerzelsun@gmail.com>
+%
+% This file 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.3c or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% \fi
+%
+% \iffalse
+%<*driver>
+\ProvidesFile{hitreport.dtx}[2021/01/14 1.0.0 Harbin Institute of Technology Report Template]
+\documentclass{ltxdoc}
+\usepackage{dtx-style}
+
+\EnableCrossrefs
+\CodelineIndex
+
+\begin{document}
+ \DocInput{hitreport.dtx}
+\end{document}
+%</driver>
+% \fi
+%
+% \CharacterTable
+% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+% Digits \0\1\2\3\4\5\6\7\8\9
+% Exclamation \! Double quote \" Hash (number) \#
+% Dollar \$ Percent \% Ampersand \&
+% Acute accent \' Left paren \( Right paren \)
+% Asterisk \* Plus \+ Comma \,
+% Minus \- Point \. Solidus \/
+% Colon \: Semicolon \; Less than \<
+% Equals \= Greater than \> Question mark \?
+% Commercial at \@ Left bracket \[ Backslash \\
+% Right bracket \] Circumflex \^ Underscore \_
+% Grave accent \` Left brace \{ Vertical bar \|
+% Right brace \} Tilde \~}
+%
+% \DoNotIndex{\newenvironment,\@bsphack,\@empty,\@esphack,\sfcode}
+% \DoNotIndex{\addtocounter,\label,\let,\linewidth,\newcounter}
+% \DoNotIndex{\noindent,\normalfont,\par,\parskip,\phantomsection}
+% \DoNotIndex{\providecommand,\ProvidesPackage,\refstepcounter}
+% \DoNotIndex{\RequirePackage,\setcounter,\setlength,\string,\strut}
+% \DoNotIndex{\textbackslash,\texttt,\ttfamily,\usepackage}
+% \DoNotIndex{\begin,\end,\begingroup,\endgroup,\par,\\}
+% \DoNotIndex{\if,\ifx,\ifdim,\ifnum,\ifcase,\else,\or,\fi}
+% \DoNotIndex{\let,\def,\xdef,\edef,\newcommand,\renewcommand}
+% \DoNotIndex{\expandafter,\csname,\endcsname,\relax,\protect}
+% \DoNotIndex{\Huge,\huge,\LARGE,\Large,\large,\normalsize}
+% \DoNotIndex{\small,\footnotesize,\scriptsize,\tiny}
+% \DoNotIndex{\normalfont,\bfseries,\slshape,\sffamily,\interlinepenalty}
+% \DoNotIndex{\textbf,\textit,\textsf,\textsc}
+% \DoNotIndex{\hfil,\par,\hskip,\vskip,\vspace,\quad}
+% \DoNotIndex{\centering,\raggedright,\ref}
+% \DoNotIndex{\c@secnumdepth,\@startsection,\@setfontsize}
+% \DoNotIndex{\ ,\@plus,\@minus,\p@,\z@,\@m,\@M,\@ne,\m@ne}
+% \DoNotIndex{\@@par,\DeclareOperation,\RequirePackage,\LoadClass}
+% \DoNotIndex{\AtBeginDocument,\AtEndDocument}
+%
+% \changes{v1.0.0}{2021/01/14}{Initial version}
+%
+% \GetFileInfo{\jobname.dtx}
+%
+% \def\indexname{索引}
+% \def\glossaryname{修改记录}
+% \IndexPrologue{\section{\indexname}}
+% \GlossaryPrologue{\section{\glossaryname}}
+
+% \title{\bfseries\color{violet} \hitreport: 哈尔滨工业大学本科生泛用报告}
+% \author{孙骁 \\[5pt]\texttt{demerzelsun@gmail.com}}
+% \date{\fileversion\ (\filedate)}
+% \maketitle\thispagestyle{empty}
+%
+% \begin{abstract}\noindent
+% 此宏包旨在建立一个免于配置的、指令相对简单的哈尔滨工业大学作业、实验报告通用模板。
+% \end{abstract}
+%
+%
+% \vskip2cm
+% \def\abstractname{免责声明}
+% \begin{abstract}
+% \noindent
+% \begin{enumerate}
+% \item 本模板的发布遵守 \LaTeX\ Project Public License,使用前请认真阅读协议内
+% 容。
+% \item \textbf{本模板为作者编写的报告模板,与哈尔滨工业大学官方没有任何关系}。本模板的格式无法兼顾所有课程要求,
+% 但已经适配了绝大多数的需求场景。
+% 任何使用本宏包进行实验报告制作时,请\textbf{务必根据课程要求进行写作}。
+% 由于使用本模板而引起的作业验收问题,
+% 均与本模板作者无关。
+% \item 任何个人或组织以本模板为基础进行修改、扩展而生成的新的专用模板,
+% 请严格遵守 \LaTeX\ Project Public License 协议。
+% 由于违犯协议而引起的任何纠纷争端均与
+% 本模板作者无关。
+% \end{enumerate}
+% \end{abstract}
+%
+% \clearpage
+% \pagestyle{fancy}
+% \begin{multicols}{2}[
+% \setlength{\columnseprule}{.4pt}
+% \setlength{\columnsep}{18pt}]
+% \tableofcontents
+% \end{multicols}
+% \clearpage
+%
+% \section{模板介绍}
+% \hitreport (\textbf{H}arbin \textbf{I}istitute of \textbf{T}echnology \LaTeX\ Versatile \textbf{Report} Template)是为哈尔滨工业大学一校三区的本科生设计的一个免于配置的作业、实验报告模板。希望它可以使你的作业或实验报告不会因形式上的缺陷导致评分的下降。
+%
+% 该文档格式基于 ctexbook, 主要完成了除了主体内容以外的几乎\textbf{全部}工作。同时,通过使用 Github 版本宏包,你还可以更好的管理自己的 \LaTeX 文档。
+%
+% 本文档将尽量完整的介绍模板的使用方法,如有不清楚之处可以参考示例文档或者根据第 节说明提问,有兴趣者都可以参与完善此手册,也非常欢迎在Github上提出Issues。
+%
+% \section{安装}
+% \label{sec:installation}
+% \subsection{CTAN}
+% 本宏包已被收纳于 CTAN 中,凡安装完整版 Texlive 用户可直接使用:
+% \begin{latex}
+% \usepackage{hitreport}
+% \end{latex}
+% 进行写作,但是通常版本较旧,且不便更新。
+%
+% \subsection{Github}
+% 想获得最新版本的请前往 Github 主页下载:
+% \url{https://github.com/demerzelsun12/hitreport}
+%
+% 同时,面向 Github 版本的说明主要在 README.md 中,
+% 如果使用的是 Github 版本,请阅读 README.md
+%
+% \subsection{Gitee}
+% 为解决部分同学无法正常访问 GitHub 或者下载速度过慢的情况,
+% 本模板在 Gitee 上也做同步更新,Gitee下载地址为:
+% \url{https://gitee.com/demerzel/hitreport}
+%
+% 模板支持在 TeX Live、MacTeX 和 MIKTeX 平台下进行编译,
+% 使用最新版本可以避免 bug。
+%
+% \subsection{模板的组成}
+% 由于报告的短时性的特点,也方便更多零基础的同学使用本模板,
+% 本模板进最大可能简化了非实际报告文字的配置部分。下表列出了模板的主要文件及其功能介绍:
+%
+% \begin{longtable}{l|p{8cm}}
+% \toprule
+% {\heiti 文件(夹)} & {\heiti 功能描述}\\\midrule
+% \endfirsthead
+% \midrule
+% {\heiti 文件(夹)} & {\heiti 功能描述}\\\midrule
+% \endhead
+% \endfoot
+% \endlastfoot
+% hitreport.ins & \textsc{DocStrip} 驱动文件(开发用) \\
+% hitreport.dtx & \textsc{DocStrip} 源文件(开发用)\\\midrule
+% ref/ & 示例文档参考文献目录 \\
+% figures/ & 示例文档图片路径 \\
+% data/ & 实例文档各章节路径 \\
+% photo/ & 模板封面引用图片路径 \\
+% code/ & 示例文档引用代码路径 \\\midrule
+% report.tex & 示例文档基本配置 \\
+% hitreport.cls & 模板类文件 \\
+% hitreport-example.tex & 示例文档主文件\\
+% hitreport-example.pdf & 示例文档 \\
+% hitsetup.tex & 示例文档基本配置\\\midrule
+% Makefile & 自动运行脚本 \\
+% latexmkrc & latexmk 配置文件 \\
+% README.md & 说明文件 \\
+% \textbf{hitreport.pdf} & 用户手册(本文档)\\ \bottomrule
+% \end{longtable}
+%
+% 几点说明:
+% \begin{itemize}
+% \item \file{hitreport.cls} 可由 \file{hitreport.ins}
+% 和 \file{hitreport.dtx} 生成,但为了降低新手用户的使用难度,故
+% 将 \file{hitreport.cls} 文件一起发布。新手可直接下载 Release 版
+% 本,Release 版本不包含 \file{hitreport.ins} 和
+% \file{hitreport.dtx}。
+% \item 使用模板文件或对模板文件进行修改前请阅读本文档:
+% \file{hitreport.pdf}。
+% \end{itemize}
+%
+%
+% \subsection{生成模板}
+% \label{sec:generate-cls}
+% 模板的源文件(\file{hitreport.dtx})中包含了大量的注释,需要将注
+% 释去掉生成轻量级的 \file{.cls} 文件供 \cs{documentclass} 调用。
+% 使用Makefile或 \XeLaTeX 生成模板文件。
+% \begin{shell}
+% $ make cls
+% \end{shell}
+% 或
+% \begin{shell}
+% $ xelatex hitreport.ins
+% \end{shell}
+%
+% \note[注意:]{如果没有生成的模板 \file{hitreport.cls} 文件
+% (与 \file{hitreport-example.tex} 在同一目录下),
+% \LaTeX{} 在编译时可能找到发行版中较旧版本的 \file{.cls},从而造成编译冲突。}
+%
+% \subsection{生成报告}
+% \label{sec:gengrate-report}
+% 本节介绍几种常见的生成报告的方法。用户可根据自己的情况选择。
+%
+% 在撰写报告时,需要注意,代码引用可以使用相对路径,但是图片引用则必须
+% 放在 figures 文件夹下。如果需要对校徽以及校名图片名称进行修改,
+% \file{hitreport.cls} 文件中相应位置也需要修改。
+%
+% 在撰写报告时,\textbf{不推荐}使用原有的 \file{hitreport-example.tex} 这一名称。
+% 建议将其复制一份,改为其他的名字(如 \file{report.tex} 或者 \file{main.tex})。
+% 需要注意,如果使用了来自 \file{data} 目录中的 \file{tex} 文件,
+% 则重命名主文件后,其顶端的 \texttt{!TeX root} 选项也需要相应修改。
+%
+% \subsubsection{GNU make}
+% \label{sec:make}
+% 如果用户可以使用 GNU make 工具,这是最方便的办法。
+% 所以 \hitreport 提供了 \file{Makefile}:
+% \begin{shell}
+% $ make report # 生成报告示例 hitreport-example.pdf
+% $ make doc # 生成说明文档 hitreport.pdf
+% $ make clean # 清理编译生成的辅助文件
+% \end{shell}
+%
+% 需要注意,如果更改了主文件的名称,则需要修改 \file{Makefile} 顶端的 \texttt{REPORT} 变量定义。
+%
+% \subsubsection{latexmk}
+% latexmk 命令支持全自动生成\LaTeX{}编写的文档,并且支持使用不同的工具链来进行生成,它会自动运行多次工具直到交叉引用都被解决。下面给出了一个用 latexmk 调用 xelatex 生成最终文档的示例:
+% \begin{shell}
+% $ latexmk hitreport-example.tex # 生成示例报告
+% $ latexmk hitreport.dtx # 生成说明文档hitreport.pdf
+% $ latexmk -c # 清理编译生成的辅助文件
+% \end{shell}
+% \texttt{latexmk} 的编译过程是通过 \file{latexmkrc} 文件来配置的,如果要进一步了解,
+% 可以参考 \pkg{latexmk} 文档。
+%
+%
+% \subsubsection{\XeLaTeX}
+% \label{sec:xelatex}
+% 如果用户无法使用以上两种较为方便的编译方法,就只能按照以下复杂的办法手动编译。
+%
+% 首先,更新模板:
+% \begin{shell}
+% $ xetex hitreport.ins # 生成 hitreport.cls
+% \end{shell}
+%
+% 然后,生成论文:
+% \begin{shell}
+% $ xelatex hitreport-example.tex
+% $ bibtex hitreport-example.aux # 生成 bbl 文件
+% $ xelatex hitreport-example.tex # 解决引用
+% $ xelatex hitreport-example.tex # 生成报告 PDF
+%
+% \end{shell}
+%
+% 使用下面的命令用来生成用户手册:
+% \begin{shell}
+% $ xelatex -shell-escape hitreport.dtx
+% $ makeindex -s gind.ist -o hitreport.ind hitreport.idx
+% $ xelatex -shell-escape hitreport.dtx
+% $ xelatex -shell-escape hitreport.dtx # 生成说明文档 hitreport.pdf
+% \end{shell}
+%
+% \subsection{升级}
+% \label{sec:upgrade}
+% 如果需要升级 \hitreport{},应当从 GitHub 下载最新的版本,
+% 将 \file{hitreport.dtx},\file{hitreport.ins},拷贝至工作目录覆盖相应的文件,然后按照
+% 第~\ref{sec:generate-cls} 节的内容生成新的模板和使用说明。
+%
+% 有时模板可能进行了重要的修改,不兼容已写好的正文内容,用户应按照示例
+% 文档重新调整。
+%
+%
+% \section{使用说明}
+% \label{sec:usage}
+% \subsection{示例文件}
+% 推荐从模板自带的示例文档入手,其中包括了写作用到的所有命令及其使用方法,只需要用自己的内容进行相应替换就可以。对于不清楚的命令可以查阅本手册。下面的例子描述了模板中章节的组织形式,来自于示例文档,具体内容可以参考模板附带的 \file{hitreport-example.tex}。
+%
+% \subsection{选项}
+% \label{sec:option}
+% 报告的语言是中文,暂不支持英文。
+% \DescribeOption{open}
+% 正规出版物的章节出现在奇数页,也就是右手边的页面,这就是 \option{right},。在这种情况下,如果前一章的最后一页也是奇数,那么模板会自动生成一个纯粹的空白页。
+% 提交的作业如果是电子稿的话,可以使用连续页,即使用\option{any}
+% \DescribeOption{wide}
+% 是否使用宽页面。如果生成作业的话,宽页面或许好看。
+% \DescribeOption{draft}
+% 是否生成水印。生成的水印为 Draft 表示此文档尚为草稿
+%
+% \subsection{字体配置}
+% \label{sec:font-config}
+% 模板默认可以自动检测操作系统,并配置改平台上合适的字体,
+% 具体的配置策略如表~\ref{tab:font}。
+% \begin{table}[htb]
+% \centering
+% \caption{hitreport 自动配置字体策略}
+% \label{tab:font}
+% \begin{tabular}{ccc}
+% \toprule
+% Windows & macOS & 其他 \\
+% \midrule
+% Times New Roman & Times New Roman & TeX Gyre Termes \\
+% Arial & Arial & TeX Gyre Heros \\
+% Courier & Menlo & TeX Gyre Cursor \\
+% 中易宋体 & 华文宋体 & Noto 宋体 \\
+% 中易黑体 & 华文黑体 & Noto 黑体 \\
+% \bottomrule
+% \end{tabular}
+% \end{table}
+%
+% 然而自动配置的字体只能保证编译通过,但是还存在一些问题:
+% \begin{enumerate}
+% \item 在其他平台上配置的 TeX Gyre 系列字体,虽然在风格上比较接近 Times 和 Arial,
+% 但是毕竟跟部分课程要求的字体不完全一致;
+% \item 华文字库虽然不违反一般的写作要求,
+% 但是其字形跟中易字库有所差别,可能被批改老师认为格式不符合要求。
+% \end{enumerate}
+%
+% 所以建议在提交最终版前使用 Windows 平台的字体进行编译。
+%
+% 用户也可以在调用 hitreport 时手动指定使用的字库,如:
+%
+% \begin{latex}
+% \documentclass[fontset=windows]{hitreport}
+% \end{latex}
+%
+% 允许的选项有 \option{windows}、\option{mac},详
+% 见 \pkg{ctex}、\pkg{xeCJK}、\pkg{fontspec} 等宏包的使用说明。
+%
+%
+% \subsection{论文设置}
+% 论文的设置可以通过统一命令 \cs{hitsetup} 设置 \emph{key=value} 形式完成。
+%
+% \DescribeMacro{\hitsetup}
+% \cs{hitsetup} 用法与常见 \emph{key=value} 命令相同,如下:
+% \begin{latex}
+% \hitsetup{
+% key1 = value1,
+% key2 = {a value, with comma},
+% }
+% % 可以多次调用
+% \hitsetup{
+% key3 = value3,
+% key1 = value11, % 覆盖 value1
+% }
+% \end{latex}
+%
+% \note[注意:]{\cs{hitsetup} 使用 \pkg{kvsetkeys} 机制,所以配置项之间不能有空行,否则
+% 会报错。}
+%
+%
+%
+% \subsection{封面信息}
+%
+% \label{sec:titlepage}
+% 封面信息可以通过统一设置命令 \cs{hitsetup} 设置 \emph{key=value} 形式完成;
+%
+% \subsubsection{报告校区}
+% 选择不同校区的校名。备选为harbin、shenzhen、weihai。
+% \begin{latex}
+% \hitsetup{
+% campus = {harbin},
+% }
+% \end{latex}
+%
+%
+% \subsubsection{报告主标题}
+% 中文标题。可以在标题内部使用换行|\\|。
+% \begin{latex}
+% \hitsetup{
+% title = {报告主标题},
+% }
+% \end{latex}
+%
+% \subsubsection{报告副标题}
+% 中文标题。可以在标题内部使用换行|\\|。
+% \begin{latex}
+% \hitsetup{
+% expand = {报告副标题},
+% }
+% \end{latex}
+%
+% \subsubsection{院系名称}
+% 院系名称。
+% \begin{latex}
+% \hitsetup{
+% department = {系名全称},
+% }
+% \end{latex}
+%
+% \subsubsection{专业名称}
+%
+% \begin{latex}
+% \hitsetup{
+% discipline = {专业名称},
+% }
+% \end{latex}
+%
+% \subsubsection{作者姓名}
+% 作者姓名。
+% \begin{latex}
+% \hitsetup{
+% author = {中文姓名},
+% }
+% \end{latex}
+%
+% \subsubsection{学号}
+% 学号。
+% \begin{latex}
+% \hitsetup{
+% student-id = {1180310840},
+% }
+% \end{latex}
+%
+% \subsubsection{指导教师}
+% 指导教师。
+% \begin{latex}
+% \hitsetup{
+% supervisor = {指导教师},
+% }
+% \end{latex}
+%
+% \subsubsection{实验地点}
+% 直接中文书写实验地点。
+% \begin{latex}
+% \hitsetup{
+% lablocation = {格物207},
+% }
+% \end{latex}
+%
+% \subsubsection{学期}
+% 课程学期,直接书写中文即可。
+% \begin{latex}
+% \hitsetup{
+% term = {2021春季学期},
+% }
+% \end{latex}
+%
+% \subsubsection{成文日期}
+% 默认为当前日期,也可以自己指定,要求使用 ISO 格式。
+% \begin{latex}
+% \hitsetup{
+% date = {2021-03-01},
+% }
+% \end{latex}
+%
+%
+% \myentry{生成封面}
+% \DescribeMacro{\maketitle}
+% 生成封面。
+% \begin{latex}
+% % 直接生成封面
+% \maketitle
+% \end{latex}
+%
+% \subsection{正文部分}
+% \subsubsection{数学符号}
+% \label{sec:math}
+% 报告的数学符号默认遵循 GB/T 3102.11—1993《物理科学和技术中使用的数学符号》。
+% 该标准参照采纳 ISO 31-11:1992,
+% 但是与 \TeX{} 默认的英美国家的符号习惯有许多差异,主要有:
+% \newcommand\dif{\mathop{}\!\mathrm{d}}
+% \begin{enumerate}
+% \item 大写希腊字母默认为斜体,
+% 有限增量符号 固定使用正体。
+% \item 数学常数和特殊函数名用正体。
+% \item 微分号使用正体。
+% \item 向量、矩阵和张量用粗斜体。
+% \item 省略号按照中文的习惯固定居中。
+% \end{enumerate}
+%
+% \DescribeOption{math-style}
+% 英文论文的数学符号默认使用 \TeX{} 样式。
+% 如果有必要,也可以通过设置 \option{math-style} 选择数学符号样式,
+% 可选:\option{GB}(中文默认),\option{TeX}(英文默认),\option{ISO}。
+% \begin{latex}
+% \hitsetup{
+% math-style = ISO,
+% }
+% \end{latex}
+%
+% 模板使用
+% \href{http://mirrors.ctan.org/macros/latex/contrib/unicode-math/unicode-math.pdf}{\pkg{unicode-math}}
+% 配置数学符号的字体。
+% 全部数学符号的命令参考
+% \href{http://mirrors.ctan.org/macros/latex/contrib/unicode-math/unimath-symbols.pdf}{\pkg{unimath-symbols}}。
+% 注意,\pkg{unicode-math} 宏包与 \pkg{amsfonts}、\pkg{amssymb}、\pkg{bm}、
+% \pkg{mathrsfs}、\pkg{upgreek} 等宏包\emph{不}兼容。
+% 模板作了处理,用户可以直接使用这些宏包的命令,如 \cs{bm}、\cs{mathscr}、
+% \cs{uppi}。
+%
+%
+% \subsubsection{定理环境}
+% \label{sec:theorem}
+% \hitreport 定义了常用的数学环境:
+%
+% \begin{center}
+% \begin{tabular}{*{7}{l}}\toprule
+% axiom & theorem & definition & proposition & lemma & conjecture &\\
+% 公理 & 定理 & 定义 & 命题 & 引理 & 猜想 &\\\midrule
+% proof & corollary & example & assumption & remark & problem & solution\\
+% 证明 & 推论 & 例子 & 假设 & 注释 & 问题 & 解\\\bottomrule
+% \end{tabular}
+% \end{center}
+%
+% 比如:
+% \begin{latex}
+% \begin{definition}
+% 道千乘之国,敬事而信,节用而爱人,使民以时。
+% \end{definition}
+% \end{latex}
+% 产生(自动编号):
+% \medskip
+%
+% \noindent\framebox[\linewidth][l]{{\heiti 定义~1.1~~~} % {道千乘之国,敬事而信,节用而爱人,使民以时。}}
+%
+% \smallskip
+% 列举出来的数学环境毕竟是有限的,如果想用\emph{胡说}这样的数学环境,那么可以定义:
+% \begin{latex}
+% \newtheorem{nonsense}{胡说}[chapter]
+% \end{latex}
+%
+% 然后这样使用:
+% \begin{latex}
+% \begin{nonsense}
+% 契丹武士要来中原夺武林秘笈。—— 慕容博
+% \end{nonsense}
+% \end{latex}
+%
+% 产生(自动编号):
+%
+% \medskip
+% \noindent\framebox[\linewidth][l]{{\heiti 胡说~1.1~~~} % {契丹武士要来中原夺武林秘笈。—— 慕容博}}
+%
+% \subsection{其他部分}
+% \subsubsection{参考文献}
+% \label{sec:bibliography}
+%
+% 参考文献通常可以使用 \hologo{BibTeX} 或 biblatex 生成。
+% \hologo{BibTeX} 是 LaTeX 处理参考文献的传统的方式,
+% 需要在使用 \cs{bibliographystyle}\marg{style} 选择样式
+% 并用 \cs{bibliography} 设置 \file{.bib} 的路径。
+% 然后使用 \texttt{bibtex} 对 \file{.aux} 文件进行编译得到 \file{.bbl} 文件。
+% 其中的参考文献表内容会在后续编译时替换到 \cs{bibliography} 的位置。
+% Biblatex 是较新的方式,需要在载入宏包时通过 \option{style} 选择样式,
+% 在导言区使用 \cs{addbibresource} 声明数据库的路径,
+% 并在输出参考文献表的位置使用 \cs{printbibliography} 命令,
+% 而且编译参考文献的命令需要换为 biber。
+% 这两种方式各有优缺点,比如 BibTeX 无法对中文按照拼音排序,一些样式更新不够及时;
+% Biblatex 运行较缓慢,无法对多个参考文献表使用不同样式。
+% 用户需要根据实际选择合适的方式。
+%
+% 由于报告基本不做参考文献的格式要求,此处的制作较为宽泛,采用 APA 格式,
+% APA 的 BibTeX 样式由 \pkg{apacite} 宏包提供,需要在导言区调用:
+% \begin{latex}
+% \usepackage[natbibapa]{apacite}
+% \bibliographystyle{apacite}
+% \end{latex}
+% 其中 \option{natbibapa} 会调用 \pkg{natbib} 来处理引用,
+% 这也是宏包推荐的用法。
+% 注意目前的 \pkg{apacite} 只支持到 APA 第 6 版。
+% 更推荐使用已经更新到 APA 第 7 版的 \pkg{biblatex-apa}:
+% \begin{latex}
+% \usepackage[style=apa]{biblatex}
+% \addbibresource{refs-apa.bib}
+% \end{latex}
+% 注意,如果参考文献中引用了中文文献的话,这两种方法都不能正确调整格式,
+% 需要手动进行修改 \file{.bbl} 文件的内容,
+% 这时 BibTeX 比 biblatex 更简单些。
+%
+%
+%
+% \subsubsection{附录}
+%
+% 附录由 \cs{appendix} 命令开启,然后像正文一样书写。部分实验报告要求附录
+% 引用代码,可以使用相对路径引用。
+% \begin{latex}
+% \appendix
+% \chapter{...}
+% ...
+% \end{latex}
+%
+%
+% \section{致谢}
+% 报告一般不需要添加致谢的章节,故本模板不做相应的制作。
+% 感谢以下宏包的作者,本宏包从中使用了部分代码和借鉴:
+% \begin{itemize}
+% \item 清华大学\thuthesis \quad https://github.com/tuna/thuthesis
+% \item 哈尔滨工业大学 \hithesis \quad https://github.com/dustincys/hithesis
+% \end{itemize}
+%
+% \StopEventually{\PrintIndex}
+% \clearpage
+%
+% \section{实现细节}
+% \subsection{基本信息}
+% \begin{macrocode}
+%<cls>\NeedsTeXFormat{LaTeX2e}[2017/04/15]
+%<cls>\ProvidesClass{hitreport}
+%<cls>[2020/12/31 v1.1 Standard LaTeX Template for hitreport]
+% \end{macrocode}
+%
+% 报错
+% \begin{macrocode}
+\newcommand\hit@error[1]{%
+ \ClassError{hitreport}{#1}{}%
+}
+\newcommand\hit@warning[1]{%
+ \ClassWarning{hitreport}{#1}%
+}
+\newcommand\hit@patch@error[1]{%
+ \hit@error{Failed to patch command \protect#1}%
+}
+\newcommand\hit@deprecate[2]{%
+ \def\hit@@tmp{#2}%
+ \hit@warning{%
+ The #1 is deprecated%
+ \ifx\hit@@tmp\@empty\else
+ . Use #2 instead%
+ \fi
+ }%
+}
+% \end{macrocode}
+%
+% 检查 \LaTeXe{} kernel 版本
+% \begin{macrocode}
+\@ifl@t@r\fmtversion{2017/04/15}{}{
+ \hit@error{%
+ TeX Live 2017 or later version is required to compile this document%
+ }
+}
+% \end{macrocode}
+%
+% 检查编译引擎,要求使用 \XeLaTeX。
+% \begin{macrocode}
+\RequirePackage{ifxetex}
+\RequireXeTeX
+\ifxetex\else
+\ClassError{hitreport}{You must use the `xelatex' driver\MessageBreak
+Please choose `xelatex'}{Just choose `xelatex', no `pdflatex' or `latex' and so on.}
+\fi
+% \end{macrocode}
+%
+% \subsection{定义选项}
+% \label{sec:defoption}
+% 初始化信息
+% \begin{macrocode}
+%<*cls>
+\RequirePackage{kvdefinekeys}
+\RequirePackage{kvsetkeys}
+\RequirePackage{kvoptions}
+\SetupKeyvalOptions{
+ family=hit,
+ prefix=hit@,
+ setkeys=\kvsetkeys}
+% \end{macrocode}
+%
+% \begin{macro}{\hitsetup}
+% 提供一个 \cs{hitsetup} 命令支持 \emph{key-value} 的方式来设置。
+% \begin{macrocode}
+\newcommand\hitsetup[1]{%
+ \kvsetkeys{hit}{#1}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% 同时用 \emph{key-value} 的方式来定义这些接口:
+% \begin{latex}
+% \hit@define@key{
+% <key> = {
+% name = <name>,
+% choices = {
+% <choice1>,
+% <choice2>,
+% },
+% default = <default>,
+% },
+% }
+% \end{latex}
+%
+% 其中 |choices| 设置允许使用的值,默认为第一个(或者 \meta{default});
+% \meta{code} 是相应的内容被设置时执行的代码。
+%
+% \begin{macrocode}
+\newcommand\hit@define@key[1]{%
+ \kvsetkeys{hit@key}{#1}%
+}
+\kv@set@family@handler{hit@key}{%
+% \end{macrocode}
+%
+% \cs{hitsetup} 会将 \meta{value} 存到 \cs{hit@\meta{key}},
+% 但是宏的名字包含 “-” 这样的特殊字符时不方便直接调用,比如 |key = math-style|,
+% 这时可以用 |name| 设置 \meta{key} 的别称,比如 |key = math@style|,
+% 这样就可以通过 \cs{hit@math@style} 来引用。
+% |default| 是定义该 \meta{key} 时默认的值,缺省为空。
+%
+% \begin{macrocode}
+ \@namedef{hit@#1@@name}{#1}%
+ \def\hit@@default{}%
+ \def\hit@@choices{}%
+ \kv@define@key{hit@value}{name}{%
+ \@namedef{hit@#1@@name}{##1}%
+ }%
+% \end{macrocode}
+%
+% 由于在定义接口时,\cs{hit@\meta{key}@@code} 不一定有定义,
+% 而且在文档类/宏包中还有可能对该 |key| 的 |code| 进行添加。
+% 所以 \cs{hit@\meta{key}@@code} 会检查如果在定义文档类/宏包时则推迟执行,否则立即执行。
+%
+% \begin{macrocode}
+ \@namedef{hit@#1@@check}{}%
+ \@namedef{hit@#1@@code}{}%
+% \end{macrocode}
+%
+% 保存下 |choices = {}| 定义的内容,在定义 \cs{hit@\meta{name}} 后再执行。
+%
+% \begin{macrocode}
+ \kv@define@key{hit@value}{choices}{%
+ \def\hit@@choices{##1}%
+ \@namedef{hit@#1@@reset}{}%
+% \end{macrocode}
+%
+% \cs{hit@\meta{key}@check} 检查 |value| 是否有效,
+% 并设置 \cs{ifhit@\meta{name}@\meta{value}}。
+%
+% \begin{macrocode}
+ \@namedef{hit@#1@@check}{%
+ \@ifundefined{%
+ ifhit@\@nameuse{hit@#1@@name}@\@nameuse{hit@\@nameuse{hit@#1@@name}}%
+ }{%
+ \hit@error{Invalid value "#1 = \@nameuse{hit@\@nameuse{hit@#1@@name}}"}%
+ }%
+ \@nameuse{hit@#1@@reset}%
+ \@nameuse{hit@\@nameuse{hit@#1@@name}@\@nameuse{hit@\@nameuse{hit@#1@@name}}true}%
+ }%
+ }%
+ \kv@define@key{hit@value}{default}{%
+ \def\hit@@default{##1}%
+ }%
+ \kvsetkeys{hit@value}{#2}%
+ \@namedef{hit@\@nameuse{hit@#1@@name}}{}%
+% \end{macrocode}
+%
+% 第一个 \meta{choice} 设为 \meta{default},
+% 并且对每个 \meta{choice} 定义 \cs{ifhit@\meta{name}@\meta{choice}}。
+%
+% \begin{macrocode}
+ \kv@set@family@handler{hit@choice}{%
+ \ifx\hit@@default\@empty
+ \def\hit@@default{##1}%
+ \fi
+ \expandafter\newif\csname ifhit@\@nameuse{hit@#1@@name}@##1\endcsname
+ \expandafter\g@addto@macro\csname hit@#1@@reset\endcsname{%
+ \@nameuse{hit@\@nameuse{hit@#1@@name}@##1false}%
+ }%
+ }%
+ \kvsetkeys@expandafter{hit@choice}{\hit@@choices}%
+% \end{macrocode}
+%
+% 将 \meta{default} 赋值到 \cs{hit@\meta{name}},如果非空则执行相应的代码。
+%
+% \begin{macrocode}
+ \expandafter\let\csname hit@\@nameuse{hit@#1@@name}\endcsname\hit@@default
+ \expandafter\ifx\csname hit@\@nameuse{hit@#1@@name}\endcsname\@empty\else
+ \@nameuse{hit@#1@@check}%
+ \fi
+% \end{macrocode}
+%
+% 定义 \cs{hitsetup} 接口。
+%
+% \begin{macrocode}
+ \kv@define@key{hit}{#1}{%
+ \@namedef{hit@\@nameuse{hit@#1@@name}}{##1}%
+ \@nameuse{hit@#1@@check}%
+ \@nameuse{hit@#1@@code}%
+ }%
+}
+% \end{macrocode}
+%
+% 定义接口向 |key| 添加 |code|:
+%
+% \begin{macrocode}
+\newcommand\hit@option@hook[2]{%
+ \expandafter\g@addto@macro\csname hit@#1@@code\endcsname{#2}%
+}
+% \end{macrocode}
+% 报告撰写的校区
+% \begin{macrocode}
+\hit@define@key{
+ campus = {
+ name = campus,
+ choices = {
+ harbin,
+ shenzhen,
+ weihai,
+ },
+ },
+% \end{macrocode}
+%
+% 字体
+% \begin{macrocode}
+ fontset = {
+ choices = {
+ windows,
+ mac,
+ ubuntu,
+ fandol,
+ none,
+ },
+ default = none,
+ },
+ system = {
+ choices = {
+ mac,
+ unix,
+ windows,
+ auto,
+ },
+ default = auto,
+ },
+ font = {
+ choices = {
+ times,
+ termes,
+ xits,
+ libertinus,
+ lm,
+ auto,
+ none,
+ },
+ default = auto,
+ },
+ cjk-font = {
+ name = cjk@font,
+ choices = {
+ windows,
+ mac,
+ noto,
+ fandol,
+ auto,
+ none,
+ },
+ default = auto,
+ },
+ math-font = {
+ name = math@font,
+ choices = {
+ xits,
+ stix,
+ libertinus,
+ lm,
+ none,
+ },
+ default = xits,
+ },
+ math-style = {
+ name = math@style,
+ choices = {
+ GB,
+ ISO,
+ TeX,
+ },
+ default = GB,
+ },
+}
+% \end{macrocode}
+%
+%
+% 定义关键字
+% \begin{macrocode}
+\newcommand\hit@tokens@keywords{}
+\ProcessOptions\relax
+% \end{macrocode}
+%
+%
+%
+% \subsection{装载宏包}
+% \label{sec:loadpackage}
+%
+% 设置默认 \option{openany}。
+% \begin{macrocode}
+\DeclareBoolOption[false]{openright}
+\DeclareComplementaryOption{openany}{openright}
+% \end{macrocode}
+%
+% \option{raggedbottom} 选项(默认打开)
+% \begin{macrocode}
+\DeclareBoolOption[true]{raggedbottom}
+% \end{macrocode}
+% 将选项传递给 \pkg{ctexbook}。
+% \begin{macrocode}
+\DeclareDefaultOption{\PassOptionsToClass{\CurrentOption}{ctexbook}}
+% \end{macrocode}
+%
+% 解析用户传递过来的选项,并加载 \pkg{ctexbook}。
+% \begin{macrocode}
+\ProcessKeyvalOptions*
+% \end{macrocode}
+%
+% 设置默认 \option{openany}。
+% \begin{macrocode}
+\ifhit@openright
+ \PassOptionsToClass{openright}{book}
+\else
+ \PassOptionsToClass{openany}{book}
+\fi
+% \end{macrocode}
+%
+% 使用 \pkg{ctexbook} 宏包,优于调用 \pkg{ctex} 宏包
+% \begin{macrocode}
+\PassOptionsToPackage{quiet}{fontspec}
+\LoadClass[a4paper,UTF8,zihao=-4,scheme=plain,fontset=none]{ctexbook}[2017/04/01]
+% \end{macrocode}
+%
+% 引用宏包和相关定义
+% \begin{macrocode}
+\RequirePackage{etoolbox}
+\RequirePackage{filehook}
+\RequirePackage{xparse}
+% \end{macrocode}
+%
+% 设置页面布局
+% \begin{macrocode}
+\RequirePackage{geometry}
+\geometry{
+ paper = a4paper, % 210 * 297mm
+ marginparwidth = 2cm,
+ marginparsep = 0.5cm,
+}
+\newcommand\hit@set@geometry{%
+ \geometry{
+ margin = 3cm,
+ headheight = 0.5cm,
+ headsep = 0.3cm,
+ footskip = 0.8cm,
+ }%
+}
+\hit@set@geometry
+% \end{macrocode}
+%
+% 利用 \pkg{fancyhdr} 设置页眉页脚。
+% \begin{macrocode}
+\RequirePackage{fancyhdr}
+% \end{macrocode}
+%
+% 设置目录
+% \begin{macrocode}
+\RequirePackage{titletoc}
+% \end{macrocode}
+%
+% 利用 \pkg{notoccite} 避免目录中引用编号混乱。
+% \begin{macrocode}
+\RequirePackage{notoccite}
+% \end{macrocode}
+%
+%
+% 数学宏包,\AmSTeX\ 宏包,用来排公式。
+% \begin{macrocode}
+\RequirePackage{amsmath}
+% \end{macrocode}
+%
+% 使用 \pkg{unicode-math} 处理数学字体。
+% \begin{macrocode}
+\RequirePackage{unicode-math}
+% \end{macrocode}
+%
+% 支持tikz画图
+% \begin{macrocode}
+\RequirePackage{tikz}
+% \end{macrocode}
+%
+% \pkg{pdfpages} 宏包便于插入 PDF 文档。
+% \begin{macrocode}
+\RequirePackage{pdfpages}
+\includepdfset{fitpaper=true}
+% \end{macrocode}
+%
+% 设置颜色
+% \begin{macrocode}
+\RequirePackage{xcolor}
+% \end{macrocode}
+%
+% 支持插入图片
+% \begin{macrocode}
+\RequirePackage{graphicx}
+% \end{macrocode}
+%
+% 并排图形。\pkg{subfigure}、\pkg{subfig} 已经不再推荐,用新的 \pkg{subcaption}。
+% 浮动图形和表格标题样式。\pkg{caption2} 已经不推荐使用,采用新的 \pkg{caption}。
+% \begin{macrocode}
+\RequirePackage[labelformat=simple]{subcaption}
+% \end{macrocode}
+%
+% 支持文章内部引用
+% \begin{macrocode}
+\RequirePackage{hyperref}
+% \end{macrocode}
+%
+% 支持添加表格
+% \begin{macrocode}
+\RequirePackage{array}
+% \end{macrocode}
+%
+% 支持表格跨页显示,booktabs 提供了 \cs{toprule} 等命令.
+% \begin{macrocode}
+\RequirePackage{longtable}
+\RequirePackage{booktabs}
+% \end{macrocode}
+%
+% multirow 支持在表格中跨行
+% \begin{macrocode}
+\RequirePackage{multirow}
+% \end{macrocode}
+%
+% 支持表格过长跨页显示
+% \begin{macrocode}
+\RequirePackage{threeparttable}
+% \end{macrocode}
+%
+% 调整间隔, 让表格更好看些
+% \begin{macrocode}
+\RequirePackage{bigstrut}
+% \end{macrocode}
+%
+% 在跨行表格中输入定界符
+% \begin{macrocode}
+\RequirePackage{bigdelim}
+% \end{macrocode}
+%
+% 设置代码环境
+% \begin{macrocode}
+\RequirePackage{listings}
+% \end{macrocode}
+%
+% 支持代码根据语言类型高亮
+% \begin{macrocode}
+\RequirePackage{xcolor}
+% \end{macrocode}
+%
+% 支持url引用
+% \begin{macrocode}
+\RequirePackage{url}
+% \end{macrocode}
+%
+%
+% \subsubsection{\pkg{algorithm} 宏包}
+%
+% 使 \env{algorithm} 和 \env{listing} 环境的名称随语言设置而改变,
+% 并使其在附录中的编号规则与图、表等一致。
+%
+% \begin{macro}{\listofalgorithm}
+% \begin{macro}{\listofalgorithm*}
+% \begin{macrocode}
+\PassOptionsToPackage{chapter}{algorithm}
+\AtEndOfPackageFile*{algorithm}{
+ \floatname{algorithm}{\thu@algorithm@name}
+ \renewcommand\listofalgorithms{%
+ \hit@listof{algorithm}%
+ }
+ \renewcommand\listalgorithmname{\hit@list@algorithm@name}
+ \def\ext@algorithm{loa}
+ \contentsuse{algorithm}{loa}
+ \titlecontents{algorithm}
+ [\z@]{}
+ {\contentspush{\fname@algorithm~\thecontentslabel\quad}}{}
+ {\hit@leaders\thecontentspage}
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+%
+% \subsubsection{\pkg{algorithm2e} 宏包}
+%
+% \begin{macrocode}
+\PassOptionsToPackage{algochapter}{algorithm2e}
+\AtEndOfPackageFile*{algorithm2e}{
+ \renewcommand\algorithmcfname{\hit@algorithm@name}
+ \SetAlgoCaptionLayout{thu@caption@font}
+ \SetAlCapSty{relax}
+ \SetAlgoCaptionSeparator{\hspace*{1em}}
+ \SetAlFnt{\fontsize{11bp}{14.3bp}\selectfont}
+ \renewcommand\listofalgorithms{%
+ \hit@listof{algorithmcf}%
+ }
+ \renewcommand\listalgorithmcfname{\hit@list@algorithm@name}
+ \def\ext@algorithmcf{loa}
+ \contentsuse{algocf}{loa}
+ \titlecontents{algocf}
+ [\z@]{}
+ {\contentspush{\algorithmcfname~\thecontentslabel\quad}}{}
+ {\hit@leaders\thecontentspage}
+}
+% \end{macrocode}
+%
+% \subsubsection{\pkg{minted} 宏包}
+%
+% \begin{macrocode}
+\AtEndOfPackageFile*{minted}{
+ \newcommand\hit@set@listing@language{%
+ \floatname{listing}{代码}%
+ }
+ \hit@set@listing@language
+}
+% \end{macrocode}
+%
+%
+%
+% 如果用户在导言区未调用 \pkg{biblatex},则自动调用 \pkg{natbib}。
+% \begin{macrocode}
+\AtEndPreamble{
+ \@ifpackageloaded{biblatex}{}{
+ \@ifpackageloaded{apacite}{}{
+ \RequirePackage{natbib}
+ }
+ }
+}
+\AtEndOfPackageFile*{natbib}{
+ \@ifpackageloaded{apacite}{}{
+ \RequirePackage{bibunits}
+ }
+}
+% \end{macrocode}
+%
+% 对冲突的宏包报错。
+% \begin{macrocode}
+\newcommand\hit@package@conflict[2]{
+ \AtBeginOfPackageFile*{#2}{
+ \hit@error{The "#2" package is incompatible with required "#1"}
+ }
+}
+\hit@package@conflict{unicode-math}{amscd}
+\hit@package@conflict{unicode-math}{amsfonts}
+\hit@package@conflict{unicode-math}{amssymb}
+\hit@package@conflict{unicode-math}{bbm}
+\hit@package@conflict{unicode-math}{bm}
+\hit@package@conflict{unicode-math}{eucal}
+\hit@package@conflict{unicode-math}{eufrak}
+\hit@package@conflict{unicode-math}{mathrsfs}
+% \end{macrocode}
+%
+% 支持文中引用
+% \begin{macrocode}
+\RequirePackage{cite}
+% \end{macrocode}
+%
+% 插入代码,进行设置
+% \begin{macrocode}
+\RequirePackage{listings}
+\lstset{
+ numbers=left, %设置行号位置
+ numberstyle=\tiny, %设置行号大小
+ keywordstyle=\color{blue}, %设置关键字颜色
+ commentstyle=\color[cmyk]{1,0,1,0}, %设置注释颜色
+ frame=single, %设置边框格式
+ escapeinside=``, %逃逸字符(1左面的键),用于显示中文
+ breaklines, %自动折行
+ extendedchars=false, %解决代码跨页时,章节标题,页眉等汉字不显示的问题
+ xleftmargin=2em,
+ xrightmargin=2em,
+ aboveskip=1em, %设置边距
+ tabsize=4, %设置tab空格数
+ showspaces=false, %不显示空格
+ belowskip=3mm,
+ showstringspaces=false,columns=flexible,
+ framerule=1pt,
+ rulecolor=\color{gray!35},
+ backgroundcolor=\color{gray!5},
+ basicstyle={\small\ttfamily},
+ stringstyle=\color{mauve},
+ breakatwhitespace=true
+}
+% \end{macrocode}
+%
+% 重定义颜色
+% \begin{macrocode}
+\definecolor{dkgreen}{rgb}{0,0.6,0}
+\definecolor{gray}{rgb}{0.5,0.5,0.5}
+\definecolor{mauve}{rgb}{0.58,0,0.82}
+% \end{macrocode}
+% 定义首行缩进
+% \begin{macrocode}
+\RequirePackage{indentfirst}
+% \end{macrocode}
+% 设置浮动体标题
+% \begin{macrocode}
+\RequirePackage{caption}
+% \end{macrocode}
+% 设置列表环境
+% \begin{macrocode}
+\RequirePackage[shortlabels]{enumitem}
+\RequirePackage{environ}
+% \end{macrocode}
+%
+% 禁止 \LaTeX{} 自动调整多余的页面底部空白,并保持脚注仍然在底部。
+% 脚注按页编号。
+% \begin{macrocode}
+\ifhit@raggedbottom
+ \RequirePackage[bottom,perpage,hang]{footmisc}
+ \raggedbottom
+\else
+ \RequirePackage[perpage,hang]{footmisc}
+\fi
+% \end{macrocode}
+%
+% 利用 \pkg{xeCJKfntef} 实现汉字的下划线和盒子内两段对齐,并可以避免
+% \cs{makebox}\oarg{width}\oarg{s} 可能产生的 underful boxes。
+% \begin{macrocode}
+\RequirePackage{xeCJKfntef}
+\RequirePackage{soul}
+% \end{macrocode}
+%
+% 下划线
+% \begin{macrocode}
+\RequirePackage{ulem}
+%
+% \end{macrocode}
+% 尺寸计算
+% \begin{macrocode}
+\RequirePackage{calc}
+% \end{macrocode}
+% 支持插入附录
+% \begin{macrocode}
+\RequirePackage[titletoc,title]{appendix}
+\AtBeginEnvironment{thebibliography}{%
+ \phantomsection
+ \addcontentsline{toc}{section}{\refname}
+ }
+% \end{macrocode}
+%
+% 修改tabular 环境, 设置表格中的行间距为正文行间距.
+% \begin{macrocode}
+\let\hitreport@oldtabular\tabular
+\let\hitreport@endoldtabular\endtabular
+\renewenvironment{tabular}%
+ {\bgroup%
+ \renewcommand{\arraystretch}{1.2}%
+ \hitreport@oldtabular}%
+ {\hitreport@endoldtabular\egroup}
+% \end{macrocode}
+% 段首缩进两个汉字
+% \begin{macrocode}
+\setlength\parindent{2em}
+% \end{macrocode}
+%
+% \subsection{主文档格式}
+% \label{sec:mainbody}
+%
+% \subsubsection{Three matters}
+% \begin{macro}{\cleardoublepage}
+% 对于 \textsl{openright} 选项,必须保证章首页右开,且如果前章末页无内容须
+% 清空其页眉页脚。
+% \begin{macrocode}
+\def\cleardoublepage{%
+ \clearpage
+ \if@twoside
+ \ifodd\c@page
+ \fi
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\frontmatter}
+% \begin{macro}{\mainmatter}
+% \begin{macro}{\backmatter}
+% 我们的单面和双面模式与常规的不太一样。
+% \begin{macrocode}
+\renewcommand\frontmatter{%
+ \cleardoublepage
+ \@mainmatterfalse
+ \pagenumbering{Roman}%
+}
+\renewcommand\mainmatter{%
+ \cleardoublepage
+ \@mainmattertrue
+ \pagenumbering{arabic}%
+}
+\renewcommand\backmatter{%
+ \if@openright
+ \cleardoublepage
+ \else
+ \clearpage
+ \fi
+ \@mainmatterfalse
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+%
+% \subsubsection{字体}
+% \label{sec:font}
+% 使用 \pkg{fontspec} 配置字体。
+% \begin{macrocode}
+\ifhit@fontset@mac
+ \hitsetup{
+ font = times,
+ cjk-font = mac,
+ }
+\else
+ \ifhit@fontset@windows
+ \hitsetup{
+ font = times,
+ cjk-font = windows,
+ }
+ \else
+ \ifhit@fontset@fandol
+ \hitsetup{
+ font = termes,
+ cjk-font = fandol,
+ }
+ \else
+ \ifhit@fontset@ubuntu
+ \hitsetup{
+ font = termes,
+ cjk-font = noto,
+ }
+ \fi
+ \fi
+ \fi
+\fi
+% \end{macrocode}
+%
+% 检测系统
+% \begin{macrocode}
+\ifhit@system@auto
+ \IfFileExists{/System/Library/Fonts/Menlo.ttc}{
+ \hitsetup{system = mac}
+ }{
+ \IfFileExists{/dev/null}{
+ \IfFileExists{null:}{
+ \hitsetup{system = windows}
+ }{
+ \hitsetup{system = unix}
+ }
+ }{
+ \hitsetup{system = windows}
+ }
+ }
+\fi
+% \end{macrocode}
+%
+% XITS 字体于 2018-10-03 更改了字体的文件名,所以需要判断。
+% 原文件名为 \file{xits-regular.otf}、\file{xits-math.otf} 等,
+% 后改为 \file{XITS-Regular.otf}、\file{XITSMath-Regular.otf} 等。
+%
+% Libertinus 字体同样。
+% \begin{macrocode}
+\let\hit@font@family@xits\@empty
+\newcommand\hit@set@xits@names{%
+ \ifx\hit@font@family@xits\@empty
+ \IfFontExistsTF{XITSMath-Regular.otf}{%
+ \gdef\hit@font@family@xits{XITS}%
+ \gdef\hit@font@style@xits@rm{Regular}%
+ \gdef\hit@font@style@xits@bf{Bold}%
+ \gdef\hit@font@style@xits@it{Italic}%
+ \gdef\hit@font@style@xits@bfit{BoldItalic}%
+ \gdef\hit@font@name@xits@math@rm{XITSMath-Regular}%
+ \gdef\hit@font@name@xits@math@bf{XITSMath-Bold}%
+ }{%
+ \gdef\hit@font@family@xits{xits}%
+ \gdef\hit@font@style@xits@rm{regular}%
+ \gdef\hit@font@style@xits@bf{bold}%
+ \gdef\hit@font@style@xits@it{italic}%
+ \gdef\hit@font@style@xits@bfit{bolditalic}%
+ \gdef\hit@font@name@xits@math@rm{xits-math}%
+ \gdef\hit@font@name@xits@math@bf{xits-mathbold}%
+ }%
+ \fi
+}
+\let\hit@font@family@libertinus\@empty
+\newcommand\hit@set@libertinus@names{%
+ \ifx\hit@font@family@libertinus\@empty
+ \IfFontExistsTF{LibertinusSerif-Regular.otf}{%
+ \gdef\hit@font@family@libertinus@serif{LibertinusSerif}%
+ \gdef\hit@font@family@libertinus@sans{LibertinusSans}%
+ \gdef\hit@font@name@libertinus@math{LibertinusMath-Regular}%
+ \gdef\hit@font@style@libertinus@rm{Regular}%
+ \gdef\hit@font@style@libertinus@bf{Bold}%
+ \gdef\hit@font@style@libertinus@it{Italic}%
+ \gdef\hit@font@style@libertinus@bfit{BoldItalic}%
+ }{%
+ \gdef\hit@font@family@libertinus@serif{libertinusserif}%
+ \gdef\hit@font@family@libertinus@sans{libertinussans}%
+ \gdef\hit@font@name@libertinus@math{libertinusmath-regular}%
+ \gdef\hit@font@style@libertinus@rm{regular}%
+ \gdef\hit@font@style@libertinus@bf{bold}%
+ \gdef\hit@font@style@libertinus@it{italic}%
+ \gdef\hit@font@style@libertinus@bfit{bolditalic}%
+ }%
+ \fi
+}
+% \end{macrocode}
+%
+% 一般的报告要求西文字体使用 Times New Roman 和 Arial,
+% 但是在 Linux 下没有这两个字体,所以使用它们的克隆版 TeX Gyre Termes 和
+% TeX Gyre Heros。
+% \begin{macrocode}
+\ifhit@font@auto
+ \ifhit@system@unix
+ \hitsetup{font=termes}
+ \else
+ \hitsetup{font=times}
+ \fi
+\fi
+\newcommand\hit@load@font@times{%
+ \setmainfont{Times New Roman}%
+ \setsansfont{Arial}%
+ \ifhit@system@mac
+ \setmonofont{Menlo}[Scale = MatchLowercase]%
+ \else
+ \setmonofont{Courier New}[Scale = MatchLowercase]%
+ \fi
+}
+\newcommand\hit@load@font@termes{%
+ \setmainfont{texgyretermes}[
+ Extension = .otf,
+ UprightFont = *-regular,
+ BoldFont = *-bold,
+ ItalicFont = *-italic,
+ BoldItalicFont = *-bolditalic,
+ ]%
+ \hit@load@texgyre@sans@mono
+}
+\newcommand\hit@load@texgyre@sans@mono{%
+ \setsansfont{texgyreheros}[
+ Extension = .otf,
+ UprightFont = *-regular,
+ BoldFont = *-bold,
+ ItalicFont = *-italic,
+ BoldItalicFont = *-bolditalic,
+ ]%
+ \setmonofont{texgyrecursor}[
+ Extension = .otf,
+ UprightFont = *-regular,
+ BoldFont = *-bold,
+ ItalicFont = *-italic,
+ BoldItalicFont = *-bolditalic,
+ Ligatures = CommonOff,
+ ]%
+}
+\newcommand\hit@load@font@xits{%
+ \hit@set@xits@names
+ \setmainfont{\hit@font@family@xits}[
+ Extension = .otf,
+ UprightFont = *-\hit@font@style@xits@rm,
+ BoldFont = *-\hit@font@style@xits@bf,
+ ItalicFont = *-\hit@font@style@xits@it,
+ BoldItalicFont = *-\hit@font@style@xits@bfit,
+ ]%
+ \hit@load@texgyre@sans@mono
+}
+\newcommand\hit@load@font@libertinus{%
+ \hit@set@libertinus@names
+ \setmainfont{\hit@font@family@libertinus@serif}[
+ Extension = .otf,
+ UprightFont = *-\hit@font@style@libertinus@rm,
+ BoldFont = *-\hit@font@style@libertinus@bf,
+ ItalicFont = *-\hit@font@style@libertinus@it,
+ BoldItalicFont = *-\hit@font@style@libertinus@bfit,
+ ]%
+ \setsansfont{\hit@font@family@libertinus@sans}[
+ Extension = .otf,
+ UprightFont = *-\hit@font@style@libertinus@rm,
+ BoldFont = *-\hit@font@style@libertinus@bf,
+ ItalicFont = *-\hit@font@style@libertinus@it,
+ ]%
+ \setmonofont{lmmonolt10}[
+ Extension = .otf,
+ UprightFont = *-regular,
+ BoldFont = *-bold,
+ ItalicFont = *-oblique,
+ BoldItalicFont = *-boldoblique,
+ ]%
+}
+\@namedef{hit@load@font@lm}{%
+ \setmainfont{lmroman10}[
+ Extension = .otf,
+ UprightFont = *-regular,
+ BoldFont = *-bold,
+ ItalicFont = *-italic,
+ BoldItalicFont = *-bolditalic,
+ ]%
+ \setsansfont{lmsans10}[
+ Extension = .otf,
+ UprightFont = *-regular,
+ BoldFont = *-bold,
+ ItalicFont = *-oblique,
+ BoldItalicFont = *-boldoblique,
+ ]%
+ \setmonofont{lmmonolt10}[
+ Extension = .otf,
+ UprightFont = *-regular,
+ BoldFont = *-bold,
+ ItalicFont = *-oblique,
+ BoldItalicFont = *-boldoblique,
+ ]%
+}
+\newcommand\hit@load@font{%
+ \@nameuse{hit@load@font@\hit@font}%
+}
+\hit@load@font
+\hit@option@hook{font}{\hit@load@font}
+% \end{macrocode}
+%
+% 使用 \pkg{unicode-math} 配置数学符号格式。
+% \begin{macrocode}
+\newcommand\hit@stix@stylistic@set{%
+ \ifhit@math@style@TeX\else
+ 8
+ \fi
+}
+\newcommand\hit@set@math@style{%
+ \ifhit@math@style@TeX
+ \unimathsetup{
+ math-style = TeX,
+ bold-style = TeX,
+ partial = italic,
+ }%
+ \else
+ \unimathsetup{
+ math-style = ISO,
+ bold-style = ISO,
+ partial = upright,
+ }%
+ \fi
+ \ifhit@math@style@GB
+ \protected\def\le{\leqslant}%
+ \protected\def\ge{\geqslant}%
+ \DeclareRobustCommand\mathellipsis{\mathinner{\unicodecdots}}%
+ \else
+ \protected\def\le{\leq}%
+ \protected\def\ge{\geq}%
+ \DeclareRobustCommand\mathellipsis{\mathinner{\unicodeellipsis}}%
+ \fi
+}
+\hitsetup{math-style=GB}%
+\hit@set@math@style
+\hit@option@hook{math-style}{\hit@set@math@style}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\newcommand\hit@load@math@font@xits{%
+ \hit@set@xits@names
+ \setmathfont{\hit@font@name@xits@math@rm}[
+ Extension = .otf,
+ StylisticSet = \hit@stix@stylistic@set,
+ ]%
+ \setmathfont{\hit@font@name@xits@math@rm}[
+ Extension = .otf,
+ StylisticSet = 1,
+ range = {cal,bfcal},
+ ]%
+}
+\newcommand\hit@load@math@font@stix{%
+ \setmathfont{STIX2Math}[
+ Extension = .otf,
+ StylisticSet = \hit@stix@stylistic@set,
+ ]%
+ \setmathfont{STIX2Math}[
+ Extension = .otf,
+ StylisticSet = 1,
+ range = {cal,bfcal},
+ ]%
+}
+\newcommand\hit@load@math@font@libertinus{%
+ \hit@set@libertinus@names
+ \setmathfont{\hit@font@name@libertinus@math .otf}%
+}
+\newcommand\hit@load@math@font@lm{%
+ \setmathfont{latinmodern-math.otf}%
+}
+\newcommand\hit@load@math@font{%
+ \@nameuse{hit@load@math@font@\hit@math@font}
+}
+\hit@load@math@font
+\hit@option@hook{math-font}{\hit@load@math@font}
+\hit@option@hook{math-style}{\hit@load@math@font}
+% \end{macrocode}
+%
+%
+% 中文字体
+% \begin{macrocode}
+\ifhit@cjk@font@auto
+ \ifhit@system@mac
+ \hitsetup{cjk-font = mac}
+ \else
+ \ifhit@system@windows
+ \hitsetup{cjk-font = windows}
+ \else
+ \IfFontExistsTF{Noto Serif CJK SC}{
+ \hitsetup{cjk-font = noto}
+ }{
+ \hitsetup{cjk-font = fandol}
+ }
+ \fi
+ \fi
+\fi
+\newcommand\hit@load@cjk@font@windows{%
+ \xeCJKsetup{EmboldenFactor=3}%
+ \setCJKmainfont{SimSun}[
+ AutoFakeBold = true,
+ ItalicFont = KaiTi,
+ ]%
+ \setCJKsansfont{SimHei}[AutoFakeBold]%
+ \setCJKmonofont{FangSong}%
+ \setCJKfamilyfont{zhsong}{SimSun}[AutoFakeBold]%
+ \setCJKfamilyfont{zhhei}{SimHei}[AutoFakeBold]%
+ \setCJKfamilyfont{zhkai}{KaiTi}%
+ \setCJKfamilyfont{zhfs}{FangSong}%
+ \setCJKfamilyfont{hwxk}{STXingkai}%
+}
+\newcommand\hit@load@cjk@font@mac{%
+ \setCJKmainfont{Songti SC}[
+ UprightFont = * Light,
+ BoldFont = * Bold,
+ ItalicFont = Kaiti SC,
+ BoldItalicFont = Kaiti SC Bold,
+ ]%
+ \setCJKsansfont{Heiti SC}[BoldFont=* Medium]%
+ \setCJKmonofont{STFangsong}
+ \setCJKfamilyfont{zhsong}{Songti SC}[
+ UprightFont = * Light,
+ BoldFont = * Bold,
+ ]%
+ \setCJKfamilyfont{zhhei}{Heiti SC}[
+ UprightFont = * Light,
+ BoldFont = * Medium,
+ ]%
+ \setCJKfamilyfont{zhfs}{STFangsong}%
+ \setCJKfamilyfont{hwxk}{STXingkai}%
+ \setCJKfamilyfont{zhkai}{Kaiti SC}[BoldFont = * Bold]%
+ \setCJKfamilyfont{zhli}{Baoli SC}%
+ \setCJKfamilyfont{zhyuan}{Yuanyi SC}[
+ UprightFont = * Light,
+ BoldFont = * Bold,
+ ]%
+}
+% \end{macrocode}
+%
+% 注意 Noto CJK 的 regular 字重名字不带“Regular”。
+% \begin{macrocode}
+\newcommand\hit@load@cjk@font@noto{%
+ \setCJKmainfont{Noto Serif CJK SC}[
+ UprightFont = * Light,
+ BoldFont = * Bold,
+ ItalicFont = FandolKai-Regular,
+ ItalicFeatures = {Extension = .otf},
+ ]%
+ \setCJKsansfont{Noto Sans CJK SC}[
+ BoldFont = * Medium,
+ ]%
+ \setCJKmonofont{Noto Sans Mono CJK SC}%
+ \setCJKfamilyfont{zhsong}{Noto Serif CJK SC}[
+ UprightFont = * Light,
+ UprightFont = * Bold,
+ ]%
+ \setCJKfamilyfont{zhhei}{Noto Sans CJK SC}[
+ BoldFont = * Medium,
+ ]%
+ \setCJKfamilyfont{zhfs}{FandolFang}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ ]%
+ \setCJKfamilyfont{zhkai}{FandolKai}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ ]%
+ \setCJKfamilyfont{hwxk}{STXingkai}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ ]%
+}
+\newcommand\hit@load@cjk@font@fandol{%
+ \setCJKmainfont{FandolSong}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ BoldFont = *-Bold,
+ ItalicFont = FandolKai-Regular,
+ ]%
+ \setCJKsansfont{FandolHei}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ BoldFont = *-Bold,
+ ]%
+ \setCJKmonofont{FandolFang}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ ]%
+ \setCJKfamilyfont{zhsong}{FandolSong}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ BoldFont = *-Bold,
+ ]%
+ \setCJKfamilyfont{zhhei}{FandolHei}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ BoldFont = *-Bold,
+ ]%
+ \setCJKfamilyfont{zhfs}{FandolFang}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ ]%
+ \setCJKfamilyfont{zhkai}{FandolKai}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ ]%
+ \setCJKfamilyfont{hwxk}{FandolKai}[
+ Extension = .otf,
+ UprightFont = *-Regular,
+ ]%
+}
+\ifhit@cjk@font@none\else
+ \providecommand\songti{\CJKfamily{zhsong}}
+ \providecommand\heiti{\CJKfamily{zhhei}}
+ \providecommand\fangsong{\CJKfamily{zhfs}}
+ \providecommand\kaishu{\CJKfamily{zhkai}}
+ \providecommand\huawenxingkai{\CJKfamily{hwxk}}
+\fi
+\newcommand\hit@load@cjk@font{%
+ \@nameuse{hit@load@cjk@font@\hit@cjk@font}%
+}
+\hit@load@cjk@font
+\hit@option@hook{cjk-font}{\hit@load@cjk@font}
+% \end{macrocode}
+%
+% \begin{macro}{\normalsize}
+% 正文小四号 (12bp) 字,行距为固定值 20 bp。
+% 其他字号的行距按照相同的比例设置。
+%
+% 表达式行的行距为单倍行距,段前空 6 磅,段后空 6 磅。
+% \begin{macrocode}
+\renewcommand\normalsize{%
+ \@setfontsize\normalsize{12bp}{20bp}%
+ \abovedisplayskip 6bp%
+ \abovedisplayshortskip 6bp%
+ \belowdisplayskip 6bp
+ \belowdisplayshortskip \abovedisplayshortskip}
+
+\normalsize
+\ifx\MakeRobust\@undefined \else
+ \MakeRobust\normalsize
+\fi
+\DeclareRobustCommand\small{%
+ \@setfontsize\small{10.5bp}{17.5bp}%
+ \abovedisplayskip 6bp%
+ \abovedisplayshortskip 6bp%
+ \belowdisplayshortskip 6bp%
+ \def\@listi{\leftmargin\leftmargini
+ \topsep \z@skip
+ \parsep \z@skip
+ \itemsep \z@skip}%
+ \belowdisplayskip \abovedisplayskip
+}
+\DeclareRobustCommand\footnotesize{%
+ \@setfontsize\footnotesize{9bp}{15bp}%
+ \abovedisplayskip 6bp%
+ \abovedisplayshortskip 6bp%
+ \belowdisplayshortskip 6bp%
+ \def\@listi{\leftmargin\leftmargini
+ \topsep \z@skip
+ \parsep \z@skip
+ \itemsep \z@skip}%
+ \belowdisplayskip \abovedisplayskip
+}
+\DeclareRobustCommand\scriptsize{\@setfontsize\scriptsize{7.5bp}{12.5bp}}
+\DeclareRobustCommand\tiny{\@setfontsize\tiny{6.5bp}{10.83bp}}
+\DeclareRobustCommand\large{\@setfontsize\large{15bp}{25bp}}
+\DeclareRobustCommand\Large{\@setfontsize\Large{18bp}{30bp}}
+\DeclareRobustCommand\LARGE{\@setfontsize\LARGE{22bp}{36.67bp}}
+\DeclareRobustCommand\huge{\@setfontsize\huge{24bp}{40bp}}
+\DeclareRobustCommand\Huge{\@setfontsize\Huge{26bp}{43.33bp}}
+% \end{macrocode}
+% \end{macro}
+%
+% WORD 中的字号对应该关系如下(1bp = 72.27/72 pt):
+% \begin{center}
+% \begin{longtable}{llll}
+% \toprule
+% 初号 & 42bp & 14.82mm & 42.1575pt \\
+% 小初 & 36bp & 12.70mm & 36.135 pt \\
+% 一号 & 26bp & 9.17mm & 26.0975pt \\
+% 小一 & 24bp & 8.47mm & 24.09pt \\
+% 二号 & 22bp & 7.76mm & 22.0825pt \\
+% 小二 & 18bp & 6.35mm & 18.0675pt \\
+% 三号 & 16bp & 5.64mm & 16.06pt \\
+% 小三 & 15bp & 5.29mm & 15.05625pt \\
+% 四号 & 14bp & 4.94mm & 14.0525pt \\
+% 小四 & 12bp & 4.23mm & 12.045pt \\
+% 五号 & 10.5bp & 3.70mm & 10.59375pt \\
+% 小五 & 9bp & 3.18mm & 9.03375pt \\
+% 六号 & 7.5bp & 2.56mm & \\
+% 小六 & 6.5bp & 2.29mm & \\
+% 七号 & 5.5bp & 1.94mm & \\
+% 八号 & 5bp & 1.76mm & \\\bottomrule
+% \end{longtable}
+% \end{center}
+%
+% \begin{macro}{\hit@def@fontsize}
+% 根据习惯定义字号。用法:
+%
+% \cs{hit@def@fontsize}\marg{字号名称}\marg{磅数}
+%
+% 避免了字号选择和行距的紧耦合。所有字号定义时为单倍行距,并提供选项指定行距倍数。
+% \begin{macrocode}
+\def\hit@def@fontsize#1#2{%
+ \expandafter\newcommand\csname #1\endcsname[1][1.3]{%
+ \fontsize{#2}{##1\dimexpr #2}\selectfont}}
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{macro}{\chuhao}
+% \begin{macro}{\xiaochu}
+% \begin{macro}{\yihao}
+% \begin{macro}{\xiaoyi}
+% \begin{macro}{\erhao}
+% \begin{macro}{\xiaoer}
+% \begin{macro}{\sanhao}
+% \begin{macro}{\xiaosan}
+% \begin{macro}{\sihao}
+% \begin{macro}{\xiaosi}
+% \begin{macro}{\wuhao}
+% \begin{macro}{\xiaowu}
+% \begin{macro}{\liuhao}
+% \begin{macro}{\xiaoliu}
+% \begin{macro}{\qihao}
+% \begin{macro}{\bahao}
+% 一组字号定义。
+% \begin{macrocode}
+\hit@def@fontsize{chuhao}{42bp}
+\hit@def@fontsize{xiaochu}{36bp}
+\hit@def@fontsize{yihao}{26bp}
+\hit@def@fontsize{xiaoyi}{24bp}
+\hit@def@fontsize{erhao}{22bp}
+\hit@def@fontsize{xiaoer}{18bp}
+\hit@def@fontsize{sanhao}{16bp}
+\hit@def@fontsize{xiaosan}{15bp}
+\hit@def@fontsize{sihao}{14bp}
+\hit@def@fontsize{xiaosi}{12bp}
+\hit@def@fontsize{wuhao}{10.5bp}
+\hit@def@fontsize{xiaowu}{9bp}
+\hit@def@fontsize{liuhao}{7.5bp}
+\hit@def@fontsize{xiaoliu}{6.5bp}
+\hit@def@fontsize{qihao}{5.5bp}
+\hit@def@fontsize{bahao}{5bp}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+%
+% \subsubsection{文章标题设置}
+% \label{sec:paragraphlanguage}
+%
+% 。
+% \begin{macrocode}
+\newcommand\hit@set@chapter@names{%
+ \ctexset{
+ chapter/name = {第,章},
+ }%
+ \def\bibname{参考文献}%
+ \def\appendixname{附录}%
+ \def\indexname{索引}%
+ \def\contentsname{目\quad 录}%
+ \def\listfigurename{插图索引}%
+ \def\listtablename{表格索引}%
+ \def\hit@list@figure@table@name{插图和附表索引}%
+ \def\hit@list@algorithm@name{算法索引}%
+ \def\listequationname{公式索引}%
+}
+\hit@set@chapter@names
+% \end{macrocode}
+%
+% \begin{macrocode}
+\newcommand\hit@set@names{%
+ \ctexset{
+ figurename = 图,
+ tablename = 表,
+ }%
+ \def\hit@algorithm@name{算法}%
+ \def\hit@equation@name{公式}%
+ \def\hit@assumption@name{假设}%
+ \def\hit@definition@name{定义}%
+ \def\hit@proposition@name{命题}%
+ \def\hit@lemma@name{引理}%
+ \def\hit@theorem@name{定理}%
+ \def\hit@axiom@name{公理}%
+ \def\hit@corollary@name{推论}%
+ \def\hit@exercise@name{练习}%
+ \def\hit@example@name{例}%
+ \def\hit@remark@name{注释}%
+ \def\hit@problem@name{问题}%
+ \def\hit@conjecture@name{猜想}%
+ \def\hit@proof@name{证明}%
+ \def\hit@theorem@separator{:}%
+}
+\hit@set@names
+% \end{macrocode}
+%
+% 带圈数字和星号使用中文字体。
+% \begin{macrocode}
+\xeCJKDeclareCharClass{CJK}{"2460 -> "2473}
+\xeCJKDeclareCharClass{CJK}{"2605}
+% \end{macrocode}
+%
+% \newcommand\unicodechar[1]{U+#1(\symbol{"#1})}
+% 由于 Unicode 的一些标点符号是中西文混用的:
+% \unicodechar{00B7}、
+% \unicodechar{2013}、
+% \unicodechar{2014}、
+% \unicodechar{2018}、
+% \unicodechar{2019}、
+% \unicodechar{201C}、
+% \unicodechar{201D}、
+% \unicodechar{2025}、
+% \unicodechar{2026}、
+% \unicodechar{2E3A},
+% 所以要根据语言设置正确的字体。
+% \footnote{\url{https://github.com/CTeX-org/ctex-kit/issues/389}}
+% 此外切换语言时,有一部分名称是需要被重新定义的。
+% \begin{macrocode}
+\newcommand\hit@set@punctuations{%
+ \xeCJKDeclareCharClass{FullLeft}{"2018, "201C}%
+ \xeCJKDeclareCharClass{FullRight}{
+ "00B7, "2019, "201D, "2013, "2014, "2025, "2026, "2E3A,
+ }%
+}
+\hit@set@punctuations
+% \end{macrocode}
+%
+% \subsubsection{页眉页脚}
+% \label{sec:headerfooter}
+%
+% \pkg{fancyhdr} 定义页眉页脚很方便,但是有一个非常隐蔽的坑。
+% 第一次调用 \pkg{fancyhdr} 定义的样式时会修改 \cs{chaptermark},
+% 这会导致页眉信息错误(多余章号并且英文大写)。
+% 这是因为在 \cs{ps@fancy} 中对 \cs{chaptermark} 进行重定义,
+% 所以我们先调用 \cs{ps@fancy},再修改 \cs{chaptermark}。
+% \begin{macrocode}
+\pagestyle{fancy}
+% \end{macrocode}
+%
+% 定义页眉和页脚。
+% 页眉宋体五号字,居中书写;
+% 页码五号 Times New Roman ,位于页面底端,居中书写。
+%
+% \begin{macrocode}
+\fancypagestyle{plain}{%
+ \fancyhf{}%
+ \renewcommand\footrulewidth{0pt}%
+ \renewcommand\headrulewidth{0.75bp}%
+ \fancyhead[C]{%
+ \wuhao
+ \leftmark
+ }%
+ \fancyfoot[C]{\wuhao\thepage}%
+ \let\@mkboth\markboth
+ \def\chaptermark##1{%
+ \markboth{\CTEXifname{\CTEXthechapter\quad}{}##1}{}%
+ }%
+ \let\sectionmark\@gobble
+}
+\pagestyle{plain}
+% \end{macrocode}
+%
+% \cs{chapter} 会调用特殊的 page style。
+% \begin{macrocode}
+\ctexset{chapter/pagestyle = plain}
+% \end{macrocode}
+%
+%
+% \subsubsection{段落}
+% \label{sec:paragraph}
+%
+% 全文首行缩进 2 字符,标点符号用全角
+% \begin{macrocode}
+\ctexset{%
+ punct=quanjiao,
+ space=auto,
+}
+\newcommand\hit@set@indent{%
+ \ctexset{autoindent=2}%
+}
+\hit@set@indent
+% \end{macrocode}
+%
+% 设置 url 样式,与上下文一致
+% \begin{macrocode}
+\urlstyle{same}
+% \end{macrocode}
+%
+% 使用 \pkg{xurl} 的方法,增加 URL 可断行的位置。
+% \begin{macrocode}
+\g@addto@macro\UrlBreaks{%
+ \do0\do1\do2\do3\do4\do5\do6\do7\do8\do9%
+ \do\A\do\B\do\C\do\D\do\E\do\F\do\G\do\H\do\I\do\J\do\K\do\L\do\M
+ \do\N\do\O\do\P\do\Q\do\R\do\S\do\T\do\U\do\V\do\W\do\X\do\Y\do\Z
+ \do\a\do\b\do\c\do\d\do\e\do\f\do\g\do\h\do\i\do\j\do\k\do\l\do\m
+ \do\n\do\o\do\p\do\q\do\r\do\s\do\t\do\u\do\v\do\w\do\x\do\y\do\z
+}
+\Urlmuskip=0mu plus 0.1mu
+% \end{macrocode}
+%
+% 取消列表的间距,以符合中文习惯。
+% \begin{macrocode}
+\partopsep=\z@skip
+\def\@listi{\leftmargin\leftmargini
+ \parsep \z@skip
+ \topsep \z@skip
+ \itemsep\z@skip}
+\let\@listI\@listi
+\@listi
+\def\@listii {\leftmargin\leftmarginii
+ \labelwidth\leftmarginii
+ \advance\labelwidth-\labelsep
+ \topsep \z@skip
+ \parsep \z@skip
+ \itemsep \z@skip}
+\def\@listiii{\leftmargin\leftmarginiii
+ \labelwidth\leftmarginiii
+ \advance\labelwidth-\labelsep
+ \topsep \z@skip
+ \parsep \z@skip
+ \partopsep \z@skip
+ \itemsep \z@skip}
+% \end{macrocode}
+%
+% 使用 \pkg{enumitem} 命令调整默认列表环境间的距离,
+% \begin{macrocode}
+\setlist{nosep}
+% \end{macrocode}
+%
+%
+% \subsubsection{脚注}
+% \label{sec:footnote}
+% 脚注内容采用小五号字,中文用宋体,英文和数字用 Times New Roman 体按两端对齐格式书写,
+% 单倍行距,段前段后均空 0 磅。
+% 脚注的序号按页编排,不同页的脚注序号不需要连续。
+%
+% 脚注处序号“1,……,10”的字体是“正文”,不是“上标”,序号与脚注内容文字之间空半个汉字符,
+% 脚注的段落格式为:单倍行距,段前空 0 磅,段后空 0 磅,悬挂缩进 1.5 字符;
+% 字号为小五号字,汉字用宋体,外文用 Times New Roman 体。
+%
+% 脚注序号使用带圈数字。
+% \begin{macro}{\hit@circled}
+% 生成带圈的脚注数字,最多处理到 10。
+% \begin{macrocode}
+\newcommand\hit@circled[1]{%
+ \ifnum#1 >10\relax
+ \hit@error{%
+ Too many footnotes in this page.
+ Keep footnote less than 10%
+ }%
+ \fi
+ {\symbol{\the\numexpr#1+"245F\relax}}%
+}
+\renewcommand{\thefootnote}{\hit@circled{\c@footnote}}
+\renewcommand{\thempfootnote}{\hit@circled{\c@mpfootnote}}
+% \end{macrocode}
+% \end{macro}
+%
+% 定义脚注分割线,字号(宋体小五),以及悬挂缩进(1.5字符)。
+% \begin{macrocode}
+\def\footnoterule{\vskip-3\p@\hrule\@width0.3\textwidth\@height0.4\p@\vskip2.6\p@}
+\footnotemargin=13.5bp
+% \end{macrocode}
+%
+% 修改 \pkg{footmisc} 定义的脚注格式。
+% \begin{macrocode}
+\long\def\@makefntext#1{%
+ \begingroup
+ % 序号取消上标
+ \def\@makefnmark{\hbox{\normalfont\@thefnmark}}%
+ \xiaowu
+ \ifFN@hangfoot
+ \bgroup
+ \setbox\@tempboxa\hbox{%
+ \ifdim\footnotemargin>\z@
+ \hb@xt@\footnotemargin{\@makefnmark\hss}%
+ \else
+ \@makefnmark
+ \fi
+ }%
+ \leftmargin\wd\@tempboxa
+ \rightmargin\z@
+ \linewidth \columnwidth
+ \advance \linewidth -\leftmargin
+ \parshape \@ne \leftmargin \linewidth
+ % \footnotesize
+ \xiaowu
+ \@setpar{{\@@par}}%
+ \leavevmode
+ \llap{\box\@tempboxa}%
+ \parskip\hangfootparskip\relax
+ \parindent\hangfootparindent\relax
+ \else
+ \parindent1em%
+ \noindent
+ \ifdim\footnotemargin>\z@
+ \hb@xt@ \footnotemargin{\hss\@makefnmark}%
+ \else
+ \ifdim\footnotemargin=\z@
+ \llap{\@makefnmark}%
+ \else
+ \llap{\hb@xt@ -\footnotemargin{\@makefnmark\hss}}%
+ \fi
+ \fi
+ \fi
+ \footnotelayout#1%
+ \ifFN@hangfoot
+ \par\egroup
+ \fi
+ \endgroup
+}
+% \end{macrocode}
+%
+%
+% \subsubsection{摘要}
+% \label{sec:abstractformat}
+% 摘要两个字设置为 3 号.
+% 定义摘要环境
+%
+% \begin{macro}{\hit@clist@use}
+% 不同论文格式关键词之间的分割不太相同,我们用 \option{keywords}
+% 来收集关键词列表,然后用本命令来生成符合要求的格式,
+% 类似于 \LaTeX3 的 \cs{clist\_use:Nn}。
+% \begin{macrocode}
+\hit@define@key{
+ keywords,
+}
+\newcommand\hit@clist@use[2]{%
+ \def\hit@@tmp{}%
+ \def\hit@clist@processor##1{%
+ \ifx\hit@@tmp\@empty
+ \def\hit@@tmp{#2}%
+ \else
+ #2%
+ \fi
+ ##1%
+ }%
+ \expandafter\comma@parse\expandafter{#1}{\hit@clist@processor}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{environment}{abstract}
+% 中文摘要部分的标题为“\textbf{摘要}”,用黑体三号字。
+% 摘要内容用小四号字书写,两端对齐,汉字用宋体,外文字用 Times New Roman 体,
+% 标点符号一律用中文输入状态下的标点符号。
+% \begin{macrocode}
+\newenvironment{abstract}{%
+ \cleardoublepage
+ \begingroup
+ \hit@chapter*{\hit@abstract@name}%
+ \endgroup
+}{%
+% \end{macrocode}
+%
+% 每个关键词之间空两个汉字符宽度, 且为悬挂缩进。
+% \begin{macrocode}
+ \par
+ \null\par
+ \textbf{关键词:}%
+ \hit@clist@use{\hit@keywords}{;}%
+ \cleardoublepage
+}
+% \end{macrocode}
+% \end{environment}
+%
+%
+% \subsection{数学环境、定理设置}
+% \label{sec:mathenv}
+%
+% \begin{macro}{\bm}
+% \begin{macro}{\boldsymbol}
+% 兼容旧的粗体命令:\pkg{bm} 的 \cs{bm} 和 \pkg{amsmath} 的 \cs{boldsymbol}。
+% \begin{macrocode}
+\DeclareRobustCommand\bm[1]{{\symbf{#1}}}
+\DeclareRobustCommand\boldsymbol[1]{{\symbf{#1}}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\square}
+% 兼容 \pkg{amssymb} 中的命令。
+% \begin{macrocode}
+\newcommand\square{\mdlgwhtsquare}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\checkmark}
+% 允许在文本模式中使用 \cs{checkmark}。
+% \begin{macrocode}
+\AtBeginDocument{%
+ \renewcommand\checkmark{\ensuremath{✓}}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% 允许太长的公式断行、分页等。
+% \begin{macrocode}
+\allowdisplaybreaks[4]
+% \end{macrocode}
+%
+% \subsubsection{浮动对象:插图和表格}
+% \label{sec:float}
+%
+% 图表浮动体的默认位置设为 |h|。
+% \begin{macrocode}
+\def\fps@figure{h}
+\def\fps@table{h}
+% \end{macrocode}
+%
+% 设置浮动对象和文字之间的距离
+% \begin{macrocode}
+\setlength{\floatsep}{6bp}
+\setlength{\textfloatsep}{6bp}
+\setlength{\intextsep}{6bp}
+\setlength{\@fptop}{0bp \@plus1.0fil}
+\setlength{\@fpsep}{12bp \@plus2.0fil}
+\setlength{\@fpbot}{0bp \@plus1.0fil}
+% \end{macrocode}
+%
+% 下面这组命令使浮动对象的缺省值稍微宽松一点,从而防止幅度对象占据过多的文本页面,
+% 也可以防止在很大空白的浮动页上放置很小的图形。
+% \begin{macrocode}
+\renewcommand{\textfraction}{0.15}
+\renewcommand{\topfraction}{0.85}
+\renewcommand{\bottomfraction}{0.65}
+\renewcommand{\floatpagefraction}{0.60}
+% \end{macrocode}
+%
+% 允许用户设置图表编号的连接符。
+% \begin{macrocode}
+\hit@define@key{
+ figure-number-separator = {
+ name = figure@number@separator,
+ default = {.},
+ },
+ table-number-separator = {
+ name = table@number@separator,
+ default = {.},
+ },
+ equation-number-separator = {
+ name = equation@number@separator,
+ default = {.},
+ },
+ number-separator = {
+ name = number@separator,
+ default = {.},
+ },
+}
+\renewcommand\thefigure{%
+ \ifnum\c@chapter>\z@
+ \thechapter
+ \hit@figure@number@separator
+ \fi
+ \@arabic\c@figure
+}
+\renewcommand\thetable{%
+ \ifnum\c@chapter>\z@
+ \thechapter
+ \hit@table@number@separator
+ \fi
+ \@arabic\c@table
+}
+\renewcommand\theequation{%
+ \ifnum\c@chapter>\z@
+ \thechapter
+ \hit@equation@number@separator
+ \fi
+ \@arabic\c@equation
+}
+\newcommand\hit@set@number@separator{%
+ \let\hit@figure@number@separator\hit@number@separator
+ \let\hit@table@number@separator\hit@number@separator
+ \let\hit@equation@number@separator\hit@number@separator
+}
+\hit@option@hook{number-separator}{\hit@set@number@separator}
+% \end{macrocode}
+%
+%
+% 对 \pkg{longtable} 跨页表格进行相同的设置。
+% \begin{macrocode}
+\AtEndOfPackageFile*{longtable}{
+ \AtBeginEnvironment{longtable}{%
+ \fontsize{11bp}{20.3bp}\selectfont
+ }
+}
+% \end{macrocode}
+%
+% 定制浮动图形和表格标题样式,以及改变附录中浮动体的编号规则:
+% \begin{itemize}
+% \item 图表标题字体为 11pt
+% \item 去掉图表号后面的冒号,图序与图名文字之间空一个汉字符宽度
+% \item 图:caption 在下,段前空 6 磅,段后空 12 磅
+% \item 表:caption 在上,段前空 12 磅,段后空 6 磅
+% \end{itemize}
+% \begin{macrocode}
+\DeclareCaptionFont{hit}{%
+ \fontsize{11bp}{15bp}\selectfont
+}
+\captionsetup{
+ font = hit,
+ labelsep = quad,
+ aboveskip = 6bp,
+ belowskip = 6bp,
+ figureposition = bottom,
+ tableposition = top,
+}
+\captionsetup[sub]{font=hit}
+\renewcommand{\thesubfigure}{(\alph{subfigure})}
+\renewcommand{\thesubtable}{(\alph{subtable})}
+% \renewcommand{\p@subfigure}{:}
+% \end{macrocode}
+%
+% 研究生和本科生都推荐使用三线表,并且要求表的上、下边线为单直线,线粗为 1.5 磅;
+% 第三条线为单直线,线粗为 1 磅。
+% 这里设置 \pkg{booktabs} 线粗的默认值。
+% \begin{macrocode}
+\heavyrulewidth=1.5bp
+\lightrulewidth=1bp
+% \end{macrocode}
+%
+% \begin{macrocode}
+\AtEndOfPackageFile*{threeparttable}{
+ \g@addto@macro\TPT@defaults{\wuhao}
+}
+% \end{macrocode}
+%
+% \subsubsection{章节标题}
+% \label{sec:theor}
+% \begin{macrocode}
+\newcommand{\hit@abstract@name}{摘 \quad 要}
+\newcommand{\hit@abstract@name@en}{Abstract}
+% \end{macrocode}
+%
+% 各级标题格式设置。
+% \begin{macrocode}
+\ctexset{%
+ chapter = {
+ nameformat = {},
+ numberformat = {},
+ titleformat = {},
+ fixskip = true,
+ afterindent = true,
+ lofskip = 0pt,
+ lotskip = 0pt,
+ },
+ section = {
+ afterindent = true,
+ },
+ subsection = {
+ afterindent = true,
+ },
+ subsubsection = {
+ afterindent = true,
+ },
+ paragraph/afterindent = true,
+ subparagraph/afterindent = true,
+}
+% \end{macrocode}
+%
+% 本模板设置:
+% \begin{itemize}
+% \item 各章标题,例如:“\textsf{第 1 章 引言}”。
+%
+% 章序号与章名之间空一个汉字符。
+% 采用黑体三号字,居中书写,单倍行距,
+% 段前空 24 磅,段后空 18 磅。
+%
+% \item 一级节标题,例如:“\textsf{2.1 实验装置与实验方法}”。
+%
+% 节标题序号与标题名之间空一个汉字符(下同)。
+% 采用黑体四号(14pt)字居左书写,行距为固定值 20 磅,
+% 段前空 24 磅,段后空 6 磅。
+%
+% \item 二级节标题,例如:“\textsf{2.1.1 实验装置}”。
+%
+% 采用黑体 13pt 字居左书写,行距为固定值 20 磅,
+% 段前空 12 磅,段后空 6 磅。
+%
+% \item 三级节标题,例如:“\textsf{2.1.2.1 归纳法}”。
+%
+% 采用黑体小四号(12pt)字居左书写,行距为固定值 20 磅,
+% 段前空 12 磅,段后空 6 磅。
+% \end{itemize}
+%
+% 这里三级节标题的“中文黑体小四号”取 13pt。
+% \begin{macrocode}
+\newcommand\hit@set@section@format{%
+ \ctexset{%
+ chapter = {
+ format = \centering\sffamily\sanhao,
+ nameformat = {},
+ titleformat = {},
+ beforeskip = 27bp,
+ afterskip = 27bp,
+ aftername = \quad,
+ },
+ section = {
+ format = \sffamily\fontsize{14bp}{20bp}\selectfont,
+ beforeskip = 24bp,
+ afterskip = 6bp,
+ aftername = \quad,
+ },
+ subsection = {
+ format = \sffamily\fontsize{13bp}{20bp}\selectfont,
+ beforeskip = 12bp,
+ afterskip = 6bp,
+ aftername = \quad,
+ },
+ subsubsection = {
+ format = \sffamily\fontsize{12bp}{20bp}\selectfont,
+ beforeskip = 12bp,
+ afterskip = 6bp,
+ aftername = \quad,
+ },
+ }%
+ \ctexset{chapter/number = \thechapter}%
+}
+\hit@set@section@format
+% \end{macrocode}
+%
+% \begin{macro}{\hit@chapter*}
+% 模板定义所有的章都出现在目录里,比如摘要、Abstract、主要符号表等。
+%
+% \begin{macrocode}
+\newcommand\hit@pdfbookmark[2]{}
+\newcommand\hit@phantomsection{}
+\NewDocumentCommand\hit@chapter{s o m o}{%
+ \IfBooleanF{#1}{%
+ \hit@error{You have to use the star form: \string\hit@chapter*}%
+ }%
+ \if@openright\cleardoublepage\else\clearpage\fi%
+ \IfValueTF{#2}{%
+ \ifthenelse{\equal{#2}{}}{%
+ \hit@pdfbookmark{0}{#3}%
+ }{%
+ \hit@phantomsection
+ \addcontentsline{toc}{chapter}{#2}%
+ }%
+ }{%
+ \hit@phantomsection
+ \addcontentsline{toc}{chapter}{#3}%
+ }%
+ \ctexset{chapter/beforeskip=40bp}
+ \chapter*{#3}%
+ \ctexset{chapter/beforeskip=30bp}
+ \IfValueTF{#4}{%
+ \ifthenelse{\equal{#4}{}}{%
+ \@mkboth{}{}%
+ }{%
+ \@mkboth{#4}{#4}%
+ }%
+ }{%
+ \@mkboth{#3}{#3}%
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \subsubsection{目录}
+% \label{sec:toc}
+% 最多 4 层,即: x.x.x.x,对应的命令和层序号分别是:
+% \cs{chapter}(0), \cs{section}(1), \cs{subsection}(2), \cs{subsubsection}(3)。
+% \begin{macrocode}
+\setcounter{secnumdepth}{3}
+\setcounter{tocdepth}{2}
+% \end{macrocode}
+%
+% \begin{macro}{\tableofcontents}
+% 目录生成命令。
+% \begin{macrocode}
+\renewcommand\tableofcontents{%
+ \hit@chapter*[]{\contentsname}%
+ \@starttoc{toc}%
+}
+\hit@define@key{
+ toc-chapter-style = {
+ name = toc@chapter@style,
+ choices = {
+ arial,
+ times,
+ },
+ default = arial,
+ },
+}
+\newcommand\hit@leaders{\titlerule*[4bp]{.}}
+\newcommand\hit@set@toc@format{%
+ \contentsmargin{\z@}%
+% \end{macrocode}
+%
+% 目录从第 1 章开始,每章标题用黑体小四号字,行间距为 20pt,
+% 行前空 6pt,行后空 0pt。
+% 其它级节标题用宋体小四字,行间距为 20pt。
+%
+% 注意示例中章标题的字母和数字是衬线体,所以这里用 \cs{heiti}。
+% 示例中的一级和二级节标题分别缩进 1 和 1.5 个汉字符。
+% \begin{macrocode}
+\titlecontents{chapter}
+ [\z@]{\addvspace{6bp}\sffamily}
+ {\contentspush{\thecontentslabel\quad}}{}
+ {\rmfamily\hit@leaders\thecontentspage}%
+\titlecontents{section}
+ [1em]{}
+ {\contentspush{\thecontentslabel\quad}}{}
+ {\hit@leaders\thecontentspage}%
+\titlecontents{subsection}
+ [2em]{}
+ {\contentspush{\thecontentslabel\quad}}{}
+ {\hit@leaders\thecontentspage}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\hit@set@toc@format
+% \end{macrocode}
+% \end{macro}
+%
+%
+%
+% \subsection{参考文献环境设置}
+% \label{sec:bib}
+%
+% 重定义参考文献环境
+% \begin{macrocode}
+\renewenvironment{thebibliography}[1]
+ {\section*{\refname}%
+ \@mkboth{\MakeUppercase\refname}{\MakeUppercase\refname}%
+ \list{\@biblabel{\@arabic\c@enumiv}}%
+ {\settowidth\labelwidth{\@biblabel{#1}}%
+ \leftmargin\labelwidth
+ \advance\leftmargin\labelsep
+ \@openbib@code
+ \usecounter{enumiv}%
+ \let\p@enumiv\@empty
+ \renewcommand\theenumiv{\@arabic\c@enumiv}}%
+ \sloppy
+ \clubpenalty4000
+ \@clubpenalty \clubpenalty
+ \widowpenalty4000%
+ \sfcode`\.\@m}
+ {\def\@noitemerr
+ {\@latex@warning{Empty `thebibliography' environment}}%
+ \endlist}
+% \end{macrocode}
+%
+%
+% \subsection{其他环境设置}
+% \label{sec:config}
+%
+% \subsubsection{\pkg{amsthm} 宏包}
+%
+% 定理标题使用黑体,正文使用宋体,冒号隔开。
+% \begin{macrocode}
+\AtEndOfPackageFile*{amsthm}{%
+ \newtheoremstyle{hit}
+ {\z@}{\z@}
+ {\normalfont}{\z@}
+ {\normalfont\sffamily}{\hit@theorem@separator}
+ {0.5em}{}
+ \theoremstyle{hit}
+ \newtheorem{assumption}{\hit@assumption@name}[chapter]%
+ \newtheorem{definition}{\hit@definition@name}[chapter]%
+ \newtheorem{proposition}{\hit@proposition@name}[chapter]%
+ \newtheorem{lemma}{\hit@lemma@name}[chapter]%
+ \newtheorem{theorem}{\hit@theorem@name}[chapter]%
+ \newtheorem{axiom}{\hit@axiom@name}[chapter]%
+ \newtheorem{corollary}{\hit@corollary@name}[chapter]%
+ \newtheorem{exercise}{\hit@exercise@name}[chapter]%
+ \newtheorem{example}{\hit@example@name}[chapter]%
+ \newtheorem{remark}{\hit@remark@name}[chapter]%
+ \newtheorem{problem}{\hit@problem@name}[chapter]%
+ \newtheorem{conjecture}{\hit@conjecture@name}[chapter]%
+ \renewenvironment{proof}[1][\hit@proof@name]{\par
+ \pushQED{\qed}%
+ % \normalfont \topsep6\p@\@plus6\p@\relax
+ \normalfont \topsep\z@\relax
+ \trivlist
+ \item[\hskip\labelsep
+ % \itshape
+ % #1\@addpunct{.}]\ignorespaces
+ \sffamily
+ #1\@addpunct{\hit@theorem@separator}]\ignorespaces
+ }{%
+ \popQED\endtrivlist\@endpefalse
+ }
+ \renewcommand\qedsymbol{\ensuremath{\QED}}
+}
+% \end{macrocode}
+%
+% \subsubsection{\pkg{ntheorem} 宏包}
+%
+% 定理标题使用黑体,正文使用宋体,冒号隔开。
+% \begin{macrocode}
+\AtEndOfPackageFile*{ntheorem}{%
+ \theorembodyfont{\normalfont}%
+ \theoremheaderfont{\normalfont\sffamily}%
+ \theoremsymbol{\ensuremath{\QED}}%
+ \newtheorem*{proof}{\hit@proof@name}%
+ \theoremstyle{plain}%
+ \theoremsymbol{}%
+ \theoremseparator{\hit@theorem@separator}%
+ \newtheorem{assumption}{\hit@assumption@name}[chapter]%
+ \newtheorem{definition}{\hit@definition@name}[chapter]%
+ \newtheorem{proposition}{\hit@proposition@name}[chapter]%
+ \newtheorem{lemma}{\hit@lemma@name}[chapter]%
+ \newtheorem{theorem}{\hit@theorem@name}[chapter]%
+ \newtheorem{axiom}{\hit@axiom@name}[chapter]%
+ \newtheorem{corollary}{\hit@corollary@name}[chapter]%
+ \newtheorem{exercise}{\hit@exercise@name}[chapter]%
+ \newtheorem{example}{\hit@example@name}[chapter]%
+ \newtheorem{remark}{\hit@remark@name}[chapter]%
+ \newtheorem{problem}{\hit@problem@name}[chapter]%
+ \newtheorem{conjecture}{\hit@conjecture@name}[chapter]%
+}
+% \end{macrocode}
+%
+% \subsubsection{\pkg{algorithm} 宏包}
+%
+% 使 \env{algorithm} 和 \env{listing} 环境的名称随语言设置而改变,
+% 并使其在附录中的编号规则与图、表等一致。
+%
+% \begin{macro}{\listofalgorithm}
+% \begin{macro}{\listofalgorithm*}
+% \begin{macrocode}
+\PassOptionsToPackage{chapter}{algorithm}
+\AtEndOfPackageFile*{algorithm}{
+ \floatname{algorithm}{\hit@algorithm@name}
+ \renewcommand\listofalgorithms{%
+ \hit@listof{algorithm}%
+ }
+ \renewcommand\listalgorithmname{\hit@list@algorithm@name}
+ \def\ext@algorithm{loa}
+ \contentsuse{algorithm}{loa}
+ \titlecontents{algorithm}
+ [\z@]{}
+ {\contentspush{\fname@algorithm~\thecontentslabel\quad}}{}
+ {\hit@leaders\thecontentspage}
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \subsubsection{\pkg{algorithm2e} 宏包}
+%
+% \begin{macrocode}
+\PassOptionsToPackage{algochapter}{algorithm2e}
+\AtEndOfPackageFile*{algorithm2e}{
+ \renewcommand\algorithmcfname{\hit@algorithm@name}
+ \SetAlgoCaptionLayout{hit@caption@font}
+ \SetAlCapSty{relax}
+ \SetAlgoCaptionSeparator{\hspace*{1em}}
+ \SetAlFnt{\fontsize{11bp}{14.3bp}\selectfont}
+ \renewcommand\listofalgorithms{%
+ \hit@listof{algorithmcf}%
+ }
+ \renewcommand\listalgorithmcfname{\hit@list@algorithm@name}
+ \def\ext@algorithmcf{loa}
+ \contentsuse{algocf}{loa}
+ \titlecontents{algocf}
+ [\z@]{}
+ {\contentspush{\algorithmcfname~\thecontentslabel\quad}}{}
+ {\hit@leaders\thecontentspage}
+}
+% \end{macrocode}
+%
+% \subsubsection{\pkg{minted} 宏包}
+%
+% \begin{macrocode}
+\AtEndOfPackageFile*{minted}{
+ \newcommand\hit@set@listing@language{%
+ \floatname{listing}{代码}%
+ }
+ \hit@set@listing@language
+}
+% \end{macrocode}
+%
+%
+% \subsubsection{\pkg{hyperref} 宏包}
+%
+% \begin{macrocode}
+\AtEndOfPackageFile*{hyperref}{
+ \hypersetup{
+ linktoc = all,
+ bookmarksnumbered = true,
+ bookmarksopen = true,
+ bookmarksopenlevel = 1,
+ unicode = true,
+ psdextra = true,
+ breaklinks = true,
+ plainpages = false,
+ pdfdisplaydoctitle = true,
+ hidelinks,
+ }%
+% \end{macrocode}
+%
+% \pkg{hyperref} 与 \pkg{unicode-math} 存在一些兼容性问题,见
+% \href{https://github.com/ustctug/ustcthesis/issues/223}{%
+% ustctug/ustcthesis\#223},
+% \href{https://github.com/ho-tex/hyperref/pull/90}{ho-tex/hyperref\#90} 和
+% \href{https://github.com/ustctug/ustcthesis/issues/235}{%
+% ustctug/ustcthesis/\#235}。
+% \begin{macrocode}
+ \@ifpackagelater{hyperref}{2019/04/27}{}{%
+ \g@addto@macro\psdmapshortnames{\let\mu\textmu}
+ }%
+ \hypersetup{
+ pdflang = zh-CN,
+ }%
+ \AtBeginDocument{%
+ \hypersetup{
+ pdftitle = \hit@title,
+ pdfauthor = \hit@author,
+ }%
+ \hypersetup{
+ pdfcreator={hitreport-v1.0}}
+ }%
+}
+% \end{macrocode}
+%
+%
+% 浮动环境设置
+% 默认情况下, \LaTeX{} 要求每页的文字至少占据 20\%,否则该页就只单独放置一个浮动环境,
+% 而这通常不是我们想要的, 我们将这个要求降低到 5\%.
+% \begin{macrocode}
+\renewcommand*{\textfraction}{0.05}
+% \end{macrocode}
+% 有时如果多个浮动环境连续放在一起, \LaTeX{}会将它们分在几个不同页,即使它们可在同一页放
+% 得下. 我们可以通过修改 |\topfraction| 和 |\bottomfraction| 分别设置顶端和底端的浮动环境的最大比例.
+% \begin{macrocode}
+\renewcommand*{\topfraction}{0.9}
+\renewcommand*{\bottomfraction}{0.8}
+% \end{macrocode}
+% 有时\LaTeX{}会把一个浮动环境单独放在一页,
+% 我们要求这个环境至少要占据 85% 才能单独放在一页.
+% 注意: |\floatpagefraction| 的数值必须小于 |\topfraction|.
+% \begin{macrocode}
+\renewcommand*{\floatpagefraction}{0.85}
+% \end{macrocode}
+% 关于图片 graphicx
+% 如果图片没有指定后缀, 依次按下列顺序搜索
+% \begin{macrocode}
+\DeclareGraphicsExtensions{.pdf,.eps,.jpg,.png}
+% \end{macrocode}
+% 设置图表搜索路径, 可以给图表文件夹取如下名字
+% \begin{macrocode}
+\graphicspath{{figures/}{figure/}{pictures/}{picture/}{pic/}{pics/}{image/}{images/}}
+% \end{macrocode}
+% 图表标题
+% \begin{macrocode}
+\DeclareCaptionFont{song}{\songti}
+\DeclareCaptionFont{minusfour}{\zihao{-4}}
+\captionsetup[figure]{
+ format=hang, %标题从第二行开始都有缩进, 应该和 justification=raggedright 的效果一样.
+ labelsep=quad, %分隔符是一个空格
+ font={song,minusfour,bf}, %图的字体, 宋体小四
+ position=bottom %position=bottom, 不代表标题放在下面, 标题仍放在你放\caption的位置.
+}
+\captionsetup[table]{%
+ format=hang, % 标题从第二行开始都有缩进, 应该和 justification=raggedright 的效果一样.
+ labelsep=quad, % 分隔符是一个空格
+ font={song,minusfour,bf}, % 表的字体, 宋体小四
+ position=top % position=bottom, 不代表标题放在下面, 标题仍放在你放\caption的位置.
+}
+% \end{macrocode}
+%
+% 列表环境设置
+% \begin{macrocode}
+\setlist{%
+ topsep=0.3em, % 列表顶端的垂直空白
+ partopsep=0pt, % 列表环境前面紧接着一个空白行时其顶端的额外垂直空白
+ itemsep=0ex plus 0.1ex, % 列表项之间的额外垂直空白
+ parsep=0pt, % 列表项内的段落之间的垂直空白
+ leftmargin=1.5em, % 环境的左边界和列表之间的水平距离
+ rightmargin=0em, % 环境的右边界和列表之间的水平距离
+ labelsep=0.5em, % 包含标签的盒子与列表项的第一行文本之间的间隔
+ labelwidth=2em % 包含标签的盒子的正常宽度;若实际宽度更宽,则使用实际宽度。
+}
+% \end{macrocode}
+%
+% \subsection{封面信息}
+% \label{sec:cover}
+%
+%
+% 报告题目。
+% \begin{macrocode}
+\hit@define@key{
+ title = {
+ default = {标题},
+ },
+% \end{macrocode}
+%
+% 报告小标题
+% \begin{macrocode}
+ expand = {
+ default = {小标题},
+ },
+% \end{macrocode}
+%
+% 姓名、学号、指导老师。
+% \begin{macrocode}
+ author = {
+ default = {姓名},
+ },
+ student-id = {
+ name = student@id,
+ },
+ supervisor = {
+ default = {导师姓名},
+ },
+% \end{macrocode}
+%
+% 院系名称。
+% \begin{macrocode}
+ department = {
+ default = {计算学部},
+ },
+% \end{macrocode}
+%
+% 专业名称。
+% \begin{macrocode}
+ discipline = {
+ default = {计算机科学与技术},
+ },
+% \end{macrocode}
+%
+% 班级序号
+% \begin{macrocode}
+ classnum = {
+ default = {1803105}
+ },
+% \end{macrocode}
+%
+% 实验地点
+% \begin{macrocode}
+ lablocation = {
+ default = {格物207}
+ },
+% \end{macrocode}
+%
+% 学期
+% \begin{macrocode}
+ term = {
+ default = {2021春}
+ },
+% \end{macrocode}
+%
+% 报告成文日期。
+% \begin{macrocode}
+ date = {
+ default = {\the\year-\two@digits{\month}-\two@digits{\day}},
+ }
+}
+% \end{macrocode}
+%
+% 输出日期的给定格式:\cs{hit@format@date}\marg{format}\marg{date},
+% 其中格式 \meta{format} 接受三个参数分别对应年、月、日,
+% \meta{date} 是 ISO 格式的日期(yyyy-mm-dd)。
+% \begin{macrocode}
+\newcommand\hit@format@date[2]{%
+ \edef\hit@@date{#2}%
+ \def\hit@@process@date##1-##2-##3\@nil{%
+ #1{##1}{##2}{##3}%
+ }%
+ \expandafter\hit@@process@date\hit@@date\@nil
+}
+\newcommand\hit@date@zh@digit[3]{#1 年 \number#2 月 \number#3 日}
+\newcommand\hit@date@zh@digit@short[3]{#1 年 \number#2 月}
+\newcommand\hit@date@zh@short[3]{\zhdigits{#1}年\zhnumber{#2}月}
+\newcommand\hit@date@month[1]{%
+ \ifcase\number#1\or
+ January\or February\or March\or April\or May\or June\or
+ July\or August\or September\or October\or November\or December%
+ \fi
+}
+\newcommand\hit@date@en@short[3]{\hit@date@month{#2}, #1}
+% \end{macrocode}
+%
+%
+% 下划线命令
+% \begin{macrocode}
+\newcommand\hit@underline[2][6em]{\hskip1pt\underline{\hb@xt@ #1{\hss#2\hss}}\hskip3pt}
+\newcommand\hit@CJKunderline[2][6em]{\CJKunderline*{\hb@xt@ #1{\hss#2\hss}}}
+% \end{macrocode}
+%
+%
+% 封面表格信息
+% \begin{macrocode}
+\newcommand\hit@titlepage@info{%
+ \large
+ \renewcommand{\arraystretch}{1}
+ \begin{tabular}{lp{3.5cm}<{\centering}lc}
+ \makebox[4em][s]{学\hspace{\fill}院}\hit@theorem@separator & {\hit@department} & \hspace{1em} \makebox[4em][s]{专\hspace{\fill}业}\hit@theorem@separator & {\hit@discipline} \\ \cline{2-2} \cline{4-4}
+ \makebox[4em][s]{班\hspace{\fill}级}\hit@theorem@separator & {\hit@classnum} & \hspace{1em} \makebox[4em][s]{学\hspace{\fill}号}\hit@theorem@separator & {\hit@student@id} \\ \cline{2-2} \cline{4-4}
+ \makebox[4em][s]{姓\hspace{\fill}名}\hit@theorem@separator & {\hit@author} &\hspace{1em} \makebox[4em][s]{实验地点}\hit@theorem@separator& {\hit@lablocation} \\ \cline{2-2} \cline{4-4}
+ \makebox[4em][s]{指导老师}\hit@theorem@separator& {\hit@supervisor} &\hspace{1em} \makebox[4em][s]{学\hspace{\fill}期}\hit@theorem@separator & {\hit@term} \\ \cline{2-2} \cline{4-4}
+ \end{tabular}
+}
+% \end{macrocode}
+%
+%
+% 论文成文打印的日期,用三号宋体汉字,字距延伸 0.5bp,
+% 所以 \cs{CJKglue} 应该设为 1 bp。
+% \begin{macrocode}
+\newcommand\hit@titlepage@date{%
+ \begingroup
+ \sanhao
+ \def\CJKglue{\hskip 1bp}%
+ \hit@format@date{\hit@date@zh@short}{\hit@date}\par
+ \endgroup
+}
+% \end{macrocode}
+%
+% 生成封面,使用\cs{maketitle}命令
+% \begin{macrocode}
+\renewcommand\maketitle{
+ \cleardoublepage
+ \pagenumbering{Alph}%
+ \hit@maketitlepage
+ \clearpage
+}
+% \end{macrocode}
+%
+%
+% 根据校区选择校区校徽及校名图片
+% \begin{macrocode}
+\newcommand\hit@titlepage@fig{
+ \ifhit@campus@harbin
+ \begin{center}
+ \begin{figure}[h]
+ \includegraphics[scale=0.5]{photo/hithrb.pdf} % 本部校徽图片
+ \end{figure}
+ \end{center}
+ \else
+ \ifhit@campus@shenzhen
+ \begin{center}
+ \begin{figure}[h]
+ \includegraphics[scale=0.26]{photo/hitsz.pdf} % 深圳校区校徽图片
+ \end{figure}
+ \end{center}
+ \else
+ \ifhit@campus@weihai
+ \begin{center}
+ \begin{figure}[h]
+ \includegraphics[scale=0.26]{photo/hitwh.pdf} % 校徽图片
+ \end{figure}
+ \end{center}
+ \fi
+ \fi
+ \fi
+}
+% \end{macrocode}
+%
+% 定义封面
+% \begin{macrocode}
+\newcommand\hit@maketitlepage{%
+\newgeometry{
+ vmargin = 2.54cm,
+ hmargin = 3.17cm,
+}
+ \newpage
+ \hit@titlepage@fig
+ \vspace{1.5cm}
+ \begingroup
+ \centering
+ \textbf{\huawenxingkai \fontsize{32}{0} \selectfont \hit@title}\\
+ \endgroup
+ \vspace{2cm}
+ \begingroup
+ \centering
+ \textbf{\heiti \fontsize{20}{0} \selectfont \hit@expand}\\
+ \endgroup
+ \vspace{2.5cm}
+ \parbox[h][10cm][t]{\textwidth}{\centering\hit@titlepage@info}\par
+ \begingroup
+ \centering
+ {\heiti \sihao\hit@format@date{\hit@date@zh@digit}{\hit@date}\par}%
+ \endgroup
+ \thispagestyle{empty}
+ \restoregeometry
+}
+% \end{macrocode}
+%
+% 定义附录
+% \begin{macrocode}
+\renewcommand{\setthesection}{\appendixname\Alph{section}}
+\renewcommand\appendix{\par
+\setcounter{section}{0}%
+\setcounter{subsection}{0}%
+\gdef\thesection{\appendixname\@Alph\c@section}}
+% \end{macrocode}
+%
+% \subsection{其它}
+% \label{sec:other}
+%
+% 借用 \cls{ltxdoc} 和 \cls{l3doc} 里面的几个命令方便写文档。
+% \begin{macrocode}
+\DeclareRobustCommand\cs[1]{\texttt{\char`\\#1}}
+\DeclareRobustCommand\file{\nolinkurl}
+\DeclareRobustCommand\env{\textsf}
+\DeclareRobustCommand\pkg{\textsf}
+\DeclareRobustCommand\cls{\textsf}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\sloppy
+%</cls>
+% \end{macrocode}
+%
+%
+% \iffalse
+% \begin{macrocode}
+%<*dtx-style>
+\ProvidesPackage{dtx-style}
+\RequirePackage{hypdoc}
+\RequirePackage{ifthen}
+\RequirePackage{fontspec}[2017/01/20]
+\RequirePackage{amsmath}
+\RequirePackage{unicode-math}
+\RequirePackage[UTF8,scheme=chinese]{ctex}
+\RequirePackage[
+ top=25mm, bottom=25mm,
+ left=40mm, right=20mm,
+ headsep=3mm]{geometry}
+\RequirePackage{hologo}
+\RequirePackage{array,longtable,booktabs}
+\RequirePackage{listings}
+\RequirePackage{fancyhdr}
+\RequirePackage{xcolor}
+\RequirePackage{enumitem}
+\RequirePackage{etoolbox}
+\RequirePackage{metalogo}
+
+\unimathsetup{
+ math-style=ISO,
+ bold-style=ISO,
+}
+
+\DeclareRobustCommand\mathellipsis{\mathinner{\unicodecdots}}
+\IfFontExistsTF{XITSMath-Regular.otf}{
+ \setmathfont[
+ Extension = .otf,
+ BoldFont = XITSMath-Bold,
+ StylisticSet = 8,
+ ]{XITSMath-Regular}
+ \setmathfont[range={cal,bfcal},StylisticSet=1]{XITSMath-Regular.otf}
+}{
+ \setmathfont[
+ Extension = .otf,
+ BoldFont = *bold,
+ StylisticSet = 8,
+ ]{xits-math}
+ \setmathfont[range={cal,bfcal},StylisticSet=1]{xits-math.otf}
+}
+
+\colorlet{hit@macro}{blue!60!black}
+\colorlet{hit@env}{blue!70!black}
+\colorlet{hit@option}{purple}
+\patchcmd{\PrintMacroName}{\MacroFont}{\MacroFont\bfseries\color{hit@macro}}{}{}
+\patchcmd{\PrintDescribeMacro}{\MacroFont}{\MacroFont\bfseries\color{hit@macro}}{}{}
+\patchcmd{\PrintDescribeEnv}{\MacroFont}{\MacroFont\bfseries\color{hit@env}}{}{}
+\patchcmd{\PrintEnvName}{\MacroFont}{\MacroFont\bfseries\color{hit@env}}{}{}
+
+\def\DescribeOption{%
+ \leavevmode\@bsphack\begingroup\MakePrivateLetters%
+ \Describe@Option}
+\def\Describe@Option#1{\endgroup
+ \marginpar{\raggedleft\PrintDescribeOption{#1}}%
+ \hit@special@index{option}{#1}\@esphack\ignorespaces}
+\def\PrintDescribeOption#1{\strut \MacroFont\bfseries\sffamily\color{hit@option} #1\ }
+\def\hit@special@index#1#2{\@bsphack
+ \begingroup
+ \HD@target
+ \let\HDorg@encapchar\encapchar
+ \edef\encapchar usage{%
+ \HDorg@encapchar hdclindex{\the\c@HD@hypercount}{usage}%
+ }%
+ \index{#2\actualchar{\string\ttfamily\space#2}
+ (#1)\encapchar usage}%
+ \index{#1:\levelchar#2\actualchar
+ {\string\ttfamily\space#2}\encapchar usage}%
+ \endgroup
+ \@esphack}
+
+\lstdefinestyle{lstStyleBase}{%
+ basicstyle=\small\ttfamily,
+ aboveskip=\medskipamount,
+ belowskip=\medskipamount,
+ lineskip=0pt,
+ boxpos=c,
+ showlines=false,
+ extendedchars=true,
+ upquote=true,
+ tabsize=2,
+ showtabs=false,
+ showspaces=false,
+ showstringspaces=false,
+ numbers=none,
+ linewidth=\linewidth,
+ xleftmargin=4pt,
+ xrightmargin=0pt,
+ resetmargins=false,
+ breaklines=true,
+ breakatwhitespace=false,
+ breakindent=0pt,
+ breakautoindent=true,
+ columns=flexible,
+ keepspaces=true,
+ gobble=4,
+ framesep=3pt,
+ rulesep=1pt,
+ framerule=1pt,
+ backgroundcolor=\color{gray!5},
+ stringstyle=\color{green!40!black!100},
+ keywordstyle=\bfseries\color{blue!50!black},
+ commentstyle=\slshape\color{black!60}}
+
+\lstdefinestyle{lstStyleShell}{%
+ style=lstStyleBase,
+ frame=l,
+ rulecolor=\color{purple},
+ language=bash}
+
+\lstdefinestyle{lstStyleLaTeX}{%
+ style=lstStyleBase,
+ frame=l,
+ rulecolor=\color{violet},
+ language=[LaTeX]TeX}
+
+\lstnewenvironment{latex}{\lstset{style=lstStyleLaTeX}}{}
+\lstnewenvironment{shell}{\lstset{style=lstStyleShell}}{}
+
+\setlist{nosep}
+
+\DeclareDocumentCommand{\option}{m}{\textsf{#1}}
+\DeclareDocumentCommand{\env}{m}{\texttt{#1}}
+\DeclareDocumentCommand{\pkg}{s m}{%
+ \textsf{#2}\IfBooleanF#1{\hit@special@index{package}{#2}}}
+\DeclareDocumentCommand{\cls}{s m}{%
+ \textsf{#2}\IfBooleanF#1{\hit@special@index{package}{#2}}}
+\DeclareDocumentCommand{\file}{s m}{%
+ \nolinkurl{#2}\IfBooleanF#1{\hit@special@index{file}{#2}}}
+\newcommand{\myentry}[1]{%
+ \marginpar{\raggedleft\color{purple}\bfseries\strut #1}}
+\newcommand{\note}[2][Note]{{%
+ \color{magenta}{\bfseries #1}\emph{#2}}}
+
+\DeclareDocumentCommand{\githubuser}{m}{\href{https://github.com/#1}{@#1}}
+
+\def\thuthesis{\textsc{Thu}\-\textsc{Thesis}}
+\def\hitreport{\textsc{Hit}\-\textsc{Report}}
+\def\hithesis{\textsc{hi}\-\textsc{Thesis}}
+%</dtx-style>
+% \end{macrocode}
+% \fi
+%
+% \Finale
+%
+\endinput
+% \iffalse
+% Local Variables:
+% mode: doctex
+% TeX-master: t
+% End:
+% \fi
diff --git a/macros/latex/contrib/hitreport/hitreport.ins b/macros/latex/contrib/hitreport/hitreport.ins
new file mode 100644
index 0000000000..a416f9cfbc
--- /dev/null
+++ b/macros/latex/contrib/hitreport/hitreport.ins
@@ -0,0 +1,54 @@
+%%
+%% Copyright (C) 2021 by Xiao Sun <demerzelsun@gmail.com>
+%%
+%% This file 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.3c or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `maintained'.
+
+\input docstrip
+\keepsilent
+
+\usedir{tex/latex/hitreport}
+
+\preamble
+
+This is a generated file.
+
+Copyright (C) 2021 by Xiao Sun <demerzelsun@gmail.com>
+
+This file 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.3c or later is part of all distributions of LaTeX
+version 2005/12/01 or later.
+
+\endpreamble
+\askforoverwritefalse
+\generate{\file{\jobname.cls}{\from{\jobname.dtx}{cls}}
+ \file{dtx-style.sty}{\from{\jobname.dtx}{dtx-style}}
+ }
+
+\obeyspaces
+\Msg{*************************************************************}
+\Msg{* *}
+\Msg{* To finish the installation you have to move the following *}
+\Msg{* files into a directory searched by TeX: *}
+\Msg{* *}
+\Msg{* hitreport.cls *}
+\Msg{* *}
+\Msg{* To produce the documentation run the file hitreport.dtx *}
+\Msg{* through LaTeX. *}
+\Msg{* *}
+\Msg{* Happy TeXing! *}
+\Msg{* *}
+\Msg{*************************************************************}
+
+\endbatchfile \ No newline at end of file
diff --git a/macros/latex/contrib/hitreport/hitreport.pdf b/macros/latex/contrib/hitreport/hitreport.pdf
new file mode 100644
index 0000000000..2abe53c09f
--- /dev/null
+++ b/macros/latex/contrib/hitreport/hitreport.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/hitsetup.tex b/macros/latex/contrib/hitreport/hitsetup.tex
new file mode 100644
index 0000000000..518c978e68
--- /dev/null
+++ b/macros/latex/contrib/hitreport/hitsetup.tex
@@ -0,0 +1,109 @@
+% !TeX root = ./hitreport-example.tex
+
+% 基本信息配置
+
+\hitsetup{
+ %******************************
+ % 注意:
+ % 1. 配置里面不要出现空行
+ % 2. 不需要的配置信息可以删除
+ % 3. 建议先阅读文档中所有关于选项的说明
+ %******************************
+ %
+ % 校区选择
+ % 可供选择为harbin, shenzhen, weihai,必须填写
+ campus = {harbin},
+ %
+ % 标题
+ % 可使用“\\”命令手动控制换行
+ %
+ title = {哈尔滨工业大学报告 \LaTeX{} \\ 模板使用示例文档},
+ %
+ % 副标题
+ % 可使用“\\”命令手动控制换行
+ %
+ expand = {实验一},
+ %
+ % 所在学院(部)
+ % 填写所属学院(部)的全名
+ %
+ department = {计算学部},
+ %
+ % 专业
+ % 填写专业名称
+ %
+ discipline = {计算机科学与技术},
+ %
+ % 姓名
+ %
+ author = {孙骁},
+ %
+ % 学号
+ %
+ student-id = {1180310840},
+ %
+ % 指导教师
+ %
+ supervisor = {XX},
+ %
+ % 实验地点
+ % 暂未区分课程报告封面与实验报告封面,课程报告可随意填写
+ %
+ lablocation = {格物207},
+ %
+ % 报告学期
+ %
+ term = {2021春季学期},
+ %
+ % 日期
+ % 使用 ISO 格式;默认为当前时间
+ %
+ % date = {2019-07-07},
+ %
+}
+
+% 载入所需的宏包
+
+% 可以使用 nomencl 生成符号和缩略语说明
+% \usepackage{nomencl}
+% \makenomenclature
+
+% 表格加脚注
+\usepackage{threeparttable}
+
+% 表格中支持跨行
+\usepackage{multirow}
+
+% 固定宽度的表格。
+% \usepackage{tabularx}
+
+% 跨页表格
+\usepackage{longtable}
+
+% 量和单位
+\usepackage{siunitx}
+
+% 定理类环境宏包
+\usepackage{amsthm}
+% 也可以使用 ntheorem
+% \usepackage[amsmath,thmmarks,hyperref]{ntheorem}
+
+% 参考文献使用 BibTeX + natbib 宏包
+% 顺序编码制
+%\usepackage[sort]{natbib}
+%\bibliographystyle{thuthesis-numeric}
+
+% 著者-出版年制
+% \usepackage{natbib}
+
+% 声明 BibLaTeX 的数据库
+% \addbibresource{ref/refs.bib}
+
+% 定义所有的图片文件在 figures 子目录下
+\graphicspath{{figures/}}
+
+% 数学命令
+\newcommand\dif{\mathop{}\!\mathrm{d}} % 微分符号
+
+% hyperref 宏包在最后调用
+\usepackage{hyperref}
diff --git a/macros/latex/contrib/hitreport/latexmkrc b/macros/latex/contrib/hitreport/latexmkrc
new file mode 100644
index 0000000000..17e9557a5e
--- /dev/null
+++ b/macros/latex/contrib/hitreport/latexmkrc
@@ -0,0 +1,18 @@
+# vim: set ft=perl:
+
+$pdf_mode = 5;
+
+$xelatex = "xelatex -shell-escape -file-line-error -halt-on-error -interaction=nonstopmode -no-pdf -synctex=1 %O %S";
+$xdvipdfmx = "xdvipdfmx -q -E -o %D %O %S";
+
+$bibtex_use = 1.5;
+
+$clean_ext = "hd loe ptc run.xml synctex.gz thm xdv";
+
+$makeindex = "makeindex -s gind.ist %O -o %D %S";
+
+add_cus_dep('nlo', 'nls', 0, 'nlo2nls');
+sub nlo2nls {
+ system("makeindex -s nomencl.ist -o \"$_[0].nls\" \"$_[0].nlo\"");
+}
+push @generated_exts, 'nlo', 'nls';
diff --git a/macros/latex/contrib/hitreport/photo/hithrb.pdf b/macros/latex/contrib/hitreport/photo/hithrb.pdf
new file mode 100644
index 0000000000..46d4fc2ece
--- /dev/null
+++ b/macros/latex/contrib/hitreport/photo/hithrb.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/photo/hitsz.pdf b/macros/latex/contrib/hitreport/photo/hitsz.pdf
new file mode 100644
index 0000000000..acea1c82b0
--- /dev/null
+++ b/macros/latex/contrib/hitreport/photo/hitsz.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/photo/hitwh.pdf b/macros/latex/contrib/hitreport/photo/hitwh.pdf
new file mode 100644
index 0000000000..31d9993d8c
--- /dev/null
+++ b/macros/latex/contrib/hitreport/photo/hitwh.pdf
Binary files differ
diff --git a/macros/latex/contrib/hitreport/ref/appendix.bib b/macros/latex/contrib/hitreport/ref/appendix.bib
new file mode 100644
index 0000000000..1e4cc0daef
--- /dev/null
+++ b/macros/latex/contrib/hitreport/ref/appendix.bib
@@ -0,0 +1,14 @@
+@book{abrahams99tex,
+ author = {Paul W. Abrahams and Karl Berry and Kathryn A. Hargreaves},
+ title = {{\TeX} for the Impatient},
+ publisher = {Addison-Wesley},
+ year = 1990,
+}
+
+@incollection{salomon1995advanced,
+ author = {David Salomon},
+ title = {The advanced {\TeX}book},
+ address = {New York},
+ publisher = {Springer},
+ year = 1995,
+}
diff --git a/macros/latex/contrib/hitreport/ref/refs.bib b/macros/latex/contrib/hitreport/ref/refs.bib
new file mode 100644
index 0000000000..4ca6bccded
--- /dev/null
+++ b/macros/latex/contrib/hitreport/ref/refs.bib
@@ -0,0 +1,331 @@
+@article{zhangkun1994,
+ author = {张昆 and 冯立群 and 余昌钰 and others},
+ title = {机器人柔性手腕的球面齿轮设计研究},
+ journal = {清华大学学报: 自然科学版},
+ volume = {34},
+ number = {2},
+ pages = {1--7},
+ year = {1994},
+ key = {zhang1 kun1},
+}
+
+@book{zhukezhen1973,
+ author = {竺可桢},
+ title = {物理学论},
+ address = {北京},
+ publisher = {科学出版社},
+ year = {1973},
+ pages = {56--60},
+ key = {zhu2 ke3 zhen1},
+}
+
+@inproceedings{dupont1974bone,
+ author = {Dupont, B},
+ title = {Bone marrow transplantation in severe combined immunodeficiency with an unrelated MLC compatible donor},
+ editor = {White, H J and Smith, R},
+ booktitle = {Proceedings of the third annual meeting of the International Society for Experimental Hematology},
+ address = {Houston},
+ publisher = {International Society for Experimental Hematology},
+ year = {1974},
+ pages = {44--46},
+}
+
+@mastersthesis{zhengkaiqing1987,
+ author = {郑开青},
+ title = {通讯系统模拟及软件},
+ address = {北京},
+ school = {清华大学无线电系},
+ year = {1987},
+ key = {zheng4 kai1 qing1},
+}
+
+@patent{jiangxizhou1980,
+ author = {姜锡洲},
+ title = {一种温热外敷药制备方案: 中国, 88105607.3},
+ date = {1980-07-26},
+ key = {jiang1 xi1 zhou1},
+}
+
+@standard{jianduju1994,
+ author = {中华人民共和国国家技术监督局},
+ title = {GB3100-3102. 中华人民共和国国家标准-量与单位},
+ address = {北京},
+ publisher = {中国标准出版社},
+ year = {1994},
+ key = {zhong1 hua2 ren2 min2 gong4 he2 guo2},
+}
+
+@article{merkt1995rotational,
+ author = {Merkt, Fr{\'e}d{\'e}ric and Mackenzie, S R and Softley, Timothy P},
+ title = {Rotational Autoionization Dynamics in High Rydberg States of Nitrogen},
+ journal = {J Chem Phys},
+ year = {1995},
+ volume = {103},
+ pages = {4509--4518},
+}
+
+@article{mellinger1996laser,
+ author = {Mellinger, A and Vidal, C R and Jungen, {Ch}},
+ title = {Laser reduced fluorescence study of the carbon monoxide nd triplet Rydberg series - Experimental results and multichannel quantum defect analysis},
+ journal = {J Chem Phys},
+ year = {1996},
+ volume = {104},
+ pages = {8913--8921},
+}
+
+@article{bixon1996dynamics,
+ author = {Bixon, M and Jortner, Joshua},
+ title = {The dynamics of predissociating high {Rydberg} states of {NO}},
+ journal = {J Chem Phys},
+ year = {1996},
+ volume = {105},
+ pages = {1363--1382},
+}
+
+@article{mahui1995,
+ author = {马辉 and 李俭 and 刘耀明 and others},
+ title = {利用 {REMPI} 方法测量 {BaF} 高里德堡系列光谱},
+ journal = {化学物理学报},
+ year = {1995},
+ volume = {8},
+ pages = {308--311},
+ key = {ma3 hui1},
+}
+
+@article{carlson1981two,
+ author = {Carlson, N W and Taylor, A J and Jones, K M and Schawlow, A L},
+ title = {Two-step polarization-labeling spectroscopy of excited states of {Na2}},
+ journal = {Phys Rev A},
+ year = {1981},
+ volume = {24},
+ pages = {822--834},
+}
+
+@article{taylor1983scanning,
+ author = {Taylor, A J and Jones, K M and Schawlow, A L},
+ title = {Scanning pulsed-polarization spectrometer applied to {Na2}},
+ journal = {J Opt Soc Am},
+ year = {1983},
+ volume = {73},
+ pages = {994--998},
+}
+
+@article{taylor1981study,
+ author = {Taylor, A J and Jones, K M and Schawlow, A L},
+ title = {A study of the excited {1$\Sigma$g+} states in {Na2}},
+ journal = {Opt Commun},
+ year = {1981},
+ volume = {39},
+ pages = {47--50},
+}
+
+@article{shimizu1983laser,
+ author = {Shimizu, Kazuko and Shimizu, Fujio},
+ title = {Laser induced fluorescence spectra of the a {3$\Pi$u--X 1$\Sigma$g+} band of {Na2} by molecular beam},
+ journal = {J Chem Phys},
+ year = {1983},
+ volume = {78},
+ pages = {1126--1131},
+}
+
+@article{atkinson1982experimental,
+ author = {Atkinson, J B and Becker, J and Demtr{\"o}der, W},
+ title = {Experimental observation of the a {3$\Pi$u} state of {Na2}},
+ journal = {Chem Phys Lett},
+ year = {1982},
+ volume = {87},
+ pages = {92--97},
+}
+
+@article{kusch1975perturbations,
+ author = {Kusch, P and Hessel, M M},
+ title = {Perturbations in the A {1$\Sigma$u+} state of {Na2}},
+ journal = {J Chem Phys},
+ year = {1975},
+ volume = {63},
+ pages = {4087--4088},
+}
+
+@book{guangxi1993,
+ author = {广西壮族自治区林业厅},
+ title = {广西自然保护区},
+ address = {北京},
+ publisher = {中国林业出版社},
+ year = {1993},
+ key = {guang3 xi1 zhuang4 zu2 zi4 zhi4 qu1},
+}
+
+@book{huosini1989guwu,
+ author = {霍斯尼},
+ title = {谷物科学与工艺学原理},
+ translator = {李庆龙},
+ edition = {2},
+ address = {北京},
+ publisher = {中国食品出版社},
+ year = {1989},
+ pages = {15--20},
+ key = {huo4 si1 ni2},
+}
+
+@book{wangfuzhi1865songlun,
+ author = {王夫之},
+ title = {宋论},
+ edition = {刻本},
+ address = {金陵},
+ publisher = {曾氏},
+ year = {1865(清同治四年)},
+ key = {wang2 fu1 zhi1},
+}
+
+@book{zhaoyaodong1998xinshidai,
+ author = {赵耀东},
+ title = {新时代的工业工程师},
+ address = {台北},
+ publisher = {天下文化出版社},
+ year = {1998},
+ urldate = {1998-09-26},
+ url = {http://www.ie.nthu.edu.tw/info/ie.newie.htm},
+ key = {zhao4 yao4 dong1},
+}
+
+@standard{biaozhunhua2002tushu,
+ author = {全国信息与文献工作标准化技术委员会出版物格式分委员会},
+ title = {GB/T 12450-2001 图书书名页},
+ address = {北京},
+ publisher = {中国标准出版社},
+ year = {2002},
+ pages = {1},
+ key = {quan2 guo2 xin4 xi1},
+}
+
+@book{chubanzhuanye2004,
+ author = {全国出版专业职业资格考试办公室},
+ title = {全国出版专业职业资格考试辅导教材: 出版专业理论与实务•中级},
+ edition = {2014},
+ address = {上海},
+ publisher = {上海辞书出版社},
+ year = {2004},
+ pages = {299--307},
+ key = {quan2 guo2 chu1 ban3 ye4},
+}
+
+@techreport{who1970factors,
+ author = {{World Health Organization}},
+ title = {Factors Regulating the Immune Response: Report of {WHO Scientific Group}},
+ address = {Geneva},
+ publisher = {WHO},
+ year = {1970},
+}
+
+@book{peebles2001probability,
+ author = {Peebles, Jr, Peyton Z.},
+ title = {Probability, Random Variables, and Random Signal Principles},
+ edition = {4},
+ address = {New York},
+ publisher = {McGraw Hill},
+ year = {2001},
+}
+
+@incollection{baishunong1998zhiwu,
+ author = {白书农},
+ title = {植物开花研究},
+ editor = {李承森},
+ booktitle = {植物科学进展},
+ address = {北京},
+ publisher = {高等教育出版社},
+ year = {1998},
+ pages = {146--163},
+ key = {bai2 shu1 nong2},
+}
+
+@incollection{weinstein1974pathogenic,
+ author = {Weinstein, L and Swertz, M N},
+ title = {Pathogenic Properties of Invading Microorganism},
+ editor = {Sodeman, Jr, William A and Sodeman, William A},
+ booktitle = {Pathologic physiology: mechanisms of disease},
+ address = {Philadelphia},
+ publisher = {Saunders},
+ year = {1974},
+ pages = {745--772},
+}
+
+@inproceedings{hanjiren1985lun,
+ author = {韩吉人},
+ title = {论职工教育的特点},
+ editor = {中国职工教育研究会},
+ booktitle = {职工教育研究论文集},
+ address = {北京},
+ publisher = {人民教育出版社},
+ year = {1985},
+ pages = {90--99},
+ key = {han2 ji2 ren2},
+}
+
+@periodical{dizhi1936dizhi,
+ author = {中国地质学会},
+ title = {地质评论},
+ year = {1936},
+ volume = {1},
+ number = {1},
+ address = {北京},
+ publisher = {地质出版社},
+ key = {zhong1 guo2 di4 zhi3 xue2 hui4},
+}
+
+@periodical{tushuguan1957tushuguanxue,
+ author = {中国图书馆学会},
+ title = {图书馆学通讯},
+ year = {1957/1990},
+ number = {1--4},
+ address = {北京},
+ publisher = {北京图书馆},
+ key = {zhong1 guo2 tu2 shu1 guan3 xue2 hui4},
+}
+
+@periodical{aaas1883science,
+ author = {{American Association for the Advancement of Science}},
+ title = {Science},
+ year = {1883},
+ volume = {1},
+ number = {1},
+ address = {Washington, D.C.},
+ publisher = {American Association for the Advancement of Science},
+}
+
+@newspaper{fugang2000fengsha,
+ author = {傅刚 and 赵承 and 李佳路},
+ title = {大风沙过后的思考},
+ journal = {北京青年报},
+ date = {2000-04-12},
+ number = {14},
+ urldate = {2002-03-06},
+ url = {http://www.bjyouth.com.cn/Bqb/20000412/B/4216%5ED0412B1401.htm},
+ key = {fu4 gang1},
+}
+
+@online{xiaoyu2001chubanye,
+ author = {萧钰},
+ title = {出版业信息化迈入快车道},
+ year = {2001},
+ date = {2001-12-19},
+ urldate = {2002-04-15},
+ url = {http://www.creader.com/news/20011219/200112190019.htm},
+ key = {xiao1 yu4},
+}
+
+@online{oclc2000about,
+ author = {{Online Computer Library Center, Inc}},
+ title = {About {OCLC}: History of Cooperation},
+ year = {2000},
+ urldate = {2000-01-08},
+ url = {http://www.oclc.org/about/cooperation.en.htm},
+}
+
+@software{scitor2000project,
+ author = {{Scitor Corporation}},
+ title = {Project scheduler},
+ address = {Sunnyvale, Calif.},
+ publisher = {Scitor Corporation},
+ year = {1983},
+ medium = {DK},
+}