最終更新:2017-08-13 (日) 16:54:33 (7d)

Visual Studio Code > LaTeX Workshop

Repository

Changelog

Usage

TeX ファイルを保存すると自動的にビルドされる

ビルドに成功すると

LaTeX toolchain succeeded.

と表示される

左下のマークをクリックすると

Please Select LaTeX Workshop Actions

と表示され以下のアクションが選択できる

  • Build LaTeX project
  • View PDF file in web page
  • View PDF file in new tab
  • SyncTeX from cursor
  • Clean up auxiliary files
  • Open citation browser
  • Show last LaTeX log

LaTeX Workshop [3.3.0] - 2017-08-08 で PDF ファイルを表示すると日本語が表示されない

LaTeX Workshop [3.3.0] - 2017-08-08 で PDF ファイルを表示すると日本語が表示されません。

日本語を表示するためには以下の作業を実行します。

  1. http://mozilla.github.io/pdf.js/getting_started/#download から PDF.js の Pre-built の Stable をクリックして zip ファイルをダウンロードして展開する
  2. 展開したファルダーの中にある web フォルダーをクリックすると cmaps フォルダーがあるので cmaps フォルダーを
    Windows の場合は %USERPROFILE%\.vscode\extensions\James-Yu.latex-workshop-3.3.0\viewer\
    macOS, Linux の場合は $HOME/.vscode/extensions/James-Yu.latex-workshop-3.3.0/viewer/
    フォルダーにコピーする
  3. Windows の場合は %USERPROFILE%\.vscode\extensions\James-Yu.latex-workshop-3.3.0\viewer\viewer.js
    macOS, Linux の場合は $HOME/.vscode/extensions/James-Yu.latex-workshop-3.3.0/viewer/viewer.js
    を開いて
    PDFJS.cMapUrl = '../web/cmaps/';
    PDFJS.cMapUrl = 'cmaps/';
    に修正して保存する

以上の作業で日本語が表示されるようになります。

設定

Ctrl+Comma で既定の設定と settings.json を開きます。左側に表示されている既定の設定の LaTeX Workshop configuration を選択します。 デフォルトでは latex-workshop.latex.toolchain が以下のように設定されています。

  "latex-workshop.latex.toolchain": [
    {
      "command": "latexmk",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "-pdf",
        "%DOC%"
      ]
    }
  ],

Windows で Latexmk-upLaTeX-pdfdvi を使用する場合は右側に表示されている settings.json に以下の設定を追加・保存してデフォルトの設定を上書きします。

    "latex-workshop.latex.toolchain": [
      {
        "command": "latexmk",
        "args": [
          "-e",
          "$latex=q/uplatex %O -kanji=utf8 -no-guess-input-enc -synctex=1 -interaction=nonstopmode -file-line-error %S/",
          "-e",
          "$bibtex=q/upbibtex %O %B/",
          "-e",
          "$biber=q/biber %O --bblencoding=utf8 -u -U --output_safechars %B/",
          "-e",
          "$makeindex=q/upmendex %O -o %D %S/",
          "-e",
          "$dvipdf=q/dvipdfmx %O -o %D %S/",
          "-norc",
          "-pdfdvi",
          "%DOC%"
        ]
      }
    ]

macOS, Linux で Latexmk-upLaTeX-pdfdvi を使用する場合は右側に表示されている settings.json に以下の設定を追加・保存してデフォルトの設定を上書きします。

    "latex-workshop.latex.toolchain": [
      {
        "command": "latexmk",
        "args": [
          "-e",
          "$latex=q/uplatex %O -synctex=1 -interaction=nonstopmode -file-line-error %S/",
          "-e",
          "$bibtex=q/upbibtex %O %B/",
          "-e",
          "$biber=q/biber %O --bblencoding=utf8 -u -U --output_safechars %B/",
          "-e",
          "$makeindex=q/upmendex %O -o %D %S/",
          "-e",
          "$dvipdf=q/dvipdfmx %O -o %D %S/",
          "-norc",
          "-pdfdvi",
          "%DOC%"
        ]
      }
    ]

使い方

ファイルの内容を変更して Ctrl+S で保存するとビルドコマンドが実行されます。ファイルの内容を変更していない状態でビルドコマンドを実行したい場合は 右クリック → Build LaTeX project あるいは Ctrl+Alt+B でビルドコマンドを実行します。

右上の PDF ファイルのアイコンを左クリックあるいは Ctrl+Alt+T で右側に新しいタブで PDF ファイルを表示します。右クリック → SyncTeX from cursor あるいは Ctrl+Alt+S で forward search,Ctrl+左クリックで inverse search を行います。

Ctrl+Alt+V でウェブブラウザで PDF ファイルを表示します。右クリック → SyncTeX from cursor あるいは Ctrl+Alt+S で forward search,Ctrl+左クリックで inverse search を行います。

右クリック → LaTeX Workshop: All actions あるいは Ctrl+Alt+L で Please Select LaTeX Workshop Actions が表示され以下のリストから Action を選択すると実行されます。

Build LaTeX project
View PDF file in web page
View PDF file in new tab
SyncTeX from cursor
Clean up auxiliary files
Open citation browser
Count words in LaTeX document
Show LaTeX log
Open LaTeX Workshop change log
Create an issue on Github
Star the project