platex-vscode-template

Visual Studio Code (VS Code) で日本語論文をLaTeX で書くときのテンプレート． pLaTeX でのビルドを行う．

ディレクトリ	含まれるファイルの種類
.devcontainer	Dev Container (Docker) の設定ファイル
.vscode	VS Code 用の設定ファイル
fig	論文に使用する画像ファイル
out	LaTeX による生成ファイル(PDF もここ)

環境構築

前提としてVS Code をインストールしてください． TeXLive は直接インストールして使用するか，仮想環境のDocker 上にインストールして使用するか，どちらでもお好みの方を選べます．

TeXLive

1. TeXLive をインストール
2. このフォルダをVS Code を開き，推奨拡張機能をインストールする（VS Code から提案されると思います）

• LaTeX Workshop
• テキスト校正くん
• Code Spell Checker

Docker

1. Docker をインストールして起動
2. このフォルダをVS Code を開き，ウィンドウ左下の>< をクリックしてReopen in container をクリック

よく使うショートカットキー

ショートカットキー	機能
Ctrl + Alt + B	ビルド
Ctrl + Alt + V	PDF を表示
Ctrl + Alt + C	中間ファイルの削除
Ctrl + Alt + M	数式プレビュの表示
Ctrl + Alt + J	PDF の該当の場所にジャンプ
PDF を Ctrl + クリック	.tex の該当の行にジャンプ
Ctrl + Shift + M	エラーやワーニングの確認
Ctrl + Shift + U	ログファイルの確認

.tex ファイルの保存時にも自動ビルドが実行される設定としている．

動作確認

1. $ git clone [email protected]:kimushun1101/platex-vscode-template.git
   もしくは
   GitHub ページの Code<>▼ から Download ZIP して展開する．
2. VS Code で File→Open Folder でこのフォルダを開く．（Docker の場合は Reopen in container まで行う）
3. sample.tex を開いた状態で，Ctrl + Alt + B
4. ビルドの完了後に Ctrl + Alt + V

使い方

動作確認したディレクトリでそのまま作業（3番）を進めても良いですが，以下の手順で，ご自身のGitHub にリポジトリを作成してバージョン管理することをオススメします．

1. GitHub アカウントの作成．Git をインストールして使い方を習得（とりあえずclone, add, commit, push ができればよい）．
2. Use this template▼ からCreate a new repositoryを行う．Private リポジトリとすることをオススメします．
3. Code<>▼ から作成したリポジトリのパスをコピーして$ git clone 作成したリポジトリのパス
4. 論文を提出する学会などが配布しているTeX ファイルやそのスタイルファイルをこのディレクトリにコピーアンドペーストして，動作確認と同様の方法でビルドしてください．

BibTex

• reference.bib はZotero やMendeley などの文書管理ツールのエクスポート機能などで作成するか，Google Scholar より調べて引用→BibTeXなどからコピーアンドペーストして加筆していくとよい．
• bst ファイルが提供されていない場合には，out/sample.bbl をsample.tex にコピーアンドペーストして，提出先が要求するフォーマットに手動で修正してください．

参考

• LaTeX Workshop を使いこなす
• Dockerイメージはこちらを使用させていただきました．https://github.com/tbistr/texlive-full-devcontainer

ライセンス

The MIT License