From 0af5ca03249c5b0c11fc15adfc09e7fe5a0f8a5b Mon Sep 17 00:00:00 2001
From: Alex Vear <av@axvr.io>
Date: Tue, 8 Sep 2020 19:47:57 +0100
Subject: [PATCH] Add option to disable (La)TeX syntax highlighting

---
 TODO           |  1 -
 doc/org.txt    | 18 ++++++++++++++++++
 syntax/org.vim | 20 +++++++++++---------
 3 files changed, 29 insertions(+), 10 deletions(-)

diff --git a/TODO b/TODO
index 164852e..5152107 100644
--- a/TODO
+++ b/TODO
@@ -1,5 +1,4 @@
 * Future
-  - Option to disable TeX highlighting.
   - Syntax highlight checkboxes and checkbox cookies
   - Separate syntax group for heading delimiters
   - Syntax highlight and indent "properties"
diff --git a/doc/org.txt b/doc/org.txt
index faa67fc..7e6535b 100644
--- a/doc/org.txt
+++ b/doc/org.txt
@@ -122,6 +122,23 @@ To disable italics only in a single buffer, use this instead:
 >
     let b:org_use_italics = 0
 <
+------------------------------------------------------------------------------
+                                 *'b:org_highlight_tex'*  *'g:org_highlight_tex'*
+Value: numeric~
+Default: 1~
+
+Enable/disable syntax highlighting of inline (La)TeX blocks[4].  This option
+exists as some Org mode users don't use TeX and may find the highlighting
+annoying.
+
+To disable for all Org mode files place the following line in your vimrc:
+>
+    let g:org_highlight_tex = 0
+<
+To disable only in a single buffer, use this instead:
+>
+    let b:org_highlight_tex = 0
+<
 ==============================================================================
  4. CHANGE LOG                                                  *org-changelog*
 
@@ -188,6 +205,7 @@ works are:
 [1]: <https://www.gnu.org/software/emacs/manual/html_node/emacs/Outline-Mode.html>
 [2]: <https://orgmode.org/>
 [3]: <http://vimdoc.sourceforge.net/htmldoc/uganda.html#license>
+[4]: <https://orgmode.org/manual/LaTeX-fragments.html>
 
 ------------------------------------------------------------------------------
 vim:et:ts=4:sts=4:sw=4:tw=78:ft=help:norl:
diff --git a/syntax/org.vim b/syntax/org.vim
index 802ea1b..97ae111 100644
--- a/syntax/org.vim
+++ b/syntax/org.vim
@@ -122,15 +122,17 @@ highlight def link orgHyperRight Comment
 
 " TeX
 "   Ref: https://orgmode.org/manual/LaTeX-fragments.html
-syntax include @LATEX syntax/tex.vim
-syntax region orgMath start="\\begin\[.*\]{.*}"  end="\\end{.*}"         keepend contains=@LATEX
-syntax region orgMath start="\\begin{.*}"        end="\\end{.*}"         keepend contains=@LATEX
-syntax region orgMath start="\\\["               end="\\\]"              keepend contains=@LATEX
-syntax region orgMath start="\\("                end="\\)"               keepend contains=@LATEX
-syntax region orgMath start="\S\@<=\$\|\$\S\@="  end="\S\@<=\$\|\$\S\@=" keepend oneline contains=@LATEX
-syntax region orgMath start=/\$\$/               end=/\$\$/              keepend contains=@LATEX
-syntax match  orgMath /\\\$/ conceal cchar=$
-highlight def link orgMath String
+if org#option('org_highlight_tex', 1)
+    syntax include @LATEX syntax/tex.vim
+    syntax region orgMath start="\\begin\[.*\]{.*}"  end="\\end{.*}"         keepend contains=@LATEX
+    syntax region orgMath start="\\begin{.*}"        end="\\end{.*}"         keepend contains=@LATEX
+    syntax region orgMath start="\\\["               end="\\\]"              keepend contains=@LATEX
+    syntax region orgMath start="\\("                end="\\)"               keepend contains=@LATEX
+    syntax region orgMath start="\S\@<=\$\|\$\S\@="  end="\S\@<=\$\|\$\S\@=" keepend oneline contains=@LATEX
+    syntax region orgMath start=/\$\$/               end=/\$\$/              keepend contains=@LATEX
+    syntax match  orgMath /\\\$/ conceal cchar=$
+    highlight def link orgMath String
+endif
 
 
 let b:current_syntax = 'org'