jupyterbook-latex [开发中]

Sphinx扩展，用于支持Jupyter Book的LaTeX基础设施。

此存储库是一个开发项目，旨在改进Jupyter Book中的LaTeX支持。

开始使用

要开始使用jupyterbook-latex，首先通过pip安装它

pip install jupyterbook-latex

然后，在Sphinx conf.py中将jupyterbook_latex添加到您的扩展

extensions = ["jupyterbook_latex"]

# autoload the sphinx.ext.imgconverter extension, optional (default is True)
# jblatex_load_imgconverter = True
# turn root level toctree captions into top-level `part` headings, optional (default is to auto-infer)
#  jblatex_captions_to_parts = True

或者，在jupyterbook config.yml中

sphinx:
    extra_extensions:
    - jupyterbook_latex
    # config:
    #   jblatex_load_imgconverter: true
    #   jblatex_captions_to_parts: true

扩展详情

此扩展不提供实际的Sphinx LaTeX主题，而是实例化多个转换（仅适用于LaTeX构建器），这些转换将AST转换为所需格式

1. 覆盖一些配置

• latex_engine -> xelatex
• latex_theme -> jupyterBook
• 在序言中附加必要的LaTeX命令

2. 当指定LaTeX构建器时

• 设置sphinx.ext.imgconverter（如果jblatex_load_imgconverter）
• 替换根文档中的子标题
• 从根级别到toc标题创建标题（如果jblatex_captions_to_parts）
• 将参考文献移动到文档底部

问题

需要解决的问题列表

https://github.com/executablebooks/meta/issues/169

开发者笔记

一个包含许多不同项目配置的仓库可用于测试和开发，同时提供了实现想法和笔记。