Require text to be wrapped in braces to export as sub/superscript

Now ox-hugo by default requires text, to be sub/super-scripted, to
be wrapped in {}.

So now "a_b" will be exported as "a_b", but "a_{b}" will be exported
as "a<sub>b</sub>". To revert back to the earlier behavior, user needs
to add "#+OPTIONS: ^:t" to their Org file.

README.org

@@ -153,6 +153,13 @@ The common =ox-hugo= export bindings are:
 Do =M-x customize-group=, and select =org-export-hugo= to see the
 available customization options for this package.
 * Changelog
+** 0.2.2 <2017-10-10 Tue>
+*** Backward-incompatible changes
+- Now =ox-hugo= by default requires text, to be sub/super-scripted, to
+  be wrapped in ={}=. So now =a_b= will be exported as =a_b=, but
+ =a_{b}= will be exported as =a<sub>b</sub>=. To revert back to the
+  earlier behavior, user needs to add =#+OPTIONS: ^:t= to their Org
+  file.
 ** 0.2.1 <2017-09-28 Thu>
 *** Fixes
 - Single column tables now export correctly [[[https://github.com/kaushalmodi/ox-hugo/issues/84][84]]].

doc/content/doc/changelog.md

@@ -6,6 +6,18 @@ draft = false
   identifier = "changelog"
 +++
 
+## 0.2.2 <span class="timestamp-wrapper"><span class="timestamp">&lt;2017-10-10 Tue&gt;</span></span> {#0-dot-2-dot-2-span-class-timestamp-wrapper-span-class-timestamp-and-lt-2017-10-10-tue-and-gt-span-span}
+
+
+### Backward-incompatible changes {#backward-incompatible-changes}
+
+-   Now `ox-hugo` by default requires text, to be sub/super-scripted, to
+    be wrapped in `{}`. So now `a_b` will be exported as `a_b`, but
+    `a_{b}` will be exported as `a<sub>b</sub>`. To revert back to the
+    earlier behavior, user needs to add `#+OPTIONS: ^:t` to their Org
+    file.
+
+
 ## 0.2.1 <span class="timestamp-wrapper"><span class="timestamp">&lt;2017-09-28 Thu&gt;</span></span> {#0-dot-2-dot-1-span-class-timestamp-wrapper-span-class-timestamp-and-lt-2017-09-28-thu-and-gt-span-span}
 
 

doc/ox-hugo-manual.org

@@ -11,6 +11,13 @@
 :PROPERTIES:
 :CUSTOM_ID: changelog
 :END:
+** 0.2.2 <2017-10-10 Tue>
+*** Backward-incompatible changes
+- Now =ox-hugo= by default requires text, to be sub/super-scripted, to
+  be wrapped in ={}=. So now =a_b= will be exported as =a_b=, but
+ =a_{b}= will be exported as =a<sub>b</sub>=. To revert back to the
+  earlier behavior, user needs to add =#+OPTIONS: ^:t= to their Org
+  file.
 ** 0.2.1 <2017-09-28 Thu>
 *** Fixes
 - Single column tables now export correctly {{{issue(84)}}}.

ox-hugo.el

@@ -5,7 +5,7 @@
 ;; URL: https://ox-hugo.scripter.co
 ;; Package-Requires: ((emacs "24.5") (org "9.0"))
 ;; Keywords: Org, markdown, docs
-;; Version: 0.2
+;; Version: 0.2.2
 
 ;;; Commentary:
 
@@ -520,6 +520,7 @@ The auto-copying behavior is disabled if this variable is set to nil."
                    (:with-toc nil "toc" nil) ;No TOC by default
                    (:with-smart-quotes nil "'" nil) ;Don't use smart quotes; that is done automatically by Blackfriday
                    (:with-special-strings nil "-" nil) ;Don't use special strings for ndash, mdash; that is done automatically by Blackfriday
+                   (:with-sub-superscript nil "^" '{}) ;Require curly braces to be wrapped around text to sub/super-scripted
                    (:hugo-front-matter-format "HUGO_FRONT_MATTER_FORMAT" nil     org-hugo-front-matter-format)
                    (:hugo-level-offset "HUGO_LEVEL_OFFSET" nil 1)
                    (:hugo-preserve-filling "HUGO_PRESERVE_FILLING" nil org-hugo-preserve-filling) ;Preserve breaks so that text filling in Markdown matches that of Org

test/setup-ox-hugo.el

@@ -1,4 +1,4 @@
-;; Time-stamp: <2017-09-25 21:47:44 kmodi>
+;; Time-stamp: <2017-10-10 12:13:14 kmodi>
 
 ;; Setup to test ox-hugo using emacs -Q and the latest stable version of Org
 
@@ -182,9 +182,6 @@ to be installed.")
   ;;   Non-existent agenda file
   (defun org-check-agenda-file (file)))
 
-(with-eval-after-load 'ox
-  (setq org-export-with-sub-superscripts '{}))
-
 (with-eval-after-load 'ox-hugo
   (setq org-hugo-langs-no-descr-in-code-fences '(org)))
 

test/site/content-org/all-posts.org

@@ -1499,6 +1499,24 @@ ghi
 abc
 def
 ghi
+* Export Settings                                           :export_settings:
+** Sub/superscripts require braces
+:PROPERTIES:
+:EXPORT_FILE_NAME: sub-superscripts-require-braces
+:END:
+*** Following text will export =_= and =^= verbatim
+a_b a_bc a^b a^bc
+*** Following text will export =_{..}= as subscript and =^{..}= as superscript
+a_{b} a_{bc} a^{b} a^{bc}
+** Sub/superscripts don't require braces
+:PROPERTIES:
+:EXPORT_FILE_NAME: sub-superscripts-dont-require-braces
+:EXPORT_OPTIONS: ^:t
+:END:
+*** Following text will export =_..= as subscript and =^..= as superscript
+a_b a_bc a^b a^bc
+*** Following text will export =_{..}= as subscript and =^{..}= as superscript
+a_{b} a_{bc} a^{b} a^{bc}
 * TODO Pre-Draft State
 :PROPERTIES:
 :EXPORT_FILE_NAME: draft-state-todo

test/site/content/posts/sub-superscripts-dont-require-braces.md

@@ -0,0 +1,14 @@
++++
+title = "Sub/superscripts don't require braces"
+tags = ["export-settings"]
+draft = false
++++
+
+## Following text will export `_..` as subscript and `^..` as superscript {#following-text-will-export-dot-dot-as-subscript-and-dot-dot-as-superscript}
+
+a<sub>b</sub> a<sub>bc</sub> a<sup>b</sup> a<sup>bc</sup>
+
+
+## Following text will export `_{..}` as subscript and `^{..}` as superscript {#following-text-will-export-dot-dot-as-subscript-and-dot-dot-as-superscript}
+
+a<sub>b</sub> a<sub>bc</sub> a<sup>b</sup> a<sup>bc</sup>

test/site/content/posts/sub-superscripts-require-braces.md

@@ -0,0 +1,14 @@
++++
+title = "Sub/superscripts require braces"
+tags = ["export-settings"]
+draft = false
++++
+
+## Following text will export `_` and `^` verbatim {#following-text-will-export-and-verbatim}
+
+a\_b a\_bc a^b a^bc
+
+
+## Following text will export `_{..}` as subscript and `^{..}` as superscript {#following-text-will-export-dot-dot-as-subscript-and-dot-dot-as-superscript}
+
+a<sub>b</sub> a<sub>bc</sub> a<sup>b</sup> a<sup>bc</sup>