本项目仓库中已存在编译好的PDF文档,也可在页面右侧Releases中直接下载查看。
PDF文档中代码块复制不便,Releases中会有单独的文件提供文档中出现的代码,可对照查看;或在项目库中直接打开code.md,可以方便地复制。
如果这个笔记对你有帮助,不妨点个 Star,或者分享给需要的同学,感谢支持!
如有参与编写或修改的需求,需要本地编译,可按如下步骤搭建环境。
在Linux或者Windows系统中,可安装Tex Live配置编译环境; 在MacOS中,可安装Mac Tex配置编译环境。
相关安装流程网上的教程有很多,不再赘述。
本文档中,使用了tcolorbox、minted宏包,用于配置展示代码的环境。其中minted宏包依赖于Python的Pygments包。
Python环境配置不再赘述,在电脑上有Python和pip的情况下,终端运行下面命令,安装Pygments:
pip install Pygments在Linux中最好加上sudo提权。
若有类似如下的报错:
error: externally-managed-environment
× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
python3-xyz, where xyz is the package you are trying to
install.
If you wish to install a non-Debian-packaged Python package,
create a virtual environment using python3 -m venv path/to/venv.
Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
sure you have python3-full installed.
If you wish to install a non-Debian packaged Python application,
it may be easiest to use pipx install xyz, which will manage a
virtual environment for you. Make sure you have pipx installed.
See /usr/share/doc/python3.12/README.venv for more information.
note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.
按照提示在终端输入以下命令继续安装:
pip install Pygments --break-system-packagesLinux中最好加上sudo提权。
接下来按照提示继续安装即可。
本文档使用了宋体、楷体、思源宋体、Times New Roman、Maple字体,所用字体在本项目库\dependency\fonts\里提供,需安装所有字体后才能正常编译。