CaTeX（軽鳥／怪鳥）で快適 LaTeX ライフ in VSCode konn-san.com

ギリシア文字補完、イメージ補完、フォント補完

最初に書いておくと、実はまだ、VSCode では他の機能拡張で提供されている構文定義から、構文上のスコープを得る方法が提供されていません。 これはつまり、手軽に「今カーソルのある場所が数式の内部なのか手軽に判定できない」という意味です。 という訳で、下記のギリシア文字補完、イメージ補完等は数式環境外でも呼び出せてしまう状態です。 まあ、TikZ 環境の中で \matrix[math nodes] { ... } と書かれててもイメージ補完が使えなかったりすることはよくあり、そういう点では望ましいかもしれませんが、普通の本文中（テキストモード）でも ; や : を入力しようとしたら補完を解除しないといけないのは、ちょっと不便かもしれません。 その内なんとかなる、といいな……。

デモは以下の通り。 まず、; で数式補完が、: でギリシア文字補完が走ります。

補完ではなく単に : や ; などのトリガー自身を入力したい時は、Escキーでも押して補完をキャンセルすれば大丈夫です。 本家に合わせて二回押しとかにしても良いかもしれないですが、取り敢えず現状はこうなってます。

あと本家 YaTeX にはデフォルトでは付いていませんが、@キーで数式フォント補完が走ります。 ただ、@ は LaTeX Workshop が提供している補完のプレフィックスと被っていて、使いづらいです。

また、キーボードだけではなくて、直接コマンドを呼び出すことでも補完を実行出来ます：

補完のトリガーキーや辞書は catex.image-completion を編集することでカスタマイズ出来ます。 例えば、デフォルトでは以下のような設定になっています：

{
  "name": "CaTeX Image Completion",
  "languages": [
    "latex"
  ],
  "triggers": [
    ";"
  ],
  "dictionary": "defaults/images.json",
  "renderMode": "latex"
}

renderMode の部分は必須で、triggers を空配列にすればホットキーは無効になり、直接呼出以外は出来なくなります。 languages の欄については、なんか生 TeX とか expl3 とかでも使いたくなったら入れてください。 dictionary の部分がファイルになっていますが、これは CaTeX に標準で同梱されているデフォルトの辞書 への参照になっていて、例えば、以下のように書き換えることができます：

{ ...
  "dictionary": [
      "defaults/images.json",

      // デフォルトでは \int のような \maketitle 型の補完になる。
      { "label": "{/", "body": "\\notin", "description": "∉" },

      {
        "label": "wcheck",
        "body": "widecheck", "description": "✓ (wide accent)",
        "type": "section" // "environment" などもある
      }
  ]
  ...
}

この補完機能は拙作の[Generic Input Method]機能拡張を使って実現されています。 なので、他の補完機能を作りたくなったら、同じ要領で Input Method の定義を書いて、generic-input-methods.input-methods にでも追加しておけば大丈夫な筈です。

セクション、環境、\maketitle そして {\Large } 補完

詳しくはMarketplaceやGitHubに上がっているGIFを見て欲しいんですが、C-c * 系の補完も用意してあります。 特に分ける意味もないので、例えばセクション補完では C-c s を押すと、選択範囲があれば囲む形で、そうでなければ新しくスニペットを挿入する形になっています：

また、YaTeXの補完機能 （や全く関係ないけど AquaSKK）を偉大たらしめているその場での辞書登録機能も CaTeX は提供しています。

折角 VSCode のスニペット機能を使っているので、引数の仕様まで含めて登録することが出来るようにしました。 例えば二番目に []{}[] とか入力すると、オプション引数、固定引数、オプション引数の順だという定義になります。 オプション引数はまず括弧全体が選択されるので、不要なら削除することができます。 上図の通り、デフォルトのプレースホルダ文字列も指定出来て、{foo}{}[bar]とかすると、\mycmd{foo}{}[bar]という形で挿入されるので、デフォルトの内容が決まってる時や、引数の説明などを入れると良いでしょう。

選択範囲を囲む機能については、\begin/\end-補完では選択範囲を環境の本体として扱いますが、それ以外の補完については、

1. プレースホルダが ! で始まっていればそこに挿入
2. そうでなければ一番最初の固定引数の所に挿入

という仕様です。上のデモで !here と書かれている場所がそうです。 上記 1 の場合の引数については、選択範囲が空の場合はそのまま here 部分がプレースホルダとして使用され、タブで往き来出来るようになります。 選択範囲が空でない場合は引数の内容として用いられ、その部分はスニペット展開では地の文として扱われタブでは無視されます。

以上のような機能は、\begin{}...\end{}-補完、{\Large }-補完、\maketitle-補完でも使うことが出来ます。 ただ、VSCode は2ストロークまでしかショートカットを許可していないので、YaTeX でいう C-c b aで align 環境を補完したり、C-c b [SPACE]で環境名一覧を出したり、といった機能は実装できていません。 まあとはいえ、曖昧検索をしてくれるので、今のところそんなに不便を感じていません。

自動登録をしてもいいですが、辞書を手で編集することも出来ます。 例えば以下のような感じ：

  "catex.environment.dictionary": [
    {
      "include": "defaults/environments.json"
    },
    {
      "name": "fact",
      "args": [
        {
          "kind": "optional",
          "placeholder": "title"
        }
      ]
    },
    {
      "name": "remark",
      "args": [
        {
          "kind": "optional",
          "placeholder": "title"
        }
      ]
    }
  ],

まあこれも、GitHubで defaults/*.jsonを見ればだいたい書き方がわかると思います。

VSCode における日本語入力

これは CaTeX に限らない既知の問題ですが、VSCode では日本語入力が乱れる、特に AquaSKK との食い合わせが悪い、という事が知られています。 完全に解決は出来ませんが、余分な拡張をオフにすると若干改善します。特に、私の環境では単語ベースの InteliSense 補完と Spell Right 機能拡張（自動スペルチェッカ）をオフにした所、完全にではないものの、許容出来る範囲まで文字列の乱れを軽減出来ました。

また、Emacs の要領で C-g を連発していたりすると制御文字が溜まるので、Remove backpace control character機能拡張を使うと良いでしょう。 とはいえ、たぶんこれエディタのテキストを EditorTextEdit ではなく text を置き換える形でやっていてあまり行儀がよくないのがちょっと不満です。