やらないといけない作業

1.4.1. Texlive のインストール ¶

Texlive はTexのディストリビューションの一つで最も普及しているパッケージである。 linuxでは texlive-science という自然科学用に必要な追加パッケージも含んだディストリビューションがあるが、windowsではコアの texlive をインストールした後に手動で追加パッケージを入れてやる必要がある。

1.4.1.1. ダウンロード¶

インストーラー install-tl-windows.exe をダウンロードする。

install-tl-windows.exe

ダウンロードが完了したら、インストーラーを実行する。

1.4.1.2. インストールのカスタマイズ¶

デフォルトのインストールでは必要なコレクションが欠けているのでインストールのカスタマイズを行う。

../_images/No1-12.png — 図 1.1 **install-tl-windows.exe** を起動した最初の画面で、高度な設定をクリック¶

高度な設定画面に切り替わる。

1.4.1.2.1. スキームの設定¶

フルインストールせずに必要最小限の basicスキーム でインストールする。

../_images/No1-21.png — 図 1.2 スキームの変更：をクリック¶

../_images/No1-31.png — 図 1.3 スキーム選択画面が開き、 `basicスキーム` を選択して、 OK¶

高度な設定画面に戻る。

1.4.1.2.2. 追加コレクションのカスタマイズ¶

必要な追加コレクションを設定する。

画面が追加コレクションの選択画面に切り替わり以下の各項目のチェックを入れる OK をクリックすると高度な設定画面に戻る。

言語タブ

日本語
英語・米語

ほかのコレクションタブ

Latex基本パッケージ
Latex推奨パッケージ
Tex外部プログラム
出版スタイルや学位論文
Windows専用プログラム
必要プログラムとファイル
推奨フォント
数学、自然科学、計算科学パッケージ
画像およびフォントのユーティリティ
画像と図表

../_images/No1-41.png — 図 1.5 デフォルトのコレクション¶

../_images/No1-51.png — 図 1.6 各項目にチェックをいれて OK¶

追加コレクションの数が 12個 になっているはず。

1.4.1.2.3. インストールの実行¶

インストールを開始する。

../_images/No1-61.png — 図 1.7 他のコレクションの数を確認しインストール¶

インストールには約40分かかる。

../_images/No1-71.png — 図 1.8 インストールの最中。パソコンの電源は落とさずに待つ¶

../_images/No1-81.png — 図 1.9 インストールが完了したら閉じるをクリック¶

1.4.1.3. さらなる追加パッケージのインストール¶

上の追加パッケージのインストールでも抜けているものがあるので手動でインストールする。

デスクトップに戻り、スタート画面を確認する。 Tex Live 2024 がインストールされている。TLShell TeX Live Manager を起動する。

../_images/No1-91.png — 図 1.10 **TLShell Texlive Manager** をクリック¶

新規で開くため、depositoryのロードに時間がかかる場合がある。

../_images/No1-101.png — 図 1.11 読み込みが完了したら閉じるをクリック¶

パッケージリスト

から以下のものをインストールする。

状態: すべて
詳細: すべて
検索: 名称でソート

の状態で検索するとよい。検索のフレームにインストールしたいパッケージ名を入力したら下に検索結果が出て、インストールするパッケージにチェックをしてインストールする。

funcychap
wrapfig
capt-of
framed
upquote
needspace
tabulary
varwidth
titlesec
simplekv
latexmk
latexmk.windows

注釈

もともとインストールされているものもある。

インストールが終わったら終了をクリックし、インストール完了。

1.4.2. Visual Studio Code のインストール ¶

Visual Studio Code とはMicrosoftが提供するコードエディター

sphinx の rst ファイルを編集するのに使用する。

1.4.2.1. インストール¶

https://code.visualstudio.com/download からwindows版のインストーラーをダウンロードする。

../_images/No3-11.png — 図 1.12 ダウンロードページが開いたらWindows版をダウンロード¶

インストーラーを実行するとセットアップ画面に移動する。

../_images/No3-21.png — 図 1.13 `同意する` にチェックを入れ次へをクリック¶

画面が切り替わったら以下の項目にチェックを入れる。

デスクトップ上にアイコンを作成する
サポートされているファイルの種類をエディターとして、Codeを登録する
PATHへの追加（再起動後に使用可能）

../_images/No3-31.png — 図 1.14 項目にチェックを入れる¶

インストールが開始される。インストール完了後、デスクトップに表示されたアイコンをクリックすると Visual Studio Code が開ける。

../_images/No3-41.png — 図 1.15 **Visual Studio Code** のインストール直後の起動画面¶

1.4.2.2. Visual Studio Code の環境設定¶

Visual Studio Code は様々な拡張機能がフリーで手に入れることができる。ここでは、 python や sphinx に特化した拡張機能を入れる。

画面左のテトリスのようなアイコンをクリックする。

../_images/No3-51.png — 図 1.16 必要な拡張機能をインストールできる¶

以下の項目を検索しインストールする。

Japanese Language Pack for Visual Studio Code
Pylance
Python
reStructuredText Syntax highlighting
Python Debugger

../_images/No3-61.png — 図 1.17 各項目を検索し、インストール¶

1.4.3. anaconda のインストール ¶

1.4.3.1. インストールの前準備¶

1.4.3.1.1. アカウント名を半角英数字にする¶

anaconda のインストールの際、アカウント名が全角だとエラーが表示される。そのため新規でアカウントを作成するか、アカウント名を変更する必要がある。

変更方法を以下に記載する。

../_images/No2-310.png — 図 1.18 スタート画面からアイコンを選択¶

../_images/No2-41.png — 図 1.19 アカウント設定の変更を選択¶

画面が切り替わる。関連設定 ‣ 自分のアカウントを管理をクリック

