pasc99/codespaceslatex

日本語文章を作成できるCodespaces・Devcontainer用LaTeX環境，Overleafの代用

Codespace LaTeX for Japanese

• Codespace LaTeX for Japanese
  • 概要
  • なぜCodespacesを使うのか
  • Codespaces経由の使い方
    • Troubleshooting
  • MS明朝，MSゴシックを使用したい場合
    • 1. フォントファイルの準備
    • 2. フォントのインストール
    • 3. フォントの使用
  • TODO
  • Credits

概要

• これは日本語で文章を作成するためのCodaspace/devcontainer用LaTeXです。This is a LaTeX template for Codaspace that generates Japanese PDFs.

• sanjib-senさんのWebLaTeXより派生しています。Forked from sanjib-sen/WebLaTeX.

• 日本語のPDFを作成できるように，latexmkrcの設定や，LaTeX-Workshopの設定をいれています。

なぜCodespacesを使うのか

Codespaces は GitHub が提供するクラウド開発環境です。GitHub にリポジトリを作成するだけで、そのリポジトリを開発するための環境をすぐに利用できます。この環境は、GitHub が提供するクラウド上のコンピューターで、コードを編集したり、コンパイルしたり、デバッグしたりすることができます。Overleaf，CloudLaTeXのようなオンラインLaTeX環境を使うのと比べて，Codespacesを使うメリットは下記の通りです。

• 無料（時間制限あり）
• バージョン管理ができる
• 自由に環境をカスタマイズできる

Codespaces経由の使い方

1. リポジトリの右上のUse this templateで，

   Create a new repositoryまたはOpen in a codespaceを選択します。

2. 任意のリポジトリ名を入力し，Create Fork / Create repository from templateをクリックします。

3. <> Code > CodeSpaces > Create Codespace on Mainを選択し，インストールは始めます。

   初回起動は時間がかかりますが，2回目以降は早くなります。

4. latexindentを導入されています。texファイルをセーブする時点で自動でインデントが整えられます。好みの設定を入れたい場合は，./latexindent.yamlを編集してください。

5. デフォルトのビルドで.latexmkrcは自動的に読み込まれていますので，設定を変更したい場合は直接に./.latexmkrcを編集してください。PDFファイルは./OUTのディレクトリに出力されます。

   Troubleshooting

   • デフォルトのビルドが上手くいかない場合，下記のようにレシピのBuild with .latexmkrcをクリックしてビルドしてください。 　
   • ローカルのVisual Studio CodeでCodespaceを使うとき, ローカルのLaTeX Workshopとの設定が衝突してしまうことでレシピが実行されないことがあります。その場合は，VS Codeのsettings.jsonに設定が衝突しないように設定してください。

6. texファイルの先頭にマジックコメントを入れることはできますが，デフォルトのレシピを無視して優先的に実行されるので，やっていることがわからない方にはおすすめしません。参照:マジックコメント。

MS明朝，MSゴシックを使用したい場合

1. フォントファイルの準備

• フォントのttcファイルを./mapに配置してください。

• マイクロソフトのフォントはライセンスの関係で，このリポジトリには含まれていません。

  • Windowsユーザーは，C:\Windows\Fontsからコピーしてください。
  • WordとかOffice系のアプリをお持ちのMACユーザーは，bashコマンドで

    $ open /Applications/Microsoft\ Word.app/Contents/Resources/Fonts

    Wordのフォントフォルダを開き，ttcファイルをコピーしてください。

2. フォントのインストール

ここからはCodespaceのターミナルを使用します。

• デフォルトディレクトリ/workspaces/{レポジトリ名}#になっていることを確認してください。

  • なっていない場合は，

    $ cd /workspaces/{レポジトリ名}

    で移動してください。

• 下記のコマンドで./msfont.shを実行してください。

  $ sh msfont.sh

  これでdvipdfmxのデフォルトフォントはMS系フォントになります。

• 確認のために

  $ kanji-config-updmap-sys status

  でCURRENT family for ja: msになっているか確認してください。

  3. フォントの使用

  • ここまでできたら，デフォルトフォントはMS系フォントになります。
  • 他のフォント(例えばIPAex)を指定したい場合はmainとなるtexファイルにおいて適宜に

    \usepackage[ipaex]{pxchfon}

    を追加してください。または，ターミナルで

    $ kanji-config-updmap-sys ipaex

    でデフォルトフォントを変更してください。

TODO

• WSL2のdockerを用いてdevcontainerを立ち上がる方法を書くこと

Credits

• sanjib-sen's WebLaTex
• @James-Yu's LaTeX-Workshop
• texlive/texlive:latest
• 優曇華院's MS明朝でLaTeXする話