在论文写作过程中,使用 Git 能够帮助我们清晰、可靠地记录每一次修改,使写作迭代过程更加规范、有序。本规范旨在提供一套简单易行、学习成本极低、但仍保持必要约束的 Git 工作流,适用于所有在 LaTeX 或 Markdown 环境下撰写论文的作者。
- 在 VS Code 中撰写 LaTeX
- 根据规范写好 commit 第一行摘要
- 使用 Git Graph 观察整体写作进度
- 在重要阶段添加 tag(Submission-v1, Revision-v1 等)
| % ================================================== | |
| % 智能图片加载系统 (Smart Graphics v2.1) | |
| % ================================================== | |
| % --- 1. 定义极速编译开关 --- | |
| \newif\iffastcompile | |
| % 【控制面板】 | |
| % true = 极速 Draft 模式 (读取真实图片尺寸画框,不渲染像素,极快且布局精准) | |
| % false = 正常发布模式 (渲染真实图片像素) | |
| \fastcompilefalse |
| # PowerShell 脚本:检测和修复工具环境 | |
| # 用途:检测 winget、choco、make、texlive 是否安装,并提供自动修复功能 | |
| # ============================================ | |
| # 配置项:用户可自定义 | |
| # ============================================ | |
| # 指定优先使用的 Make 类型(用于多个 make 安装时的检测) | |
| # 可选值: "GnuWin32", "MinGW", "MSYS2", "Cygwin", "Chocolatey", "Any" | |
| # "Any" 表示使用 PATH 中第一个找到的 make |
| <# | |
| install_latex_for_win.ps1 | |
| 功能: | |
| 1. 自动检查 winget / choco / make / perl | |
| 2. 自动安装 TeX Live Full(无条件 Full) | |
| 3. 若已有 TeX Live,检测是否 full -> 不是 full 则重装 full | |
| 4. 自动选择最快 CTAN 镜像 | |
| 5. 自动清理 MiKTeX / Strawberry Perl 路径污染 | |
| 6. 自动设置 PATH | |
| 7. 错误不中断,全部执行完并最终输出错误总结 |
| # ----------------------------- | |
| # 说明: | |
| # 本脚本用于解释如下命令在做什么: | |
| # iwr -useb "https://gist.githubusercontent.com/Y006/dbecbd8a37cb06006f4cac5e02088835/raw/demo.ps1" | iex | |
| # 要求: | |
| # - 注释使用中文,便于阅读 | |
| # - 所有输出使用英文,避免控制台编码导致的乱码 | |
| # 使用方式: | |
| # 1) 将本文件保存为 demo.ps1,并上传到对应 Gist | |
| # 2) 运行上面的那条一行命令,本脚本会被下载并执行,从而打印解释信息 |
| # =========================================== | |
| # 📄 LaTeX Build Template using latexmk | |
| # ------------------------------------------- | |
| # 用法: | |
| # make <filename> | |
| # 示例: | |
| # make report | |
| # | |
| # 功能: | |
| # ✅ 自动检测 latexmk 安装状态并打印版本 |