../_images/No2-51.png — 図 1.20 自分のアカウントを管理をクリック¶

webページに切り替わる。

../_images/No2-61.png — 図 1.21 Microsoftアカウントのwebページが開く¶

あなたの情報 ‣ 名前を編集する

../_images/No2-71.png — 図 1.22 名前を編集するをクリック¶

画面が切り替わる。

../_images/No2-81.png — 図 1.23 自分の名前を **半角英数字** で入力し、保存をクリック¶

自分の名前が変更される。

../_images/No2-91.png — 図 1.24 名前が半角になっていることを確認¶

一度画面を閉じ、再起動をかける。

../_images/No2-101.png — 図 1.25 スタート画面から **再起動**¶

再起動をかけると、画面右下のアカウント名が半角になる。

../_images/No2-111.png — 図 1.26 名前が半角になっていることを確認¶

1.4.3.2. インストール¶

インストールは python japanのwebページ <https://www,python.jp> python環境構築ガイド を参考にする。

1.4.3.2.1. インストーラーのダウンロード¶

以下の anaconda のwindows版のインストーラーをダウンロードする

Anaconda3-2024.02-1-Windows-x86_64.exe

注釈

最新版がある場合は最新版の方が良い。

ダウンロードが完了したら、windows版のanacondaのインストーラーを実行する。

../_images/No2-211.png — 図 1.27 ダウンロードが完了したらファイルを開くをクリック¶

1.4.3.2.2. インストーラーの実行¶

最初に、 anaconda のインストールのセットアップ画面が表示される。

../_images/No2-221.png — 図 1.28 Next をクリック¶

../_images/No2-231.png — 図 1.29 ライセンスの確認。 I Agree をクリック¶

../_images/No2-241.png — 図 1.30 使用者の範囲。ここでは `Just me` を選択し Next をクリック¶

../_images/No2-251.png — 図 1.31 インストール先のdirectory。 `Destination Folder` を確認し Next をクリック¶

インストール先のdirectoryは C:Usersアカウント名anaconda3 というように自分のアカウント先が参照されているはずである。インストール先を変えたければここで変える

anaconda の設定。以下の項目にチェックを入れる。

Create start menu shortcuts(supported packages only).
Register Anaconda3 as my default Python 3.11

注釈

1番目のチェックを忘れると、インストール完了後スタートメニューにanacondaが表示されない。

../_images/No2-261.png — 図 1.32 項目にチェックを入れ Install をクリック¶

インストールが開始される。 Completed と表示されたら完了。

../_images/No2-281.png — 図 1.33 `Completed` と表示されたら→ Next をクリック¶

../_images/No2-291.png — 図 1.34 Next をクリック¶

../_images/No2-301.png — 図 1.35 Finish をクリック¶

Webページが開く。このページは閉じてもかまわない。

../_images/No2-311.png — 図 1.36 Webページを閉じる¶

ホーム画面から、スタート画面を開くとメニューに　Anaconda3 が表示されインストールされているのがわかる。

../_images/No2-321.png — 図 1.37 **Anaconda3(64-bit)** がインストールされている¶

1.4.3.3. conda の初期化¶

anaconda がterminalで使用できるように conda の初期化を行う。

スタート画面から Anaconda3 ‣ Anaconda Prompt でterminal開く

../_images/No2-331.png — 図 1.38 ファイルから Anaconda Prompt をクリック¶

ターミナルが開く。

conda init

を入力して Enter

../_images/No2-351.png — 図 1.39 **conda** の初期化が終了する¶

(base)～ が再び出てきたら、初期化完了。

ヒント

Spyder （python programming 用）の最初の起動

sphinx とは関係ないが、python programming開発用のIDE、 spyder の使い方を示す。

スタート画面に戻り、 Anaconda3 ‣ Spyder を選択。

../_images/No2-361.png — 図 1.40 Anaconda3 から **Spyder** をクリック¶

../_images/No2-371.png — 図 1.41 **Spyder** が起動する。¶

バージョンアップや使い方ツアーを進められるが拒否して OK 。

../_images/No2-381.png — 図 1.42 OK をクリック¶

../_images/No2-391.png — 図 1.43 Dismiss をクリック¶

../_images/No2-401.png — 図 1.44 **Spyder** の初期画面¶

1.4.4. Sphinx のインストール ¶

anaconda 上に sphinx をインストールする。 Windowsのスタート画面から Anaconda Powershell Prompt を開く。

../_images/No4-11.png — 図 1.45 **Anaconda Powershell Prompt** をクリック¶

anaconda 上にプログラムをインストールする際には必ず anaconda を最新の状態にしておかなくてはならない。 Powershellで以下のコードを入力する。

conda update -n base conda
conda update --all

次に、Powershellで

conda install sphinx

を入力して sphinx をインストールする。 Windowsのスタート画面のメニューには sphinx は表示されない。

1.4.5. Graphviz のインストール ¶

Graphviz は人や物のネットワーク、フローチャート、系統樹などに適したグラフ描画ツールです。直接、windows上にインストールすることもできますが、ここでは anaconda 上にプログラムをインストールするやり方を紹介します。

1.4.5.1. インストール¶

スタート画面から Anaconda3 ‣　Anaconda Powershell Prompt を開く。

../_images/No5-11.png — 図 1.46 Anaconda Powershell Prompt を選択¶

Powershellでインストールのために以下のコードを入力する。

conda install python-graphviz

../_images/No5-21.png — 図 1.47 `conda install python-graphviz` を入力して `Enter`¶

proceed ([y]/n)? ときかれるので、 y と入力して Enter

../_images/No5-41.png — 図 1.48 この文字が表示されたらインストール完了¶

1.4.1. Texlive のインストール¶