Scroll down for the English version of README.

hitreport stands for Harbin Institute of Technology Report LaTeX Template.

hitreport是为哈尔滨工业大学一校三区本科生设计的一个免于配置的作业、实验报告模板。希望它可以使你的作业/实验报告不会因形式上的缺陷导致评分的下降。

该文档主要完成了除了主体内容以外的几乎全部工作。同时，通过使用 Github 版本宏包，你还可以更好的管理自己的 LaTeX 文档。

推荐下载发布版模板，里面包括具体使用说明以及示例文档：

• 模板使用说明 (hitreport.pdf)
• 示例文档 (hitreport-example.pdf)

为方便对 LaTeX 不熟悉的用户使用本模板，本模板的发布版也提供预生成的 cls 文件、文档和源码。如需使用稳定版本，请从 CTAN 下载。

下载途径：

• 发布版：
  • CTAN：CTAN发布地址，但是会比Github和Gitee版稍滞后。
  • GitHub Releases：最新版的及时发布途径之一。
  • Gitee Releases：最新版的及时发布途径之二。

通过 TeX 发行版工具（如 tlmgr）自动从 CTAN 更新。

下载发布版的的 zip 包，使用其中的 hitreport.cls 等文件覆盖原有的即可，无须额外操作。

从 GitHub clone 项目源码或者下载源码 zip 包，执行命令（Windows 用户在文件夹空白处按 Shift + 鼠标右键，点击“在此处打开命令行窗口”）：

xetex hitreport.ins

即可得到 hitreport.cls 等模板文件。

请在 Github Issues 上提出问题：

• GitHub Issues

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。

如果你使用时发现任何 bug 或得不到的格式，可以联系我或开 issue。 如果你有更好的作业/报告格式，欢迎添加或联系我帮忙添加。

LaTeX Project Public License, Version 1.3c (LPPL-1.3c).

hitreport stands for Harbin Institute of Technology 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.

Publish versions are recommended. Specific usage documentation and examples can be found in the archive. At present, these documents are only available in Chinese:

• 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：CTAN release address, but it will be slightly behind the Github and Gitee version。
  • GitHub Releases：One of the methods for timely release of the latest version.
  • Gitee Releases：Another method for timely release of the latest version.

Get the most up-to-date published version with your TeX distribution from CTAN.

Download the published zip files, extract hitreport.cls and other files (if needed) and override the existing ones in your report.

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):

xetex hitreport.ins

you'll get hitreport.cls along with other template files.

Please report your issues on Github Issues:

• Github Issues

make [{report|doc|clean|cleanall|distclean}]

• 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.