Skip to content

Instantly share code, notes, and snippets.

@stanislaw

stanislaw/How to generate PDF with Sphinx on macOS and Linux.md

Last active May 1, 2023 09:37
Show Gist options
  • Save stanislaw/1d5994a5a369fea749f6fb9fbea8a014 to your computer and use it in GitHub Desktop.
Save stanislaw/1d5994a5a369fea749f6fb9fbea8a014 to your computer and use it in GitHub Desktop.
Download ZIP
How to generate PDF with Sphinx on macOS and Linux
Raw
How to generate PDF with Sphinx on macOS and Linux.md

How to generate PDF with Sphinx on macOS

Install BasicTex.

Add this to your Bash or Zsh:

export PATH="/Library/TeX/texbin/:$PATH"

Install missing Tex packages:

sudo tlmgr install capt-of needspace datetime fmtcount makecell eqparbox environ framed latexmk tabulary varwidth titlesec

On Linux

apt install texlive-xetex latexmk # only to generate PDF
pip3 install sphinx

For RTEMS docs, additionally:

sudo apt install texlive-fonts-extra
@mscuthbert
Copy link

mscuthbert commented Jan 7, 2023

I also needed to run

sudo tlmgr install latexmk tex-gyre fncychap wrapfig tabulary varwidth titlesec

but the PDF generated was still too corrupted

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment