{"id":14577876,"url":"https://github.com/sjtug/SJTUBeamer","last_synced_at":"2025-09-04T12:33:16.763Z","repository":{"id":37001956,"uuid":"359191422","full_name":"sjtug/SJTUBeamer","owner":"sjtug","description":"上海交通大学 Beamer 模版 | Beamer template for Shanghai Jiao Tong University","archived":false,"fork":false,"pushed_at":"2023-12-27T02:50:15.000Z","size":5195,"stargazers_count":538,"open_issues_count":6,"forks_count":60,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-06-06T18:56:27.510Z","etag":null,"topics":["beamer","beamer-template","latex","latex-template","latex-template-beamer","sjtu","tex","xelatex"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sjtug.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2021-04-18T16:07:22.000Z","updated_at":"2024-06-06T16:59:56.000Z","dependencies_parsed_at":"2023-12-02T07:23:03.373Z","dependency_job_id":"eec51f29-7573-4c82-b73a-8fbce2cd7b47","html_url":"https://github.com/sjtug/SJTUBeamer","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sjtug%2FSJTUBeamer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sjtug%2FSJTUBeamer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sjtug%2FSJTUBeamer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sjtug%2FSJTUBeamer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sjtug","download_url":"https://codeload.github.com/sjtug/SJTUBeamer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":218022250,"owners_count":16266473,"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":["beamer","beamer-template","latex","latex-template","latex-template-beamer","sjtu","tex","xelatex"],"created_at":"2024-09-07T17:01:20.896Z","updated_at":"2024-12-31T08:31:22.100Z","avatar_url":"https://github.com/sjtug.png","language":"TeX","funding_links":[],"categories":["Popular \u0026 New LaTeX Templates","TeX"],"sub_categories":["Presentation/Slides"],"readme":"# SJTUBeamer 🤓\n\n[![TeXPage](https://img.shields.io/badge/SJTUBeamer-TeXPage-495A80)](https://www.texpage.com/template/c0decdfd-ca66-4f4a-807d-5217f729dcfa)\n[![Overleaf](https://img.shields.io/badge/SJTUBeamer-Overleaf-098842)](https://www.overleaf.com/latex/templates/sjtubeamer/dgvrnpndrtjh)\n[![discussions](https://img.shields.io/github/discussions/sjtug/SJTUBeamer)](https://github.com/sjtug/SJTUBeamer/discussions)\n[![Build](https://github.com/sjtug/SJTUBeamer/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/sjtug/SJTUBeamer/actions/workflows/build.yml)\n\n欢迎使用 SJTUBeamer! 🥳\n\nSJTUBeamer 是上海交通大学的非官方 Beamer 模版。您可以使用 SJTUBeamer 制作幻灯片，展示您的成果。\n\n这个仓库中包含 SJTUBeamer 所使用的宏包 `sjtubeamer`，以及一个示例文档。\n\n## 快速上手 👋\n\n目前的 `main.tex` 是一个示例文档《如何使用 LaTeX 排版论文》。您可以将里面的内容替换掉。下面是一个最简示例：\n\n\u003cdetails\u003e\n\n\u003csummary\u003e点击展开代码片段\u003c/summary\u003e\n\n```latex\n\\documentclass[\n    % draft,          % 草稿模式\n    aspectratio=169,  % 使用 16:9 比例\n]{ctexbeamer}\n\\mode\u003cpresentation\u003e\n\n\\usetheme[min]{sjtubeamer}\n% 使用 maxplus/max/min 切换标题页样式\n% 使用 red/blue 切换主色调\n% 使用 light/dark 切换亮/暗色模式\n% 使用外样式关键词以获得不同的边栏样式\n%   miniframes infolines  sidebar \n%   default    smoothbars split\t \n%   shadow     tree       smoothtree\n% 使用 topright/bottomright 切换徽标位置\n% 使用逗号分隔列表以同时使用多种选项\n\n% \\tikzexternalize[prefix=build/]\n% 如果您需要缓存 tikz 图像，请取消注释上一行，并在编译选项中添加 -shell-escape。\n\n\\usepackage[backend=biber,style=gb7714-2015]{biblatex}\n\\addbibresource{thesis.bib}\n\n\\institute[SJTUG]{上海交通大学 Linux 用户组} % 组织\n\n\\title{SJTUBeamer 幻灯片模板}         % 标题\n\\subtitle{SJTUBeamer Template}       % 副标题\n\\author{SJTUG}                       % 作者\n\\date{\\today}                        % 日期  \n\n\\begin{document}\n\n\\maketitle                           % 创建标题页\n\n\\part{第一部分}\n\n% 使用节目录\n\\AtBeginSection[]{\n  \\begin{frame}\n    % \\tableofcontents[currentsection,hideallsubsections]  % 传统节目录             \n    \\sectionpage                        % 节页\n  \\end{frame}\n}\n\n\\section{第 1 节}\n\n\\begin{frame}\n  \\frametitle{标题}\n  \\paragraph{列表} 这个\\alert{幻灯片}有下面几项：\n  \\begin{itemize}\n    \\item 第 1 项\n    \\item 第 2 项\n    \\item 第 3 项\n  \\end{itemize}\n\\end{frame}\n\n\\begin{frame}\n  \\frametitle{标题}\n  \\framesubtitle{子标题}\n  \\begin{equation}\n    x^2+2x+1=(x+1)^2\n  \\end{equation}\n\\end{frame}\n\n\\section{第 2 节}\n\\begin{frame}\n  \\frametitle{一些盒子}\n  \\begin{block}{盒子}\n    这是一个盒子\\cite{thelegendofjiang}\n  \\end{block}\n  \\begin{alertblock}{注意}\n    注意内容\n  \\end{alertblock}\n  \\begin{exampleblock}{示例}\n    示例内容\n  \\end{exampleblock}\n\\end{frame}\n\n\\begin{frame}[fragile]          % 注意添加 fragile 标记\n  \\frametitle{代码块}\n  % 代码块参数：语言，标题\n  % 请减少代码初始的缩进\n  \\begin{codeblock}[language=c++]{C++代码}\n#include\u003ciostream\u003e\n\nint main(){\n  // Console Output\n  std::cout \u003c\u003c \"Hello, SJTU!\" \u003c\u003c std::endl;\n  return 0;\n}\n  \\end{codeblock}\n\\end{frame}\n\n\\part{参考文献}\n\\begin{frame}[allowframebreaks]\n  \\printbibliography[heading=none]\n\\end{frame}\n\n\\makebottom       % 创建结束页\n\n\\end{document}\n```\n\n\u003c/details\u003e\n\n## 使用方法 🧰\n\n普通用户只需编辑 `main.tex` 即可开始使用。\n\n### 模版下载与编译\n\n* TeXPage/Overleaf\n  * 直接使用 [TeXPage 模板库链接](https://www.texpage.com/template/c0decdfd-ca66-4f4a-807d-5217f729dcfa)/[Overleaf 模板库链接](https://www.overleaf.com/latex/templates/sjtubeamer/dgvrnpndrtjh)。\n  * 或者手动上传至 TeXPage/Overleaf 使用：\n    * 下载开发版压缩包。页面右上角 Code - Download Zip 即可。\n    * 或下载 [最新版](https://github.com/sjtug/SJTUBeamer/releases) 压缩包，点击 “Source Code (zip)” 即可下载。\n    * 或下载 [最新版](https://github.com/sjtug/SJTUBeamer/releases) 最小依赖压缩包，点击 `sjtubeamer-online.zip` 下载。\n    * 上传至 TeXPage/Overleaf。\n    * TeXPage/Overleaf 的设置中需要选择“XeLaTeX”编译器编译。\n* 本地使用\n  * 安装 TeXLive 套件。\n  * 下载模板至本地：\n    * 使用 git 克隆仓库 `git clone https://github.com/sjtug/SJTUBeamer/` 或 `git clone https://mirror.sjtu.edu.cn/git/SJTUBeamer.git/`。\n    * 或下载开发版压缩包。页面右上角 Code - Download Zip 即可。\n    * 或下载 [最新版](https://github.com/sjtug/SJTUBeamer/releases) 压缩包。点击 “Source Code (zip)” 即可下载。\n  * 之后通过 `latexmk -xelatex main.tex` 命令进行编译即可。\n  * VSCode 用户可以使用 LaTeX Workshop 中的 “Recipe: latexmk (latexmkrc)” 进行编译。\n\n目前模版最新的稳定版是 v3.1.0。您可以在 [发布页](https://github.com/sjtug/SJTUBeamer/releases) 查看修改日志和更多资料。通常来说，SJTUBeamer 的一个稳定版本包括如下内容：\n\n* `sjtubeamerquickstart.pdf`：SJTUBeamer 快速入门，另见对应 [源代码](https://github.com/sjtug/SJTUBeamer/blob/main/src/doc/sjtubeamerquickstart.tex)。\n* `sjtubeamer.pdf`: **强烈推荐在使用前阅读一遍 👍👍👍** SJTUBeamer 用户文档。\n* `sjtubeamerdevguide.pdf`: SJTUBeamer 开发指南。\n* `sjtulib-talk-max-red.pdf`: 示例文档《如何使用 LaTeX 排版论文》的 `max,red` 主题版本。\n* `sjtulib-talk-maxplus-blue.pdf`: 示例文档《如何使用 LaTeX 排版论文》的 `maxplus,blue` 主题版本。\n* `sjtulib-talk-maxplus-red.pdf`: 示例文档《如何使用 LaTeX 排版论文》的 `maxplus,red` 主题版本。\n* `sjtulib-talk-min-red.pdf`: 示例文档《如何使用 LaTeX 排版论文》的 `min,red` 主题版本。\n* `sample-all-covers.pdf`: 所有配色主题的封面封底。\n* `sjtubeamer-ctan.zip`: 包含所有文档和样式的压缩包。\n* `sjtubeamer-online.zip`：包含插件与最小依赖，适合于在线平台使用。\n* SJTUBeamer 源代码。\n\n请使用 Chrome 浏览器或 Adobe Acrobat 打开 SJTUBeamer 用户文档，以避免 PDF 兼容性导致的显示问题。\n\n## 使用反馈与贡献代码 👷\n\n* 文件清单详见 [MANIFEST](src/MANIFEST.md)。\n* 在使用过程中，您可以在 [GitHub Discussions](https://github.com/sjtug/SJTUBeamer/discussions) 讨论区提问任何使用上的问题、交流想法。\n* 在开发过程中，您可以通过 [GitHub Issues](https://github.com/sjtug/SJTUBeamer/issues) 提供 SJTUBeamer 的 Bug 反馈和新功能提案。同时，也欢迎您直接提交 [Pull Request](https://github.com/sjtug/SJTUBeamer/pulls) 代码修改帮助我们改进。\n* 所有对模版的修改应该在 `.dtx` 文件中进行，而后用 l3build 生成 sty 文件。\n* 您可以阅读发布页面中的《SJTUBeamer 开发指南》`sjtubeamerdevguide.pdf` 了解模版的实现细节与编译方法。\n\n整个开发流程如下：\n\n* 修改 `.dtx` 文件。\n* 运行 `make generate` 将生成的 sty 文件拷贝到根目录下。\n* 更新 `main.tex`，运行 `make build` 查看模版修改后的效果。\n* 更新开发文档，运行 `make build-dev` 编译所有开发文档，运行单元测试。\n* （可选）运行 `make format-dev` 格式化所有文件。\n* 发 PR。\n\n新贡献者可以将自己的信息加入 `src/doc/sjtubeamerdevguide.tex` 的 `Developer` 章节。\n\n## 展示 🧐\n\n详细展示见 [样式一览](https://github.com/sjtug/SJTUBeamer/discussions/138)。\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://user-images.githubusercontent.com/61653082/160813366-5c7bd98b-dc3c-43ac-9cf4-1cb375228470.jpg\"\u003e\n  \u003cimg alt=\"Red Cover\" src=\"https://user-images.githubusercontent.com/61653082/160813386-8cb98131-0cae-456b-af1e-cec671e5fc8e.jpg\"\u003e\n\u003c/picture\u003e\n    \n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://user-images.githubusercontent.com/61653082/160813414-9b43c4b3-4e6d-4f51-9c63-ff7a87eafcf7.jpg\"\u003e\n  \u003cimg alt=\"Blue Cover\" src=\"https://user-images.githubusercontent.com/61653082/160813430-1c7647d4-6346-4fd8-b43f-e156b6234b0e.jpg\"\u003e\n\u003c/picture\u003e\n\n## 许可证\n\nSJTUBeamer 仓库同时包含 SJTUBeamer 包和一个示例文档。其中内容的许可证各不相同。您可以阅读各个文件的开头部分，了解该文件所使用的许可证。\n\n* SJTUBeamer 包使用的许可证为 Apache-2.0。\n* SJTUBeamer 示例文档使用 CC-BY-SA 4.0 许可。\n* sjtuvi 和 sjtucover 库及其附属徽标、图片由上海交通大学持有版权。校属各单位及个人以经营为目的使用视觉形象识别系统，须向学校申请使用许可。校外单位及个人未经许可，不得制作或使用载有视觉形象识别系统的物品。您可以在 [vi.sjtu.edu.cn](https://vi.sjtu.edu.cn/index.php/articles/bulletin/16) 阅读许可协议。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsjtug%2FSJTUBeamer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsjtug%2FSJTUBeamer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsjtug%2FSJTUBeamer/lists"}