執筆環境を整えた

修論執筆の環境を整えた。メモを残しておく。

やりたいこと

Overleaf ⇔ Git hub ⇔ なにかしらのlocal tex editor

執筆は基本的にOverleafでいいか～と思っていたが、海外出張が2回も入った＝ネット無し作業時間が発生したのと、まあ何があるかわからんのでローカルでもバックアップとりつつ作業できるといいなと思ったので

 

環境

  • Overleaf professional

    • CERNのアカウントを通すと無償でprofessionalが使える

  • Git hub

  • VSCode

    • 今回はwin11で動かした

 

準備

  1. Overleafのアカウント登録

  2. Git hubのアカウント登録

  3. Git for windowsのインストール

  4. VSCodeのインストール

  5. TEX Liveのインストール

 

レポジトリを作る

今回はGit hubのブラウザページから新規レポジトリを作成

先輩から頂いていたテンプレートがあったので、vmware経由でこのレポジトリにまとめた

 

Overleafと連携する

OverleafのNew Projectに Import from Github があるのでそれを選択

最初はGit hub連携みたいなのに誘導されるので、それに従ってユーザー名やpwを入力

連携が完了すると、importできるようになる

 

VSCodeと連携する

sshの設定をする

  1. Git bushを開く

  2. ssh-keygen -t ed25519 -C "your_email@example.com"

    • rsaは2023年3月から使えなくなった…

  3. Enter3回

  4. eval "$(ssh-agent -s)"

    • agentのpidが出てくることを確認

  5. ssh-add ~/.ssh/id_ed25519

  6. clip < ~/.ssh/id_ed25519.pub

  7. Git hubのブラウザにアクセス→右上の自分のアイコン→settings→SSH and GPG keys→New SSH key

  8. 出てきた表示の一番広いところに、6でclipしたものをペースト(ctri+v)

  9. Add SSH keyをクリック→完了

  10. git bushで ssh -T git@github.com をして、Hi!みたいな陽気な返事が来たらOK

新しい SSH キーを生成して ssh-agent に追加する - GitHub Docs

gitの設定をする

  1. VSCodeを開く

  2. terminalを開く→git bushを開く

  3. git config --global user.name {your name}

    git config --global user.email {email}

  4. ssh -T git@github.com

  5. 何か聞かれたらyesをタイプして完了

Visual Studio Codeでgit for Windowsを使えるようにするまで | Tech Note Meeting

git cloneする

    1. Git hubを開き、cloneしたいレポジトリのhttpsをコピー

    2. VSCodeでcommand paletteを開く

    3. git cloneと検索→選択して開く

    4. 1でコピーしたURLを貼り付ける

    5. Git hubとの連携を尋ねられるので、誘導に従って連携

      • ユーザー名とpwを入力する感じのやつ

    6. レポジトリの保存先を聞かれるので指定

    7. 完了

 

Texを使えるようにする

  1. TEX Live managerからlatexmkがインストール済みか確認

  2. VSCodeでterminalを開く→power shellで

  3. C:のユーザー名直下に .latexmkrc を作成

    • $latex = 'platex  -halt-on-error -synctex=1 %O %S';

      $latex_silent = 'platex -synctex=1 -halt-on-error -interaction=batchmode';

      $bibtex = 'pbibtex %O %B';

      $dvipdf = 'dvipdfmx %O -o %D %S';

      $makeindex = 'mendex %O -o %D %S';

      $max_repeat = 10;

      $pdf_mode = 3;

  4. LaTex Workshopをインストール

  5. VSCode左下の歯車→右上のファイルマーク

  6. 開いた setting.json を編集

    • "latex-workshop.intellisense.package.enabled": true,
          "latex-workshop.latex.autoClean.run": "onBuilt",
          "latex-workshop.latex.clean.fileTypes": [
              "*.blg",
              "*.idx",
              "*.ind",
              "*.lof",
              "*.lot",
              "*.out",
              "*.toc",
              "*.acn",
              "*.acr",
              "*.alg",
              "*.glg",
              "*.glo",
              "*.gls",
              "*.ist",
              "*.fls",
              "*.log",
              "*.fdb_latexmk",
              "*.snm",
              "*.nav",
              "*.dvi",
              "*.synctex.gz"
          ],
         
          "latex-workshop.view.pdf.viewer": "tab",

       

          "latex-workshop.latex.tools": [
              {
                  "name": "latexmk",
                  "command": "latexmk",
                  "args":[
                      "%DOCFILE%"
                  ]
                },
          ],

       

          "latex-workshop.latex.recipes": [
              {
                  "name": "latexmk",
                  "tools": ["latexmk"]
                },
          ],

       

          "latex-workshop.latex.autoClean.run": "onFailed"

  7. 右上に▶のビルドボタンが出るので、それでビルド

  8. 生成されたpdfを開く→できた！

0からTeX環境を構築する - Qiita

VScodeでLaTex環境を整える際のあれこれ

VSCodeでのLaTeXの環境構築

 

git push / pull する

Overleaf

左上のMenu→Git hubでこのポップアップが出てくる

VSCode

左上のsource controllからcommitやpushが可能

コメント必須っぽい？