Latex specific features for jupyter book
Project description
sphinx-jupyterbook-latex
Sphinx extension to support LaTeX infrastructure for Jupyter Book.
This repository is a development project to improve LaTeX support
in Jupyter Book
.
Get started
To get started with sphinx-jupyterbook-latex
, first install it through pip
:
pip install sphinx-jupyterbook-latex
then, add sphinx_jupyterbook_latex
to your extensions,
in a Sphinx conf.py
:
extensions = ["sphinx_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
OR in the jupyterbook config.yml
:
sphinx:
extra_extensions:
- sphinx_jupyterbook_latex
# config:
# jblatex_load_imgconverter: true
# jblatex_captions_to_parts: true
Extension Details
This extension does not provide an actual Sphinx LaTeX theme, instead it instantiates a number of transforms (for LaTeX builders only) that manipulate the AST into the required format:
- Overrides some configuration:
latex_engine
->xelatex
latex_theme
->jupyterBook
- appends necessary LaTeX commands to the preamble
- When a latex builder is specified:
- Set's up
sphinx.ext.imgconverter
(ifjblatex_load_imgconverter
) - Replace sub-headers in the root document
- Create headings from the root-level toctree captions (if
jblatex_captions_to_parts
) - Move bibliographies to the bottom of the document
Issues
A list of issues that need to be addressed:
https://github.com/executablebooks/meta/issues/169
Developer Notes
A repository that contains many different project configurations for testing and development is available, along with implementation idea and notes
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sphinx_jupyterbook_latex-0.4.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | dbc997ae9ee1fd51277c6ad66e93c9cad2a6158fa02b304621e703ea6d3bae98 |
|
MD5 | 2cc41b742c14f1d6e8442017c60d9b17 |
|
BLAKE2b-256 | 8f036c4f8753299a33b46f3a5b9b1a6db2eff81bfc0bb0b159814d7a8c07b316 |
Hashes for sphinx_jupyterbook_latex-0.4.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 869b4af57a6ed7b2da0881d75a930f067006ec4d0a90d7c7c18efb4c2577fb16 |
|
MD5 | 060ea076331ae9b2aef2297224ea1879 |
|
BLAKE2b-256 | 8e1cfac1789ed19e5c1f70cb59c81221f5c0aaa79cd4abf75e856ee674f85760 |