windowsにおけるパスに日本語を含むtexファイルのlatexmkを用いたコンパイル

Question

実現したいこと

texファイルのフルパス中に日本語が入っていても、Windows10のVisual Studio Code上でlatexmkを用いてショートカットキーを用いて楽にコンパイルできるようにしたいです。

また、補足情報になぜ日本語のパス名でコンパイルしたいのか、今の状況、譲れない点、譲歩できる点を記載しています。

発生している問題・エラーメッセージ

フルパス中にC:\Documents\プログラミング\main.texのようにして、フルパス中プログラミングなどの日本語が入るとUTF-8に変換された際に文字化けし、texファイルとしては許されていない文字に文字化けするようで、コンパイルできません。
実際にC:\Documents\プログラミング\main.texのファイルをコンパイルした時のエラーメッセージは以下のようになります。

Latexmk: This is Latexmk, John Collins, 26 Dec. 2019, version: 4.67.
Latexmk: Filename 'c:/Documents/�v���O���~���O/main' contains character not allowed for TeX file.
Latexmk: Stopping because of bad filename(s).
C:\texlive\2019\bin\win32\runscript.tlu:907: command failed with exit code 2:
perl.exe c:\texlive\2019\texmf-dist\scripts\latexmk\latexmk.pl -synctex=1 -interaction=nonstopmode -file-line-error -pdfdvi c:/Documents/�v���O���~���O/main

この時のmain.texのファイルの中身は以下です。

\documentclass[dvipdfmx, a4paper, 11pt]{jsarticle}%A４用紙縦、明朝（デフォルト）１１ポイント
\begin{document}
テンプレートです.
\end{document}

応急処置的な解決法

フルパス中にプログラミングという文字が含まれている場合は、ターミナルで、以下を実行してフルパスで実行しないようにしています。

$ cd C:\Documenst\プログラミング
$ latexmk main.tex

環境

• OS : Windows10 pro
• エディタ ： Visual Studio Code
• texディストリビューション ： Tex Live
• texのコンパイルレシピ： latexmk
• pdf Viewer : texworks
• VSCode で TeX を書こう

上記のサイトを見て、Vscodeの設定をしました。ただし、viewerの部分はtexworksに変えています。

#!/usr/bin/env perl
# file          .latexmkrc
# author        Ryotaro Onuki
# created_at    2019.01.25
# modified_at   2019.02.05

## latex commands
$latex            = 'platex -synctex=1 -halt-on-error';
$latex_silent     = 'platex -synctex=1 -halt-on-error -interaction=batchmode';
$bibtex           = 'pbibtex -kanji=utf8';
$dvipdf           = 'dvipdfmx %O -o %D %S';
$makeindex        = 'mendex %O -o %D %S';
$max_repeat       = 5;

## pdf mode
$pdf_mode         = 3; # 0: none, 1: pdflatex, 2: ps2pdf, 3: dvipdfmx

## viewer settings
$pvc_view_file_via_temporary = 0;
if ($^O eq 'darwin') {
    # OSX
    $pdf_previewer = 'open -a Preview';
} elsif ($^O eq 'linux') {
    # linux
    $pdf_previewer = 'evince';
} else {
    # Windows
    $pdf_previewer    = '"C:\texlive\2019\bin\win32\texworks.exe" -reuse-instance %O %S';
}

## output directory
$aux_dir          = "build/";
$out_dir          = "build/";

補足情報

なぜ日本語のパス名でコンパイルしたいのか

• texファイルの名前を英字にするのは構わないのですが、フォルダの名前まで英字にするとファイル整理の際に見づらくなると思っているためです。

今の状況

• TeXにとってやばい入力ファイル名

このサイトから文字化けした時に~が入っているため、コンパイルできないことまではわかりましたが、Windowsでの日本語の文字化けを解決する方法は載っていなかっため、今回質問しました。

• また、いらない情報かもしれませんが、記載しておきます。

