bitnp / bithesis-wiki Goto Github PK
View Code? Open in Web Editor NEW非官方本科生毕业设计论文/研究生学位论文 LaTeX 模板(以及更多)在线文档
Home Page: https://bithesis.bitnp.net
License: Creative Commons Zero v1.0 Universal
非官方本科生毕业设计论文/研究生学位论文 LaTeX 模板(以及更多)在线文档
Home Page: https://bithesis.bitnp.net
License: Creative Commons Zero v1.0 Universal
目前的文档结构有一些问题:
latexmk -pdf -silent -synctex=1 "main"
没有走 latexmkrc
。
to give the usage of pnpm
.
目前,bithesis.cls
已经模板文件一起分发,不再需要用户从包管理器手动安装。
因此,有必要删除/修正相关的提示,以降低引起歧义的可能。
点击链接报错:Sorry, we can’t find the page you are looking for.
No response
No response
No response
No response
No response
No response
问题描述:
按照文档的提示,需要“在 VS Code 的设置中添加如下的内容定义”,按照我的理解,意味着要在如下的文件中
~/Library/Application Support/Code/User/settings.json
(Mac)
或者
%appdata%\Roaming\Code\User\settings.json
(Windows)
添加文档中所述的内容。
这样会导致LaTeX Workshop的默认设置被覆盖,并使得未来的LaTeX编译均使用XeTeX进行编译,可能会导致其他不兼容XeTeX的模板编译错误。
可能的解决方法
LaTeX Workshop自带了一些如"latexmk", "latexmk (latexmkrc)", "latexmk (lualatex)", "latexmk (xelatex)"等编译模板,其中"latexmk (xelatex)"与文档所述的编译命令类似,并且经测试可以完成对研究生毕设模板的编译。
可能的文档或模板修改方法
latex-workshop.latex.recipe.default命令中可以指定是选择“第一个”工具进行编译,还是选择“上一个”。因此文档中可以指明修改该项设置为“上一个”,随后点击边栏TeX图标中Build LaTeX project - Recipe: latexmk (xelatex)
按照扩展开发者的建议https://github.com/James-Yu/LaTeX-Workshop/wiki/Compile#latex-recipes
If you want to preset a per-file recipe, you may also consider place the LaTeX Workshop-specific derivative %!LW recipe=recipe-name at the top of your root file, similar to the wider recognized %!TeX root=root-file magic comment.
是否可以在模板头部添加相关内容以默认选择XeTeX进行编译?
现有文件并不能通过pnpm format
。
Line 6 in fb0132f
./.vitepress/cache
没有被忽略。
Line 2 in fb0132f
VitePress 文档 说可以使用 Algolia 或 https://github.com/emersonbottero/vitepress-plugin-search ,文档自己用的是 Algolia。
好像之前说要转 Docusaurus?那边似乎也是 Algolia。
有句 TODO 直接出现在了简介 | BIThesis 上。
BIThesis-wiki/wiki/guide/intro.md
Lines 19 to 21 in 128c0f0
这一行源于75dfe00
,之前的图如下。
<!-- HTML Meta Tags -->
<title>BIThesis</title>
<meta name="description" content="📖 Unofficial LaTeX templates for your bachelor graduation thesis (and more) here at BIT.">
<!-- Facebook Meta Tags -->
<meta property="og:url" content="https://bithesis.bitnp.net">
<meta property="og:type" content="website">
<meta property="og:title" content="BIThesis">
<meta property="og:description" content="📖 Unofficial LaTeX templates for your bachelor graduation thesis (and more) here at BIT.">
<meta property="og:image" content="">
<!-- Twitter Meta Tags -->
<meta name="twitter:card" content="summary_large_image">
<meta property="twitter:domain" content="bithesis.bitnp.net">
<meta property="twitter:url" content="https://bithesis.bitnp.net">
<meta name="twitter:title" content="BIThesis">
<meta name="twitter:description" content="📖 Unofficial LaTeX templates for your bachelor graduation thesis (and more) here at BIT.">
<meta name="twitter:image" content="">
<!-- Meta Tags Generated via https://www.opengraph.xyz -->
目前的 SEO 惨不忍睹。
使用系统包管理器(如apt)安装的texlive是由发行版重新打包的版本,因此对于使用非滚动发行的发行版的用户会安装到老版本的texlive,如ubuntu 22.04中为texlive 2021,ubuntu 20.04中为texlive 2019,而ubuntu 18.04中为texlive 2017。see https://tug.org/texlive/distro.html and https://tug.org/texlive/debian.html
同时,系统包管理器将texlive安装到系统目录中,也无法使用tlmgr更新。
可使用如下方法将 LaTeX 文件(或编译后的 pdf 格式文件)转换为 Word 文件。
注意:将未公开的论文上传至网络有风险,推荐在本地进行转换。
pandoc 本地转换
- 具体操作可参考 Latex2Word 这篇博客。
- 优点:公式支持相对较好;可以基于 Word 模板进行转换。
- 缺点:
subfigure
支持差(可手动对编译后的 pdf 文件截图,进行替换);需手动调整对公式的\ref
(可使用 Word 全局替换)。在线转换
如下网址效果较好:
https://bithesis.bitnp.net/guide/getting-started.html
目前文档中,此项内容丢失。
This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.
These updates are awaiting their schedule. Click on a checkbox to get an update now.
.github/workflows/test.yml
actions/checkout v4
actions/setup-node v4
gaurav-nelson/github-action-markdown-link-check v1
package.json
@types/node ^20.0.0
@typescript-eslint/eslint-plugin ^7.0.0
@typescript-eslint/parser ^7.0.0
eslint ^9.0.0
eslint-config-prettier ^9.0.0
eslint-config-xo ^0.45.0
eslint-plugin-vue ^9.15.1
markdown-it-footnote ^4.0.0
prettier ^3.0.0
typescript ^5.1.3
vitepress 1.3.1
vue ^3.3.4
目前 Vercel 有两个问题:
不过 Cloudflares 在大陆访问的速度可能有点难以保证?
“推销”时同学反映 VS Code 第一步就卡住了……
快捷键 ctrl/cmd + , 打开 UI 设置界面
这里被误以为是两步,不知道怎么“打开 UI 设置界面”。
建议用“以”连接,或者改成“……(此时会打开 UI 设置界面)”。
点击右上角 Open Settings (JSON) 按钮即可打开相应的 JSON 格式配置文件
VSC 有好几个“右上角”。在大屏幕上,它们还不挨着,导致同学只找了最下面的“右上角”,结果没找到。
另外,如果安装了语言包,这个按钮叫打开设置 (json)
,不过相信一般人能转的过来。
如果 VitePress 能做到,建议加图标(codicon go to file);也可改成搜索latex-workshop.latex.tools
,然后单击“在settings.json
中编辑”。
目前,wiki中在“如何开始”中为Windows 和 Linux 系统系统的用户推荐使用TeX Live并提供了TeX Live的安装方式。但是,在实际使用中,TeX Live存在一定的问题如下:
而MiKTeX可以做到
但是会有如下问题
因此可以考虑
其中对教程若进行“基础”更改应该不会导致兼容性问题,因为仍默认推荐用户使用TeX Live。而进行“进阶”修改,则可能会造成问题,例如
希望通过本issue与维护者和使用者讨论相关问题。
下载VSCode的latex-workshop插件后,其中latex-workshop.latex.tools自带latexmk的选项,但是其参数指定与Wiki上推荐的方法有出入,按插件默认的参数编译后会直接报错,无法正常编译。
建议在Wiki中的相应部分加入强调,检查使用latex-workshop时相关的recipe/tools参数是否与Wiki上一致,以免浪费时间。
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.