LaTeX + Python 科研工作流:从Jupyter Notebook到学术论文的代码高亮实践
在数据驱动的研究领域,Python已成为科学计算和机器学习的事实标准语言,而Jupyter Notebook凭借其交互式特性成为探索性数据分析的首选工具。但当研究进入论文撰写阶段,如何将这些动态生成的代码优雅地迁移到静态的LaTeX文档中,同时保持专业排版和语法高亮,成为许多研究者面临的现实挑战。
传统复制粘贴方式不仅破坏代码格式,更无法满足学术出版对文献一致性的严苛要求。本文将构建一套完整的解决方案,通过minted宏包与Pygments的组合,实现从.ipynb文件到LaTeX文档的无损代码迁移,同时分享如何通过浮动环境、交叉引用等高级功能满足期刊投稿的技术规范。
1. 环境配置:构建LaTeX-Python协同工作流
1.1 基础组件安装
实现代码高亮需要LaTeX与Python生态的协同工作。核心组件包括:
- Pygments:Python生态的语法高亮引擎,支持超过500种编程语言
- minted:LaTeX宏包,作为Pygments的接口提供高质量排版
- Jupyter Notebook:原始代码的编辑环境
推荐使用conda管理Python环境以避免依赖冲突:
bash复制conda create -n latex python=3.9 pygments jupyter
conda activate latex
对于TeX发行版,现代版本如TeX Live 2023已内置minted宏包。验证安装完整性:
bash复制texdoc minted # 查看宏包文档
pygmentize -V # 检查Pygments版本
1.2 编译器特殊配置
由于minted需要调用外部Pygments程序,必须启用LaTeX编译器的shell escape功能。不同编辑器的配置方式:
| 编辑器 | 配置路径 | 参数示例 |
|---|---|---|
| TeXShop | 偏好设置→引擎 | 添加-shell-escape |
| Overleaf | 菜单→编译器 | 选择XeLaTeX并添加参数 |
| V |
