在科研写作和学术出版的领域里,LaTeX 一直是众多学者和研究人员的得力助手,它能生成高质量的文档。而 Git 作为强大的版本控制系统,在软件开发中发挥着重要作用。现在,有一个神奇的工具将这两者结合起来,那就是 latexgit_tex
!
什么是 latexgit_tex
?
latexgit_tex
是一个能让你从 Git 仓库下载、访问文件,甚至执行文件,并在 LaTeX 中使用这些文件或其输出的工具。它就像是一座桥梁,将 LaTeX 和 Git 的优势完美融合。
主要功能
- 文件下载与访问:可以轻松地从 Git 仓库下载文件,并在 LaTeX 代码中访问它们。比如在撰写论文时,直接将实际软件仓库中的程序代码引入到文档中,让代码引用变得简单高效。
- 文件后处理:对下载的文件进行后处理,例如去除 Python 代码中的注释和类型提示。这样处理后的文件可以更方便地在 LaTeX 中使用,避免了一些不必要的干扰信息。
- 程序执行与输出获取:能够执行本地或从 Git 仓库下载的脚本或程序,并将其输出获取到本地文件中,这些文件又可以在 LaTeX 文档中使用。就像可以运行一个生成图形的脚本,然后将生成的图形直接嵌入到 LaTeX 文档里。
- 本地路径创建:创建可在 LaTeX 中访问的本地路径,并将其作为参数传递给执行的脚本或程序。例如,给一个 Python 脚本传递一个路径参数,让它创建并存储一个
matplotlib
图形,然后就能在 LaTeX 文档中引用这个图形。
工作原理
它的工作方式有点像 BibTeX。在 LaTeX 文档中先定义从 Git 仓库加载文件的请求,第一次编译 LaTeX 时,这些请求只会产生虚拟结果,并且会将这些请求存储在项目的 aux
文件中。接着执行 python3 -m texgit.run
命令(类似于执行 bibtex
来构建参考文献),Python 包会执行实际的 Git 请求并更新 aux
文件。在第二次编译 LaTeX 时,就可以访问这些文件的实际内容了。
安装与使用
安装 latexgit_tex
也不复杂:
- 通过
pip install texgit
安装 Python 包。 - 确保系统中安装了
git
,在 Ubuntu Linux 上可以使用 sudo apt-get install git
进行安装。 - 从 https://thomasweise.github.io/texgit_tex/texgit.sty 下载
texgit.sty
文件并复制到 LaTeX 项目文件夹中,或者将 texgit.tds.zip
解压到 TeX 树中。
使用时,如果主文档是 article.tex
,可以按照以下步骤进行构建:
- 执行
python3 -m texgit.run article
。
文件信息
texgit.zip
:是可以提交到 https://ctan.org/upload 的压缩包版本。texgit.tds.zip
:是符合 TDS 规范 的版本,可以直接解压到用户的 TeX 树中。
如果你对 latexgit_tex
有任何疑问或建议,可以联系 Prof. Dr. Thomas Weise(汤卫思教授),他就职于合肥大学(Hefei University)人工智能与大数据学院(School of Artificial Intelligence and Big Data)的应用优化研究所(Institute of Applied Optimization),邮箱是 tweise@hfuu.edu.cn,并抄送 tweise@ustc.edu.cn。
latexgit_tex
为 LaTeX 用户带来了更多的便利和可能性,让科研写作更加高效和灵活。快来试试这个神器吧!
Github仓库 https://github.com/thomasWeise/latexgit_tex
成为 LaTeX 会员,尽享精致科研!
开通 LaTeX VIP 地址:
https://www.latexstudio.net/index/recharge/choice.html
