tj-csccg/tongji-undergrad-thesis

:page_facing_up: 同济大学本科生毕业设计论文模板 | Tongji University Undergraduate Thesis Template | Overleaf / Mac / Linux / Windows / Workshop / Docker

tongji-undergrad-thesis's Issues

Docs: a new README designed to better guide users

文档不足之处

• 平台相关
  • 在线平台：Overleaf
  • 本地：MacOS / Windows / 各种 Linux 发行版
• 使用过程
  • 模版编译（编译配置、依赖安装等）
  • 最佳实践（LaTeX 基础知识、模版使用教学、工作流等）
• 不，我需要其他文档：_________

对文档的期望

可参考 #30 中提供的组织方式。

MacOS：使用 matrix 测试 XeLaTeX 与 LuaLaTeX

ROADMAP: complete documentation / example

Now, documentation is identical to example. In sections, there is a not-so-standard undergraduate thesis written by ganler.

Complete a brand-new and excellent documentation, teach basic LaTeX writing skills and guide users to features implemented in "tongjithesis".

ROADMAP: solve font and style problem

• "毕业设计模板（理工类）" uses Times New Roman now.
• Template style is still incompleted.

BUG: 摘要和目录的页码问题

使用平台详情

• 线上：Overleaf
• 本地：MacOS
• 本地：Windows
• 本地：各种 Linux 发行版
• 不，我使用的是 _________

问题描述

使用双面打印版本时，由于 \cleardoublepage 不会停止页码的计数，因此摘要和目录下方的罗马数字页码将以 Ⅰ-Ⅲ-Ⅴ 的形式递增。

其他信息

可能的解决方案：使用 \setcounter{page} 设置正确页码。

FEAT: 模版提供双页版本

新增特性类型

• 构建相关（如需要提供新的构建方法，现有构建方式需要迭代重构等）
• 模板功能相关（如需要模板提供其他实用功能，适配新的模板样式等）
• 文档相关（如更好展现该模板使用方法的想法）

特性描述

可能有双页打印的要求。目前的装订线、页眉页脚均不符合双页装订要求。

其他信息

无。

参考文献网页链接过长的情况下会超出右侧页边

使用平台详情

• 线上：Overleaf
• 本地：MacOS
• 本地：Windows
• 本地：各种 Linux 发行版
• 不，我使用的是 _________

问题描述

当引用了有较长链接的网页文件时，参考文献的部分网页链接会超出显示范围。

如：

