[LaTeX] [Mojave] Mac에서 latexindent가 제대로 작동하지 않는 경우의 해결 방법

소개

Mac (Mojave)의 VSCode에서 LaTeX 환경을 구축 할 때 Format Document가 제대로 작동하지 않았기 때문에 원인을 조사했습니다.

이전에 쓴 이 기사에 따라 설치한 경우를 전제로 하고 있습니다.
[Mojave] MacTex 2018 + VS Code로 LaTeX 환경 구축 - Qiita

.tex 파일을 마우스 오른쪽 버튼으로 클릭하면 Format Document를 선택할 수 있지만 오류가 발생합니다.

로그

VSCode에서 로그 출력을 보면 perl 모듈이 부족하다는 설명이있었습니다.
조사해 보면, 이 자동 들여쓰기 기능은 latexindent 가 담당하고 있는 것 같고, latexindent 는 많은 perl 모듈에 의존하고 있는 것 같습니다.
로그에서도 Log::Log4perl가 부족하다고 하고 있네요.

[18:20:25] Formatting failed with exit code 2
[18:20:25] stderr: Can't locate Log/Log4perl.pm in @INC (you may need to install the Log::Log4perl module) (@INC contains: /usr/local/texlive/2018/texmf-dist/scripts/latexindent /usr/local/Cellar/perl/5.28.1/lib/perl5/site_perl/5.28.1/darwin-thread-multi-2level /usr/local/Cellar/perl/5.28.1/lib/perl5/site_perl/5.28.1 /usr/local/Cellar/perl/5.28.1/lib/perl5/5.28.1/darwin-thread-multi-2level /usr/local/Cellar/perl/5.28.1/lib/perl5/5.28.1 /usr/local/lib/perl5/site_perl/5.28.1/darwin-thread-multi-2level /usr/local/lib/perl5/site_perl/5.28.1) at /usr/local/texlive/2018/texmf-dist/scripts/latexindent/LatexIndent/LogFile.pm line 22.

cpan 명령으로 해당 모듈을 설치하고 Format Document를 실행합니다.
에러 내용이 바뀔 때마다 지정된 모듈을 설치한다는 것을 반복해 보았습니다만, 도중에 이끼 버렸습니다.File::HomeDir가 의존하는 Mac::SystemDirectory에 문제가 있으며 설치가 진행되지 않습니다.

다른 프로젝트이지만 Mojave 관련 문제로 issue가 서있는 것 같습니다.
Failed to install on OSX Mojave Mac::SystemDirectory is not installed. · Issue #39 · sqitchers/homebrew-sqitch

이 issue에 따르면 brew로 넣은 perl이라면 문제없이 설치 가능하다는 것이었다.
시도해 보면 의외로 쉽게 해결할 수 있었으므로, 다음 절에서 실제로 입력한 명령을 올려 둡니다.

명령

cpan 보다 cpanm 쪽이 편리할 것 같았으므로, 김에 넣어 두었습니다.
기본적인 작업은 Format Document를 실행할 때 오류 메시지로 화를 낼 때마다 지정된 모듈을 설치하는 것입니다.
물론 일부러 VSCode에서 시도하지 않고 명령 줄에서 디버깅 할 수 있다고 생각합니다.

$ brew install perl
$ brew install cpanm
$ cpanm Log::Log4perl Log::Dispatch::File YAML::Tiny File::HomeDir Unicode::GCString

결론

실제로 입력 한 명령 자체는 적지 만 원인을 조사하는 데 시간이 걸렸습니다.

평소에는 perl을 많이 사용하지 않으므로 모듈에 대한 인식이 잘못되었을 수 있습니다.
뭔가 있으면 코멘트 부탁드립니다.

참고

[Mojave] MacTex 2018 + VS Code로 LaTeX 환경 구축 - Qiita

Formatting failed error · Issue #376 · James-Yu/LaTeX-Workshop

Failed to install on OSX Mojave Mac::SystemDirectory is not installed. · Issue #39 · sqitchers/homebrew-sqitch