今のところプログラミングという文字以外で許されない文字に文字化けするものは見つけていません。
そのため、プログラミングという文字さえ入っていなければコンパイルできる状態ではあります。

譲りたくない点

• エディタはVscodeでお願いします。
• 理由にも書きましたが、あくまでフォルダ名は日本語にしたいと思っていますので、フォルダ名を英字にしろっていうのは無しでお願いします。

譲歩できる点

• latexmkを使用しているのはあくまでも中間ファイルをまとめてbuildフォルダに置くことができて、フォルダ内がすっきりするため使用しているだけです。

そのため、中間ファイルがまとめられる、または消せて、その上でVscodeでショートカットキーが使えるのであれば、latexmkでなくても構いません。

• 何か設定する際にコマンドを使う際にはgit bash、（power shell）、wslがインストールされている状態ですので、Linuxコマンドであっても構いません。

追記

大変長くなってしまい、申し訳ないです。
コンパイルする方法がない、あるいは、推奨されない（texの挙動がおかしくなる）等の理由で解決できる方法がなければそれでもかまいません。
解決できる方法があるのであれば、知りたいと思って、質問した次第です。

Answer 1

ターミナルで、以下を実行してフルパスで実行しないようにしています。

latexmkに-cdというオプションがあって、当該フォルダ内へのカレントディレクトリの移動を自動で実行するとのことです。

とはいえ、VSCodeからlatexmkに引数を渡した時点でパス名が文字化けしているのであれば、打つ手は限られます。

さらに、「現状ではシフトJISでパスが行ってしまっていること」、そして「チルダを含むパスではTeXが正常に動作しない（シフトJISでミの2バイト目がチルダと同じコードです）こと」など、これで解決するかも試してみないとわからないです。

---

理由にも書きましたが、あくまでフォルダ名は日本語にしたいと思っていますので、フォルダ名を英字にしろっていうのは無しでお願いします。

日本語のファイル名・フォルダ名は、エンコードの関係で数多くの問題を巻き起こします（例えば、macOSで作ったプログラミングというフォルダと、LinuxでUTF-8エンコードして作ったプログラミングというフォルダは、名前が一致しません）。

ツールを作る側としてはできるだけ対応すべきなのは間違いないですが、使う側としては諦めも必要かと思います。

あくまで作りたいものがTeXの文書なのであれば、その出来具合にフォルダ名は関係してきません。その本質的ではないこだわりのために工数を費やすより、そこは割り切って本題の文書作成に時間をかける、あるいは浮いた時間を別なことに活用するほうが合理的です。

Comments

[maisumakun]

> フォルダの名前まで英字にするとファイル整理の際に見づらくなると思っているためです。

慣れの問題です。

[tama14142356]

> 日本語のファイル名・フォルダ名は、エンコードの関係で数多くの問題を巻き起こします

はい、身に染みて感じています。
そのため、一時期、windows全体のエンコードをUTF-8に変える設定をしたりもしましたが、アプリをインストールするときに文字化けしてしまって、セキュリティの観点から危険な気がして、断念しました、、、。

[tama14142356]

> ツールを作る側としてはできるだけ対応すべきなのは間違いないですが、使う側としては諦めも必要かと思います。

ですよね、、。
時にはあきらめも大事ですよね。
その言葉が欲しくて質問したようなものなので、ありがとうございました。

Answer 2

Latex workshopはきちんと現在のワークスペースを認識しているようなので、%DOC% (ファイルのフルパスから拡張子を除いたもの)の代わりに %DOCFILE%(フォルダを含まないファイルの名前から拡張子を除いたもの)を指定すると、フォルダの日本語がlatexmkに渡されないので、正しくコンパイルできるようになると思います。

私の場合は setting.json に以下のように書いています。

{
    "latex-workshop.latex.recipes": [
        {
            "name": "latexmk",
            "tools": [
                "latexmk",
            ]
        },
    ],
    "latex-workshop.latex.tools": [
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-f",
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        }
    ],
}

Comments

[tgmknmt]

長らく困っていたことの1つであった問題が解決したので、とても助かりました！