将IPython笔记本mhchem降价转换为pdf

Question

在了解了如何将mhchem插入IPython笔记本中的MathJax表达式之后（从这个问题开始），我非常高兴，直到我想将笔记本转换为PDF。我的降价单元格包含：

$\require{mhchem}$
$\ce{CH2O2->[k_1]H2 + CO2}$

但尝试使用以下终端命令将笔记本转换为PDF

ipython nbconvert untitled.ipynb --to pdf

导致一个！未定义的控制序列错误-类似于这篇文章。但是提出的解决方案（\tex orpdfString）无法被标记单元格中的MathJax解释器识别。有什么想法或解决方法吗？

IPython 3.0.0/MiKTeX 2.9/win7x86

Answer 1

在未能遵循上述答案后，我发现了一个简单的解决方法。

您只需编辑nbconvert使用的默认LaTex模板，即可将其包括在内

\usepackage{mhchem}

在序言中。这意味着所有的化学方程都将像你笔记本上的任何数学方程一样工作。

对我（macOS）来说，模板位于/Users/USER/opt/anaconda3/share/jupyter/nbconvert/templates/latex/base。tex.j2

我不确定这是否相关，但在修改了与数学块中我的$旁边的空格相关的序言后，我出现了一些编译错误。在确保$内部没有空间，外部有一个空间后，所有的问题都得到了解决。

Answer 2

要包含mhchem包，您需要创建一个自定义模板。此外，还需要处理pdflatex中不可用的\requiremathjax命令。

一个可能的模板（chemtempl.tplx）可能看起来像

((*- extends 'article.tplx' -*))

((* block packages *))
((( super() )))
\usepackage{mhchem}
((* endblock packages *))

((* block commands *))
((( super() )))
% disable require command
\newcommand{\require}[1]{}
((* endblock commands *))

此模板通过覆盖包和命令块扩展到默认的文章模板。super调用类似于python命令，包含原始块内容。\require命令是通过定义一个新命令来解决的，该命令只接受一个参数，不执行任何操作-

模板的用法如下

jupyter nbconvert --template chemtempl.tplx --to pdf notebook.ipynb

如果您使用的是IPython 3。只需将jupyter替换为ipython。

要将模板与笔记本中的下载为pdf功能一起使用，必须使用配置文件。为此，为ipython 3.x或ipython 4.x（jupyter）创建一个配置文件（.ipython/profile\u default/ipython\u config.py）：

c = get_config()
c.LatexExporter.template_path = ['/home/path/to/template/']
c.LatexExporter.template_file = 'chemtempl.tplx'

重新启动Jupyter后，应该加载新的配置并使用模板。

（我想对于IPython 3.x，该文件也可以命名为IPython_notebook_config.py，但目前我没有3.x版本来测试这个。）