{"id":13468297,"url":"https://github.com/tuna/thuthesis","last_synced_at":"2025-05-14T06:14:11.744Z","repository":{"id":1644887,"uuid":"2370395","full_name":"tuna/thuthesis","owner":"tuna","description":"LaTeX Thesis Template for Tsinghua University","archived":false,"fork":false,"pushed_at":"2024-09-27T04:32:49.000Z","size":7715,"stargazers_count":4578,"open_issues_count":11,"forks_count":1076,"subscribers_count":88,"default_branch":"master","last_synced_at":"2024-10-29T15:19:58.083Z","etag":null,"topics":["ctan","latex","latex-thesis-template","tex","thuthesis","tsinghua","tsinghua-university"],"latest_commit_sha":null,"homepage":"https://www.ctan.org/pkg/thuthesis","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lppl-1.3c","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tuna.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-09-12T10:20:07.000Z","updated_at":"2024-10-29T07:30:40.000Z","dependencies_parsed_at":"2024-01-13T16:22:56.313Z","dependency_job_id":"682ec1d0-3b9b-4399-a612-00554d35a527","html_url":"https://github.com/tuna/thuthesis","commit_stats":{"total_commits":1188,"total_committers":54,"mean_commits":22.0,"dds":0.6287878787878788,"last_synced_commit":"60661f7d140c192418cc9151b54a6c59a99fae23"},"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuna%2Fthuthesis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuna%2Fthuthesis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuna%2Fthuthesis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuna%2Fthuthesis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tuna","download_url":"https://codeload.github.com/tuna/thuthesis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247949073,"owners_count":21023268,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ctan","latex","latex-thesis-template","tex","thuthesis","tsinghua","tsinghua-university"],"created_at":"2024-07-31T15:01:08.385Z","updated_at":"2025-04-09T00:29:11.061Z","avatar_url":"https://github.com/tuna.png","language":"TeX","funding_links":[],"categories":["TeX","Popular \u0026 New LaTeX Templates","Thesis"],"sub_categories":["Thesis/Dissertation"],"readme":"[![Actions Status](https://github.com/tuna/thuthesis/workflows/Test/badge.svg)](https://github.com/tuna/thuthesis/actions)\n[![GitHub downloads](https://img.shields.io/github/downloads/tuna/thuthesis/total)](https://github.com/tuna/thuthesis/releases)\n[![GitHub commits](https://img.shields.io/github/commits-since/tuna/thuthesis/latest)](https://github.com/tuna/thuthesis/commits/master)\n[![GitHub release](https://img.shields.io/github/v/release/tuna/thuthesis)](https://github.com/tuna/thuthesis/releases/latest)\n[![CTAN](https://img.shields.io/ctan/v/thuthesis)](https://www.ctan.org/pkg/thuthesis)\n\n\n# ThuThesis\n\n\u003e Scroll down for the English version of README.\n\n**ThuThesis** 是 **T**sing**h**ua **U**niversity **Thesis** LaTeX Template 的缩写。\n\n此宏包旨在建立一个简单易用的清华大学学位论文 LaTeX 模板，包括本科综合论文训练、硕士论文、博士论文以及博士后出站报告。\n\n**由于模板升级频繁，在开始使用和提问前，请确保您已经认真完整地阅读了使用说明文档和示例代码。**\n\n## 版权\n\n本项目采用 [LaTeX项目公共许可证 v1.3c](https://www.latex-project.org/lppl/lppl-1-3c/) 授权，任何违反该许可证使用 ThuThesis 的行为将被记录在 [耻辱柱](https://github.com/tuna/thuthesis/issues/754) 页面中，以示警告。\n\n本项目分发的 `thu-fig-logo.pdf` 与 `thu-text-logo.pdf` 为载有清华大学校徽与校名的图形文件，用于制作制作本科生综合论文训练封面。这些图形从 [清华大学视觉形象系统](https://vi.tsinghua.edu.cn/) 获取，除裁剪周边空白外，项目维护者未进行任何其他修改。\n请注意：相关图形与文字都是清华大学的注册商标，除此模板外，请勿用于任何其他用途。\n\n## 下载\n\n推荐下载**发布版**模板，里面包括具体使用说明以及示例文档：\n\n* 模板使用说明（`thuthesis.pdf`）\n* 示例文档（`thuthesis-example.pdf`）\n\n在开始书写前，建议将 `thuthesis-example.tex` 复制或重命名为其他有意义的名称。\n\n### 下载途径\n\n* 发布版：\n  * 仅下载：\n    * [CTAN](https://www.ctan.org/pkg/thuthesis)：可能滞后正式发布少许时间。\n    * [GitHub Releases](https://github.com/tuna/thuthesis/releases)：最新版的及时发布途径。\n    * [TUNA 镜像站](https://mirrors.tuna.tsinghua.edu.cn/github-release/tuna/thuthesis/)：GitHub Releases 的镜像。\n  * 在线编辑：\n    * [TeXPage 模板](https://www.texpage.com/template/72b580ca-51fa-4ecc-82b3-0509bc1d6a07)（提供 Windows 中文字体）\n    * [Overleaf 模板](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) （[Overleaf 降低了免费账户的编译时间](https://www.overleaf.com/blog/changes-to-free-compile-timeouts-and-servers)， 使用本模板的项目会因为规模较大[容易超时](https://github.com/tuna/thuthesis/issues/984)）\n* 开发版：[GitHub](https://github.com/tuna/thuthesis)\n\n### 注意事项\n\n* GitHub 仓库的开发版仅供开发者与需要尚未发布的功能的有经验的 TeX 用户使用，不提供任何保证。\n* **任何在其他途径分发的 ThuThesis（包含其变体或衍生物）均不是官方版本，请谨慎使用。**\n\n## 更新日志\n\n每个版本的详细更新日志，请见 [CHANGELOG.md](CHANGELOG.md)。使用文档中也包含了这一内容。\n\n## 升级\n\n### 自动更新\n\n通过 TeX 发行版工具（如 `tlmgr`）自动从 [CTAN](https://www.ctan.org/pkg/thuthesis) 更新。\n\n### 手动更新\n\n#### 发布版\n\n下载发布版的 zip 包，使用其中的 `thuthesis.cls` 等文件覆盖原有的即可，无须额外操作。\n\n#### 开发版\n\n有两种获得开发版编译结果的方式：\n\n1. 从 GitHub 上对应 commit 的名为 `Test` 的 workflow 中下载 `thuthesis-snapshot-release` 并解压，其中的 `dist` 文件夹包含了编译后的开发版代码。\n2. 从 GitHub clone 项目源码或者下载源码 zip 包，执行 `xetex thuthesis.ins`。\n\n## 提问\n\n按推荐顺序排序：\n\n* 先到 [FAQ](https://github.com/tuna/thuthesis/wiki/FAQ) 看看常见问题；\n* 在 [GitHub Discussions](https://github.com/tuna/thuthesis/discussions) 搜索已有讨论，如果没有则提出新问题；\n* 如果认为模板存在问题，可在 Issues 中使用相应的模板提出。\n* 入门问题可以参考[wiki/新手指南](https://github.com/tuna/thuthesis/wiki/新手指南)学习\n\n## Makefile的用法\n\n```shell\nmake [{thesis|doc|clean|cleanall|distclean}]\n```\n\n### 目标\n* `make thesis`    生成论文 `thuthesis-example.pdf`；\n* `make doc`       生成模板使用说明书 `thuthesis.pdf`；\n* `make clean`     删除示例文件的中间文件（不含 `thuthesis-example.pdf`）；\n* `make cleanall`  删除示例文件的中间文件和 `thuthesis-example.pdf`；\n* `make distclean` 删除示例文件和模板的所有中间文件和 PDF。\n\n---\n\n# ThuThesis\n\n**ThuThesis** is an abbreviation of **T**sing**h**ua **U**niversity **Thesis** LaTeX Template.\n\nThis package establishes a simple and easy-to-use LaTeX template for Tsinghua dissertations, including general undergraduate research papers, masters theses, doctoral dissertations, and postdoctoral reports. An English translation of this README follows the Chinese below.\n\n**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.**\n\n## Copyright\n\nThis project is licensed under the [The LaTeX project public license v1.3c](https://www.latex-project.org/lppl/lppl-1-3c/). Any use of ThuThesis that violates this license will be recorded in the [Hall of Shame](https://github.com/tuna/thuthesis/issues/754).\n\nThe distributed `thu-fig-logo.pdf` and `thu-text-logo.pdf` files in this project contain the graphical emblem and name of Tsinghua University, and are used for creating undergraduate thesis covers only.\nThese graphics were obtained from the [Tsinghua University Visual Identity System](https://vi.tsinghua.edu.cn). No modifications were made by the project maintainers except cropping the white space. \nNote: Both the relevant graphics and text are registered trademarks of Tsinghua University. You must not use them for any other purposes except within this template.\n\n## Downloads\n\n**Published versions** are recommended. Specific usage documentation and examples can be found in the archive. At present, these documents are **only available in Chinese**:\n\n* Template usage documentation (`thuthesis.pdf`)\n* Template example (`thuthesis-example.pdf`)\n\nBefore you start writing, it is recommended to copy or rename `thuthesis-example.tex` to another meaningful name.\n\n### Download Methods\n\n* Published versions:\n  * Download only:\n    * [CTAN](https://www.ctan.org/pkg/thuthesis)\n    * [GitHub Releases](https://github.com/tuna/thuthesis/releases)\n    * [TUNA Mirrors](https://mirrors.tuna.tsinghua.edu.cn/github-release/tuna/thuthesis/): mirror of GitHub Releases\n  * Online editor:\n    * [TeXPage template](https://www.texpage.com/template/72b580ca-51fa-4ecc-82b3-0509bc1d6a07) (providing Chinese fonts of Windows)\n    * [Overleaf template](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) ([free compile time was reduced](https://www.overleaf.com/blog/changes-to-free-compile-timeouts-and-servers); projects using this template will be relatively large, and thus [likely to time-out](https://github.com/tuna/thuthesis/issues/984))\n* Developer versions: [GitHub](https://github.com/tuna/thuthesis)\n\n### Notes\n\n* The development version in the GitHub repository is intended for developers and experienced TeX users who require unreleased features, and no guarantees are provided.\n* **ThuThesis (including its variants / derivatives) distributed in any other way is NOT an official version. Use at your own risk.**\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for detailed changes in each release. They are also included in the usage documentation.\n\n## Updates\n\n### Automatic\n\nGet the most up-to-date published version with your TeX distribution from [CTAN](https://www.ctan.org/pkg/thuthesis).\n\n### Manual\n\n#### Published versions\n\nDownload the published zip files, extract `thuthesis.cls` and other files (if needed) and override the existing ones in your thesis.\n\n#### Development versions\n\nThere are two ways to obtain the compiled development version:\n\n1. Download the `thuthesis-snapshot-release` from the `Test` workflow of the corresponding commit on GitHub and extract it. The `dist` folder contains the compiled template of development version.\n2. Clone the project source code from GitHub or download the source code tarball, and run `xetex thuthesis.ins`.\n\n## Reporting Issues\n\nPlease follow the procedure below:\n\n* Check the [FAQ](https://github.com/tuna/thuthesis/wiki/FAQ).\n* Search [GitHub Discussions](https://github.com/tuna/thuthesis/discussions) and create if not existed.\n* Create an issue (with specified template) if you believe there is a bug.\n* Beginners may go to [wiki/新手指南](https://github.com/tuna/thuthesis/wiki/新手指南) for basic information.\n\n## Makefile Usage\n\n```shell\nmake [{all|thesis|doc|clean|cleanall|distclean}]\n```\n\n### Targets\n* `make thesis`    generate thesis `thuthesis-example.pdf`;\n* `make doc`       generate template documentation thuthesis.pdf;\n* `make clean`     delete all examples' files (excluding thuthesis-example.pdf);\n* `make cleanall`  delete all examples' files and thuthesis-example.pdf;\n* `make distclean` delete all examples' and templates' files and PDFs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuna%2Fthuthesis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftuna%2Fthuthesis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuna%2Fthuthesis/lists"}