@misc{tansuoziyoude,
  title = {{年度报告｜自由职业者们的真实生活，也许和你想的不一样..}},
  author = {自由会客厅},
  journal = {微信公众平台},
  urldate = {2024-05-07},
  abstract = {自由职业/副业青年生存现状大揭秘！},
  howpublished = {http://mp.weixin.qq.com/s?\_\_biz=Mzg4NDgyMTgwMg==\&mid=2247567632\&idx=1\&sn=d1ff312b6e45b558b8c716103bb64b1c\&chksm=cfb1d355f8c65a4337ac4b8ce6c62d00fa99fb38801049b12f71486c67c8a58565c707d77a30\#rd},
  langid = {chinese},
}

The font size of Abstract's Title should be 'small two'

Bug：封面编译问题

使用平台详情

• 线上：Overleaf
• 本地：MacOS
• 本地：Windows
• 本地：各种 Linux 发行版
• 不，我使用的是 _________

问题描述

编译封面时，课题名称字数过多，超出下划线无法换行

Windows：使用 matrix 测试 XeLaTeX 与 LuaLaTeX

ROADMAP: build ci for macos / windows

新增特性类型

• 构建相关（如需要提供新的构建方法，现有构建方式需要迭代重构等）
• 模板功能相关（如需要模板提供其他实用功能，适配新的模板样式等）
• 文档相关（如更好展现该模板使用方法的想法）

特性描述

维护者不太可能在每次 commit 前都进行多平台测试，希望通过 GitHub Actions 在 MacOS 与 Windows 上测试。

其他信息

不适用 xu-cheng/latex-action 或 xu-cheng/texlive-action，因为目前 Docker action 仅支持 Linux 平台。

• #16
• #14

CI: Windows CI not passed

使用平台详情

• 线上：Overleaf
• 本地：MacOS
• 本地：Windows
• 本地：各种 Linux 发行版
• 不，我使用的是 _________

问题描述

目前 Windows 的 CI 在 texlive 的安装上出了些问题，进而导致 CI 无法通过。

将ganler / overleaf_tongji_thesis迁移至TJ-CSCCG组织下

Why

• 因为本人即将毕业，之后本模板将失去维护，故想将其挂在一个org下，寻找新的维护人员。
• 本模板显然更适合放到有同济“商标”的组织架构下，而非个人项目；

Call for maintainer:

• 根据反馈（e.g., issue）感谢latex内容；
• 定时上传overleaf（https://www.overleaf.com/latex/templates/tongji-undergrad-thesis/dfdvqsmpfcgk）
  • 请使用tongji-undergrad-thesis作为项目名称；
  • 请点击submit，提交到overleaf gallery，注意模板内的内容不得是具体一个人的毕设，否则管理员会退回；

在拥有maintainer之前&&2021年7月前，@ganler 会在TJ-CSCCG下继续维护该项目。

Call for suggestions

@skyleaworlder
@E011011101001

所以如果你们觉得OK，就:

• 把这个仓库删掉@skyleaworlder：https://github.com/TJ-CSCCG/overleaf_tongji_thesis
• 移交本仓库权限至TJ-CSCCG@ganler

模板功能相关（如需要模板提供其他实用功能，适配新的模板样式等）

Use mactex instead of texlive in order to resolve tlmgr problem on macos

文档不足之处

• 平台相关
  • MacOS Ventura 13.6.3
• 使用过程
  • tlmgr的引入和使用问题：使用brew 安装texlive后，执行sudo tlmgr update --self显示tlmgr: action not allowed in system mode: update，根据 https://tex.stackexchange.com/questions/621211/tlmgr-action-not-allowed-in-system-mode-texlive ，卸载texlive后重新安装mactex后tlmgr更新正常

DOCS: 建立仓库 Wiki 或文档

文档不足之处

• 平台相关
  • 在线平台：Overleaf
  • 本地：MacOS / Windows / 各种 Linux 发行版
• 使用过程
  • 模版编译（编译配置、依赖安装等）
  • 最佳实践（LaTeX 基础知识、模版使用教学、工作流等）
• 不，我需要其他文档：应该将 README 中的部分内容搬迁到 Wiki 当中，或者建立独立的文档。

对文档的期望

• 对于 Wiki，当前的 “字体” 与 “双页设置” 就比较适宜放在 Wiki 中，然后在 README 中可以直接搞个链接过去。
• 对于独立文档，搞个 docs 文件夹或者新搞个类似 “latex-talk” 的仓库？

其他信息

无

ROADMAP: build ci

GitHub Actions recommended.

tongji-undergrad-thesis need a pipeline to test source files.

长标题无法自动换行

使用平台详情

• 线上：Overleaf
• 本地：MacOS
• 本地：Windows
• 本地：各种 Linux 发行版
• 不，我使用的是 _________

问题描述

论文标题和副标题比较长时，不可以自动换行

其他信息

MacOS编译错误：Package minted Error: You must have `pygmentize' installed to use this package

使用平台详情

• 线上：Overleaf
• 本地：MacOS
• 本地：Windows
• 本地：各种 Linux 发行版
• 不，我使用的是 _________

编译日志

报错内容 [点击打开]

tongji-undergrad-thesis/main.tex:21: Package minted Error: You must have `pygmentize' installed to use this package.

文件结构

问题描述

在macos上编译发现的一个问题，参考解决方案：https://tex.stackexchange.com/questions/48018/minted-not-working-on-mac

其他信息