diff --git a/BIT-thesis-template-grd/demo.tex b/BIT-thesis-template-grd/demo.tex index 5b266c4..7665287 100644 --- a/BIT-thesis-template-grd/demo.tex +++ b/BIT-thesis-template-grd/demo.tex @@ -8,7 +8,7 @@ % 默认单面打印 oneside 、硕士论文模板 master -\documentclass[oneside, master]{BIT-thesis-grd} +\documentclass[oneside, doctor]{BIT-thesis-grd} % 模板选项: 硕士论文 master; 博士论文 doctor diff --git a/README.md b/README.md index d2041a8..562af20 100644 --- a/README.md +++ b/README.md @@ -62,29 +62,186 @@ latexmk - 在vscode上编译 (LaTex Workshop):对于使用vscode写tex的用户,添加如下配置,可在vscode上使用XeLaTeX: ``` -"latex-workshop.latex.tools": [ - { - "name": "xelatex", - "command": "xelatex", - "args": [ - "-synctex=1", - "-interaction=nonstopmode", - "-file-line-error", - "%DOC%" - ] - } -], -"latex-workshop.latex.recipes": [ - { - "name": "xelatex -> bibtex -> xelatex*2", - "tools": [ - "xelatex", - "bibtex", - "xelatex", - "xelatex" - ] - } -] +// ======================== LaTeX 设置 BEGIN ======================== + // bibtex 格式 + "latex-workshop.bibtex-format.tab": "tab", + + // 自动编译,全部关闭,当且仅当你认为有需要的时候才会去做编译 + "latex-workshop.latex.autoBuild.run": "never", + "latex-workshop.latex.autoBuild.cleanAndRetry.enabled": false, + + // 设置 latex-workshop 的 PDF 预览程序,external 指的是外部程序 + //"latex-workshop.view.pdf.viewer": "external", + //"latex-workshop.view.pdf.ref.viewer": "external", + //"latex-workshop.view.pdf.external.viewer.command": "D:/Users/newton/Documents/Softwares/software_windows/design/SumatraPDF-3.2-64.exe", + //"latex-workshop.view.pdf.external.viewer.args": [ + // "%PDF%" + //], + + // 配置正向、反向搜索:.tex -> .pdf + //"latex-workshop.view.pdf.external.synctex.command": "D:/Users/newton/Documents/Softwares/software_windows/design/SumatraPDF-3.2-64.exe", + //"latex-workshop.view.pdf.external.synctex.args": [ + // 正向搜索 + // "-forward-search", + // "%TEX%", + // "%LINE%", + // "-reuse-instance", + // 反向搜索 + // "-inverse-search", + // "\"C:/Program Files/Microsoft VS Code/Code.exe\" \"C:/Program Files/Microsoft VS Code/resources/app/out/cli.js\" -gr %f:%l", + // "%PDF%" + //], + + // 这是一些独立的编译选项,可以作为工具被编译方案调用 + "latex-workshop.latex.tools": [ + { + // Windows 原生安装 TeX Live 2021 的编译选项 + "name": "Windows XeLaTeX", + "command": "xelatex", + "args": [ + "-synctex=1", + "-interaction=nonstopmode", + "-file-line-error", + "-pdf", + "%DOCFILE%" + ] + }, + { + // Windows Biber 编译 + "name": "Windows Bibtex", + "command": "bibtex", + "args": [ + "%DOCFILE%" + ] + }, + { + // WSL XeLaTeX 编译一般的含有中文字符的文档 + "name": "WSL XeLaTeX", + "command": "wsl", + "args": [ + "/usr/local/texlive/2021/bin/x86_64-linux/xelatex", + "-synctex=1", + "-interaction=nonstopmode", + "-file-line-error", + "-pdf", + //"-output-directory=%OUTDIR%", + //"-aux-directory=%OUTDIR%", + "%DOCFILE%" + ] + }, + { + // WSL biber / bibtex 编译带有 citation 标记项目的文档 + "name": "WSL Bibtex", + "command": "wsl", + "args": [ + "/usr/local/texlive/2021/bin/x86_64-linux/bibtex", + "%DOCFILE%" + ] + }, + { + // macOS 或者 Linux 的简单编译 + // 两种操作系统的操作方式相同 + "name": "macOS / Linux XeLaTeX", + "commmand": "xelatex", + "args": [ + "-synctex=1", + "-interaction=nonstopmode", + "-file-line-error", + "-pdf", + "%DOCFILE%" + ] + }, + { + // macOS 或者 Linux 的索引编译 + // 两种操作系统的操作方式相同 + "name": "macOS / Linux Bibtex", + "command": "bibtex", + "args": [ + "%DOCFILE%" + ] + } + ], + + // 这是一些编译方案,会出现在 GUI 菜单里 + "latex-workshop.latex.recipes": [ + { + // 1.1 Windows 编译简单的小文档,这个选项不太常用,因为绝大多数文章都需要有参考文献索引 + "name": "Windows XeLaTeX 简单编译", + "tools": [ + "Windows XeLaTeX" + ] + }, + { + // 1.2 Windows 编译带有索引的论文,需要进行四次编译;-> 符号只是一种标记而已,没有程序上的意义 + "name": "Windows xe->bib->xe->xe 复杂编译", + "tools": [ + "Windows XeLaTeX", + "Windows Bibtex", + "Windows XeLaTeX", + "Windows XeLaTeX" + ] + }, + { + // 2.1 WSL 编译简单的小文档,这个选项不太常用,因为我绝大多数文章都需要有引用。 + "name": "XeLaTeX 简单编译", + "tools": [ + "WSL XeLaTeX" + ] + }, + { + // 2.2 带有 citation 索引的文档,需要进行四次编译;-> 符号只是一种标记而已,没有程序上的意义 + "name": "xe->bib->xe->xe 复杂编译", + "tools": [ + "WSL XeLaTeX", + "WSL Bibtex", + "WSL XeLaTeX", + "WSL XeLaTeX" + ] + }, + { + // 3.1 macOS 简单 小文档 + "name": "macOS XeLaTeX 简单编译", + "tools": [ + "macOS XeLaTeX" + ] + }, + { + // 3.2 macOS 四次编译 + "name": "macOS xe->bib->xe->xe 复杂编译", + "tools": [ + "macOS / Linux XeLaTeX", + "macOS / Linux Bibtex", + "macOS / Linux XeLaTeX", + "macOS / Linux XeLaTeX" + ] + } + ], + + // 清空中间文件 + "latex-workshop.latex.clean.fileTypes": [ + "*.aux", + "*.bbl", + "*.blg", + "*.idx", + "*.ind", + "*.lof", + "*.lot", + "*.out", + "*.toc", + "*.acn", + "*.acr", + "*.alg", + "*.glg", + "*.glo", + "*.gls", + "*.ist", + "*.fls", + "*.log", + "*.fdb_latexmk", + "*.bcf", + "*.run.xml", + "*.synctex.gz" + ], ``` ## Linux用户可能遇到的问题