{"id":19230100,"url":"https://github.com/changkun/swunthesis","last_synced_at":"2025-02-23T11:15:24.129Z","repository":{"id":96323543,"uuid":"46580732","full_name":"changkun/SWUNThesis","owner":"changkun","description":"LaTeX Thesis Template for Southwest University for Nationalities","archived":false,"fork":false,"pushed_at":"2016-05-09T05:42:27.000Z","size":9324,"stargazers_count":5,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-04T23:17:48.566Z","etag":null,"topics":["ctex","texlive"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/changkun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2015-11-20T18:55:21.000Z","updated_at":"2023-06-05T04:48:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"08ab638d-4c01-4803-b62d-0a25ce12344a","html_url":"https://github.com/changkun/SWUNThesis","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/changkun%2FSWUNThesis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/changkun%2FSWUNThesis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/changkun%2FSWUNThesis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/changkun%2FSWUNThesis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/changkun","download_url":"https://codeload.github.com/changkun/SWUNThesis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240304703,"owners_count":19780313,"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":["ctex","texlive"],"created_at":"2024-11-09T15:36:54.072Z","updated_at":"2025-02-23T11:15:24.074Z","avatar_url":"https://github.com/changkun.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SWUNThesis 是什么？\nSWUNThesis 为 **S**outh**W**est **U**niversity for **N**ationalities **Thesis** LaTeX Template 之缩写。\n\n本宏包旨在建立一个简单易用的西南民族大学学位论文模板，当前仅支持本科学士论文，对其他格式（如科技论文、报告、硕士学位论文等）的支持会陆续加入（可能？）。\n\n使用过程中若遇到任何问题，请按以下顺序提交问题：\n\n1. **[GitHub Issuse](https://github.com/changkun/SWUNThesis/issues)**\n2. **[hi[at]changkun.us](mailto:hi@changkun.us)**。\n\n使用宏包的关键语句为：\n\n```latex\n\\usepackage{template/swunthesis} \n```\n\n文章的整体框架如下，使用示例请参考 [example](./example) 文件夹下的示范。将 template 文件夹、Makefile 与 main.tex 放置于同一目录下，并将正文内容分章节放置于 `content` 目录下即可使用，下方有具体的安装和使用教程。\n\n## 目录说明\n\n* [template](./template) - 此目录下为宏包的全部依赖文件\n* [images](./image) - 此目录下为本项目的图片说明\n* [example](./example) - 此目录下展示了一个完整的论文示例\n* [example-win](./example-win) - 此目录下展示了一个 Windows 平台下的完整的论文示例\n* [README.md](./README.md) - 项目说明\n* [LICENCE](./LICENSE) - 项目使用许可\n\n## 安装、使用教程\n\n### 前置安装\n\n* Windows 用户请安装 [CTeX 完整版](http://www.ctex.org/CTeXDownload)(约1.3G, 推荐) 或 [TeXLive for Windows](https://www.tug.org/texlive/windows.html)\n\n\u003e CTeX WinEdt 编译问题解决方案\n\u003e \n\u003e **Windows 用户注意**：CTEX 版本需要 2.0.2 以上，版本查看方式请在命令行中输入 `texdoc ctex` 。\n\n\u003e * 缺少 qtcore4.dll：[解决方案](https://www.baidu.com/link?url=xaETqZBcpIT6acrKVdN9g5iMWJ3WzBnipIK0JMvyVGYHWenKtpmk5Nw-bGdQRzHfnd2fnhDNFi4t4dCL3Yo2-8yY6Kf1zQtVUgwb2iVXnZS\u0026wd=\u0026eqid=f49127ba0004396b000000035716062d)\n\u003e * 请使用 `xelatex` 编译时提示缺少 `amsmath`，请使用 CTeX 自带的 Package Manager 安装此宏包\n\u003e * 若各种提示 `undefine control sequence` 则请在线更新 `ctex`, `l3kernel`, `l3packages`, `xeCJK`, `csvsimple` 包，将所有宏包更新最佳。\n\n* Linux Ubuntu 用户请使用 TeXLive，在终端中使用： \n\n```bash\nsudo apt-get install texlive-full\n```\n\n即可完成安装。\n\n* Mac 用户请下载 [MacTex](https://www.tug.org/mactex/) 安装包进行安装\n\n### 文档编译方法\n\n**Windwos 用户**：\n\n* CTeX WinEdt 用户先使用 `xelatex` 编译一次 `main.tex` 文件、再使用 `bibtex` 编译一次 `main.tex`、最后再使用 `xelatex` 编译两次 `main.tex` 即完成 `main.pdf` 的全部编译，如下图所示\n\n![](./images/a.png)\n![](./images/b.png)\n![](./images/c.png)\n![](./images/d.png)\n\n* TeXLive 用户可以使用 `latexmk` 并添加 `-xelatex` 参数一次完成对 `main.tex` 的编译。\n\n**Linux(Ubuntu)/Mac 用户**：\n\n* 直接在 `main.tex` 目录下使用：\n\n```bash\nmake clean\nmake \n```\n\n命令进行编译。\n\n## 最佳实践\n\n在 [example](./example) 目录下的文件结构是本人在编写论文过程中对项目进行管理的最佳实践，我个人强烈推荐你使用此示例下的目录结构进行论文管理，结构示例如下：\n\n```\n├── Makefile\n├── README.md  - 如果你希望将论文开源，那么这个文件是有必要的\n├── code\n│   └── main.c\n├── content\n│   ├── abstract.tex\n│   ├── appendix.tex\n│   ├── ch01.tex\n│   ├── ch02.tex\n│   ├── ch03.tex\n│   ├── info.tex\n│   └── thanks.tex\n├── data\n│   └── data.csv\n├── figures\n│   └── pic.jpg\n├── main.pdf\n├── main.tex\n├── references\n│   └── main.bib\n└── template\n    ├── bstutf8.bst\n    ├── logo.jpg\n    ├── swunthesis.sty\n    └── title.jpg\n```\n\n## 样式预览\n\n在线预览：[PDF](./example/main.pdf)\n\n![](./images/1.jpg)\n![](./images/2.jpg)\n![](./images/3.jpg)\n\n*其他说明：本宏包基于 CTEX 进行开发，并不是完全意义上可用于发布的模板宏包，本人水平时间精力有限，如果你希望改进这个项目，可以 fork 或 pull request 来进行贡献。*\n\n## 使用许可\n本项目依照 GNU LGPL 协议授权分发的自由软件, 在使用本项目时，您的可以：\n\n- 任意下载本项目且无需支付任何费用\n- 任意将本项目的副本分发给他人使用\n- 获取和修改本项目的源代码\n\n唯需遵守以下条件:\n- 当您将自己对本项目的修改版(即衍生作品)发布时，衍生作品也必须按照GNU LGPL或更严格的协议发布\n\n**特别声明** 由于 LaTeX 文档的特殊性，使用此宏包构建的文档（即学位论文）不属于 LGPL 协议生效的一部分，即用户无需在文档中包含本宏包的版权声明和引用说明。\n**如果你希望表示对本项目的支持，可以在学位论文末尾的感谢处保留对项目作者的支持和感谢。**\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchangkun%2Fswunthesis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchangkun%2Fswunthesis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchangkun%2Fswunthesis/lists"}