From: Vladimír Vondruš <mosra@centrum.cz>
Date: Thu, 7 Dec 2017 10:34:03 +0000 (+0100)
Subject: doc: document the additional pain inflicted on macOS LaTeX users.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=b6ab81bcc3f031819edbceabdccd151b38960b5a;p=blog.git

doc: document the additional pain inflicted on macOS LaTeX users.
---

diff --git a/doc/plugins/math-and-code.rst b/doc/plugins/math-and-code.rst
index 494b99c3..36cb0423 100644
--- a/doc/plugins/math-and-code.rst
+++ b/doc/plugins/math-and-code.rst
@@ -66,6 +66,16 @@ package manager, for example on Ubuntu:
 
     sudo apt-get install texlive-base texlive-latex-extra texlive-fonts-extra
 
+.. block-warning:: Note for macOS users
+
+    On macOS 10.11 and up, if you use MacTex, there's some additional setup
+    needed `as detailed here <https://tex.stackexchange.com/a/249967>`_ --- you
+    need to update your :sh:`$PATH` so the binaries are properly found:
+
+    .. code:: sh
+
+        export PATH=$PATH:/Library/TeX/Distributions/.DefaultTeX/Contents/Programs/texbin
+
 .. note-success::
 
     This plugin makes use of the ``latex2svg.py`` utility from :gh:`tuxu/latex2svg`,