Emacsでorg-modeの上付き文字と下付き文字の記法を切り替える

次のOrgファイルをみてください。

base.org::

#+begin_example
- 10^24
- 10^-12
- x^2-y^3
- x_{i^2}
- snake_case_function_name() is a function.
#+end_example

このファイルをHTMLに変換します(base.orgを開いて M-x org-html-export-as-html )。

(一部抜粋)

ブラウザではこのように表示されます。

5行目の snake_case_function_name() is a function. のところが下付き文字になってしまっていて期待通りとは言えない表示になっています。

Orgでは _ と ^ はマークアップの為に使われる文字です。 ^ は続く文字列を上付き文字、 _ は続く文字列を下付き文字として扱います。

特にunder score( _ )は関数名などで使われることも多いので、関数名を書く時に常にこのような表示になってしまうのは困ります。

Orgファイルのヘッダーの設定でこの挙動を変更できます。Orgファイル内に #+OPTIONS: ^:nil を追加すると、この記法を解釈しないように設定できます。

disable.org::

#+OPTIONS: ^:nil
- 10^24
- 10^-12
- x^2-y^3
- x_{i^2}
- snake_case_function_name() is a function.

このファイルをHTMLに変換します。

(一部抜粋)

ブラウザではこのように表示されます。

最後の snake_case_function_name() is a function. は正しく表示されるようになりましたが、他の上付き/下付き文字にしたいところも無効になってしまいました。

最後の snake_case_function_name() is a function. はそのまま出力して欲しいですが、他のものは上付き/下付き文字として解釈して欲しいところです。今度は #+OPTIONS: ^:{} のように {} を設定します。

sub.org::

#+OPTIONS: ^:{}
- 10^24
- 10^-12
- x^2-y^3
- x_{i^2}
- snake_case_function_name() is a function.

このファイルをHTMLに変換します。

(一部抜粋)

ブラウザではこのように表示されます。

1〜3行目は記法が無視されました。4行目は部分的に記法が無視されたようです。5行目は記法が無視されて期待通りの表示になりました。この設定は ^ および _ の直後が {} で括られている時のみ解釈させられます。それに合うようにsub.orgを修正し、sub-fix.orgとして保存します。

sub_fix.org::

#+OPTIONS: ^:{}
- 10^{24}
- 10^{-12}
- x^{2-y^{3}}
- x_{i^{2}}
- snake_case_function_name() is a function.

このファイルをHTMLに変換します。

(一部抜粋)

ブラウザではこのように表示されます。

1〜4行目は上付き/下付き文字が解釈されて、5行目は下付き文字ではなくなっています。全て期待通りの表示になっています。

これまではOrgファイルのヘッダーに設定を記述していました。しかしこれでは全てのOrgファイルに設定を追加しなければなりません。Orgファイルがたくさんある場合はそんなことしたくありません。この設定はEmacs Lispの変数からも設定可能です。

記法を無効にする設定::

(custom-set-variables '(org-export-with-sub-superscripts nil))

{} で括られたところだけ記法を有効にする設定::

(custom-set-variables '(org-export-with-sub-superscripts '{}))

Emacs Lispで設定する場合 {} は評価できないので '{} のように ' を使ってシンボルを設定します。

記法を有効にする設定::

(custom-set-variables '(org-export-with-sub-superscripts t))

org-export-with-sub-superscriptsにはnil, {}, それ以外が設定できます。

文書の記述内容によって値の変更をすると良いでしょう。(デフォルト値には "'{}" が適切な気がしますが、なぜそうなっていないのでしょう…)

Orgの上付き/下付き文字の設定を変更して挙動を確認しました。Orgファイル内で設定するには #+OPTIONS: ^:値 を使って設定しました。Emacs Lispの変数から設定する場合はorg-export-with-sub-superscriptsをcustom-set-variablesを使って設定しました。 設定値は nil , {} とそれ以外を設定できることを確認しました。

• https://code.orgmode.org/bzg/org-mode/src/master/lisp/ox.el#L678-L705
• https://www.gnu.org/software/emacs/manual/html_node/org/Export-settings.html