33 | 34 | {{ cell.contributor.name }} 35 | 36 | 37 | {{ cell.contributor.name }} 38 | 39 |
40 |{{ cell.contribution }}
41 |
30 |
31 | 之后，重启电脑，刷新字体缓存，确认编译状况。
32 |
--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "type": "module",
3 | "scripts": {
4 | "dev": "vitepress dev wiki",
5 | "build": "vitepress build wiki",
6 | "preview": "vitepress preview wiki",
7 | "format": "prettier --write --ignore-path .prettierignore .",
8 | "lint:prettier": "prettier --check --ignore-path .prettierignore ."
9 | },
10 | "devDependencies": {
11 | "@css-render/vue3-ssr": "^0.15.14",
12 | "@types/markdown-it": "^14.1.2",
13 | "@types/node": "^22.17.0",
14 | "@typescript-eslint/eslint-plugin": "^8.38.0",
15 | "@typescript-eslint/parser": "^8.38.0",
16 | "eslint": "^9.32.0",
17 | "eslint-config-prettier": "^10.1.8",
18 | "eslint-plugin-vue": "^10.3.0",
19 | "gray-matter": "^4.0.3",
20 | "markdown-it-footnote": "^4.0.0",
21 | "naive-ui": "^2.42.0",
22 | "prettier": "^3.6.2",
23 | "typescript": "^5.8.3",
24 | "vitepress": "1.6.4",
25 | "vue": "^3.5.18"
26 | },
27 | "pnpm": {
28 | "peerDependencyRules": {
29 | "ignoreMissing": [
30 | "@algolia/client-search"
31 | ]
32 | }
33 | }
34 | }
35 |
--------------------------------------------------------------------------------
/wiki/faq/edit-const.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - bithesis
4 | - text
5 | ---
6 |
7 | # 如何更改模板中的字符串？（例：“毕业设计”→“课程报告”，“结论”→“结论与展望”）
8 |
9 |
10 |
11 | 1. 常见修改需求：用选项设置
12 |
13 | 搜索[[texdoc:bithesis]]，找到相关设置，然后编辑`main.tex`，设置`\BITSetup{…}`，例如：
14 |
15 | ```latex
16 | \BITSetup{
17 | const/info/major = {专业名称},
18 | style/headline = {本科生课程报告},
19 | }
20 | ```
21 |
22 | 从 v3.8.4 开始，有些局部常量支持在局部设置：
23 |
24 | ```latex
25 | \begin{conclusion}[title = 结论与展望]
26 | ……
27 | \end{conclusion}
28 | ```
29 |
30 | 2. 不常见修改需求：编辑`bithesis.cls`
31 |
32 | 编辑`bithesis.cls`，替换字符串。
33 |
34 | 不过`*.cls`中有些原始字符串比较复杂，可能搜整词搜不到，必须搜单字或用正则表达式。一些原始字符串的例子如下：
35 |
36 | ```latex
37 | % 整词，最容易搜
38 | {symbols} {主要符号对照表} {Nomenclature},
39 |
40 | % 字间可能混杂空格
41 | {school} {学\qquad 院} {School},
42 |
43 | % 还有更复杂的空格——本科模板为`\quad`，而硕博模板不空格
44 | {figure} {插\__bithesis_label_space: 图} {Illustrations},
45 | ```
46 |
47 | ::: tip 欢迎反馈
48 | 如果你的修改是学院、教务部或答辩老师要求的，比较普遍，欢迎[反馈](https://github.com/BITNP/BIThesis/issues/new)。模板可以更新。
49 | :::
50 |
--------------------------------------------------------------------------------
/wiki/.vitepress/theme/FAQList.vue:
--------------------------------------------------------------------------------
1 |
21 |
22 |
23 |
24 | 全部
25 |
26 | {{ tag }}
27 |
28 |
29 | {{ currentTag }}
30 |-
31 |
- 32 | {{ p.title }} 33 | 34 |
4 |
5 |
6 |
7 | ## 视频相关说明
8 |
9 | - 官方的安装指南：[Installing TeX Live over the Internet](https://www.tug.org/texlive/acquire-netinstall.html)
10 | - 以 Ubuntu 为例子，安装 TeX Live 发行版。
11 |
12 | ```bash
13 | sudo apt install texlive
14 | ```
15 |
16 | - macOS 系统下载使用 [MacTeX 发行版](https://www.tug.org/mactex/)
17 | - [MaxTeX 的下载页面](https://www.tug.org/mactex/mactex-download.html)
18 |
19 | - 使用 Homebrew 包管理的同学，通过 Homebrew Cask 直接安装 MacTeX：
20 |
21 | ```bash
22 | # 加载 Homebrew Cask
23 | brew tap caskroom/cask
24 |
25 | # 利用 Cask 安装 MacTeX
26 | brew cask install mactex
27 | ```
28 |
29 | - 验证 `xelatex` LaTeX 编译器的安装情况：
30 |
31 | ```powershell
32 | xelatex --version
33 | ```
34 |
35 | - 验证 `biber` 参考文献编译器的安装情况：
36 |
37 | ```powershell
38 | biber --version
39 | ```
40 |
41 | - VS Code 编辑器：[Visual Studio Code - Code editing. Redefined.](https://code.visualstudio.com/)
42 |
--------------------------------------------------------------------------------
/wiki/.vitepress/util.ts:
--------------------------------------------------------------------------------
1 | import matter from 'gray-matter'
2 |
3 | export function getTitleFromSrc(src: string): string | undefined {
4 | const lines = matter(src).content.split('\n')
5 |
6 | for (const line of lines) {
7 | // https://github.com/jooy2/vitepress-sidebar/blob/c6102e0d4aa2fa1395ab60af370d43d9b344fe67/lib/helper.ts#L164-L186
8 | if (/^# /.test(line)) {
9 | let title = line.replace(/^# /, '')
10 |
11 | if (/\[(.*)]\(.*\)/.test(title)) {
12 | // Remove hyperlink from h1 if exists
13 | const execValue = /(.*)?\[(.*)]\((.*)\)(.*)?/.exec(title) || ''
14 |
15 | title = execValue.length > 0 ? `${execValue[1] || ''}${execValue[2] || ''}${execValue[4] || ''}` : ''
16 | }
17 |
18 | // Remove certain Markdown format
19 | // https://github.com/jooy2/vitepress-sidebar/blob/c6102e0d4aa2fa1395ab60af370d43d9b344fe67/lib/helper.ts#L88-L94
20 | title = title
21 | .replace(/\*{1,2}([^*]+?)\*{1,2}/g, '$1')
22 | .replace(/_{1,2}([^_]+?)_{1,2}/g, '$1')
23 | .replace(/~{1,2}([^~]+?)~{1,2}/g, '$1')
24 | .replace(/`{1,3}([^`]+?)`{1,3}/g, '“$1”')
25 |
26 | return title
27 | }
28 | }
29 | }
30 |
--------------------------------------------------------------------------------
/wiki/faq/biber-backend.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - meta
4 | - biblatex-gb7714-2015
5 | - bithesis
6 | ---
7 |
8 | # 参考文献空白，BibTeX 报错`I found no \citation commands`（如何换用 biber？）
9 |
10 | ::: tip 应当无此问题
11 | 如果您按照 [📃 编辑器配置与模板编译](../guide/configure-and-compile.md)使用 latexmk、VS Code、TeXstudio 或在线平台，并且没有删除`main.tex`中的魔术注释`% !BIB program = biber`，应当无此问题。
12 |
13 |
14 |
15 | :::
16 |
17 | ## 现象
18 |
19 | 若出现以下所有现象，很可能是此问题。
20 |
21 | - 能生成 PDF，但参考文献
22 | - 正文引用处显示 key 而非编号
23 | - 文末著录列表完全空白
24 |
25 | - BibTeX 报错`I found no \citation commands`
26 |
27 | 
28 |
29 | `main.blg`也有如下内容：
30 |
31 | ```log
32 | This is BibTeX, Version 0.99d (TeX Live 2025)
33 | I found no \citation commands---while reading file main.aux
34 | I found no \bibdata command---while reading file main.aux
35 | I found no \bibstyle command---while reading file main.aux
36 | ```
37 |
38 | ## 应对
39 |
40 | **原因**：模板要求用 biber 程序编译，但实际用了 bibtex 程序。
41 |
42 | **背景原因**：LaTeX 传统上用 BibTeX 排版参考文献，但这种方法对中文支持差。因此，[[pkg:bithesis]]等国内 LaTeX 模板多用[[pkg:biblatex]]，其默认后端是 biber 程序。
43 |
44 | **解决方法**：换用 biber。具体请结合自己的编辑器查询互联网或[人工智能](../guide/ask-computer.md)。
45 |
--------------------------------------------------------------------------------
/wiki/faq/index.md:
--------------------------------------------------------------------------------
1 |
4 |
5 | # 🥑 疑难杂症
6 |
7 | ## 问题目录 {#faq-list}
8 |
9 |
4 |
5 |
6 |
7 | ## 视频相关说明
8 |
9 | ### 安装
10 |
11 | Pandoc 详细的安装说明：[Installing pandoc](https://pandoc.org/installing.html).
12 |
13 | - Windows 上你可以直接在 [Pandoc 的 GitHub Release 页面](https://github.com/jgm/pandoc/releases/latest) 下载 Windows MSI 安装文件手动安装。
14 | - 在 macOS 上你可以使用 Homebrew 包管理工具安装 pandoc：
15 |
16 | ```bash
17 | brew install pandoc
18 | ```
19 |
20 | - 在 Linux 上你可以使用你所用发行版的包管理工具安装 pandoc，比如：
21 |
22 | ```bash
23 | sudo apt install pandoc
24 | ```
25 |
26 | 终端中检测 Pandoc 的安装：
27 |
28 | ```bash
29 | pandoc --version
30 | ```
31 |
32 | ### 使用
33 |
34 | - 朴素格式转化：
35 |
36 | ```bash
37 | # 命令格式如下：
38 | pandoc {LaTeX 文档文件} -o {输出 Word 文档}
39 | # 比如：
40 | pandoc main.tex -o main.docx
41 | ```
42 |
43 | - 含有目标模板 Word 文档的格式转换：
44 |
45 | ```bash
46 | # 命令格式如下：
47 | pandoc {LaTeX 文档文件} --reference-doc={参考模板 Word 文档} -o {输出 Word 文档}
48 | # 比如：
49 | pandoc main.tex --reference-doc=template.docx -o main.docx
50 | ```
51 |
52 | - 含有参考文献文档的格式转换：
53 |
54 | ```bash
55 | pandoc main.tex --bibliography=refs.bib --reference-doc=template.docx -o main.docx
56 | ```
57 |
--------------------------------------------------------------------------------
/wiki/faq/clean.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag: meta
3 | ---
4 |
5 | # 如何清除缓存？
6 |
7 | 编译 LaTeX 时除了生成 PDF，还可能生成`*.aux`等辅助文件和日志。
8 |
9 | 偶尔先前编译有错，缓存了错误的辅助文件，会导致下一次编译异常。这时可清除缓存从最干净的状态重试。当然，清除缓存也能释放硬盘空间，保持文件整洁。
10 |
11 | ::: details “编译异常”的可能现象
12 |
13 | - 之前加了错误代码导致编译失败，现已撤销，但仍无法编译生成 PDF。
14 |
15 | - 更换了编译器或文档类，编译失败。
16 |
17 | - [成果清单编号顺序错乱](./pub-disorder.md)
18 |
19 | :::
20 |
21 | ::: tip 另法
22 | 如果您使用终端，也可直接[运行`latexmk -c`](../guide/commands.md#latexmk-c) 删除。
23 | :::
24 |
25 | ## 使用 VS Code（LaTeX Workshop 插件） {#vscode}
26 |
27 | 主侧栏 → LaTeX → 构建 LaTeX 项目 → 清理辅助文件。
28 |
29 | 
30 |
31 | ::: details 该按钮单击后没有反馈，如何确认成功了？
32 |
33 | 底部面板 → 输出（Ctrl+Shift+U）→ LaTeX Workshop，搜索“clean”。
34 |
35 | :::
36 |
37 | 若找不到按钮，可按F1直接搜索命令 LaTeX Workshop: Clean up auxiliary files，Enter。
38 |
39 | 
40 |
41 | ## 使用 TeXstudio {#texstudio}
42 |
43 | 顶栏 → 工具 → 清理辅助文件，确定。
44 |
45 | 
46 |
47 | 
48 |
49 | ## 使用在线平台
50 |
51 | ### Overleaf
52 |
53 | 重新编译 → 从头开始重新编译。
54 |
55 | 
56 |
57 | ### TeXPage
58 |
59 | 日志 →（最下面）原始日志 → 清空编译缓存，清除缓存。
60 |
61 | 
62 |
63 | ## 手动删除
64 |
65 | 找到`main.tex`所在文件夹，删除与之并列的`main.aux`、`main.bbl`等文件。
66 |
--------------------------------------------------------------------------------
/wiki/faq/weird-font.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - font
4 | - bithesis
5 | ---
6 |
7 | # 字体奇怪：逗号不像宋体、定理环境中汉字倾斜……
8 |
9 |
10 |
11 | 如果您遇到以下任何现象，请参考[如何换用中易字库](./word-font.md)。
12 |
13 | - [逗号不像宋体](https://ask.latexstudio.net/ask/question/8035.html)
14 |
15 | 
16 |
17 | - [[pkg:bithesis]]的`them`定理环境中汉字倾斜
18 |
19 | （正常情况：楷体）
20 |
21 | 
22 |
23 | ::: details 如需确认问题，可加入字体测试表格
24 |
25 | 在文档中加入下面这段，编译，正常效果如图。
26 |
27 | ```latex
28 | \begin{table}[htb]
29 | \linespread{1.5}
30 | \zihao{5}
31 | \centering
32 | \caption{字体效果表格}
33 | \begin{tabular}{@{}lllll@{}}
34 | & Regular & Bold & Italic & Bold Italic \\ \hline
35 | 宋体 & 宋体 & \textbf{宋体粗体} & \textit{楷体} & \textbf{\textit{楷书粗斜体}} \\
36 | 黑体 & {\heiti{}黑体} & \textbf{\heiti{}黑体粗体} & \textit{\heiti{}黑体斜体} & \textit{\textbf{\heiti{}黑体粗斜体}} \\
37 | 楷体 & {\kaishu{}楷书} & \textbf{\kaishu{}楷书粗体} & \textit{\kaishu{}斜体楷体} & \textbf{\textit{\kaishu{}楷书粗斜体}} \\
38 | \end{tabular}
39 | \end{table}
40 | ```
41 |
42 | 
43 |
44 | 如果以上测试不够，还可使用[完整版](https://github.com/BITNP/BIThesis/blob/66c063676db20d7b040777e994f8ab0e8643a033/templates/undergraduate-thesis/chapters/1_chapter1.tex#L83-L107)。
45 |
46 | :::
47 |
--------------------------------------------------------------------------------
/wiki/faq/array-stretch.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - bithesis
4 | - par
5 | ---
6 |
7 | # 如何调整表格行高？
8 |
9 | ## BIThesis（v3.7.8+）
10 |
11 | 请编辑`main.tex`，用`\BITSetup`设置`misc/tabularRowSeparation`选项，例如：
12 |
13 | ```latex
14 | \BITSetup{
15 | misc / tabularRowSeparation = 1.6,
16 | % 设为 1.25 更接近本科 Word 模板实作
17 | % 设为 1.6 更接近硕博 Word 模板实作
18 | }
19 | ```
20 |
21 | 这种方式会影响全文所有表格。若只需调整个别表格，可在正文`\BITSetup`，并用大括号`{}`限制作用范围，例如：
22 |
23 | ```latex {1-2,18}
24 | {
25 | \BITSetup{ misc / tabularRowSeparation = 1.6 }
26 | \begin{table}[htbp]
27 | \centering
28 | \caption{统计表}
29 | \begin{tabular}{ccccc}
30 | \toprule
31 | 项目 & 产量 & 销量 & 产值 & 比重 \\
32 | \midrule
33 | 手机 & 1000 & 10000 & 500 & 50\% \\
34 | 计算机 & 5500 & 5000 & 220 & 22\% \\
35 | 笔记本电脑 & 1100 & 1000 & 280 & 28\% \\
36 | \midrule
37 | 合计 & 17600 & 16000 & 1000 & 100\% \\
38 | \bottomrule
39 | \end{tabular}
40 | \end{table}
41 | }
42 | ```
43 |
44 | ## 一般 LaTeX 文档
45 |
46 | 请参考 [How do I change column or row separation in LaTeX tables? - Overleaf](https://www.overleaf.com/learn/latex/Questions/How_do_I_change_column_or_row_separation_in_LaTeX_tables%3F)，重定义`\arraystretch`：
47 |
48 | ```latex
49 | \renewcommand*{\arraystretch}{1.6}
50 | ```
51 |
52 | 不过这会同时影响表格和矩阵，用于中文并不合适——表格里写方块字，矩阵里写字母，前者行高应大于后者。[[pkg:bithesis]]的`misc/tabularRowSeparation`选项也用`\arraystretch`实现，不过只影响表格，不影响矩阵。
53 |
--------------------------------------------------------------------------------
/wiki/faq/bib-comma.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag: biblatex-gb7714-2015
3 | ---
4 |
5 | # biber 报错`syntax error: found "茂录聦"`
6 |
7 |
8 |
9 | ```log
10 | syntax error: found "茂录聦", expected end of entry ("}" or ")")
11 | ```
12 |
13 | 请检查`*.bib`，应该是有 ASCII 逗号`,`误写成全宽逗号`，`了。
14 |
15 | 以下是报错如此迷惑的原因。
16 |
17 | ## 为何会出现`茂录聦`或`ï¼\x8c`？
18 |
19 | ### 显示日志
20 |
21 | `biber main.bcf`会把日志存到`main.blg`里，这个文件中存的字节是`b'\xc3\xaf\xc2\xbc\xc2\x8c'`，它按 GB 18030 解码是`'茂录聦'`，按UTF-8解码是`'ï¼\x8c'`。因此，有些环境下报错说`found "茂录聦"`，有些则说`found "ï¼\x8c"`。
22 |
23 | ### 生成日志
24 |
25 | 那么为什么会有`b'\xc3\xaf\xc2\xbc\xc2\x8c'`呢？将全宽逗号`'，'`按UTF-8编码，然后将结果作为Unicode码位再按UTF-8编码，两次编码后即为这串字节。
26 |
27 | ```python
28 | >>> from unicodedata import lookup, name
29 |
30 | >>> '茂录聦'
31 | '茂录聦'
32 |
33 | >>> _.encode('gb18030')
34 | b'\xc3\xaf\xc2\xbc\xc2\x8c'
35 |
36 | >>> bytes(map(ord, _.decode('utf8')))
37 | b'\xef\xbc\x8c'
38 |
39 | >>> _.decode('utf8')
40 | '，'
41 |
42 | >>> name(_)
43 | 'FULLWIDTH COMMA'
44 |
45 | >> '，'
46 | '，'
47 |
48 | >> _.encode('utf8')
49 | b'\xef\xbc\x8c'
50 |
51 | >> ''.join(map(chr, _))
52 | 'ï¼\x8c'
53 | ```
54 |
55 | ### 验证
56 |
57 | 往`*.bib`里写各种乱七八糟东西，发现报错都符合预期。
58 |
59 | ```bibtex
60 | @article{Jiang2005Size,
61 | title = {形状记忆聚合物研究现状与发展},
62 | author = {姜敏 and 彭少贤 and 郦华兴},
63 | journal = {现代塑料加工应用},
64 | volume = {17},
65 | number = {2},
66 | pages = {53-56},
67 | year = {3001}，，©孔乙己äüïabc，，
68 | }
69 | ```
70 |
--------------------------------------------------------------------------------
/wiki/faq/longtable.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag: package
3 | ---
4 |
5 | # 跨页三线表（续表）
6 |
7 |
8 |
9 | 使用[[pkg:longtable]]制作跨页三线表（续表）。
10 |
11 | ::: details 效果截图
12 | 
13 | :::
14 |
15 | ```latex
16 | \usepackage{longtable}
17 | % 此外还需要 booktabs，不过 bithesis 已经引入，不必重复
18 | ```
19 |
20 | ```latex
21 | \begin{longtable}[htbp]{cccc}
22 | \caption{标题} \label{tab:标题} \\
23 | % 👇第一个表头
24 | \toprule
25 | 甲 & 乙 & 丙 & 丁 \\
26 | \midrule
27 | \endfirsthead
28 | % 👇每次跨页后的表头
29 | \multicolumn{4}{l}{续表} \\
30 | \toprule
31 | 甲 & 乙 & 丙 & 丁 \\
32 | \midrule
33 | \endhead
34 | % 👇每次临跨页前的结尾
35 | \midrule
36 | \multicolumn{4}{r}{{续下页}} \\
37 | \endfoot
38 | \bottomrule
39 | \endlastfoot
40 | % 👇表的内容
41 | 1 & 2 & 3 & 4 \\
42 | 1 & 2 & 3 & 4 \\
43 | 1 & 2 & 3 & 4 \\
44 | 1 & 2 & 3 & 4 \\
45 | 1 & 2 & 3 & 4 \\
46 | 1 & 2 & 3 & 4 \\
47 | 1 & 2 & 3 & 4 \\
48 | \end{longtable}
49 | ```
50 |
51 | 相关链接：
52 |
53 | - [CY/T 170—2019《学术出版规范 表格》](https://www.nppa.gov.cn/xxgk/fdzdgknr/hybz/202210/t20221004_445179.html)
54 |
55 | > - 7.4.2 转页接排
56 | > - 7.4.2.1 表格一面排不下时，可采用转页接排的方法处理。
57 | > - 7.4.2.2 转页接排的表格应重复排横表头和关于单位的陈述，并在横表头上方加“表××（续）” 或“续表”字样。
58 | > - 7.4.2.3 前页表格最下端的行线应用细线，转页接排表格的顶线应用粗线。
59 |
60 | - [GB/T 7713.2—2022《学术论文编写规则》](https://lib.tsinghua.edu.cn/wj/GBT7713_2-2022.pdf)
61 |
62 | > - 5.5.5 表格宜紧置于首次提及该表编号的正文之后，先见文字后见表。如果某个表格需要转页接排，则应在随后接排该表的表格上方加“表×（续）”或“续表”字样。续表应重复表头。
63 |
--------------------------------------------------------------------------------
/wiki/faq/bib-cite-author.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - biblatex-gb7714-2015
4 | ---
5 |
6 | # citeauthor 引用作者时，如何始终用“等”而非“et al.”？
7 |
8 | `\citeauthor{…}`命令可带作者引用。默认情况下，它会给中文多人作者加“等”，给非中文多人作者加“et al.”，并且二者前均有空格，如下例所示。
9 |
10 | ```latex
11 | \citeauthor{吴伟仁2017}\cite{吴伟仁2017}和\citeauthor{su2025}\cite{su2025}都研究“嫦娥”任务。
12 | ```
13 |
14 | > 吴伟仁 等[1]和 Su et al.[2]都涉及“嫦娥”任务。
15 |
16 | 若想把“et al.”也改成“等”，请以下两方案之一操作。（两方案都只影响正文引用，不会影响文末著录格式。）
17 |
18 | ::: details 国标基本没有规定
19 |
20 | 对于我们一般采用的顺序编码制，国标没有描述如何引用作者，示例中也无相关情况。
21 |
22 | 对于著者-出版年制，国标 §10.2.2 规定：
23 |
24 | > 正文中引用多著者文献时，对欧美著者只需标注第一个著者的姓，其后附“et al.”；对于中国著者应标注第一著者的姓名，其后附“等”字。姓氏与“et al.”“等”之间留适当空隙。
25 |
26 | [[pkg:biblatex-gb7714-2015]]的默认样式可能是由此外推而来。
27 |
28 | :::
29 |
30 | ## 若想始终用“等”并保留空格
31 |
32 | 请编辑`main.tex`，在导入[[pkg:biblatex]]时设置`gbcitelocal=chinese`。
33 |
34 | ```latex {5}
35 | \usepackage[
36 | backend=biber,
37 | style=gb7714-2015,
38 | gbalign=gb7714-2015,
39 | gbcitelocal=chinese,
40 | …
41 | ]{biblatex}
42 | ```
43 |
44 | > 吴伟仁 等[1]和 Su 等[2]都涉及“嫦娥”任务。
45 |
46 | `gbcitelocal`默认为`gb7714`，会区分中英文；现改为`chinese`，会全部按中文。
47 |
48 | ## 若想始终用“等”并去除空格
49 |
50 | 请编辑`main.tex`，在导言区用以下代码修改本地化字符串。
51 |
52 | ```latex
53 | \DefineBibliographyStrings{english}{
54 | andincite = {和},
55 | andincitecn = {和},
56 | andothersincitecn = {\unspace 等},
57 | andothersincite = {\unspace 等},
58 | }
59 | ```
60 |
61 | > 吴伟仁等[1]和 Su 等[2]都涉及“嫦娥”任务。
62 |
63 | 更新信息请参考[[texdoc:biblatex-gb7714-2015]]。
64 |
--------------------------------------------------------------------------------
/wiki/faq/char-missing.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag: font
3 | ---
4 |
5 | # 生僻字无法显示（例：彧、璟）
6 |
7 |
11 |
12 | - **Windows 平台**预装了中易字库，字符较全，一般正常。
13 |
14 | 如果您那儿确实有问题，请参考下文[另外定义字体](#另外定义字体)。
15 |
16 | - **其它平台**默认用 Fandol 等字库，可能缺字。请优先参考[如何换用中易字库](./word-font.md)。
17 |
18 | ## 另外定义字体
19 |
20 |
21 |
22 | 1. 定义一个包含生僻字的字体`custom-font`，注意要确保你的系统存在[该字体](https://www.ctan.org/tex-archive/fonts/notocjksc)。
23 |
24 | ```latex
25 | \setCJKfamilyfont{custom-font}{Noto Serif CJK SC}
26 | ```
27 |
28 | 2. 使用自己定义的字体
29 |
30 | ```latex
31 | 荀{\CJKfamily{custom-font} 彧}不是苟或。
32 | ```
33 |
34 | `\CJKfamily`会切换字体，影响之后所有内容。故另套`{}`来分组，限制其作用范围。
35 |
36 | 更多解释请参考[[texdoc:lshort-zh-cn]]或[[texdoc:ctex]]。
37 |
38 | ::: warning ↕️ 字可能上下错位
39 | 有个别同学反映，自定义字体的字会上下错位。这是因为不同字体的基线没对齐。可以考虑用`\raisebox{<竖直位移>}{<内容>}`等方法微调，或者忽略。
40 | :::
41 |
42 | ## 备用办法
43 |
44 | 万一您非常“幸运”，问题到这里仍未解决，可以再试试以下办法，或者咨询身边朋友。
45 |
46 | - 关闭`\BITSetup`里`style`中的选项`windowsSimSunFakeBold = true`。（删除或修改为`false`）
47 |
48 | - 直接设置[[pkg:ctex]]：
49 |
50 | ```latex
51 | \PassOptionsToClass{fontset=windows}{ctexbook} % [!code ++]
52 | \documentclass[…]{bithesis}
53 | ```
54 |
55 | - 在`\BITSetup{…}`之后再次设置字体：
56 |
57 | ```latex
58 | \setCJKmainfont{SimSun}[ItalicFont=KaiTi, AutoFakeBold]
59 | ```
60 |
--------------------------------------------------------------------------------
/wiki/.vitepress/theme/news.data.ts:
--------------------------------------------------------------------------------
1 | /**
2 | * News posts, to be used at runtime.
3 | */
4 |
5 | import { createContentLoader } from 'vitepress'
6 |
7 | export interface NewsPost {
8 | /** @example `"−∞ 至2020年10月"` */
9 | period: string
10 | /** @example `"/news/2020"` */
11 | url: string
12 | /**
13 | * 按时间倒序排列。
14 | * @example `["[1.2.0-beta-3] - 2020-06-01", "[1.1.0] - 2020-05-19"]
15 | */
16 | releases: string[]
17 | }
18 |
19 | declare const data: NewsPost[]
20 | export { data }
21 |
22 | export default createContentLoader('news/*.md', {
23 | includeSrc: true,
24 | transform(raw): NewsPost[] {
25 | return raw
26 | .filter(({ url }) => url !== '/news/') // Ignore `index.md`
27 | .map(({ url, src }) => parse(url, src as string))
28 | .sort((a, b) => b.url.localeCompare(a.url)) // 按时间倒序排列
29 | },
30 | })
31 |
32 | function parse(url: string, src: string): NewsPost {
33 | const lines = src.split('\n')
34 |
35 | const period = lines.find((l) => /^# 更新说明：/.test(l))?.replace('# 更新说明：', '')
36 | if (!period) {
37 | console.warn(`未能从 ${url} 中提取一级标题，将用 URL 替代`)
38 | }
39 |
40 | const releases = lines
41 | .filter((l) => /^## /.test(l))
42 | ?.map((line) => {
43 | const release = /^## (.+?)(?:\{.+\})?$/.exec(line.trim())?.at(1)?.trim()
44 | if (!release) {
45 | console.warn(`未能从 ${url} 中提取二级标题，将跳过：“${line}”`)
46 | }
47 | return release
48 | })
49 | .filter((r) => r !== undefined)
50 |
51 | return { period: period ?? url, url, releases }
52 | }
53 |
--------------------------------------------------------------------------------
/wiki/faq/biber-perl-cache.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - meta
4 | - biblatex-gb7714-2015
5 | ---
6 |
7 | # 参考文献空白，biber 报错`Can't call method "binmode"`
8 |
9 | ## 现象
10 |
11 | 若出现以下所有现象，才可能是此问题。
12 |
13 | - 能生成 PDF，但参考文献
14 | - 正文引用处显示 key 而非编号
15 | - 文末著录列表完全空白
16 |
17 | - biber 报错：
18 |
19 | ```log
20 | Can't call method "binmode" on an undefined value at C:\Users\中文名\AppData\Local\Temp\par-b2dcbae8eeda\cache-8f3580e5758dcf9e518781a55b95cc7413268871\inc\lib/Biber/Utils.pm line 114.
21 | ```
22 |
23 | - 即使注释掉`main.tex`中所有章节和`*.bib`大部分项目，只保留单个`\cite`，也仍如此
24 |
25 | ## 应对
26 |
27 | **原因**：Windows 用户名有 ASCII 以外的汉字，导致 biber 无法读取缓存。
28 |
29 | **背景原因**：biber 是个 perl 程序，perl 缓存在`$env:TEMP`里，`$env:TEMP`默认在用户目录下。
30 |
31 | **解决方法**：（任选其一）
32 |
33 | - 给 biber 加`-winunicode`选项，修改解码方式。
34 |
35 | ::: details TeXstudio 设置方法
36 |
37 | （顶栏）选项 → 设置 TeXstudio → 命令 → Biber，从`biber.exe %`改成`biber.exe -winunicode %`。
38 |
39 | 
40 |
41 | :::
42 |
43 | - 修改用户名（记得先备份），或者换其它设备或在线平台。
44 |
45 | - 每次使用时在 PowerShell 里设置 `$env:TEMP`到一个纯 ASCII 路径，然后从 shell 里启动 TeXstudio 等编辑器或手动用 latexmk 编译。
46 |
47 | ::: warning 谨慎操作
48 | 如果您头一次听说 shell，建议寻求有经验者帮助。
49 | :::
50 |
51 | ::: tip 本问答主要整理于2025年5月
52 |
53 | 此问题[从 Windows 10 1803 开始出现](https://github.com/plk/biber/issues/369)，以上解决方法针对 biber 2.20（2024年3月发布）测试过。
54 |
55 | [2024年10月 biber 改进了解码方式](https://github.com/plk/biber/commit/c8017572331ac55e6ab74553b291a57b1c60efd6)，[2025年7月发布的 biber 2.21](https://github.com/plk/biber/releases/tag/v2.21)可能已修复这个问题。
56 |
57 | :::
58 |
--------------------------------------------------------------------------------
/wiki/assets/word-font-ctex-fontset-windows.def:
--------------------------------------------------------------------------------
1 | %% Modified from `texmf-dist/tex/latex/ctex/fontset/ctex-fontset-windows.def'.
2 | %% The LaTeX Project Public License 1.3c
3 |
4 | \GetIdInfo$Id: ctex.dtx 13a2256 2022-07-14 18:54:09 +0800 Qing Lee
4 |
5 |
6 |
7 | ## 视频相关说明
8 |
9 | ### 初步配置
10 |
11 | - 本项目的 [GitHub Release 页面](https://github.com/BITNP/BIThesis/releases/)
12 | - [BIThesis 项目首页](https://github.com/BITNP/BIThesis)
13 | - 个人信息的定义位于 `main.tex` 的 [此处](https://github.com/BITNP/BIThesis/blob/main/templates/undergraduate-thesis/main.tex#L63-L70)
14 | - `\deptName`：你所在学院
15 | - `\majorName`：你所就读的专业
16 | - `\yourName`：你的姓名
17 | - `\yourStudentID`：你的学号
18 | - `\mentorName`：你的指导教师
19 | - 章节文件的相对路径引用：
20 |
21 | ```latex
22 | % 第一章
23 | \input {chapters/1_chapter1.tex}
24 | % 在这里添加第二章、第三章……TeX 文件的引用
25 | \input {chapters/2_chapter2.tex}
26 | \input {chapters/3_chapter3.tex}
27 | ```
28 |
29 | 之后，你可以分别在每个章节独立的 TeX 文件中撰写每一章节的内容。
30 |
31 | ### 后续模块
32 |
33 | 在正文之后，我们的论文还剩下：结论、参考文献、附录与致谢这四个模块。它们依次位于：
34 |
35 | :::vue
36 | .
37 | ├── Conclusion 结论：`misc/3_conclusion.tex`
38 | ├── Reference 参考文献：`misc/4_reference.tex`
39 | ├── Appendix 附录：`misc/5_appendix.tex`
40 | └── Acknowledgements 致谢：`misc/6_acknowledgements.tex`
41 | :::
42 |
43 | 复制得到的参考文献 BibTeX 类似：
44 |
45 | ```bibtex
46 | @inproceedings {szegedy2016rethinking,
47 | title={Rethinking the inception architecture for computer vision},
48 | author={Szegedy, Christian and Vanhoucke, Vincent and Ioffe, Sergey and Shlens, Jon and Wojna, Zbigniew},
49 | booktitle={Proceedings of the IEEE conference on computer vision and pattern recognition},
50 | pages={2818--2826},
51 | year={2016}
52 | }
53 | ```
54 |
55 | - 引用这一标签为 `szegedy2016rethinking` 的参考文献：
56 |
57 | ```latex
58 | 正文，正文正文 \cite{szegedy2016rethinking} 正文正文……
59 | ```
60 |
--------------------------------------------------------------------------------
/wiki/.vitepress/sitemap_page.ts:
--------------------------------------------------------------------------------
1 | import { readFile, writeFile } from 'node:fs/promises'
2 | import path from 'node:path'
3 |
4 | import type { SiteConfig } from 'vitepress'
5 |
6 | import { getTitleFromSrc } from './util'
7 |
8 | /**
9 | * 生成网站地图
10 | *
11 | * 注意是单独页面，并非`sitemap.xml`。用于给智能体导入知识库。
12 | *
13 | * 参考 [VitePress 的`src/node/build/generateSitemap.ts`](https://github.com/vuejs/vitepress/blob/26cb685adf54f07fe3e9fd7bfd49a0ff79956923/src/node/build/generateSitemap.ts)。
14 | */
15 | export async function generate_sitemap_page(site: SiteConfig) {
16 | const pages = site.pages.map((page) => ({
17 | file: path.join(site.srcDir, page),
18 | url: (site.rewrites.map[page] ?? page)
19 | .replace(/(^|\/)index\.md$/, '$1')
20 | .replace(/\.md$/, site.cleanUrls ? '' : '.html'),
21 | }))
22 |
23 | const links = await Promise.all(
24 | pages.map(async ({ file, url }) => {
25 | const src = await readFile(file, 'utf-8')
26 | // url 也可能空，例如`/index.md`
27 | const title = getTitleFromSrc(src) ?? (url || '首页')
28 | return { url, title }
29 | })
30 | )
31 | links.sort(
32 | (a, b) =>
33 | by_category(a, b, (x) => x.url === '') ??
34 | by_category(a, b, (x) => x.url.startsWith('guide/')) ??
35 | a.url.localeCompare(b.url)
36 | )
37 |
38 | await writeFile(
39 | path.join(site.outDir, 'sitemap.html'),
40 | [
41 | '- ',
42 | ...links.map(({ url, title }) => `
- ${title} `), 43 | '
24 |
25 | ![]()
32 |
42 |
43 |
44 |
45 |
71 |
--------------------------------------------------------------------------------
/wiki/video/intro.md:
--------------------------------------------------------------------------------
1 | # BIThesis 系列视频教程
43 |
44 |
45 |
--------------------------------------------------------------------------------
/wiki/faq/bib-sort.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - pub
4 | - bithesis
5 | - biblatex-gb7714-2015
6 | ---
7 |
8 | # 怎么调整「攻读学位期间发表论文与研究成果清单」的顺序
9 |
10 | > （十二）攻读学位期间发表的论文与研究成果清单
11 | >
12 | > 应列出攻读学位期间发表的与学位论文内容相关的学术论文和研究成果，**按发表的时间顺序列出**，研究成果可以是在学期间参加的研究项目、获得专利、获奖情况等。
13 |
14 | 学校要求「攻读学位期间发表论文与研究成果清单」中的论文按发表时间排序，但实际可能有别的需求，想自定义排序。
15 |
16 | `\BITSetup{…}`的`publications/sorting`选项用于控制是否按照发表时间排序。您大致有以下三种选择。
17 |
18 | - [完全按发表时间排序](#true)——保留默认的`true`即可。
19 | - [完全手动指定顺序](#false)——修改为`false`。
20 | - [在发表时间顺序上微调，把个别的提到最前](#sortkey)——保留默认的`true`，同时使用`sortkey`字段。
21 |
22 | ## 完全按发表时间排序（默认）{#true}
23 |
24 | 保留默认的`true`即可。（严格来说，这是按年份、姓名、标题排序。）
25 |
26 | ## 完全手动指定顺序 {#false}
27 |
28 | 编辑`main.tex`，在`\BITSetup{…}`中将`publications/sorting`设置为`false`：
29 |
30 | ```latex
31 | \BITSetup{
32 | …,
33 | publications/sorting = {false},
34 | }
35 | ```
36 |
37 | 这样会按照`\addpubs`或`\addpub`引用顺序来排。
38 |
39 | ## 在发表时间顺序上微调，把个别的提到最前 {#sortkey}
40 |
41 |
42 |
43 | [保留默认的`true`](#true)，同时在`reference/pub.bib`文件中给个别项加上`sortkey`字段：
44 |
45 | ```bibtex{6}
46 | @article{myCiteKey2,
47 | title = {交联型与线形水性聚氨酯的形状记忆性能比较},
48 | author = {李杰 and 张三 and 罗运军},
49 | author+an = {2:myself="\Author[][][共同二作]"},
50 | date = {2007},
51 | sortkey = {002},
52 | }
53 | ```
54 |
55 | 例如，上面这样可保证它在`sortkey = {001}`那项后面，且在没标`sortkey`的其它项前面。
56 |
57 | 详细解释可参考[[texdoc:biblatex-gb7714-2015]]（中文）或[[texdoc:biblatex]]（英文）。
58 |
59 | ::: details 更全面的例子
60 |
61 | 如果在`reference/pub.bib`中定义以下三项并引用（其它项不指定`sortkey`），那么可以保证`wandering-earth`、`wandering-earth-2`、`three-body`依次出现在清单开头，且其它项在后面按发表时间排序。
62 |
63 | ```bibtex
64 | @misc{wandering-earth, …, sortkey = {1}, …}
65 | @misc{wandering-earth-2, …, sortkey = {2}, …}
66 | @misc{three-body, …, sortkey = {13}, …}
67 | ```
68 |
69 | :::
70 |
71 | ::: info ♻ 有错误？清空缓存重试
72 | 注意，如果编译后编号产生错误，请使用 `latexmk -c` 或手动清空缓存后再编译，参考[如何清除缓存](./clean.md)。
73 | :::
74 |
--------------------------------------------------------------------------------
/wiki/faq/algorithm.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - bithesis
4 | - package
5 | ---
6 |
7 | # 如何排版算法（伪代码）？
8 |
9 | 有以下三种互不兼容的方式。
10 |
11 | ## [[pkg:algorithm2e]]方式（推荐）{#algorithm2e}
12 |
13 | 引入宏包时，要加上选项 `algochapter` 才能按学校要求分章编号，示例如下。
14 |
15 | ```latex
16 | \usepackage[ruled, algochapter]{algorithm2e}
17 | ```
18 |
19 | 使用示例请参考 [Algorithms - Overleaf 文档的 The `algorithm2e` package 一节](https://www.overleaf.com/learn/latex/Algorithms#The_algorithm2e_package)或者 [BIThesis 的测试用例](https://github.com/BITNP/BIThesis/blob/main/tests/algorithm2e/main.tex)，也可直接查询互联网及人工智能。
20 |
21 | ::: tip 📥 报错 file not found？请补装宏包
22 | 如果您之前精简了 TeX Live 安装内容，需要补装宏包：
23 |
24 | ```shell
25 | tlmgr install algorithm2e endfloat ifoddpage tocbibind
26 | ```
27 |
28 | :::
29 |
30 | ## [[pkg:algorithms|algorithm]] + X 方式
31 |
32 | 引入[[pkg:algorithms|algorithm]]时，要加上选项 `chapter` 才能按学校要求分章编号，示例如下。
33 |
34 | ```latex
35 | \usepackage[chapter]{algorithm}
36 | \usepackage{algorithmic} % 也可替换为 algpseudocode 或 algcompatible
37 | ```
38 |
39 | 使用示例请参考 [Algorithms - Overleaf 文档](https://www.overleaf.com/learn/latex/Algorithms)。
40 |
41 | ::: warning 🧓 不推荐
42 | [[pkg:algorithms]]2009年后就未再更新，有些小问题，我们不推荐使用（除非您已有现成代码）。例如，`algorithm`环境按`H`与`h/t/b/p`方式浮动时，算法内部的行距不同；再比如`\IF`等命令设计得不好，LaTeX 源代码难以自动缩进。
43 | :::
44 |
45 | ::: tip 📏 微调下边线宽度
46 |
47 | `algorithm`环境默认采用[[pkg:float]]提供的`ruled`样式，这种样式会在算法内容上下画边线。
48 |
49 | 然而下边线默认会比上边线细，有部分盲评专家建议改粗。如果你想改粗，请在`\usepackage{algorithmic}`之后加上以下代码。
50 |
51 | ```latex
52 | \makeatletter
53 | \patchcmd{\fs@ruled}
54 | {\def\@fs@post{\kern2pt\hrule\relax}}
55 | {\def\@fs@post{\kern2pt\hrule height 0pt depth .8pt\relax}}
56 | {}{}
57 | \makeatother
58 | ```
59 |
60 | 参考：
61 |
62 | - [Tune rule height in ruled float - TeX - LaTeX Stack Exchange](https://tex.stackexchange.com/a/248941/266758)
63 | - [`float.dtx`中的`\newcommand\fs@ruled{…}`](https://mirrors.ctan.org/macros/latex/contrib/float/float.dtx)
64 |
65 | :::
66 |
67 | ## 使用模板提供的 `algo` 环境
68 |
69 | 这是模板“预定义的数学环境”之一，不额外依赖宏包，但功能有限，基本只支持编号。
70 |
--------------------------------------------------------------------------------
/wiki/faq/autoref-name.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - package
4 | - text
5 | - bithesis
6 | ---
7 |
8 | # `\autoref`中文引用名称
9 |
10 |
14 |
15 | [[pkg:hyperref]]提供的`\autoref`可以在交叉引用时自动带上 figure, table, chapter 等名称。
16 |
17 | - `\autoref`是给空格分词的语言准备的，按现在[[pkg:bithesis]]的实现，`\autoref{fig:sth}啊` ⇒ `图 1-1啊`，数字前有空格，数字后没空格。改为`\autoref{fig:sth} 啊`（⇒ `图 1-1 啊`）或再像下面那样定义`\figureautorefname`即可。
18 |
19 | - 在导言区加下面这段可实现`\autoref{ch:whatever}` ⇒ `第2章`等。
20 |
21 | ```latex
22 | \usepackage{hyperref}
23 | % https://bithesis.bitnp.net/faq/autoref-name.html
24 | \def\chapterautorefname~#1\null{第~#1~章\null}
25 | \def\sectionautorefname~#1\null{第~#1~节\null}
26 | \def\subsectionautorefname~#1\null{第~#1~节\null}
27 | % 严格按学校标准：\def\equationautorefname~#1\null{式（#1）\null}
28 | \def\equationautorefname~#1\null{式~(#1)~\null}
29 | ```
30 |
31 | 来源：
32 |
33 | - [hyperref - How to use the command `\autoref` to implement the same effect when use the command `\eqref`? - TeX - LaTeX Stack Exchange](https://tex.stackexchange.com/a/66150/82731)
34 | - [中国科学技术大学 USTC thesis](https://github.com/ustctug/ustcthesis/blob/3900c0d711c01972ccf57fedb14911d1d7dc711b/ustcthesis.cls#L3232-L3250)、[西南交通大学 SWJTU thesis](https://github.com/swjtutug/swjtuthesis/blob/4b2869b8de1ebe87b24028d59a6f2f6751788772/swjtuthesis.dtx#L810-L824)
35 |
36 | ## 已知的问题
37 |
38 | 附录中也有 section，传入的`#1`形如`附录 A`，`\autoref{…}`会变成`第 附录 A 节`。
39 |
40 | 在`\autoref`前重定义`\sectionautorefname`可解决，但那样反而不如直接`\ref{…} ` ⇒ `附录 A `方便。
41 |
42 | ## 相关讨论
43 |
44 | - [如何在宏两侧自动插入CJKecglue · Issue #23 · CTeX-org/forum](https://github.com/CTeX-org/forum/issues/23)
45 | - [`\ref` 中出现数字时，与随后紧跟的汉字之间缺少空格 · Issue #392 · CTeX-org/ctex-kit](https://github.com/CTeX-org/ctex-kit/issues/392)
46 |
47 | ## 题外话
48 |
49 | [Reference Function – Typst Documentation](https://typst.app/docs/reference/model/ref/#parameters-supplement)
50 |
51 | ```typst
52 | #set ref(supplement: it => {
53 | if it.func() == heading {
54 | "Chapter"
55 | } else {
56 | "Thing"
57 | }
58 | })
59 | ```
60 |
--------------------------------------------------------------------------------
/.github/workflows/test.yml:
--------------------------------------------------------------------------------
1 | # This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
2 | # For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
3 |
4 | name: Node.js CI
5 |
6 | on:
7 | push:
8 | branches: ['main']
9 | pull_request:
10 | branches: ['main']
11 |
12 | jobs:
13 | build:
14 | runs-on: ubuntu-latest
15 | steps:
16 | - uses: actions/checkout@v4
17 | - uses: pnpm/action-setup@v4
18 | with:
19 | version: 9
20 | - uses: actions/setup-node@v4
21 | with:
22 | node-version: 20
23 | cache: pnpm
24 | - run: pnpm install
25 | - run: pnpm build
26 | - run: pnpm lint:prettier
27 | - uses: actions/upload-artifact@v4
28 | with:
29 | name: vitepress-dist
30 | path: wiki/.vitepress/dist/
31 |
32 | check-links:
33 | runs-on: ubuntu-latest
34 | needs: build
35 | steps:
36 | - uses: actions/checkout@v4
37 | - name: Restore the cache
38 | uses: actions/cache@v4
39 | with:
40 | path: .lycheecache
41 | key: lychee-${{ github.sha }}
42 | restore-keys: lychee-
43 | - name: Check links in README and other markdown files
44 | uses: lycheeverse/lychee-action@v2
45 | with:
46 | args: >-
47 | --verbose
48 | --no-progress
49 | --config .github/lychee.toml
50 | .
51 | - uses: actions/download-artifact@v4
52 | with:
53 | name: vitepress-dist
54 | path: wiki/.vitepress/dist/
55 | - name: Check links in the website
56 | uses: lycheeverse/lychee-action@v2
57 | with:
58 | # 必须检查构建结果，因为有些链接在 *.md 里没有，如 wiki/.vitepress/theme/link_render.ts
59 | args: >-
60 | --verbose
61 | --no-progress
62 | --config .github/lychee.toml
63 | --root-dir "${{ github.workspace }}/wiki/.vitepress/dist/"
64 | ./wiki/.vitepress/dist/
65 |
--------------------------------------------------------------------------------
/wiki/faq/watermark.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag: bithesis
3 | ---
4 |
5 | # 如何添加“北京理工大学”水印
6 |
7 |
11 |
12 | 计算机学院要求本科毕业设计必须有“北京理工大学”水印，添加方法如下。
13 |
14 | ::: details 效果截图
15 | 
16 | :::
17 |
18 | 1. **下载水印底图`background.pdf`，保存到`images/`目录，并重命名为`background.pdf`**
19 |
20 | 知网毕设系统会导出 Word 和 PDF，二者水印不一样。可任选一种下载：[Word 效果底图](/assets/watermark/background-word.pdf)、[PDF 效果底图](/assets/watermark/background-pdf.pdf)。
21 |
22 | ::: details 两种底图的区别
23 | - 左：Word效果——编辑系统导出的 Word，再导出 PDF 得到。
24 | - 右：PDF效果——直接编辑系统导出的 PDF 得到。
25 |
26 | 
27 |
28 | :::
29 |
30 | 2. **编辑`main.tex`**
31 |
32 | ```latex {1-8,12}
33 | \newcommand\BackgroundPicture{%
34 | \put(0,0){%
35 | \parbox[b][\paperheight]{\paperwidth}{%
36 | \vfill
37 | \centering%
38 | \includegraphics[width=\paperwidth]{images/background.pdf}
39 | \vfill
40 | }}}
41 |
42 | % 文档开始
43 | \begin{document}
44 | \AddToShipoutPicture{\BackgroundPicture}
45 | …
46 | ```
47 |
48 | 如需进一步调整水印透明度，可参考：[graphics - Includegraphics: set image opacity - TeX - LaTeX Stack Exchange](https://tex.stackexchange.com/questions/86500/includegraphics-set-image-opacity)。
49 |
50 | 3. **重新编译**
51 |
52 | ## 另法：直接操作 PDF
53 |
54 | 上述方法重新编译原有LaTeX项目，这种方法直接操作既有的`old.pdf`。
55 |
56 | 1. 同上下载水印底图`background.pdf`
57 |
58 | 2. 保存以下内容为`main.tex`
59 |
60 | ```latex
61 | % !TeX program = xelatex
62 | \documentclass{bithesis} % 需要用 bithesis 修改页面尺寸
63 |
64 | \usepackage{pdfpages}
65 |
66 | \newcommand\BackgroundPicture{%
67 | \put(0,0){%
68 | \parbox[b][\paperheight]{\paperwidth}{%
69 | \vfill
70 | \centering%
71 | \includegraphics[width=\paperwidth]{images/background.pdf}
72 | \vfill
73 | }}}
74 |
75 | \begin{document}
76 |
77 | \AddToShipoutPicture{\BackgroundPicture}
78 | \includepdf[pages=-]{old.pdf}
79 |
80 | \end{document}
81 | ```
82 |
83 | 3. 编译`main.tex`
84 |
--------------------------------------------------------------------------------
/wiki/faq/bib-conference.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag: biblatex-gb7714-2015
3 | ---
4 |
5 | # 引用会议的小技巧（魔改国标）
6 |
7 |
8 |
9 | 以下技巧用于满足一些个性化的引文格式要求。
10 |
11 | ## 仅去除`//`
12 |
13 | 如果仅需去除`//`双斜线，可以在下面新增选项 `gbpunctin=false`：
14 |
15 | ```latex {6}
16 | \usepackage[
17 | backend=biber,
18 | style=gb7714-2015,
19 | gbalign=gb7714-2015,
20 | gbnamefmt=lowercase,
21 | gbpunctin=false,
22 | gbpub=false,
23 | doi=false,
24 | url=false,
25 | eprint=false,
26 | isbn=false,
27 | ]{biblatex}
28 | ```
29 |
30 | 效果如下：
31 |
32 | ```bibtex
33 | @inproceedings{dwarkadasCashmereVLMRemoteMemory1999,
34 | title = {Cashmere-{{VLM}}: {{Remote}} Memory Paging for Software Distributed Shared Memory},
35 | shorttitle = {Cashmere-{{VLM}}},
36 | booktitle = {Proceedings 13th {{International Parallel Processing Symposium}} and 10th {{Symposium}} on {{Parallel}} and {{Distributed Processing}}. {{IPPS}}/{{SPDP}} 1999},
37 | author = {Dwarkadas, S. and Hardavellas, N. and Kontothanassis, L. and Nikhil, R. and Stets, R.},
38 | year = {1999},
39 | month = apr,
40 | pages = {153--159},
41 | doi = {10.1109/IPPS.1999.760451},
42 | }
43 | ```
44 |
45 | > Dwarkadas S, Hardavellas N, Kontothanassis L, et al. Cashmere-VLM: Remote Memory Paging for Software Distributed Shared Memory[C]. Proceedings 13th International Parallel Processing Symposium and 10th Symposium on Parallel and Distributed Processing. IPPS/SPDP 1999. 1999: 153-159.
46 |
47 | ## 去除`//`，同时移动`[C]`
48 |
49 | 国标要求的引用会议论文格式为
50 |
51 | - 贾东琴,柯平.面向数字素养的高校图书馆数字服务体系研究[C]//中国图书馆学会.中国图书馆学会年会论文集:2011年卷. 北京:国家图书馆出版社,2011:45-52.
52 |
53 | 需要满足个性化的引文格式——“作者. 文献名. 会议名[C] 地点. 举办者. 其他信息”，即
54 |
55 | - 贾东琴,柯平.面向数字素养的高校图书馆数字服务体系研究. 中国图书馆学会年会论文集:2011年卷.[C]北京:国家图书馆出版社,2011:45-52.
56 |
57 | 格式的，可以
58 |
59 | - 将`@inproceedings`改为`@proceedings`，
60 | - 然后将`booktitle`的内容挪入`title`标签内，并将`booktitle`删除，即修改题名为`面向数字素养的高校图书馆数字服务体系研究. 中国图书馆学会年会论文集:2011年卷`。
61 |
62 | ## 其它参考
63 |
64 | 还有其他需求可以参考：
65 |
66 | - 浙江大学：[去掉参考文献中的双斜线 · Issue #117 · TheNetAdmin/zjuthesis](https://github.com/TheNetAdmin/zjuthesis/issues/117)
67 | - 上海交通大学：[bibtex中inproceedings条目产生的“//”和\[s.n.\],\[S.l\]的问题 · Issue #337 · sjtug/SJTUThesis](https://github.com/sjtug/SJTUThesis/issues/337)
68 |
--------------------------------------------------------------------------------
/wiki/.vitepress/naive-ui-adapter/theme.ts:
--------------------------------------------------------------------------------
1 | /**
2 | * 接入 Naive UI 并同步主题
3 | * https://www.naiveui.com/zh-CN/os-theme/docs/vitepress
4 | */
5 |
6 | import { setup } from '@css-render/vue3-ssr'
7 | import { darkTheme, lightTheme, NConfigProvider } from 'naive-ui'
8 | import { useData, useRoute } from 'vitepress'
9 | import { defineComponent, reactive, inject, h, watchEffect } from 'vue'
10 |
11 | import Layout from '../theme/Layout.vue'
12 |
13 | const CssRenderStyle = defineComponent({
14 | setup() {
15 | const collect = inject('css-render-collect') as () => any
16 | return {
17 | style: collect(),
18 | }
19 | },
20 | render() {
21 | return h('css-render-style', {
22 | innerHTML: this.style,
23 | })
24 | },
25 | })
26 |
27 | const VitepressPath = defineComponent({
28 | setup() {
29 | const route = useRoute()
30 | return () => {
31 | return h('vitepress-path', null, [route.path])
32 | }
33 | },
34 | })
35 |
36 | const NaiveUIProvider = defineComponent({
37 | // 同步主题
38 | // https://github.com/07akioni/naive-ui-vitepress-demo/issues/2
39 | // https://github.com/tusen-ai/naive-ui/pull/6057
40 | setup() {
41 | const isDark = useData().isDark
42 | const providerProps = reactive({
43 | abstract: true,
44 | inlineThemeDisabled: true,
45 | theme: isDark ? darkTheme : lightTheme, // set on SSR
46 | })
47 |
48 | return {
49 | isDark,
50 | providerProps,
51 | }
52 | },
53 | mounted() {
54 | watchEffect(() => {
55 | // set on client
56 | this.providerProps.theme = this.isDark ? darkTheme : lightTheme
57 | })
58 | },
59 | render() {
60 | return h(NConfigProvider, this.providerProps, {
61 | default: () => [
62 | h(Layout, null, { default: this.$slots.default?.() }),
63 | // @ts-ignore 没有识别 vite 的`import.meta.env`
64 | import.meta.env.SSR ? [h(CssRenderStyle), h(VitepressPath)] : null,
65 | ],
66 | })
67 | },
68 | })
69 | export { NaiveUIProvider as Layout }
70 |
71 | export function enhanceApp({ app }) {
72 | // @ts-ignore 没有识别 vite 的`import.meta.env`
73 | if (import.meta.env.SSR) {
74 | const { collect } = setup(app)
75 | app.provide('css-render-collect', collect)
76 | }
77 | }
78 |
--------------------------------------------------------------------------------
/wiki/.vitepress/theme/custom.css:
--------------------------------------------------------------------------------
1 | :root {
2 | --bithesis-green: 0, 153, 68;
3 | --vp-c-brand: rgb(var(--bithesis-green));
4 |
5 | --vp-custom-block-tip-text: var(--vp-c-brand);
6 | --vp-custom-block-tip-border: rgba(var(--bithesis-green), 0.25);
7 | --vp-custom-block-tip-bg: rgba(var(--bithesis-green), 0.05);
8 |
9 | --vp-button-brand-border: var(--vp-c-brand);
10 | --vp-button-brand-bg: rgba(var(--bithesis-green), 0.9);
11 | }
12 |
13 | #embed-video {
14 | position: relative;
15 | padding-top: 66%;
16 | margin-top: 16px;
17 | margin-bottom: 16px;
18 | }
19 |
20 | #embed-video > iframe {
21 | position: absolute;
22 | top: 0;
23 | left: 0;
24 | width: 100%;
25 | height: 100%;
26 | }
27 |
28 | img[src^='https://img.shields.io/badge/'],
29 | img.icon {
30 | display: inline;
31 | vertical-align: middle;
32 | }
33 | .dark img.icon {
34 | filter: invert();
35 | }
36 |
37 | .vp-doc :is(.vp-external-link-icon, .vp-doc a[href*="://"], .vp-doc a[target="_blank"]):not(:is(.no-icon, svg a, :has(img, svg)))::after
38 | {
39 | /* 默认图标用于方块字很怪，换成 https://primer.style/octicons/icon/link-external-16/ */
40 | --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' width='16' height='16'%3E%3Cpath d='M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z'%3E%3C/path%3E%3C/svg%3E");
41 | margin: 2px;
42 | width: 16px;
43 | height: 16px;
44 | vertical-align: middle;
45 | }
46 |
47 | .tag-row {
48 | padding: 1em 0;
49 |
50 | font-size: 0.8em;
51 |
52 | display: flex;
53 | flex-wrap: wrap;
54 | gap: 0.5em;
55 |
56 | a {
57 | display: inline-block;
58 |
59 | padding: 0.125em 0.75em;
60 | border-radius: 2em;
61 |
62 | text-decoration: none;
63 | color: var(--vp-c-brand);
64 | background-color: var(--vp-custom-block-tip-border);
65 | }
66 | }
67 |
68 | a.wikitext-ish-link > code.pkg {
69 | --vp-code-bg: none;
70 | --vp-custom-block-details-code-bg: none;
71 | padding: 0 0.25em;
72 | }
73 |
74 | .vp-doc a {
75 | text-decoration: none;
76 | }
77 |
78 | .vp-doc a:hover {
79 | text-decoration: underline;
80 | }
81 |
--------------------------------------------------------------------------------
/wiki/.vitepress/theme/link_render.ts:
--------------------------------------------------------------------------------
1 | import MarkdownIt from 'markdown-it'
2 |
3 | type ParsingResult = {
4 | url: string
5 | innerMarkdown: string
6 | }
7 |
8 | function parse(raw: string): ParsingResult {
9 | let [url, inner] = raw.split('|')
10 |
11 | if (url.startsWith('pkg:')) {
12 | const pkg = url.replace(/^pkg:/, '')
13 | url = `https://www.ctan.org/pkg/${pkg}`
14 | inner = '`' + (inner ?? pkg) + '`{.pkg}宏包'
15 | }
16 |
17 | if (url.startsWith('texdoc:')) {
18 | const pkg = url.replace(/^texdoc:/, '')
19 | url = `https://texdoc.org/pkg/${pkg}`
20 | inner ??= '`' + pkg + '`{.pkg}手册'
21 | }
22 |
23 | inner ??= url
24 |
25 | return { url, innerMarkdown: inner }
26 | }
27 |
28 | /**
29 | * Wikitext-ish links
30 | *
31 | * # Examples
32 | * - `[[pkg:bithesis]]` ⇒ [`bithesis`宏包](https://www.ctan.org/pkg/bithesis)
33 | * - `[[pkg:algorithms|algorithmic]]` ⇒ [`algorithmic`宏包](https://www.ctan.org/pkg/algorithms)
34 | * - `[[texdoc:unicode-math]]` ⇒ [`unicode-math`手册](https://texdoc.org/pkg/unicode-math)
35 | * - ``[[texdoc:lshort-zh-cn|那份介绍（`lshort`中文版）]]`` ⇒ [那份介绍（`lshort`中文版）](https://texdoc.org/pkg/lshort-zh-cn)
36 | */
37 | export default function LinkRender(md: MarkdownIt) {
38 | md.inline.ruler.before('link', 'wikitext-ish-link', function (state, silent) {
39 | const max = state.posMax
40 | const start = state.pos
41 |
42 | if (state.src.charCodeAt(start) !== 0x5b /* [ */ || state.src.charCodeAt(start + 1) !== 0x5b /* [ */) {
43 | return false
44 | }
45 |
46 | let pos = start + 2
47 | while (pos < max) {
48 | if (state.src.charCodeAt(pos) === 0x5d /* ] */ && state.src.charCodeAt(pos + 1) === 0x5d /* ] */) {
49 | break
50 | }
51 | pos++
52 | }
53 |
54 | if (pos === max) {
55 | return false
56 | }
57 |
58 | const raw = state.src.slice(start + 2, pos)
59 | const parsed = parse(raw)
60 |
61 | if (!silent) {
62 | const token = state.push('link_open', 'a', 1)
63 | token.attrs = [
64 | ['href', parsed.url],
65 | ['class', 'wikitext-ish-link no-icon'], // Disable https://vitepress.dev/reference/default-theme-config#externallinkicon
66 | ]
67 | token.info = 'auto'
68 |
69 | const inner = state.push('html_inline', '', 0)
70 | inner.content = md.renderInline(parsed.innerMarkdown)
71 | inner.meta ||= { slug: parsed.innerMarkdown }
72 |
73 | state.push('link_close', 'a', -1)
74 | }
75 |
76 | state.pos = pos + 2
77 | return true
78 | })
79 | }
80 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
2 | 
3 |
4 | 📖 [_非官方本科生毕业设计论文/研究生学位论文 LaTeX 模板（以及更多）在线文档_](https://bithesis.bitnp.net)
5 |
6 | [](https://github.com/BITNP/BIThesis)
7 | [](./LICENSE)
8 | [](https://jq.qq.com/?_wv=1027&k=KYDrmS5z)
9 | [](https://vercel.com/everything411/bithesis-wiki/deployments)
10 | [](https://app.netlify.com/sites/bithesis-wiki/deploys)
11 |
12 |
13 |
14 |
3 |
4 | 📖 [_非官方本科生毕业设计论文/研究生学位论文 LaTeX 模板（以及更多）在线文档_](https://bithesis.bitnp.net)
5 |
6 | [](https://github.com/BITNP/BIThesis)
7 | [](./LICENSE)
8 | [](https://jq.qq.com/?_wv=1027&k=KYDrmS5z)
9 | [](https://vercel.com/everything411/bithesis-wiki/deployments)
10 | [](https://app.netlify.com/sites/bithesis-wiki/deploys)
11 |
12 | 欢迎
15 | 16 | BIThesis 是针对北京理工大学本科生毕业毕业论文、研究生学位论文的一个非官方的 LaTeX 模板，BIThesis 同时也包括其他本科学习中涉及到的文献综述、实验报告等的 LaTeX 模板。 17 | 18 | **本项目为 [BIThesis 在线文档](https://bithesis.bitnp.net) 的代码仓库。如果你仅仅想使用 BIThesis，请访问 [BIThesis](https://github.com/BITNP/BIThesis) 仓库。** 19 | 20 | > [!NOTE] 21 | > 本项目获得了[北京理工大学研究生院](https://grd.bit.edu.cn/xwgz/xwgz2/wjxz_xwgz/b117824.htm)、[北京理工大学教务部](https://jwb.bit.edu.cn/)和[北京理工大学计算机学院](https://cs.bit.edu.cn/) 的认可、背书与大力支持。详见：[致谢 - 官方赞助](https://bithesis.bitnp.net/guide/acknowledgements.html#%E5%AE%98%E6%96%B9%E8%B5%9E%E5%8A%A9-official-sponsors)。 22 | 23 |交流社区
24 | 25 | > 订阅更新，询问问题，提出需求……请加入北理 BIThesis 官方社区！ 26 | 27 | [](https://jq.qq.com/?_wv=1027&k=KYDrmS5z) 28 | 29 | ## 本地编译运行 30 | 31 | ### 克隆仓库 32 | 33 | ```Bash 34 | git clone https://github.com/BITNP/BIThesis-wiki 35 | 36 | cd BIThesis-wiki 37 | ``` 38 | 39 | ### 安装依赖 40 | 41 | ```Bash 42 | pnpm install 43 | ``` 44 | 45 | ### 编译运行 46 | 47 | 你可以构建出所有文件（在 `wiki/.vitepress/dist/` 下）: 48 | 49 | ```Bash 50 | pnpm build 51 | ``` 52 | 53 | 或者实时预览: 54 | 55 | ```Bash 56 | pnpm dev 57 | ``` 58 | 59 | ## 贡献者指南 60 | 61 | 详情请查看[贡献者指南](https://github.com/BITNP/BIThesis/blob/main/contributing-zh.md)。 62 | 63 | ## 贡献者 64 | 65 | > 本项目的存在离不开以下所有贡献者的辛勤贡献。参见 [GitHub Contributors](https://github.com/BITNP/BIThesis/graphs/contributors) 与 [BIThesis - 致谢](https://bithesis.bitnp.net/guide/acknowledgements.html)。 66 | 67 | --- 68 | 69 | 📖 **BIThesis** ©BITNP. Released under the [CC0 1.0 Universal License](./LICENSE). 70 | 71 | Maintained with help from [contributors](https://github.com/BITNP/BIThesis-wiki/graphs/contributors). 72 | -------------------------------------------------------------------------------- /wiki/news/2024.md: -------------------------------------------------------------------------------- 1 | # 更新说明：2023年11月至2024年10月 2 | 3 | 相关通知： 4 | 5 | - **本科生** 6 | - [关于2023-2024学年本科生毕业设计（论文）工作安排的通知 - 教务部 | 北京理工大学](https://jwb.bit.edu.cn/tzgg/209ca646b5a84480b460faf21fb3d6e3.htm)（2023年11月7日） 7 | 8 | - [毕设加油站之BIThesis毕设LaTeX模板 - 北京理工大学教务部微信公众号](https://mp.weixin.qq.com/s/I1SsP9VSaQ90a_2tW4zQUg)（2024年4月24日) 9 | 10 | - **研究生** 11 | - [文件下载-研究生学位论文模版-北京理工大学研究生院](https://web.archive.org/web/20240806045855/https://grd.bit.edu.cn/xwgz/xwgz2/wjxz_xwgz/b119746.htm) 12 | 13 | `研究生论文模版 - {全体硕士及2020级以前博士,2020级及以后博士}适用.doc` 14 | 15 | - [文件下载-LaTeX学位论文模板-北京理工大学研究生院](https://web.archive.org/web/20240921003837/https://grd.bit.edu.cn/xwgz/xwgz2/wjxz_xwgz/b117824.htm)（2024年4月8日） 16 | 17 | `BIThesis-graduate-thesis-template-3.7.3.zip` 18 | 19 | ## [3.8.0] - 2024-10-07 20 | 21 | ## [3.8.0-alpha-3] - 2024-09-15 22 | 23 | ## [3.8.0-alpha-2] - 2024-08-30 24 | 25 | ## [3.7.10-alpha-1] - 2024-07-25 26 | 27 | > [!TIP] 28 | > 若是初次使用，可先参考**快速使用指南**（[本科][undergraduate-handbook]／[硕博][graduate-handbook]）或者 [Wiki 网站](https://bithesis.bitnp.net/)。有需要再进一步参考[详细配置手册`bithesis.pdf`][bithesis-pdf]。 29 | 30 | [undergraduate-handbook]: https://github.com/BITNP/BIThesis/releases/download/v3.7.10-alpha-1/undergraduate-handbook.pdf 31 | [graduate-handbook]: https://github.com/BITNP/BIThesis/releases/download/v3.7.10-alpha-1/graduate-handbook.pdf 32 | [bithesis-pdf]: https://github.com/BITNP/BIThesis/releases/download/v3.7.10-alpha-1/bithesis.pdf 33 | 34 | ## [3.7.9] - 2024-05-30 35 | 36 | ## [3.7.8] - 2024-05-27 37 | 38 | ## [3.7.7] - 2024-05-04 39 | 40 | ## [3.7.6] - 2024-04-29 41 | 42 | > [!TIP] 43 | > 44 | > 这一错误是 [v3.7.5](https://github.com/BITNP/BIThesis/releases/tag/v3.7.5) 引入的。如果您受到影响，请替换`bithesis.cls`。 45 | 46 | ## [3.7.5] - 2024-04-25 47 | 48 | > [!CAUTION] 49 | > 50 | > #469 导致`\usepackage[chapter]{algorithm}`时出现多余“algorithm2ealgochaper”字样，#481 已修复，下个版本会解决。 51 | 52 | ## [3.7.4] - 2024-04-16 {title="v3.7.4 (Public Release) 600 stars achieved!"} 53 | 54 | > [!TIP] 55 | > 56 | > 写伪代码一般有`algorithm`+X或`algorithm2e`两种方式，BIThesis 最近几个版本适配了它们，您引入相关宏包即可使用。只需注意采用`algorithm2e`方式时，要加上选项`algochapter`才能按学校要求分章编号（例如`\usepackage[ruled,algochapter]{algorithm2e}`），详见手册`bithesis.pdf`（搜索“算法”）。 57 | 58 | ## [3.7.3] - 2024-04-12 59 | 60 | ## [3.7.2] - 2024-04-06 61 | 62 | > [!IMPORTANT] 63 | > 64 | > 在研究生模板的“研究成果声明”一页，之前第二段“论文中的研究数据及结果……”漏掉了☑，现在补上了。 65 | > 66 | > 请研究生同学升级到此版本及以上。（替换`bithesis.cls`即可） 67 | 68 | ## [3.7.1] - 2024-03-26 69 | 70 | ## [3.7.1-alpha-1] - 2024-03-23 {title="Test only"} 71 | 72 | ## [3.7.0] - 2024-03-22 73 | 74 | **已经根据最新的（2024）研究生模板更新样式，请研究生同学升级到此版本及以上。特别鸣谢：@Manpopp 。** 75 | 76 | ## [3.6.2] - 2024-02-27 77 | 78 | ### 重要修改 79 | 80 | 对于研究生模板，在 `main.tex` 中存在这样一行配置： 81 | 82 | ``` 83 | pageVerticalAlign = scattered, 84 | ``` 85 | 86 | 请删去它，删去以后文本会顶部对齐（更类似于 word 文档）。 87 | -------------------------------------------------------------------------------- /assets/chinese.svg: -------------------------------------------------------------------------------- 1 | 24 | -------------------------------------------------------------------------------- /wiki/assets/chinese.svg: -------------------------------------------------------------------------------- 1 | 24 | -------------------------------------------------------------------------------- /wiki/guide/commands.md: -------------------------------------------------------------------------------- 1 | # 🍖常用命令 2 | 3 | 如果您使用终端，可用以下命令补充图形界面缺失的功能。 4 | 5 | ## 清除缓存 {#latexmk-c} 6 | 7 | 编译 LaTeX 时除了生成 PDF，还可能生成`*.aux`等辅助文件和日志。 8 | 9 | 偶尔先前编译有错，缓存了错误的辅助文件，会导致下一次编译异常。这时可清除缓存从最干净的状态重试： 10 | 11 | ```shell 12 | $ latexmk -c 13 | … 14 | Latexmk: Doing main (small) clean up for 'main.tex' 15 | … 16 | ``` 17 | 18 | 此命令也可用于释放磁盘空间或保持文件整洁。 19 | 20 | 更多细节请查阅[[texdoc:latexmk]]或 [tldr 太长不看版](https://tldr.inbrowser.app/pages/common/latexmk)。 21 | 22 | ## 统计字数 23 | 24 | 统计全文： 25 | 26 | ```shell 27 | $ texcount main.tex -merge -chinese -stat -total 28 | … 29 | Han: 2224 👈总汉字数 30 | … 31 | All words: 2382 👈总词数（西文按词计，中文每个汉字计一词） 32 | ``` 33 | 34 | 分章统计： 35 | 36 | ```shell 37 | $ texcount main.tex -merge -sub=chapter 38 | … 39 | Subcounts: 40 | text+headers+captions (#headers/#floats/#inlines/#displayed) 41 | 391+1+0 (1/0/1/0) _top_ 42 | 👆第一章以前的部分，例如摘要 43 | 730+68+27 (7/2/0/0) Chapter: 绪论 44 | 👆此章正文有730字，标题有68字，图注、表注有27字 45 | 553+6+0 (1/3/21/2) Chapter: 具体研究内容 46 | 👆此章包括1个标题、3个浮动体、21个行内公式、2个行间公式 47 | … 48 | ``` 49 | 50 | :::tip 🤨 乱码怎么办 51 | 请将终端编码设为 UTF-8。对于 PowerShell，请执行： 52 | 53 | ```powershell 54 | [console]::InputEncoding = [console]::OutputEncoding = [System.Text.UTF8Encoding]::new() 55 | ``` 56 | 57 | ::: 58 | 59 | 更多细节请查阅[[texdoc:TeXcount]]或 [tldr 太长不看版](https://tldr.inbrowser.app/pages/common/texcount)。 60 | 61 | ## 查找帮助文档 {#texdoc} 62 | 63 | 用 [texdoc](https://tug.org/texdoc/) 可按关键词查找、打开各种帮助文档。 64 | 65 | - `texdoc biblatex-gb7714-2015` 66 | 67 | 👆打开指定宏包的文档，这里会弹出《[[texdoc:biblatex-gb7714-2015|符合 GB/T 7714-2015 标准的 biblatex 参考文献样式]]》 68 | 69 | - `texdoc texcount` 70 | 71 | 👆打开指定工具的文档 72 | 73 | - `texdoc lshort-zh-cn` 74 | 75 | 👆打开指定参考资料，这里会弹出《[[texdoc:lshort-zh-cn|一份（不太）简短的 LaTeX2e 介绍]]》 76 | 77 | ## 补充安装缺失的包 {#tlmgr} 78 | 79 | 可使用 tlmgr（TeX Live package manager）。 80 | 81 | ```shell 82 | # 安装某个包 83 | $ tlmgr install minted 84 | … 85 | 86 | # 升级所有包 87 | $ tlmgr update --all 88 | … 89 | 90 | # 按正则表达式搜索文件，确定某个文件由哪个包提供 91 | # 其中 --global 代表搜索整个发行版，无论是否安装过 92 | $ tlmgr search --global --file 'bit.+\.cls' 93 | tlmgr.pl: package repository https://mirrors.cernet.edu.cn/CTAN/systems/texlive/tlnet (verified) 94 | bithesis: 95 | texmf-dist/tex/latex/bithesis/bithesis.cls 96 | texmf-dist/tex/latex/bithesis/bitbeamer.cls 97 | texmf-dist/tex/latex/bithesis/bitreport.cls 98 | fbithesis: 99 | texmf-dist/tex/latex/fbithesis/fbithesis.cls 100 | 101 | # 同上，但要求完全匹配文件名开头 102 | $ tlmgr search --global --file '/times.sty' 103 | tlmgr.pl: package repository https://mirrors.cernet.edu.cn/CTAN/systems/texlive/tlnet (verified) 104 | psnfss: 105 | texmf-dist/tex/latex/psnfss/times.sty 106 | ``` 107 | 108 | 更多细节请查阅[[texdoc:tlmgr]]或 [tldr 太长不看版](https://tldr.inbrowser.app/pages/common/tlmgr)。 109 | -------------------------------------------------------------------------------- /wiki/guide/acknowledgements.md: -------------------------------------------------------------------------------- 1 | 4 | 5 | # 🙇♂️ 致谢 6 | 7 | **BIThesis 项目的实现离不开以下单位、领导、老师和同学们的大力支持与卓越贡献。** 8 | 9 | 14 | 15 | ## Maintainers 16 | 17 | ### 2025 18 | 19 |
85 |
86 | ---
87 |
88 | 附录：Emoji 索引
89 | 90 | | Emoji | 代表 | 注释 | 91 | | :---: | :--------------------: | :--------------------------------: | 92 | | 💻 | Code | 撰写项目代码内容 | 93 | | 🚧 | Maintenance | 日常项目维护者 | 94 | | 📆 | Project Management | 项目日程管理与规划 | 95 | | 💬 | Answering Questions | 对 issue 中的问题进行解答 | 96 | | 📖 | Documentation | 撰写项目文档、手册、Wiki | 97 | | 🎨 | Design | 项目 logo、图标等素材设计 | 98 | | 🌍 | Translation | 国际化，文档、注释与参考资料的翻译 | 99 | | 📓 | User Testing | 参与测试 | 100 | | 🎞 | Video Tutorial Editing | 视频教程文案、剪辑 | 101 | | 🎙 | Voice/Sound | 视频教程配音、调音 | 102 | -------------------------------------------------------------------------------- /wiki/.vitepress/theme/PubAuthorAnnotation.vue: -------------------------------------------------------------------------------- 1 | 49 | 50 | 51 |效果
76 |-
77 |
-
78 | 普通模式下：
{{ normal_out }}作者姓名 80 |
81 | -
82 | 盲审模式下：
{{ blind_out }}{{ blind_notes }} 84 |
85 |
126 | 🔗 分享链接 127 |
128 |
129 | 请编辑main.tex，用\BITSetup设置{{ key }}选项为{{ value }}：
133 |
71 |
72 | 欢迎通过 Slack 社区、Github Issue 或者其他方式对我们的 v2 版本提供反馈与建议！
73 |
74 | [](https://join.slack.com/t/bithesis/shared_invite/zt-epmzkyk0-fJRsUS36AlwMNB2AI_Q~Vw)
75 |
76 |
77 |
78 | ## [2.0.0-beta-1] - 2021-01-08
79 |
80 | 这同样是一个 Preview Release，仅对文档做了更新。
81 |
82 | ## [2.0.0-alpha] - 2021-01-06
83 |
84 | 🥶 新年快乐！
85 |
86 | 在 2021 年，我们在 CTAN 上发布了[bithesis 宏集](https://www.ctan.org/pkg/bithesis) —— 以版本号 `v2.0.0` 为标识。这意味着：
87 |
88 | - 你的 Scaffold（模板）将更加精简。
89 | - 你获得可选的更多个性化的配置。
90 | - 你的论文写作将不受限于我们的版本更新。
91 |
92 | 同时我们保持了文档样式的兼容性：
93 |
94 | - `v2` 和 `v1` 的文档样式完全一样的。👍🏼
95 | - **你完全可以使用 `v2` 进行毕业论文的撰写。** 🤗（当然是推荐使用 `v2` 版本的！）
96 |
97 | 现在，你可以开始使用这个预览版以尝试这些新的体验。不过首先，你需要确保 `bithesis` 存在于你的发行版中：
98 |
99 | ### 更新 LaTeX 发行版至最新
100 |
101 | `bithesis` 跟随 CTAN 的其它宏包一起（比如 `CTeX`），被自动打包到了最新的 LaTeX 发行版中。如果你安装 LaTeX 的时间早于2021年，那么建议你运行以下语句，通过包管理器更新自己的包：
102 |
103 | ```
104 | tlmgr update --self --all
105 | ```
106 |
107 | _如果你在使用其他的发行版（如 `MikTex`），可以使用相应的包管理器更新或者安装 `bithesis`_。
108 |
109 | ### 验证 `bithesis` 成功安装
110 |
111 | 一般来说，你可以尝试运行
112 |
113 | ```
114 | texdoc bithesis
115 | ```
116 |
117 | 来打开 `bithesis` 的宏集手册（目前手册中没有内容）。
118 |
119 | 
120 |
121 | 如果能够打开文档，就意味着 `bithesis` 正确安装。
122 |
123 | ### 下载 v2.0.0 的模板
124 |
125 | 在这个 Release 下方，有最新的模板下载链接。下载并解压以后，就可以愉快地使用啦！
126 |
127 | ---
128 |
129 |
130 |
131 | 欢迎通过 Slack 社区、Github Issue 或者其他方式对我们的 v2 版本提供反馈与建议！
132 |
133 | [](https://join.slack.com/t/bithesis/shared_invite/zt-epmzkyk0-fJRsUS36AlwMNB2AI_Q~Vw)
134 |
135 |
136 |
137 | ## [1.2.1] - 2020-12-30
138 |
139 | ☃️ Time flies! Welcome to 2021!
140 |
141 | In v1.2.1, we did not ship any new features or issue fixes. We focused on refining our documents, indicating the completion of the project’s migration.
142 |
143 | ### 🎉 Official Support
144 |
145 | This project (2021) is verified as compatible with the latest final-year thesis formatting standards of BIT. In short, you are more than welcome to use it in your graduation thesis.
146 |
147 | ### 📦 Maintainer Change
148 |
149 | Finally, we are proud to announce that, as of 2021, this project will be officially maintained and developed by the Net Pioneer Association of BIT.
150 |
151 | ---
152 |
153 |
154 |
155 | For more support, please join the discussion in the Slack community!
156 |
157 | [](https://join.slack.com/t/bithesis/shared_invite/zt-epmzkyk0-fJRsUS36AlwMNB2AI_Q~Vw)
158 |
159 |
160 |
--------------------------------------------------------------------------------
/assets/english.svg:
--------------------------------------------------------------------------------
1 |
32 |
--------------------------------------------------------------------------------
/wiki/assets/english.svg:
--------------------------------------------------------------------------------
1 |
32 |
--------------------------------------------------------------------------------
/wiki/faq/word-font.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag: font
3 | ---
4 |
5 | # 中文字体如何才能与 Word 模板完全相同？（换用中易字库）
6 |
7 | 首先明确，Word 模板中的中文字体属于「中易字库」，包括`simsun.ttc`（宋体，SimSun）等。
8 |
9 | - **Windows**——这是默认设置，无需修改，开箱即用。
10 | - **其它平台**——需强制 LaTeX 使用中易字库，并确保字体文件可用，详见下文。
11 |
12 | ## 强制 LaTeX 使用中易字库 {#ctex-fontset}
13 |
14 | 请编辑`main.tex`，在开头如下设置：
15 |
16 | ```latex
17 | \documentclass[…]{bithesis} % [!code --]
18 | \documentclass[…, ctex={fontset=windows}]{bithesis} % [!code ++]
19 | ```
20 |
21 | 这会让[[pkg:ctex]]跳过操作系统检测，直接使用 Windows 平台默认的中易字库。
22 |
23 | ::: details 其它 LaTeX 文档怎么办？
24 |
25 | 以上方法仅限[[pkg:bithesis]]。自己直接用[[pkg:ctex]]请如下设置：
26 |
27 | ```latex
28 | \documentclass{ctexbook} % [!code --]
29 | \documentclass[fontset=windows]{ctexbook} % [!code ++]
30 | ```
31 |
32 | 其它模板请如下设置：
33 |
34 | ```latex
35 | \PassOptionsToClass{fontset=windows}{ctexbook} % [!code ++]
36 | \documentclass[…]{任何基于ctexbook的文档类}
37 | ```
38 |
39 | :::
40 |
41 | 如上设置后，若[[pkg:fontspec]]报错`The font "SimSun" cannot be found`，说明您的平台并无中易字库，需补充准备字体文件，请继续操作。
42 |
43 | ## 准备字体文件
44 |
45 | 各平台最简方法不同，以下由易到难介绍。（📥表示需在本地[下载 LaTeX 发行版](../guide/getting-started.md)）
46 |
47 | ### [TeXPage](https://www.texpage.com) 等国产在线平台（难度：😀）{#texpage}
48 |
49 | 已预装中易字库，如上强制 LaTeX 使用即可，无此问题。
50 |
51 | ### WSL (Windows Subsystem for Linux)（难度：🙂+📥）{#wsl}
52 |
53 | 直接使用外面 Windows 的字体文件。
54 |
55 | 请通过 WSL 的命令行按序执行：
56 |
57 | ```shell
58 | # 将 Windows 的字体目录软链接到 WSL 的字体目录，
59 | sudo ln -s /mnt/c/Windows/Fonts /usr/share/fonts/win-fonts
60 |
61 | # 刷新字体缓存
62 | fc-cache -fv
63 | ```
64 |
65 | ### Linux、macOS 等其它本地平台（难度：🤨+📥）{#unix}
66 |
67 | 在系统中安装中易字库，通常双击字体文件即可。
68 |
69 | 中易字库包括 SimSun、SimHei、KaiTi、FangSong 等。然而由于版权和历史原因，它不太有正经下载渠道……
70 |
71 | - 若是 **macOS 且安装了 Word**，可切换到以下目录，找到`Simsun.ttc`、`SimHei.ttf`、`Kaiti.ttf`（注意并非 SimKai）、`Fangsong.ttf`，双击安装。
72 |
73 |
74 |
75 | ```log
76 | /Applications/Microsoft Word.app/Contents/Resources/DFonts/
77 | ```
78 |
79 | 然后打开“字体册”，确认有新安装的字体。
80 |
81 | - 若是**其它情况**，建议找个 Windows 系统，从`C:/Windows/Fonts/`拷贝`sim{sun,hei,kai,fang}*.{ttf,ttc}`，双击安装。
82 |
83 | ### [Overleaf](https://www.overleaf.com/) 等在线平台（难度：🤨😥😖）{#overleaf}
84 |
85 | 上传字体到 LaTeX 项目，同时用`ctex-fontset-windows.def`定义字体。
86 |
87 | ::: details 原因
88 |
89 | [[pkg:ctex]]使用[[pkg:fontspec]]调用字体，调用时按**字体名**（如 SimSun），而非**文件名**（如`simsun.ttc`）。这可能是考虑到文件名能随意更改，不反映文件中的实际字体。
90 |
91 | 根据[[texdoc:fontspec]] §2 Font selection，按字体名调用时，只支持 XeTeX/LuaTeX 已知的系统字体（≈ 操作系统字体目录的字体）；按文件名调用时，才会搜索当前工作目录（≈ LaTeX 项目）中的字体文件。
92 |
93 | 然而在线平台上，我们没有权限添加系统字体。于是只好绕过[[pkg:ctex]]默认机制，自己按文件名调用字体。
94 |
95 | :::
96 |
97 | 1. 找个 Windows 系统，在`C:/Windows/Fonts/`找到`simsun.ttc`和`sim{hei,kai,fang}.ttf`，上传到 LaTeX 项目，与`main.tex`并列。
98 |
99 | 2. 创建`ctex-fontset-windows.def`，与`main.tex`并列，内容如下。
100 |
101 | :::: details `ctex-fontset-windows.def`（单击展开）
102 |
103 | <<< ../assets/word-font-ctex-fontset-windows.def{latex}
104 |
105 | ::: warning 📅 最后检查于2025年10月
106 | 以上内容修改自[[pkg:ctex]] 2.5.10 2022-07-14 的`ctex-fontset-windows.def`，以后可能需要参考 [CTeX-org/ctex-kit 源代码](https://github.com/CTeX-org/ctex-kit/blob/1ee66c6f130802d3400f893db01fd6a6701ab164/ctex/ctex.dtx#L11065-L11172)更新。
107 | :::
108 |
109 | ::::
110 |
111 | 3. 如果您之前没有操作，请[强制 LaTeX 使用中易字库](#ctex-fontset)。
112 |
113 | ### 自行部署的 [Overleaf Community 版](https://github.com/overleaf/toolkit/)（难度：😀+📥👷♀️🚧）{#overleaf-community}
114 |
115 | 如果您[采用北大 LCPU 版 Overleaf 自行部署](https://github.com/lcpu-club/overleaf/wiki/快速开始)，可以使用以下镜像替换原有的`ghcr.io/lcpu-club/sharelatex-base`，它们已经包含了中易字库。
116 |
117 | - `docker.io/everything411/sharelatex-base:2024.1`
118 | - `docker.io/everything411/sharelatex-base:2022.1`
119 | - `docker.io/everything411/sharelatex-base:2020.1`
120 |
121 | ::: warning 📅 最后检查于2025年4月
122 | 这些镜像违反了[微软的再分发规则][ms-font-faq]，有潜在失效风险。
123 | :::
124 |
125 | 另见：[提供自建Overleaf实例的教程 · Issue #445 · BITNP/BIThesis-wiki](https://github.com/BITNP/BIThesis-wiki/issues/445#issuecomment-2728226319)
126 |
127 | ::: info 也许能更简单
128 | 也许可以修改[`services/clsi/app/js/DockerRunner.js`](https://github.com/lcpu-club/overleaf/blob/3ebfd0a523adfef3164a1b14419eb9e2c968c78f/services/clsi/app/js/DockerRunner.js#L4)中的 docker 调用规则，允许创建容器时额外挂载，从而添加字体。待测试补充。
129 | :::
130 |
131 | ::: tip 🏃♀️ 树挪死，人挪活
132 | 可以考虑换到容易的平台，甚至请同学帮忙在 Windows 上编译最终版 PDF。
133 | :::
134 |
135 | ## 参考
136 |
137 | - [[texdoc:ctex]]
138 | - [[texdoc:xeCJK]]
139 | - [[texdoc:fontspec]]
140 | - [Overleaf 中的 CJK 字体设置 | sikouhjw.github.io](https://sikouhjw.github.io/2021/02/14/2021-02-14-fontset-overleaf/)
141 | - [SimSun font family - Typography | Microsoft Learn](https://learn.microsoft.com/zh-cn/typography/font-list/simsun)
142 | - [字体重新分发常见问题解答 - Typography | Microsoft Learn][ms-font-faq]
143 |
144 | [ms-font-faq]: https://learn.microsoft.com/zh-cn/typography/fonts/font-faq
145 |
--------------------------------------------------------------------------------
/wiki/guide/converting-to-word.md:
--------------------------------------------------------------------------------
1 | # 🔁 将 LaTeX 格式的文档转换为 Word
2 |
3 | :::warning ❗ 请注意：很难完全自动转换
4 | 由于 Word 文档的封闭性，LaTeX 几乎无法保留完整格式地转到 Word。因此我们强烈建议在任何场合提交 PDF 或 LaTeX 相关代码，而不是 Word。
5 | :::
6 |
7 | 如果你决定使用 LaTeX 进行论文撰写，但是你的导师希望你提供 Word 版本的论文进行方便的批注等，你可以使用下面的方法来将你的 LaTeX 论文转换为 Word 格式的文档。需要注意的是，这种方式的转换并不能完整的将 LaTeX 论文的全部格式进行转换，**仅能保证正文部分内容的不丢失**，其余包括「论文封面」、「表格」等等部分的内容，在转换的过程中都可能丢失。这些部分需要你后期手动进行添加。
8 |
9 | 大致有两类思路：
10 |
11 | - LaTeX 正常编译成 PDF，然后 **PDF → Word**（[在线](#online-pdf)／[本地](#offline-pdf)）
12 | - 直接 **LaTeX → Word**（[本地](#offline-latex)）
13 |
14 | 一般前者整体效果好，后者公式效果好。
15 |
16 | ## 在线转换 PDF → Word {#online-pdf}
17 |
18 |
22 |
23 | ::: danger ⚠ 注意安全
24 | 将未发表论文上传至网络有风险，请注意安全，谨慎使用。
25 | :::
26 |
27 | 无需注册的：
28 |
29 | - [iLovePDF](https://www.ilovepdf.com/pdf_to_word)：整体效果好，包括页眉和页脚；公式支持差。
30 |
31 | - [Adobe Acrobat online tools](https://www.adobe.com/acrobat/online/pdf-to-word.html)：效果与 iLovePDF 类似；虽然是大公司，但访问性差，可能超时或提示“Access Denied”。
32 |
33 | 需要注册的：
34 |
35 | - [nitro](https://cloud.gonitro.com/)：对超链接、目录、段落格式和字体等支持较好；公式支持差。
36 |
37 | ## 本地转换 PDF → Word {#offline-pdf}
38 |
39 | - 用 **Adobe Acrobat** 打开 PDF，转换为 Word 文档：可以保持大体的文档结构；但公式之类依旧会比较凌乱；实测知网可以查重。
40 |
41 | - 直接用 **MS Word** 打开 PDF：效果一般。
42 |
43 | ## 本地转换 LaTeX → Word {#offline-latex}
44 |
45 | 图形化界面：未知。
46 |
47 | 命令行界面：
48 |
49 | - [Pandoc](https://pandoc.org)（详见[后文](#pandoc)）：通用工具，可以结合 Word 模板达到较好效果；不支持多级嵌套表格。
50 |
51 | - [Mingzefei/latex2word](https://github.com/Mingzefei/latex2word)：pandoc + [pandoc-crossref](https://lierdakil.github.io/pandoc-crossref/) + [python 包](https://pypi.org/project/tex2docx/)，据称支持公式转换、多子图导入、交叉引用；2023年国人新创，但只有单个开发者，稳定性存疑。
52 |
53 | ## 使用 Pandoc 本地转换 {#pandoc}
54 |
55 | ::: details 准备工作：安装 Pandoc 命令行工具
56 |
57 | Pandoc 是一个支持几乎所有 Markup 格式文档的「通用文档转换器」，是一个命令行工具，支持所有常用操作系统。我们可以借助 pandoc 进行格式转换。
58 |
59 | Pandoc 详细的安装说明请见官方文档：[Installing pandoc](https://pandoc.org/installing.html).
60 |
61 | 简单来说：
62 |
63 | - 在 Windows 上你可以使用 scoop 包管理工具安装 pandoc（为了方便设置命令行工具的环境变量，推荐使用 scoop 进行安装）：
64 |
65 | ```powershell
66 | scoop install pandoc
67 | ```
68 |
69 | **关联阅读：**[「一行代码」搞定软件安装卸载，用 Scoop 管理你的 Windows 软件](https://sspai.com/post/52496)
70 |
71 | 当然你也可以直接在 [Pandoc 的 GitHub Release 页面](https://github.com/jgm/pandoc/releases/latest) 下载 Windows MSI 安装文件手动安装。
72 |
73 | - 在 macOS 上你可以使用 Homebrew 包管理工具安装 pandoc：
74 |
75 | ```bash
76 | brew install pandoc
77 | ```
78 |
79 | - 在 Linux 上你可以使用你所用发行版的包管理工具安装 pandoc，比如：
80 |
81 | ```bash
82 | sudo apt install pandoc
83 | ```
84 |
85 | 之后，在终端中输入：
86 |
87 | ```powershell
88 | pandoc --version
89 | ```
90 |
91 | 如果出现类似下面的输出，说明你的 pandoc 安装成功。
92 |
93 | 
94 |
95 | :::
96 |
97 | ### 完善 Word 格式的模板文件
98 |
99 | 为了保证导出的 Word 文档格式和学校提供的模板大体一致，我们需要确认 Word 版本的模板**已经准确定义了各级标题、正文等部分的格式。**
100 |
101 | 
102 |
103 | 之后，我们需要将这一文件（`doc` 或 `docx`）保存，**留作 pandoc 的格式参考。**
104 |
105 | ### 进行格式转换
106 |
107 | 最后，我们进行格式的转换。
108 |
109 | :::warning ❗ 特别强调
110 | Pandoc 格式转换功能有限，无法处理 LaTeX 多级嵌套表格（本模板的「毕业论文」使用了多级嵌套表格，直接调用 pandoc 默认情况下会报错。需要删掉 LaTeX 文档中的表格，并后期手动录入 Word 之中），也无法保证格式与 LaTeX 原文档 **完全一致**，都需要我们后期手动进行调整。
111 | :::
112 |
113 | #### 朴素格式转换
114 |
115 | 如果你只希望将文本内容导出为 Word，不在意格式或其他内容的正确性，你可以直接使用下面的命令进行最普通的文本转换：
116 |
117 | ```bash
118 | pandoc {LaTeX 文档文件} -o {输出 Word 文档}
119 | ```
120 |
121 | 比如：
122 |
123 | ```bash
124 | pandoc main.tex -o main.docx
125 | ```
126 |
127 | 没有特别指明模板 Word 文档格式与参考文献文档的情况下，pandoc 仅会处理你 LaTeX 文档中的文字内容，按照标题、正文的格式整理进入 Word。
128 |
129 | #### 含有目标模板 Word 文档的格式转换
130 |
131 | 如果你希望按照模板 Word 文档的规定格式进行转换，那么你可以直接使用下面的命令进行格式转换：
132 |
133 | ```bash
134 | pandoc {LaTeX 文档文件} --reference-doc={参考模板 Word 文档} -o {输出 Word 文档}
135 | ```
136 |
137 | 比如，我们的 LaTeX 文档文件名称为 `main.tex`，参考模板 Word 文档名称为 `template.docx`，希望输出名为 `main.docx` 的 Word 文档，我们即可如下组织 pandoc 转换命令：
138 |
139 | ```bash
140 | pandoc main.tex --reference-doc=template.docx -o main.docx
141 | ```
142 |
143 | #### 含有参考文献文档的格式转换
144 |
145 | 如果你的 LaTeX 文档中包含有参考文献的引用，那么你需要特别明确参考文献 BibTeX 文件，将文件以 `--bibliography={参考文献文件}` 的参数告知 pandoc，从而让 pandoc 正确处理你的参考文献。比如：
146 |
147 | ```bash
148 | pandoc main.tex --bibliography=refs.bib --reference-doc=template.docx -o main.docx
149 | ```
150 |
151 | ## 另可参阅
152 |
153 | - [日经问题：LaTeX 如何转为 Word？ · Issue #22 · CTeX-org/forum](https://github.com/CTeX-org/forum/issues/22)
154 | - [msword - How to convert a scientific manuscript from LaTeX to Word using Pandoc? - TeX - LaTeX Stack Exchange](https://tex.stackexchange.com/questions/111886/how-to-convert-a-scientific-manuscript-from-latex-to-word-using-pandoc)
155 | - [LaTeX（XeLaTeX）写的文档如何一键转为word？ - 知乎](https://www.zhihu.com/question/31850346)
156 | - [文件格式相关 - README - BUAAthesis: 北航毕设论文LaTeX模板](https://github.com/BHOSC/BUAAthesis/tree/master?tab=readme-ov-file#文件格式相关)
157 |
--------------------------------------------------------------------------------
/wiki/faq/math-font.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - font
4 | - package
5 | ---
6 |
7 | # 如何修改数学公式的字体？
8 |
9 | :::: details 效果对比
10 |
11 | 
12 |
13 | - **非 Unicode 方法**
14 |
15 | 直接书写、使用原生的`\mathbf`、使用[[pkg:bm]]提供的`\bm`。
16 |
17 | - **Unicode 方法**（简称 unimath）
18 |
19 | 使用[[pkg:unicode-math]]设置字体为 TeX Gyre Termes Math（具体方法见后）。TeX 样式即默认样式，ISO 样式需手动导入宏包并设置`\unimathsetup{ math-style = ISO, bold-style = ISO }`。
20 |
21 | ::: details 测试细节
22 |
23 | 排除字体差异后，非 Unicode 方法和 Unicode 方法的关键区别是映射的字符不同。从 PDF 中复制公式出来，会得到以下这些字符，可以看到只有 Unicode 方法会采用粗体字符。
24 |
25 | ```
26 | (a, z, B, X) (α, β, Γ, Ξ) (∂, ∁, ∇, ⊥)
27 | (a, z, B, X) (α, β, ?, ?) (∂, ∁, ∇, ⊥)
28 | (a, z, B, X) (α, β, Γ, Ξ) (∂, ∁∁∁, ∇, ⊥)
29 |
30 | (𝑎, 𝑧, 𝐵, 𝑋) (𝛼, 𝛽, Γ, Ξ) (𝜕, ∁, ∇, ⟂)
31 | (𝐚, 𝐳, 𝐁, 𝐗) (𝜶, 𝜷, 𝚪, 𝚵) (𝝏, ∁, 𝛁, ⟂)
32 |
33 | (𝑎, 𝑧, 𝐵, 𝑋) (𝛼, 𝛽, 𝛤, 𝛯) (𝜕, ∁, ∇, ⟂)
34 | (𝒂, 𝒛, 𝑩, 𝑿) (𝜶, 𝜷, 𝜞, 𝜩) (𝝏, ∁, 𝛁, ⟂)
35 | ```
36 |
37 | 此外，字体缺少字形时（比如加粗`∁`），Unicode 方法会放弃，而[[pkg:bm]]可能通过复制三份叠加来制造字形（所以出现了`∁∁∁`）。
38 |
39 | 用于测试的具体代码如下，包含大小写拉丁和希腊字母，以及几个特殊符号。
40 |
41 | ```latex
42 | \begin{equation}
43 | \begin{aligned}
44 | & (a, z, B, X) && (\alpha, \beta, \Gamma, \Xi) && (\partial, \complement, \nabla, \perp) \\
45 | & \symbf{(a, z, B, X)} && \symbf{(\alpha, \beta, \Gamma, \Xi)} && \symbf{(\partial, \complement, \nabla, \perp)}
46 | % & \mathbf{(a, z, B, X)} && \mathbf{(\alpha, \beta, \Gamma, \Xi)} && \mathbf{(\partial, \complement, \nabla, \perp)} \\
47 | % & \bm{(a, z, B, X)} && \bm{(\alpha, \beta, \Gamma, \Xi)} && \bm{(\partial, \complement, \nabla, \perp)}
48 | \end{aligned}
49 | \end{equation}
50 | ```
51 |
52 | :::
53 |
54 | ::::
55 |
56 | ## BIThesis
57 |
58 | 请编辑`main.tex`，用`\BITSetup`设置`style/mathFont`选项，例如：
59 |
60 | ```latex {4}
61 | \BITSetup{
62 | …,
63 | style = {
64 | mathFont = termes,
65 | },
66 | }
67 | ```
68 |
69 | 这里`terms`指 TeX Gyre Termes Math 字体，它相当接近 Times New Roman。
70 |
71 | ::: details 二者可见区别
72 | Termes 的斜体`𝑧`和粗斜体`𝒛`最后一笔都是弯的（弯的样子参考上面的效果对比），而 Times 只有粗斜体`𝒛`如此，普通斜体`𝑧`则是直的。
73 |
74 | 以下设置能混合两种字体，让斜体使用 Times；不过数学字体的细节对于学位论文并不重要，而且这种设置方法还会导致 Times 缺少的`∂`等字符无法显示，所以非常不建议使用。
75 |
76 | ```latex
77 | \usepackage{unicode-math}
78 | \setmathfont{texgyretermes-math.otf}
79 | \setmathfont[range=it]{timesi.ttf} % 把斜体替换为 Times，但非常不建议 ⛔
80 | ```
81 |
82 | :::
83 |
84 | 更多字体选择请参考[[texdoc:bithesis]]。
85 |
86 | ::: tip 📥 报错 font cannot be found？请补装字体
87 |
88 | > ! Package fontspec Error:
89 | >
90 | > The font "texgyretermes-math" cannot be found; this may be but usually is not a fontspec bug.
91 | > Either there is a typo in the font name/file, the font is not installed (correctly), or there is a
92 | > bug in the underlying font loading engine (XeTeX/luaotfload).
93 |
94 | 如果您之前精简了 TeX Live 安装内容，报告以上错误，那么需要补装字体：
95 |
96 | ```shell
97 | tlmgr install tex-gyre-math
98 | ```
99 |
100 | :::
101 |
102 | ## 一般 LaTeX 文档
103 |
104 |
105 |
106 | 可以在导言区引入[[pkg:unicode-math]]，并使用 `\setmathfont{…}` 修改数学环境下字体，例如：
107 |
108 | ```latex
109 | \usepackage{unicode-math}
110 | \unimathsetup{
111 | math-style = ISO,
112 | bold-style = ISO,
113 | }
114 | \setmathfont{XITSMath-Regular.otf}
115 | ```
116 |
117 | （部分环境需手动安装字体）
118 |
119 | 更多字体与使用方法请参考[[texdoc:unicode-math]]。
120 |
121 | ## 可能存在的问题
122 |
123 | ### 粗体：`\boldsymbol` → `\symbf`
124 |
125 | [[pkg:unicode]]与上世纪的字体管理方式不兼容。使用[[pkg:unicode]]后，加粗无法使用[[pkg:amsbsy]]的`\boldsymbol`、[[pkg:bm]]的`\bm`、[[pkg:physics]]的`\vb`等。
126 |
127 | 建议使用`\symbf`加粗，`\symup`、`\symit`、`\symcal`等同理。
128 |
129 | ::: details 另法：采用兼容手段
130 |
131 | 也可以考虑兼容手段，例如使用[[pkg:physics2]]的`bm-um.legacy`，或者自己[`\renewcommand*`](https://texfaq.org/FAQ-newcmdstar)：
132 |
133 | ```latex
134 | % Overwrite some commands from physics to be compatible with unicode-math
135 | \RenewCommandCopy\vb\symbf
136 | \renewcommand*{\vdot}{\symbf{\cdot}}
137 | \renewcommand*{\grad}{\symbf{\nabla}}
138 | \renewcommand*{\divergence}{\symbf{\nabla} \vdot}
139 | ```
140 |
141 | :::
142 |
143 | 参考：[LaTeX 排版国标样式的数学符号 - LaTeX工作室](https://www.latexstudio.net/archives/51494)。
144 |
145 | ### 如需兼容[[pkg:mathtools]]
146 |
147 | [[pkg:mathtools]]提供了`gather`环境、`\coloneqq`符号（:=）等命令，但个别命令与[[pkg:unicode-math]]冲突。如需使用，可在导入时关闭警告：
148 |
149 | ```latex {5}
150 | % 注意导入顺序
151 | \usepackage{amsmath}
152 | \usepackage{mathtools}
153 | \usepackage[
154 | warnings-off={mathtools-colon, mathtools-overbracket},
155 | ]{unicode-math}
156 |
157 | \unimathsetup{…}
158 | ```
159 |
160 | ### 字体字面较大
161 |
162 | 如果使用 TeX Gyre Pagella Math 等字面较大的字体，略微增加数学行距可能更美观：
163 |
164 | ```latex
165 | \setmathfont{texgyrepagella-math.otf}
166 | \SetMathEnvironmentSinglespace{1.05}
167 | ```
168 |
169 | 请参考[[texdoc:zhlineskip]]。
170 |
171 | ### 混用字体
172 |
173 | 下例中，主要使用 Latin Modern Math，双线体（如 ℕℤℚℝℂ）使用 TeX Gyre Pagella Math，[空集符号 ∅ 使用 Asana Math](https://tex.stackexchange.com/questions/208014/empty-set-symbols-confused)。
174 |
175 | ```latex
176 | \setmathfont{latinmodern-math.otf}
177 | \setmathfont[range=\mathbb]{texgyrepagella-math.otf}
178 | \setmathfont[range=\varnothing]{Asana-Math.otf}
179 | ```
180 |
181 | 详情请参考[[texdoc:unicode-math]]。
182 |
--------------------------------------------------------------------------------
/wiki/news/2023.md:
--------------------------------------------------------------------------------
1 | # 更新说明：2022年11月至2023年10月
2 |
3 | 相关通知：
4 |
5 | - [关于2023届本科生毕业设计（论文）工作安排的通知 - 教务部 | 北京理工大学](https://jwb.bit.edu.cn/tzgg/9b6fd5d2adda4185bafe988347225292.htm)（2022年10月31日）
6 |
7 | ## [3.6.1] - 2023-10-26
8 |
9 | - 修复了公式与上下文的间距问题。
10 | - 增加了快速使用手册，为替换研究生院官方模板作准备。
11 |
12 | ## [3.6.0] - 2023-10-02
13 |
14 | ## [3.6.0-beta-11-test-2] - 2023-07-13
15 |
16 | ## [3.6.0-beta-11] - 2023-07-13
17 |
18 | ## [3.6.0-beta-10] - 2023-07-08
19 |
20 | ## [3.6.0-beta-9] - 2023-06-01
21 |
22 | 修复了研究生模板在双面打印的情况下，第一章有可能出现在偶数页的问题。
23 |
24 | ## [3.6.0-beta-8] - 2023-05-29
25 |
26 | ## [3.6.0-beta-7] - 2023-05-22
27 |
28 | 关于本科生盲审导出删除封面的配置，需要按照最新的模板中 `main.tex` 里的示例更新一下配置。
29 |
30 | ## [3.6.0-beta-6] - 2023-05-18
31 |
32 | ## [3.6.0-beta-5] - 2023-05-17
33 |
34 | - 修复了 listings 标题样式问题。
35 |
36 | ## [3.6.0-beta-4] - 2023-05-16
37 |
38 | - 大幅度精简了 bithesis.pdf 手册体积。
39 | - 修复了本科模板中附录格式的问题。
40 |
41 | ## [3.6.0-beta-3] - 2023-05-09
42 |
43 | 与之前版本类似。除了：
44 |
45 | - 在盲审模式下也不隐藏书脊和原创性声明。
46 | - 修复了 figure/table/equation 的 `\autoref` 标签。
47 |
48 | ## [3.6.0-beta-2] - 2023-05-08
49 |
50 | ### 本版本为针对研究生盲审的修复版本，主要修复了封面信息隐藏问题
51 |
52 | 本科生不用下载此版本。
53 |
54 | #### 修复错误的目录缩进长度，感谢 @ccyousa 。
55 |
56 | #### 修复 typo 「中图分类号」
57 |
58 | #### **在替换 `bithesis.cls` 以后，在盲审模式下，封面将不再隐藏。** 封面信息如下展示：
59 |
60 | 
61 |
62 | 同时，我们提供了 `\SecretInfo` 接口，用于让你自己控制隐藏信息。
63 |
64 | 
65 |
66 | ## [3.5.4] - 2023-04-30
67 |
68 | ### :clinking_glasses: 五一快乐！预祝盲审顺利！
69 |
70 | 主要修复了：
71 |
72 | - 三级节标题（`\subsubsection`）的样式问题（变为不加粗）。
73 | - 增加了一个可以打开链接颜色的开关（`misc/hideLinks`）。
74 |
75 | ## [3.5.4-alpha-1] - 2023-04-25
76 |
77 | 预览版本，供测试使用。
78 |
79 | ## [3.5.3] - 2023-04-23
80 |
81 | 本次更新提供以下样式修复：
82 |
83 | 1. 表格字号默认设置为 5 号字，更符合学校规范要求。
84 |
85 | 
86 |
87 | 2. 预设了 `\autoref` 的默认文字。
88 |
89 | 
90 |
91 | ## [3.5.2] - 2023-04-14
92 |
93 | 本次更新引入了大量针对样式的修复：
94 |
95 | - 修复盲审模式下「攻读学位期间发表论文与研究成果清单」作者对齐问题。
96 | - 修复 `\subsubsection` 前后间距问题
97 | - 调整本科生模板图片、表格前后一行空白行距离
98 | - 修复图片、表格目录的标题和行间距问题。
99 | - 显示增加班级字段的配置选项。
100 |
101 | ## [3.5.1] - 2023-04-07
102 |
103 | - 修复了 `listofx` 邻接 `\mainmatter` 时错误的页眉格式。
104 |
105 | ## [3.5.0] - 2023-04-04
106 |
107 | 此版本带来了一些更新与问题修复：
108 |
109 | - 新功能：文本默认垂直对齐上方（而不是分散对齐），更接近 Word 样式。在多图的时候排版更美观。用户可以选择还原到旧样式。
110 | - 新功能：增加多种数学字体的选项。
111 | - 修复 `listoffigure` 和 `listoftable` 目录的错误样式，目前和旧 $\LaTeX$ 模板一致（Word 没有给出这部分模板）。
112 | - 在文档中增加了关于“如何得到类似于 Word 中文字体”的方法说明。
113 |
114 | 请根据手册中提供的方法进行升级，升级前请做好备份。
115 |
116 | ## [3.4.3] - 2023-03-16
117 |
118 | **此版本带来了很多更新**：
119 |
120 | - 启用伪粗体以保证粗宋体可以得到类似 Word 中的效果。
121 | - 下线了本科毕设开题报告模板（计算机学院），因为学校已采用在线系统提交的方式。
122 | - 移除了默认对 `unicode-math` 的依赖，现在默认采用 `amsmath` ，更符合用户直觉。
123 | - 关闭了参考文献的 `gbpunctin` 以更接近北理工的论文格式。
124 | - 增加了 `english=true` 的模板选项，以支持研究生英文模板的使用。
125 | - 并修复了一些细节问题。
126 |
127 | 更新到新版本的方法请参考 `bithesis.pdf` 手册。
128 |
129 | ## [3.4.2] - 2023-03-05
130 |
131 | - 按照新的模板，修复了本科生毕设模板的封面问题。
132 | - 重命名了 `theorem` 环境，以解决冲突问题。（存在 break change）
133 |
134 | ## [3.4.1] - 2023-03-02
135 |
136 | 这一版本没有提供任何新功能或者修复。主要是增加了模板中的 `magic comments`，使得大部分编辑器能够自动识别编译所需要使用的工具链。
137 | 从这个版本开始，使用 `TeXstudio` 等工具应该不需要再手动配置工具链，直接编译即可。
138 |
139 | ## [3.4.0] - 2023-02-20
140 |
141 | - 新功能：可以通过选项配置「研究成果清单」中姓名的显示数量，以防止自己的名字被省略。
142 | - 修复：抑制了关于字体的警告消息，以防引起用户的疑惑。
143 |
144 | ## [3.3.2] - 2023-02-17
145 |
146 | 修复了研究生模板中关键词的字体字形问题。
147 |
148 | ## [3.3.1] - 2023-02-11
149 |
150 | - 研究生模板针对空白页问题进行修复，现在默认启用双页打印的格式（`twoside`）。（如果你从原有版本升级而来，可以在升级后手动开启 `twoside` 模式）
151 | - 修复多处文档问题，包括有关数学字体替换的兼容性问题和示例代码的吞字问题。
152 |
153 | ## [3.3.0] - 2023-02-03
154 |
155 | ### :firecracker: **新年快乐！又要开学啦！**
156 |
157 | - 增加了新的模板选项 `quirks` 用于兼容北理工特殊格式（详情请查看手册或 #209 ）。
158 | - 更新、修复了多处文档问题。
159 |
160 | ## [3.3.0-alpha-1] - 2023-01-20
161 |
162 | 更新方式：从旧版本升级到此版本，只需要直接替换 bithesis.cls 文件即可。
163 |
164 | - 在模板类选项中，引入了 quirks 模式，开启后支持一些针对北理工特殊格式的细节上的适配。
165 |
166 | 开启方法：
167 |
168 | ```diff
169 | % 在 main.tex 中使用 quirks 即可。
170 | - \documentclass[type=master]{bithesis}
171 | + \documentclass[type=master,quirks]{bithesis}
172 | ```
173 |
174 | ## [3.2.3] - 2022-12-30
175 |
176 | - 修复了研究生模板中，PDF 中附录书签的错误索引（感谢 @oPengLuo 提供的反馈）。
177 | - 修复文件名错误拼写。
178 |
179 | 更新方式：从旧版本升级到此版本，只需要直接替换 bithesis.cls 文件即可。
180 |
181 | ## [3.2.3-alpha-1] - 2022-12-28
182 |
183 | 修复 PDF 中，附录目录的错误索引。（只有以章节（`\chapter`）为附录目录的模板存在此问题。）
184 |
185 | 从旧版本升级到此版本，只需要直接替换 `bithesis.cls` 文件即可。
186 |
187 | ## [3.2.2] - 2022-12-22
188 |
189 | 修复了本科生外文翻译模板中，重复的「参考文献」标题的问题。
190 | 对其他模板没有影响。
191 |
192 | ## [3.2.1] - 2022-12-19
193 |
194 | 感谢 @KaysinBIT 提供的反馈。
195 |
196 | 本次小版本提升主要优化了生成 PDF 的书签样式。
197 |
198 | ## [3.2.1-alpha-1] - 2022-12-15 {title="Preview Release for v3.2.1"}
199 |
200 | PR #194
201 |
202 | ## [3.2.0] - 2022-12-04
203 |
204 | 本次更新主要增加了以下内容：
205 |
206 | - 增加了自适应下划线的空白填充。简而言之，现在你可以通过 `cover/autoWidthPadding` 为封面的每个信息项的首尾添加一个空白间距，使得排版更美观。
207 | - 丰富了[开发者文档](https://github.com/BITNP/BIThesis/blob/main/DEVELOPMENT.md)
208 |
--------------------------------------------------------------------------------
/wiki/guide/ask-computer.md:
--------------------------------------------------------------------------------
1 | ---
2 | outline:
3 | level: 2 # 屏蔽人工智能回复中的标题
4 | ---
5 |
6 | # 🤖 询问人工智能
7 |
8 |
9 |
10 | 如果遇到问题，你可以——
11 |
12 | 1. 搜索本站 [🥑 疑难杂症](../faq/)（搜索栏在页面上方）
13 | 2. 查询互联网及 🤖 人工智能
14 | 3. 询问同学，可加入 [🐧 QQ 群：737548118](https://jq.qq.com/?_wv=1027&k=KYDrmS5z)
15 |
16 | 下面介绍“询问人工智能”的实例。
17 |
18 | [[toc]]
19 |
20 | > [!IMPORTANT] 🖖 欢迎贡献
21 | >
22 | > 如果你估计也能帮到别人，欢迎[增改疑难解答页面](../faq/index.md#如何贡献)甚至[修改模板本身](https://github.com/BITNP/BIThesis/blob/main/DEVELOPMENT.md)。
23 |
24 | ## 用 LaTeX 实现特定效果
25 |
26 | 直接加上“LaTeX”问通用大语言模型即可。例如：
27 |
28 | > [LaTeX 如何把`\listoffigures`加进目录？](https://www.doubao.com/thread/we453a08700029c49)
29 |
30 | ::: details 🤖 人工智能的回复
31 |
32 | 在 LaTeX 里，要把 `\listoffigures` 加入目录，可借助 `tocbibind` 宏包或者手动添加。下面为你分别介绍这两种方法：
33 |
34 | ### 方法一：使用 `tocbibind` 宏包
35 |
36 | `tocbibind` 宏包能够自动把目录、图目录、表目录等加入主目录。下面是示例代码：
37 |
38 | ```latex
39 | \documentclass{article}
40 | \usepackage{tocbibind} % 加载 tocbibind 宏包
41 |
42 | \begin{document}
43 | \tableofcontents % 生成目录
44 | \listoffigures % 生成图目录
45 |
46 | \section{示例部分}
47 | \begin{figure}[h]
48 | \centering
49 | \rule{2cm}{2cm} % 这里用一个方块代表图形
50 | \caption{示例图形}
51 | \end{figure}
52 | \end{document}
53 | ```
54 |
55 | 在这个示例中，`tocbibind` 宏包被加载之后，`\listoffigures` 就会自动被加入到主目录里。
56 |
57 | ### 方法二：手动添加
58 |
59 | 要是不想使用宏包，也能手动把 `\listoffigures` 加到目录中。示例代码如下：
60 |
61 | ```latex
62 | \documentclass{article}
63 |
64 | \begin{document}
65 | \tableofcontents % 生成目录
66 | \addcontentsline{toc}{section}{\listfigurename} % 手动添加图目录到目录
67 | \listoffigures % 生成图目录
68 |
69 | \section{示例部分}
70 | \begin{figure}[h]
71 | \centering
72 | \rule{2cm}{2cm} % 这里用一个方块代表图形
73 | \caption{示例图形}
74 | \end{figure}
75 | \end{document}
76 | ```
77 |
78 | 在这段代码里，`\addcontentsline{toc}{section}{\listfigurename}` 这行代码把图目录手动添加到了主目录中。`toc` 表示要添加到目录，`section` 表示添加的条目级别，`\listfigurename` 代表图目录的名称。
79 |
80 | 你可以把上述代码复制到 LaTeX 编辑器里进行编译，这样就能看到图目录被添加到主目录中的效果了。
81 |
82 | :::
83 |
84 | ::: tip 🧠 分析测试
85 |
86 | 1. 回复中的方法一使用[[pkg:tocbibind]]，之前没听说过，也许不兼容我加的其它宏包，先看看方法二。
87 |
88 | 2. 回复中的方法二手动添加，按照提示编辑`main.tex`，重新编译。
89 |
90 | 3. 检查 PDF，发现确实加进目录了，但没对齐，比“第1章”靠右。
91 |
92 | 4. 仔细阅读回复，注意到“`section`表示添加的条目级别”，而新加的目录项也确实和 §1.1 对齐了。
93 |
94 | 5. 改成`chapter`重试，成功。最终设置如下。
95 |
96 | ```latex
97 | \addcontentsline{toc}{chapter}{\listfigurename}
98 | ```
99 |
100 | :::
101 |
102 | ## 调试错误
103 |
104 | 问通用大语言模型，并尽可能附上相关代码、报错日志。
105 |
106 | 很多在线平台已经集成。
107 |
108 | - Overleaf 每隔一段时间免费用一次，具体限制没有明写。
109 | - [TeXPage 免费版 5 次/天](https://www.texpage.com/zh/pricing)。
110 |
111 | （截至2025年10月）
112 |
113 | ## 使用 BIThesis 模板
114 |
115 | [我校智能体广场的LaTeX-BIThesis帮助](https://agent.bit.edu.cn/product/llm/chat/d05ee4rha6ps7396rueg)已导入知识库，可直接使用；不过没有那么聪明，最好看一下“回答来源”……
116 |
117 | > 请问封面这个横线中的内容不用靠左吗？
118 |
119 | ::: details 🤖 人工智能的初次回复
120 |
121 | 封面横线中的内容对齐方式可以进行设置。你可以通过`cover/valueAlign`选项来设置封面信息中值（也就是横线中的内容）的对齐方式，该选项有`c`（居中）、`l`（左对齐）、`r`（右对齐）三种可选值。不过需要注意的是，此选项仅当`cover/autoWidth = false`时生效。你可以查阅相关文档以确保设置的准确性。
122 |
123 | 📃找到 3 个回答来源
124 |
125 | :::
126 |
127 | 回复提到“仅当……时生效”，于是选一下推荐问题：
128 |
129 | > `cover/autoWidth`怎么设置
130 |
131 | ::: details 🤖 人工智能的补充回复
132 |
133 | `cover/autoWidth` 选项一般不需要用户自行修改，它可以设置为 `true` 或 `false`。设置为 `true` 时，会自动计算封面中下划线的长度；若设置为 `false`，则建议配合 `cover/labelMaxWidth = ⟨ 长度 ⟩` 和 `cover/valueMaxWidth = ⟨ 长度 ⟩` 使用，以控制下划线的长度。你可以查阅相关文档以确保设置的准确性。
134 |
135 | 📃找到 3 个回答来源（和初次回复相同）
136 |
137 | :::
138 |
139 | 最终设置如下。
140 |
141 | ```latex {4-5}
142 | \BITSetup{
143 | cover = {
144 | …,
145 | autoWidth = false,
146 | valueAlign = l,
147 | },
148 | …
149 | }
150 | ```
151 |
152 | ## 使用一般模板、宏包
153 |
154 | 1. 从 [texdoc 在线版](https://texdoc.org)或其它地方[下载宏包手册](../faq/where-doc.md)
155 | 2. 将问题与手册一并发给通用大语言模型
156 |
157 | > [请问封面这个横线中的内容不用靠左吗？](https://chatglm.cn/share/F3rJt)
158 | >
159 | > （同时发送`bithesis.pdf`）
160 |
161 | ::: details 🤖 人工智能的回复
162 |
163 | 根据您提供的文档内容，封面横线中的内容默认对齐方式是 **居中**，而不是靠左。
164 | **文档中相关内容**：
165 |
166 | - **5.3.1 封面选项** 部分的 `cover/labelAlign` 选项用于设置封面信息中标签的对齐方式，其默认值为 `c`，代表 **居中** 对齐。【P14】
167 | - **5.3.1 封面选项** 部分的 `cover/valueAlign` 选项用于设置封面信息中值的对齐方式，其默认值为 `c`，代表 **居中** 对齐。【P14】
168 |
169 | **结论**：
170 |
171 | 封面横线中的内容默认是居中对齐的，如果您需要将其改为靠左对齐，可以修改 `cover/labelAlign` 和 `cover/valueAlign` 选项的值为 `l`，代表 **左对齐**。
172 |
173 | :::
174 |
175 | 然后选择页码，跳转阅读手册原文。
176 |
177 | ## 修改 BIThesis 模板
178 |
179 | 1. 在`bithesis.cls`中找到相关代码
180 | 2. 将问题与代码一并发给通用大语言模型
181 |
182 | > [LaTeX 插图列表的编号既有一位数又有两位数，目前设置如下，编号与标题间距固定，导致标题没对齐。如何让标题左对齐？](https://yuanbao.tencent.com/bot/app/share/chat/S2RzZyfJtmeK)
183 | >
184 | > ```latex
185 | > \titlecontents{figure}[0pt]{\songti\zihao{-4}}
186 | > {\figurename~\thecontentslabel\quad}{\hspace*{-1.5cm}}
187 | > {\hspace{.5em}\titlerule*{.}\contentspage}
188 | > ```
189 |
190 | 最初未启用“深度思考”，回复太离谱，于是启用重试。
191 |
192 | ::: details 🤖 人工智能“深度思考”后的回复
193 |
194 | 要让插图列表的标题左对齐，无论编号位数如何，可以通过固定编号的显示宽度实现。修改你的 `\titlecontents` 设置如下：
195 |
196 | ```latex
197 | \usepackage{titletoc}
198 | % 在导言区添加以下代码：
199 |
200 | \titlecontents{figure}[0pt]% 左缩进设为0
201 | {\songti\zihao{-4}\filright}% 整体格式（右对齐编号部分）
202 | {\figurename~\makebox[2em][l]{\thecontentslabel}}% 编号格式（固定2em左对齐）
203 | {}% 无编号条目格式（通常图表都有编号）
204 | {\titlerule*{.}\contentspage}% 填充和页码格式
205 | ```
206 |
207 | 原理解释：
208 |
209 | 1. `\makebox[2em][l]` 为编号创建固定宽度（2em）的盒子，强制编号左对齐，无论1位还是2位数字都会占满这个宽度
210 | 2. 删除原代码中破坏对齐的 `\hspace*{-1.5cm}`，改用固定宽度策略
211 | 3. `\filright` 确保编号部分右对齐，标题文本从固定位置开始
212 |
213 | 效果：
214 |
215 | ```
216 | 图 1 标题内容.............1
217 | 图 10 标题内容.............5
218 | ```
219 |
220 | 调整建议：
221 | 如果发现间距不合适，可通过修改 `2em` 的数值适配你的具体字体宽度。建议先测试 2em，如果两位数显示不全，可尝试增大到 3em。
222 |
223 | :::
224 |
225 | ::: tip 🧠 分析测试
226 |
227 | 1. 回复中改了三处，看起来只有`\makebox`这处相关，先忽略其它两处看看。
228 | 2. 在[[texdoc:lshort-zh-cn]]中搜索`\makebox`，发现有相关介绍，看来比较可靠。
229 | 3. 编辑`main.tex`在导言区粘贴原始代码，然后按提示给`\thecontentslabel`套上`\makebox[2em][l]{…}`，重新编译。
230 | 4. 检查 PDF，效果还行。
231 | 5. 再微调下具体数值，最终设置如下。
232 |
233 | ```latex {2}
234 | \titlecontents{figure}[0pt]{\songti\zihao{-4}}
235 | {\figurename~\makebox[4em][l]{\thecontentslabel}}{\hspace*{-1.5cm}}
236 | {\hspace{.5em}\titlerule*{.}\contentspage}
237 | ```
238 |
239 | :::
240 |
--------------------------------------------------------------------------------
/wiki/video/episode-3.md:
--------------------------------------------------------------------------------
1 | # 第三节 LaTeX 基本介绍
2 |
3 |
4 |
5 |
6 |
7 | ## 视频相关说明
8 |
9 | ### 编译
10 |
11 | - 定义 `latexmk` 这一工具：
12 |
13 | ```json
14 | "latex-workshop.latex.tools": [
15 | {
16 | "name": "latexmk",
17 | "command": "latexmk",
18 | "args": [
19 | "-synctex=1",
20 | "-interaction=nonstopmode",
21 | "-file-line-error",
22 | "-xelatex",
23 | "-outdir=% OUTDIR%",
24 | "-cd",
25 | "% DOC%"
26 | ],
27 | "env": {}
28 | },
29 | ]
30 | ```
31 |
32 | - 定义整个工具链：
33 |
34 | ```json
35 | "latex-workshop.latex.recipes": [
36 | {
37 | "name": "latexmk",
38 | "tools": [
39 | "latexmk"
40 | ]
41 | },
42 | ]
43 | ```
44 |
45 | ### 初步使用 LaTeX
46 |
47 | - LaTeX 初尝试：
48 |
49 | ```latex
50 | \documentclass{article}
51 |
52 | \begin{document}
53 | First document. This is a simple example, with no
54 | extra parameters or packages included.
55 | \end{document}
56 | ```
57 |
58 | - 标题，作者和日期示例：
59 |
60 | ```latex
61 | \documentclass{article}
62 |
63 | \title{First document}
64 | \author{Hubert Farnsworth
65 | \thanks{funded by the Overleaf team}}
66 | \date{February 2017}
67 | \begin{document}
68 | \maketitle
69 | We have now added a title, author and date to our first \LaTeX{} document!
70 | \end{document}
71 | ```
72 |
73 | - 文本格式化命令：
74 |
75 | ```latex
76 | \documentclass{article}
77 | \usepackage{graphicx}
78 | \graphicspath{{images/}}
79 | \begin{document} The universe is immense and it seems to be homogeneous, in a large scale, everywhere we look at.
80 | \begin{center}\includegraphics{universe}\end{center}
81 | There's a picture of a galaxy above.
82 | \end{document}
83 | ```
84 |
85 | - 添加图片示例：
86 |
87 | ```latex
88 | \documentclass{article}
89 | \usepackage{graphicx}
90 | \graphicspath{{images/}}
91 |
92 | \begin{document}
93 | The universe is immense and it seems to be homogeneous, in a large scale, everywhere we look at.
94 |
95 | \begin{center}
96 | \includegraphics{universe}
97 | \end{center}
98 |
99 | There's a picture of a galaxy above.
100 | \end{document}
101 | ```
102 |
103 | - 图片添加标题，标签和参考示例：
104 |
105 | ```latex
106 | \documentclass{article}
107 | \usepackage{graphicx}
108 | \graphicspath{{images/}}
109 |
110 | \begin{document}
111 |
112 | \begin{figure}[h]
113 | \centering
114 | \includegraphics[width=0.25\textwidth]{universe}
115 | \caption{a nice plot}
116 | \label{fig:mesh1}
117 | \end{figure}
118 |
119 | As you can see in the figure\ref{fig:mesh1}, the function grows near 0. Also, in the page\pageref{fig:mesh1} is the same example.
120 | \end{document}
121 | ```
122 |
123 | - 表格示例：
124 |
125 | ```latex
126 | \documentclass{article}
127 |
128 | \begin{document}
129 | \begin{center}
130 | \begin{tabular}{c c c}
131 | cell1 & cell2 & cell3 \\
132 | cell4 & cell5 & cell6 \\
133 | cell7 & cell8 & cell9
134 | \end{tabular}
135 | \end{center}
136 | \end{document}
137 | ```
138 |
139 | - 无序列表示例：
140 |
141 | ```latex
142 | \documentclass{article}
143 |
144 | \begin{document}
145 | \begin{itemize}
146 | \item The individual entries are indicated with a black dot, a so-called bullet.
147 | \item The text in the entries may be of any length.
148 | \end{itemize}
149 | \end{document}
150 | ```
151 |
152 | - 有序列表示例：
153 |
154 | ```latex
155 | \documentclass{article}
156 |
157 | \begin{document}
158 | \begin{enumerate}
159 | \item This is the first entry in our list
160 | \item The list numbers increase with each entry we add
161 | \end{enumerate}
162 | \end{document}
163 | ```
164 |
165 | - 添加数学公式示例：
166 |
167 | ```latex
168 | \documentclass{article}
169 |
170 | \begin{document}
171 | The mass-energy equivalence is described by the famous equation\[E=mc^2\] discovered in 1905 by Albert Einstein. In natural units ($c=1$), the formula expresses the identity
172 |
173 | \begin{equation}
174 | E=m
175 | \end{equation}
176 | \end{document}
177 | ```
178 |
179 | - 论文摘要示例：
180 |
181 | ```latex
182 | \documentclass{article}
183 |
184 | \begin{document}
185 | \begin{abstract}
186 | This is a simple paragraph at the beginning of the document. A brief introduction about the main subject.
187 | \end{abstract}
188 | \end{document}
189 | ```
190 |
191 | - 换行示例：
192 |
193 | ```latex
194 | \documentclass{article}
195 | \begin{document}
196 |
197 | Now that we have written our abstract, we can begin writing our first paragraph.
198 |
199 | This line will start a second Paragraph.
200 | \end{document}
201 | ```
202 |
203 | - 添加章节示例：
204 |
205 | ```latex
206 | \documentclass{article}
207 | \begin{document}
208 |
209 | \section{Introduction}
210 | This is the first section.Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam lobortisfacilisis sem.
211 |
212 | \section{Second Section}
213 | Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam lobortis facilisissem.
214 |
215 | \subsection{First Subsection}
216 | Praesent imperdietmi nec ante. Donec ullamcorper, felis non sodales...
217 |
218 | \section*{Unnumbered Section}
219 | Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam lobortis facilisissem
220 | \end{document}
221 | ```
222 |
223 | - 添加目录示例：
224 |
225 | ```latex
226 | \documentclass{article}
227 | \usepackage[utf8]{inputenc}
228 |
229 | \title{Sections and Chapters}
230 | \author{Gubert Farnsworth}
231 | \date{}
232 |
233 | \begin{document}
234 | \maketitle
235 | \tableofcontents
236 |
237 | \section{Introduction} This is the first section.
238 | \addcontentsline{toc}{section}{Unnumbered Section}
239 | \section*{Unnumbered Section} Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
240 | \section{Second Section} Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
241 | \end{document}
242 | ```
243 |
244 | - [Overleaf 官方文档](https://www.overleaf.com/learn/latex/Main_Page)
245 |
--------------------------------------------------------------------------------
/wiki/news/2025.md:
--------------------------------------------------------------------------------
1 | # 更新说明：2024年11月至2025年10月
2 |
3 | 相关通知：
4 |
5 | - **本科生**
6 | - [关于2024-2025学年本科生毕业设计（论文）工作安排的通知 - 教务部 | 北京理工大学](https://jwb.bit.edu.cn/tzgg/9285cb76d5d94deea31e5c632bc58a70.htm)（2024年10月28日）
7 |
8 | - [关于开展2025年本科毕业设计（论文）检测、评阅、抽检及答辩相关工作的通知 - 教务部 | 北京理工大学](https://jwb.bit.edu.cn/tzgg/2775d173038b465299f6e32818d09912.htm)（2025年5月8日）
9 |
10 | `附件3 本科毕业设计（论文）模板及打印装订要求.rar`
11 |
12 | - [毕设加油站之BIThesis毕设LaTeX模板 - 北京理工大学教务部微信公众号](https://mp.weixin.qq.com/s/9lfXYmImLLL1Nc3BR6si4A)（2025年5月19日）
13 |
14 | - **研究生**
15 | - [关于2025年夏季研究生学位论文评阅、学位答辩及申请相关工作的通知-通知公告-北京理工大学研究生院](https://grd.bit.edu.cn/xwgz/xwgz2/tzgg_xwgz/eee4d72dc39b437dbacb3786dd8a4baf.htm)（2025年4月2日）
16 |
17 | - [研究生学位论文模版-2025更新-文件下载-北京理工大学研究生院](https://grd.bit.edu.cn/xwgz/xwgz2/wjxz_xwgz/b119746.htm)
18 |
19 | `封面-{学术型,专业型}-2025.docx`、`学位论文模版-{学术型,专业型}-2025.doc`
20 |
21 | - [LaTeX学位论文模板-2025更新-文件下载-北京理工大学研究生院](https://grd.bit.edu.cn/xwgz/xwgz2/wjxz_xwgz/b117824.htm)（2025年4月8日）
22 |
23 | `BIThesis-graduate-thesis-template-3.8.3.zip`、`升级指南.pdf`
24 |
25 | - [北京理工大学研究生学位论文撰写规范-文件下载-北京理工大学研究生院](https://grd.bit.edu.cn/xwgz/xwgz2/wjxz_xwgz/b117825.htm)
26 |
27 | `北京理工大学研究生学位论文撰写规范（研函〔2018〕60 号）.pdf`
28 |
29 | ## [3.8.6] - 2025-10-17
30 |
31 | ## [3.8.6-beta-1] - 2025-05-21
32 |
33 | ## [3.8.5] - 2025-05-15
34 |
35 | 与 v3.8.4 相比，主要是修复小问题。如无需要，可以不升级。
36 |
37 | ### 🐛 Bug Fixes
38 |
39 | - 汉化 algorithms 和 algorithm2e 包，并更正字号 ([76579b9](https://github.com/BITNP/BIThesis/commit/76579b9cff54fd08495feb0df50dbfed9c47cf2b)) by @YDX-2147483647
40 |
41 | 若已在`*.tex`中自行汉化或调整字号，应该仍然生效，无需专门改动。
42 |
43 | - TeX Live 2022/2023 或更早版本无法发出警告 ([bdfc3cc](https://github.com/BITNP/BIThesis/commit/bdfc3cce8d88362392af7624b1326bad8b42212b)) by @YDX-2147483647 in [#636](https://github.com/BITNP/BIThesis/pull/636)
44 |
45 | 对于硕博模板，如果未按[硕博升级指南](https://bithesis.bitnp.net/news/2025.html#硕博升级指南)操作就升级到 v3.8.3+，会警告缺少文件。然而若使用旧版 TeX Live，该警告操作会导致文档无法编译，引发困惑。此次修复让警告能正常发出了；当然，仍需按警告提示下载缺失的文件。
46 |
47 | ## [3.8.5-alpha-3] - 2025-05-03
48 |
49 | ## [3.8.5-alpha-2] - 2025-04-24
50 |
51 | 这个测试版主要是修复小问题。如无需要，可以不升级。
52 |
53 | ### 🐛 Bug Fixes
54 |
55 | - 汉化 algorithms 和 algorithm2e 包，并更正字号 ([76579b9](https://github.com/BITNP/BIThesis/commit/76579b9cff54fd08495feb0df50dbfed9c47cf2b)) by @YDX-2147483647
56 |
57 | 若已在`*.tex`中自行汉化或调整字号，应该仍然生效，无需专门改动。
58 |
59 | - TeX Live 2022/2023 或更早版本无法发出警告 ([bdfc3cc](https://github.com/BITNP/BIThesis/commit/bdfc3cce8d88362392af7624b1326bad8b42212b)) by @YDX-2147483647 in [#636](https://github.com/BITNP/BIThesis/pull/636)
60 |
61 | 对于硕博模板，如果未按[硕博升级指南](https://bithesis.bitnp.net/news/2025.html#硕博升级指南)操作就升级到 v3.8.3+，会警告缺少文件。然而若使用旧版 TeX Live，该警告操作会导致文档无法编译，引发困惑。此次修复让警告能正常发出了；当然，仍需按警告提示下载缺失的文件。
62 |
63 | ## [3.8.5-alpha-1] - 2025-04-24
64 |
65 | （存在问题，请忽略）
66 |
67 | ## [3.8.4] - 2025-04-18
68 |
69 |
70 |
71 | 此版本只修改了封面、摘要等前置内容，对正文无影响。如无需要，可以不更新。
72 |
73 | ### 🚀 Features
74 |
75 | - 支持在PDF书签中隐去封面、书脊、题名页、声明，如`\MakeCover[bookmarked = false]` ([186e09a](https://github.com/BITNP/BIThesis/commit/186e09a741f2e4e8d712afc7db4dd59627554100)) by @YDX-2147483647
76 |
77 | ```latex
78 | \MakeCover[bookmarked = false]
79 | \MakePaperBack[bookmarked = false]
80 | \MakeTitle % 默认 bookmarked = true
81 | \MakeOriginality[bookmarked = false]
82 | ```
83 |
84 | - 支持用`title`修改`conclusion`环境内的标题 ([0eb90b6](https://github.com/BITNP/BIThesis/commit/0eb90b699246895cbb5a9b25dc00b27d6d33a92e)) by @YDX-2147483647
85 |
86 | ```latex
87 | \begin{conclusion}[title = 结论与 $\lim_{t \to +\infty}$]
88 | 如需更改，可设置 title。
89 | \end{conclusion}
90 | ```
91 |
92 | ## [3.8.3] - 2025-04-08
93 |
94 | 这个版本主要是适应2025年三月末新研究生模板。
95 |
96 | - 硕博模板
97 | - 若已在用[之前 v3.8.3-alpha-1 测试版](https://github.com/BITNP/BIThesis/releases/tag/v3.8.3-alpha-1)：这次基本没有变化，可以不升级；如想升级，替换`bithesis.cls`即可。
98 | - 若在用 [v3.8.2](https://github.com/BITNP/BIThesis/releases/tag/v3.8.2) 或更早版本：因为要填信息，不能像往常一样单纯替换`bithesis.cls`；请参考以下升级指南。
99 |
100 | - 本科模板：升级仍只需替换`bithesis.cls`。
101 |
102 | ### 硕博升级指南
103 |
104 | 0. 下载新的[模板包](https://github.com/BITNP/BIThesis/releases/download/v3.8.3/graduate-thesis.zip)并解压。
105 | 1. 用新的`bithesis.cls`替换旧的`bithesis.cls`。
106 | 2. 将新的`misc/icon_{academic,professional}.jpg`复制到旧的`misc/`。
107 | 3. 参考新的`main.tex`重新填写`\BITSetup{ info = {…} }`：
108 | - 增加学号`studentId`（用于封皮）、研究生类型`degreeType`（学术型`academic`、专业型`professional`）。
109 | - 若是专业型研究生，增加行业合作导师`industrialMentor{,En}`。
110 | - 若是工程硕博士专项，增加`工程硕博士专项 = true`。
111 | 4. 重新编译。
112 |
113 | 此外，关于 #584 图表标题与周围文字的间距异常（特别是 float 宏包），可以用`\captionsetup[figure]{belowskip = 0pt}`微调。
114 |
115 | ::: details 补充：如果三种类型都不是，封面「学生类型」信息框为美观默认关闭，可以手动开启。
116 |
117 | 请编辑`main.tex`：
118 |
119 | ```diff
120 | \BITSetup{
121 | cover = {
122 | …
123 | autoWidthPadding = 0.25em,
124 | + showSpecialTypeBox = true,
125 | },
126 | ```
127 |
128 | 以前和研究生院确认过这个信息框重要程度比较低，这回还没有问。如果有人通知要始终保留，欢迎分享，LaTeX模板可以改一下默认行为。
129 |
130 | :::
131 |
132 | ## [3.8.3-alpha-1] - 2025-03-31
133 |
134 | ### 硕博升级指南
135 |
136 | 这个测试版主要是适应2025年三月末新研究生模板。因为要填信息，不能像往常一样单纯替换`bithesis.cls`；请如下操作。
137 |
138 | 0. 下载新的[模板包](https://github.com/BITNP/BIThesis/releases/download/v3.8.3-alpha-1/graduate-thesis.zip)并解压。
139 | 1. 用新的`bithesis.cls`替换旧的`bithesis.cls`。
140 | 2. 将新的`misc/icon_{academic,professional}.jpg`复制到旧的`misc/`。
141 | 3. 参考新的`main.tex`重新填写`\BITSetup{ info = {…} }`：
142 | - 增加学号`studentId`（用于封皮）、研究生类型`degreeType`（学术型`academic`、专业型`professional`）。
143 | - 若是专业型研究生，增加行业合作导师`industrialMentor{,En}`。
144 | - 若是工程硕博士专项，增加`工程硕博士专项 = true`。
145 | 4. 重新编译。
146 |
147 | 此外，关于 #584 图表标题与周围文字的间距异常（特别是 float 宏包），可以用`\captionsetup[figure]{belowskip = 0pt}`微调。
148 |
149 | （本科不受影响，升级仍只需替换`bithesis.cls`，当然不升级也可以。）
150 |
151 | #### 补充（2025年4月3日傍晚）
152 |
153 | 如果三种类型都不是，封面「学生类型」信息框为美观默认关闭。如需开启，请编辑`main.tex`：
154 |
155 | ```diff
156 | \BITSetup{
157 | cover = {
158 | …
159 | autoWidthPadding = 0.25em,
160 | + showSpecialTypeBox = true,
161 | },
162 | ```
163 |
164 | 以前和研究生院确认过这个信息框重要程度比较低，这回还没有问。如果有人通知要始终保留，欢迎分享，LaTeX模板可以改一下默认行为。
165 |
166 | ## [3.8.2] - 2025-03-25
167 |
168 | v3.8.2 主要更改：
169 |
170 | - 改善文档，特别是将以前散落各处的FAQ整理成了 [🥑 疑难杂症 (bithesis.bitnp.net/faq)](https://bithesis.bitnp.net/faq/)。
171 | - 对于硕博模板，参考学校规定调整了图表前后的间距，原先间距过大。
172 |
173 | 如果使用本科模板，或者不介意间距，可以不更新`bithesis.cls`。
174 |
175 | ## [3.8.1] - 2025-01-03
176 |
--------------------------------------------------------------------------------
/wiki/faq/bib-entry.md:
--------------------------------------------------------------------------------
1 | ---
2 | tag:
3 | - biblatex-gb7714-2015
4 | ---
5 |
6 | # 参考文献书写示例
7 |
8 |
13 |
14 | 利用以下代码，可以生成北京理工大学本科Word模板中“不同类别文献书写规范要求”的示例。
15 |
16 | 更多例子与说明请参考：
17 |
18 | - [GB/T 7714—2015《信息与文献 参考文献著录规则》](https://lib.tsinghua.edu.cn/wj/GBT7714-2015.pdf)
19 | - [[texdoc:biblatex-gb7714-2015]]
20 |
21 | ## 期刊
22 |
23 | 主要责任者. 文献题名[J]. 刊名, 出版年份, 卷号(期号): 起止页码.
24 |
25 | - 余雄庆. 飞机总体多学科设计优化的现状与发展方向[J]. 南京航空航天大学学报, 2008(04): 417-426.
26 | - Hajela P, Bloebaum C L, Sobieszczanski-Sobieski J. Application of Global Sensitivity Equations in Multidisciplinary Aircraft Synthesis[J]. Journal of Aircraft, 1990, 27(12): 1002-110.
27 |
28 | ```bibtex
29 | @article{yuFeiJiZongTiDuoXueKeSheJiYouHuaDeXianZhuangYuFaZhanFangXiang2008,
30 | title = {飞机总体多学科设计优化的现状与发展方向},
31 | author = {余, 雄庆},
32 | date = {2008},
33 | journaltitle = {南京航空航天大学学报},
34 | pages = {417--426},
35 | issn = {1005-2615},
36 | url = {https://kns.cnki.net/kcms/detail/detail.aspx?filename=NJHK200804000&dbcode=CJFQ&dbname=CJFD2008&v=},
37 | urldate = {2020-02-29},
38 | keywords = {aircraft design,multidisciplinary design optimization,optimization,优化,多学科设计优化,飞行器设计},
39 | langid = {中文;},
40 | number = {04}
41 | }
42 | @article{Hajela2012Application,
43 | title={Application of Global Sensitivity Equations in Multidisciplinary Aircraft Synthesis},
44 | author={Hajela, P. and Bloebaum, C. L. and Sobieszczanski-Sobieski, Jaroslaw},
45 | journal={Journal of Aircraft},
46 | volume={27},
47 | number={12},
48 | pages = {1002-110},
49 | year={1990},
50 | }
51 | ```
52 |
53 | ## 普通图书
54 |
55 | 主要责任者. 文献题名[M]. 出版地: 出版者, 出版年: 起止页码.
56 |
57 | - 张伯伟. 全唐五代诗格会考[M]. 南京: 江苏古籍出版社, 2002.
58 | - O’BRIEN J A. Introduction to information systems[M]. 7th ed. Burr Ridge, III: Irwin, 1994.
59 |
60 | ```bibtex
61 | @book{张伯伟2002全唐五代诗格会考,
62 | title={全唐五代诗格会考},
63 | author={张伯伟},
64 | publisher={江苏古籍出版社},
65 | location={南京},
66 | year={2002},
67 | language={zh},
68 | keywords={book},
69 | }
70 | @book{OBRIEN1994Aircraft,
71 | title={Introduction to information systems},
72 | author={O'BRIEN, James A},
73 | location={$\text{7}^\text{th}$ ed. Burr Ridge, III},
74 | publisher={Irwin},
75 | year={1994},
76 | keywords={book},
77 | }
78 | ```
79 |
80 | ## 会议论文集
81 |
82 | 主要责任者．题名:其他题名信息[C]. 出版地: 出版者, 出版年.
83 |
84 | - 雷光春. 综合湿地管理: 综合湿地管理国际研讨会论文集[C]. 北京: 海洋出版社, 2012.
85 |
86 | ```bibtex
87 | @proceedings{雷光春2012,
88 | author = {雷光春},
89 | title = {综合湿地管理: 综合湿地管理国际研讨会论文集},
90 | location = {北京},
91 | publisher = {海洋出版社},
92 | year = {2012},
93 | }
94 | ```
95 |
96 | ## 专著中析出的文献
97 |
98 | 析出文献主要责任者. 析出题名[M]//专著主要责任者. 专著题名. 出版地: 出版者, 出版年: 起止页码.
99 |
100 | - 白书农. 植物开花研究[M]//李承森. 植物科学进展. 北京: 高等教育出版社, 1998: 146-163.
101 |
102 | ```bibtex
103 | @inbook{白书农,
104 | title={植物开花研究},
105 | author={白书农},
106 | location = {北京},
107 | publisher={高等教育出版社},
108 | year={1998},
109 | pages = {146-163},
110 | editor = {李承森},
111 | booktitle = {植物科学进展},
112 | }
113 | ```
114 |
115 | ## 学位论文
116 |
117 | 主要责任者. 文献题名[D]. 保存地: 保存单位, 年份.
118 |
119 | - 张和生. 嵌入式单片机系统设计[D]. 北京: 北京理工大学, 1998.
120 | - Sobieski I P. Multidisciplinary Design Using Collaborative Optimization[D]. United States – California: Stanford University, 1998.
121 |
122 | ```bibtex
123 | @phdthesis{zhanghesheng,
124 | author = {张和生},
125 | title = {嵌入式单片机系统设计},
126 | location = {北京},
127 | school = {北京理工大学},
128 | year = {1998},
129 | language={zh},
130 | keywords={thesis},
131 | }
132 | @phdthesis{Sobieski,
133 | author = {Sobieski, I. P.},
134 | title = {Multidisciplinary Design Using Collaborative Optimization},
135 | location = {United States -- California},
136 | school = {Stanford University},
137 | year = {1998},
138 | keywords={thesis},
139 | }
140 | ```
141 |
142 | ## 报告
143 |
144 | 主要责任者. 文献题名[R]. 报告地: 报告会主办单位, 年份.
145 |
146 | - 冯西桥. 核反应堆压力容器的 LBB 分析[R]. 北京: 清华大学核能技术设计研究院, 1997.
147 | - Sobieszczanski-Sobieski J. Optimization by Decomposition: A Step from Hierarchic to Non-Hierarchic Systems[R]. NASA CP-3031, 1989.
148 |
149 | ```bibtex
150 | @techreport{fengxiqiao,
151 | author = {冯西桥},
152 | title = {核反应堆压力容器的LBB分析},
153 | address = {北京},
154 | institution = {清华大学核能技术设计研究院},
155 | year = {1997},
156 | language={zh},
157 | keywords={techreport},
158 | }
159 | @techreport{Sobieszczanski,
160 | author = {Sobieszczanski-Sobieski, J.},
161 | title = {Optimization by Decomposition: A Step from Hierarchic to Non-Hierarchic Systems},
162 | institution = {NASA CP-3031},
163 | year = {1989},
164 | keywords={techreport},
165 | }
166 | ```
167 |
168 | ## 专利文献
169 |
170 | 专利所有者. 专利题名:专利号[P]. 公告日期或公开日期[引用日期]. 获取和访问路径. 数字对象唯一标识符.
171 |
172 | - 姜锡洲. 一种温热外敷药制备方案: 881056078[P]. 1983-08-12.
173 |
174 | ```bibtex
175 | @patent{jiangxizhou,
176 | author = {姜锡洲},
177 | title = {一种温热外敷药制备方案},
178 | number = {881056078},
179 | date = {1983-08-12},
180 | }
181 | ```
182 |
183 | ::: tip 加空格换行
184 |
185 | 如果专利号太长，想提前换行，请直接加空格。
186 |
187 |
188 |
189 | :::
190 |
191 | ::: tip quirks 模式
192 |
193 | 以上`@patent`默认按国标格式；而目前北理工官方示例的专利格式如下。
194 |
195 | - 姜锡洲. 一种温热外敷药制备方案[P], 881056078, 1983-08-12.
196 |
197 | 考虑到二者差异不大，并且[本科教务部反馈不一致处以国标为准](https://github.com/BITNP/BIThesis/discussions/401)，模板默认按国标处理。若需按学校示例，请编辑`main.tex`，设置`quirks=true`：
198 |
199 | ```latex
200 | \documentclass[…]{bithesis} % [!code --]
201 | \documentclass[…, quirks=true]{bithesis} % [!code ++]
202 | ```
203 |
204 | :::
205 |
206 | ## 国际、国家标准
207 |
208 | 主要责任人. 题名: 其他题名信息[S]. 出版地: 出版者, 出版年: 引文页码.
209 |
210 | - 全国信息与文献标准化技术委员会. 文献著录: 第 4 部分 非书资料: GB/T 3792.4-2009[S]. 北京: 中国标准出版社, 2010: 3.
211 |
212 | ```bibtex
213 | @standard{GB/T3792.4-2009,
214 | publisher ={中国标准出版社},
215 | title={全国信息与文献标准化技术委员会. 文献著录: 第4部分$\,$非书资料: GB/T 3792.4-2009},
216 | location = {北京},
217 | year={2010},
218 | language={zh},
219 | pages = {3},
220 | keywords={standard},
221 | }
222 | ```
223 |
224 | ## 报纸文章
225 |
226 | 主要责任者. 文献题名[N]. 报纸名, 年(期): 页码.
227 |
228 | - 谢希德. 创造学习的思路[N]. 人民日报, 1998-12-25(10).
229 |
230 | ```bibtex
231 | @newspaper{xiexide,
232 | author = {谢希德},
233 | title={创造学习的思路},
234 | date={1998-12-25},
235 | number = {10},
236 | journal = {人民日报},
237 | keywords = {newspaper},
238 | }
239 | ```
240 |
241 | ## 电子文献
242 |
243 | 主要责任者. 电子文献题名[文献类型/载体类型]. (发表或更新日期) [引用日期]. 获取和访问路径. 数字对象唯一标识符.
244 |
245 | - 姚伯元. 毕业设计（论文）规范化管理与培养学生综合素质[EB/OL]. 中国高等教育网教学研究. (2005-02-02) [2013-03-26]. https://www.cnnic.net.cn/hlwfzyj/hlwxzbg/201201/P020120709345264469680.
246 |
247 | ```bibtex
248 | @online{yaoboyuan,
249 | author = {姚伯元},
250 | title = {毕业设计（论文）规范化管理与培养学生综合素质},
251 | organization = {中国高等教育网教学研究},
252 | date = {2005-02-02},
253 | url = {https://www.cnnic.net.cn/hlwfzyj/hlwxzbg/201201/P020120709345264469680},
254 | urldate = {2013-03-26},
255 | keywords = {online},
256 | }
257 | ```
258 |
--------------------------------------------------------------------------------
/wiki/guide/preface.md:
--------------------------------------------------------------------------------
1 | # BIThesis
2 |
3 | ## BIThesis 是什么？
4 |
5 | BIThesis 是针对北京理工大学本科以及研究生同学毕业论文制作的一个非官方的 LaTeX 模板，BIThesis 同时也包括其他本科学习中涉及到的外文翻译、实验报告等的 LaTeX 模板。
6 |
7 | ## 重要提醒
8 |
9 | 1. _尽管已有大量往届学生使用此项目进行论文撰写，但你仍需要仔细斟酌后决定是否使用我们的项目。_
10 | 2. _本模板仍处于积极维护中，因此仍有微小可能会修改部分接口。在论文撰写的过程中，请慎重考虑是否需要同步更新模板。_
11 | 3. 请对自己的撰写内容做好备份（甚至是版本管理）。
12 | 4. 尽管本项目的排版符合学校的要求，但很多时候盲审老师会有一些「自己的想法」；这是本项目无法预料的。
13 |
14 | ## Q&A
15 |
16 | ### Q：我真的可以直接将 BIThesis 模板用于我的毕业设计吗？
17 |
18 | **A：可以的。**
19 |
20 | - 本项目已经与北京理工大学[教务部](https://mp.weixin.qq.com/s/I1SsP9VSaQ90a_2tW4zQUg)、[研究生院](https://grd.bit.edu.cn/xwgz/xwgz2/wjxz_xwgz/b117824.htm)确认，可以用于撰写北京理工大学本科生、研究生毕业设计（论文）。
21 | - 本项目同时也获得了 [北京理工大学教务部](https://jwb.bit.edu.cn/)、[北京理工大学计算机学院](https://cs.bit.edu.cn/) 的认可、背书与大力支持。详见：[致谢 - 官方赞助](./acknowledgements.md)。
22 |
23 | **我们正在对项目持续更新！目前，你完全可以使用现有版本开始编写毕业设计总论文；不过与此同时，我们也在持续推进代码的升级和更新（主要是不影响使用的底层逻辑）。更多开发计划请访问我们的 [Roadmap](https://github.com/BITNP/BIThesis/projects)。想帮助这个项目持续前进？参见我们的[贡献者指南](https://github.com/BITNP/BIThesis/blob/main/contributing-zh.md)。**
24 |
25 | ### Q：BIThesis 都包含哪些模板？
26 |
27 | **A：如下表。**
28 |
29 | | 预览 | 模板及特性 |
30 | | :----------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
31 | | 
| - **研究生·学位论文**
- 包括封面，摘要，参考文献和附录等支持
- 包括公式，表格和图片等支持
- 按 GB/T 7714—2015 规范编排的书目
- 符合研究生学位论文模版的格式要求。
- 2025年3月末研究生院开始使用新的研究生学位论文模板[^1]，请使用BIThesis v3.8.3或更新的版本。
- [![open in overleaf][open-in-overleaf]][graduate-thesis]
| - **本科生·毕业设计·论文**
- 包括封面，摘要，参考文献和附录等支持
- 包括公式，表格和图片等支持
- 按 GB/T 7714—2015 规范编排的书目
- 符合北京理工大学本科毕业设计论文的格式要求。
- [![open in overleaf][open-in-overleaf]][undergraduate-thesis]
| - **本科生·毕业设计·论文（全英文专业）**
- 包括封面，摘要，参考文献和附录等支持
- 包括公式，表格和图片等支持
- 按 GB/T 7714—2015 规范编排的书目
- 符合北京理工大学本科毕业设计论文的格式要求。
- [![open in overleaf][open-in-overleaf]][undergraduate-thesis-en]
| - **本科生·毕业设计·外文翻译**
- 由毕设模板迁移而来
- 符合北京理工大学本科毕业设计模板的格式要求。
- [![open in overleaf][open-in-overleaf]][paper-translation]
| - **读书报告**
- 包括封面，BIT logo
- 格式为简化版本科毕业设计
- 适用于信息与电子学院“电磁场与电磁波”等课程和一些公选课
- [![open in overleaf][open-in-overleaf]][reading-report]
| - **演示文档**
- 包括多种文字样式变化的支持
- CJK 字体高亮支持
- [![open in overleaf][open-in-overleaf]][presentation-slide]
| - **基本实验报告**
- 包括封面，BIT logo
- 适用于无格式要求的实验报告写作
- [![open in overleaf][open-in-overleaf]][lab-report]