👨‍💻

【LaTeX】VSCodeでOverleafを操作しよう!

2024/06/19に公開

はじめに

本記事では,レガシーな組版処理システムであるLaTeXを扱うために,統合開発環境「VSCode」で「Overleaf」を操作できるようにする手順を説明します.

Overleafとは

まずは,Overleafに関する簡単な説明を行います.

Overleafは,オンラインでLaTeX文書を作成・編集・共有するためのクラウドベースのプラットフォームです.
クラウドベースであるため,ローカルにLaTeX環境を構築する必要がなく,誰でも簡単にLaTeXを使える便利なツールです.

VSCodeでOverleafを動作させるメリット

Overleafはブラウザでのみ動作可能なプラットフォームですが,本記事で紹介する手法を使うと,VSCodeで操作することが可能になります.

この手法のメリットとしては,以下が考えられます(筆者の見解).

  • 見慣れたインターフェースで編集が可能
  • 誤ってタブやウィンドウを閉じてしまう心配が少ない
  • VSCodeの様々な拡張機能が使用できる

筆者が特に気に入っている点は,「GitHub Copilotが動作する」ことです!

VSCodeにGitHub Copilotを導入しておくと,コーディング時と同様にLaTeXの編集時にも助けてくれます.
例えば,文章を書いているときには「後に続く文章候補を自動で生成」してくれたり,LaTeXでコンパイルエラーが発生したときには「自動で適切な構文に修正」してくれたりと,非常に便利なアシストを提供してくれます.

※まだVSCodeにGitHub Copilotを導入していない方は,以下のサイトなどが参考になると思いますので,導入をおすすめします.

https://code.visualstudio.com/docs/copilot/overview

https://qiita.com/RyoWakabayashi/items/1207128e88669c76bf5f

VSCodeでOverleafを操作する手順

VSCodeでOverleafを操作できるようになるまでの手順を,以下のステップに沿って説明していきます.

  • Overleafのアカウントを作成
  • VSCodeでOverleafにログイン

OverLeafのアカウントを作成

まず,以下のページからOverleafアカウントの作成を行います.

https://ja.overleaf.com/register

サインアップは,メールアドレスとパスワードを入力し,コード認証を行うだけで完了します.

※この際,有料プランへの加入を勧められますが,無料で使用したい方は「No, I don't need these」を選択して,丁重にお断りしましょう.

スクリーンショット (30).png

以上で,Overleafアカウントの作成は完了となります.

補足:プロジェクトの作成

アカウントの作成が完了すると,スタート画面が表示されます.
Create a new project」をクリックし,「空のプロジェクト」を選択します.
その後,プロジェクト名の入力を求められますので,適当な名称(Testなど)で作成してください.

スクリーンショット (31).png

スクリーンショット (32).png

プロジェクトを作成すると,画面左にソースファイル一覧,画面右にテキストファイルが表示されると思います.(以下の画像は,空のプロジェクト(プロジェクト名:Test)を作成した場合の例です)

スクリーンショット (33).png

VSCodeでOverleafログイン

先ほどサインアップしたOverleafのアカウントにVSCodeでログインします.
まず,VSCodeの拡張機能の検索欄に「Overleaf Workshop」と入力し,拡張機能をインストールします.

スクリーンショット (35).png

インストールが完了すると,サイドバーに「Overleaf Workshop」という名前のアイコンが追加されます.これをクリックしてください.

スクリーンショット (34).png

すると「www.overleaf.com」というホストが表示されるので,そこにカーソルを合わせ,ホスト名の右側にある「Login to Server」をクリックします.

スクリーンショット (36).png

ログイン手段の選択画面が表示されますが,Cookiesを用いたログイン方法「Login with Cookies」を選択してください.すると,Cookies情報の入力が求められますので,自身のOverleafのCookies情報を入力します.

OverleafのCookies情報の取得

OverleafのCookies情報の取得方法を説明します.まず,以下のページからOverleafに自身のアカウントでログインしてください.

https://ja.overleaf.com/project

ログイン後に次の手順に進みます.
ログインすると,以下の画像のようなページが表示されます.

スクリーンショット (37).png

このページのCookie情報を取得し,Overleaf Workshopのログイン時にその情報を入力することで,VSCodeからOverleafにログインすることができます.

補足:ページのCookie情報を取得する方法

まず,管理者画面を開きます(F12キーを押す,または右クリックで「検証」).
管理者画面内の「Network」タブをクリックし,検索欄に「/project」と入力します.(以下は入力後の画面例です).

スクリーンショット (38).png

この画面のままページを更新すると,projectという名称のRequestURLを含む通信が表示されます.
その中のprojectドキュメントをクリックし,Response HeadersにあるSet-Cookieに記載されている文字列(以下の画面の黒塗り部分)をコピーしてください.

画像1.png

以上で,OverleafのCookies情報の取得が完了しました.

まとめ

本記事では,オンラインで使用できるLaTeXエディタ「Overleaf」を,VSCodeで操作する方法について説明しました.
特に,LaTeX未経験の方や,環境構築が面倒だと感じて敬遠している方にとって,LaTeXを触るきっかけになれば幸いです.

https://github.com/iamhyc/Overleaf-Workshop

マイページ紹介

https://haradakaito.org/

Discussion