.. contents:: やらないといけない作業 :depth: 1 :program:`Texlive` のインストール ---------------------------- :program:`Texlive` はTexのディストリビューションの一つで最も普及しているパッケージである。 linuxでは :program:`texlive-science` という自然科学用に必要な追加パッケージも含んだ ディストリビューションがあるが、windowsではコアの :program:`texlive` をインストールした後に 手動で追加パッケージを入れてやる必要がある。 ダウンロード ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ インストーラー :program:`install-tl-windows.exe` をダウンロードする。 :download:`install-tl-windows.exe ` ダウンロードが完了したら、インストーラーを実行する。 インストールのカスタマイズ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ デフォルトのインストールでは必要なコレクションが欠けているのでインストールのカスタマイズを行う。 .. figure:: No1-1.png :width: 250 :command:`install-tl-windows.exe` を起動した最初の画面で、:guilabel:`高度な設定` をクリック 高度な設定画面に切り替わる。 スキームの設定 """""""""""""""""" フルインストールせずに必要最小限の ``basicスキーム`` でインストールする。 .. figure:: No1-2.png :width: 600 スキームの :guilabel:`変更`： をクリック .. figure:: No1-3.png :width: 250 スキーム選択画面が開き、 ``basicスキーム`` を選択して、 :guilabel:`OK` 高度な設定画面に戻る。 追加コレクションのカスタマイズ """"""""""""""""""""""""""""""""" 必要な追加コレクションを設定する。 .. figure:: No1-2.png :width: 600 追加コレクションの数の :guilabel:`カスタマイズ` をクリック 画面が追加コレクションの選択画面に切り替わり以下の各項目のチェックを入れる :guilabel:`OK` をクリックすると高度な設定画面に戻る。 :言語タブ: - ``日本語`` - ``英語・米語`` :ほかのコレクションタブ: - ``Latex基本パッケージ`` - ``Latex推奨パッケージ`` - ``Tex外部プログラム`` - ``出版スタイルや学位論文`` - ``Windows専用プログラム`` - ``必要プログラムとファイル`` - ``推奨フォント`` - ``数学、自然科学、計算科学パッケージ`` - ``画像およびフォントのユーティリティ`` - ``画像と図表`` .. figure:: No1-4.png :width: 500 デフォルトのコレクション .. figure:: No1-5.png :width: 500 各項目にチェックをいれて :guilabel:`OK` 追加コレクションの数が ``12個`` になっているはず。 インストールの実行 """"""""""""""""""""" インストールを開始する。 .. figure:: No1-6.png :width: 600 他のコレクションの数を確認し :guilabel:`インストール` インストールには約40分かかる。 .. figure:: No1-7.png :width: 500 インストールの最中。パソコンの電源は落とさずに待つ .. figure:: No1-8.png :width: 500 インストールが完了したら :guilabel:`閉じる` をクリック さらなる追加パッケージのインストール ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 上の追加パッケージのインストールでも抜けているものがあるので手動でインストールする。 デスクトップに戻り、スタート画面を確認する。 :program:`Tex Live 2024` がインストールされている。:program:`TLShell TeX Live Manager` を起動する。 .. figure:: No1-9.png :width: 350 :program:`TLShell Texlive Manager` をクリック 新規で開くため、depositoryのロードに時間がかかる場合がある。 .. figure:: No1-10.png :width: 350 読み込みが完了したら :guilabel:`閉じる` をクリック :パッケージリスト: から以下のものをインストールする。 :状態: :guilabel:`すべて` :詳細: :guilabel:`すべて` :検索: :guilabel:`名称でソート` の状態で検索するとよい。 検索のフレームにインストールしたいパッケージ名を入力したら下に検索結果 が出て、インストールするパッケージにチェックをしてインストールする。 - funcychap - wrapfig - capt-of - framed - upquote - needspace - tabulary - varwidth - titlesec - simplekv - latexmk - latexmk.windows .. note:: もともとインストールされているものもある。 .. figure:: No1-11.png :width: 600 インストールしたいパッケージにチェックをいれて :guilabel:`選択項目をインストール` をクリック インストールが終わったら :guilabel:`終了` をクリックし、インストール完了。 :program:`Visual Studio Code` のインストール ------------------------------------------ :program:`Visual Studio Code` とはMicrosoftが提供するコードエディター :program:`sphinx` の :file:`rst` ファイルを編集するのに使用する。 インストール ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ https://code.visualstudio.com/download からwindows版のインストーラーをダウンロードする。 .. figure:: No3-1.png :width: 600 ダウンロードページが開いたらWindows版をダウンロード インストーラーを実行するとセットアップ画面に移動する。 .. figure:: No3-2.png :width: 300 ``同意する`` にチェックを入れ :guilabel:`次へ` をクリック 画面が切り替わったら以下の項目にチェックを入れる。 - ``デスクトップ上にアイコンを作成する`` - ``サポートされているファイルの種類をエディターとして、Codeを登録する`` - ``PATHへの追加（再起動後に使用可能）`` .. figure:: No3-3.png :width: 300 項目にチェックを入れる インストールが開始される。インストール完了後、デスクトップに表示されたアイコンをクリックすると :program:`Visual Studio Code` が開ける。 .. figure:: No3-4.png :width: 600 :program:`Visual Studio Code` のインストール直後の起動画面 :program:`Visual Studio Code` の環境設定 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :program:`Visual Studio Code` は様々な拡張機能がフリーで手に入れることができる。 ここでは、 :program:`python` や :program:`sphinx` に特化した拡張機能を入れる。 画面左のテトリスのようなアイコンをクリックする。 .. figure:: No3-5.png :width: 600 必要な拡張機能をインストールできる 以下の項目を検索しインストールする。 - ``Japanese Language Pack for Visual Studio Code`` - ``Pylance`` - ``Python`` - ``reStructuredText Syntax highlighting`` - ``Python Debugger`` .. figure:: No3-6.png :width: 600 各項目を検索し、インストール :program:`anaconda` のインストール ----------------------------------- インストールの前準備 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ アカウント名を半角英数字にする """"""""""""""""""""""""""""""" :program:`anaconda` のインストールの際、アカウント名が全角だとエラーが表示される。 そのため新規でアカウントを作成するか、アカウント名を変更する必要がある。 変更方法を以下に記載する。 .. figure:: No2-3.png :width: 300 スタート画面からアイコンを選択 .. figure:: No2-4.png :width: 300 :menuselection:`アカウント設定の変更` を選択 画面が切り替わる。 :menuselection:`関連設定 --> 自分のアカウントを管理` をクリック .. figure:: No2-5.png :width: 600 :guilabel:`自分のアカウントを管理` をクリック webページに切り替わる。 .. figure:: No2-6.png :width: 600 Microsoftアカウントのwebページが開く :menuselection:`あなたの情報 --> 名前を編集する` .. figure:: No2-7.png :width: 600 :guilabel:`名前を編集する` をクリック 画面が切り替わる。 .. figure:: No2-8.png :width: 300 自分の名前を **半角英数字** で入力し、 :guilabel:`保存` をクリック 自分の名前が変更される。 .. figure:: No2-9.png :width: 600 名前が半角になっていることを確認 一度画面を閉じ、再起動をかける。 .. figure:: No2-10.png :width: 300 スタート画面から **再起動** 再起動をかけると、画面右下のアカウント名が半角になる。 .. figure:: No2-11.png :width: 300 名前が半角になっていることを確認 インストール ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ インストールは python japanのwebページ **python環境構築ガイド** を参考にする。 インストーラーのダウンロード """""""""""""""""""""""""""""""" 以下の :program:`anaconda` のwindows版のインストーラーをダウンロードする :download:`Anaconda3-2024.02-1-Windows-x86_64.exe ` .. note:: 最新版がある場合は最新版の方が良い。 ダウンロードが完了したら、windows版のanacondaのインストーラーを実行する。 .. figure:: No2-21.png :width: 200 ダウンロードが完了したら :guilabel:`ファイルを開く` をクリック インストーラーの実行 """"""""""""""""""""""""""""""""" 最初に、 :program:`anaconda` のインストールのセットアップ画面が表示される。 .. figure:: No2-22.png :width: 300 :guilabel:`Next` をクリック .. figure:: No2-23.png :width: 300 ライセンスの確認。 :guilabel:`I Agree` をクリック .. figure:: No2-24.png :width: 300 使用者の範囲。ここでは ``Just me`` を選択し :guilabel:`Next` をクリック .. figure:: No2-25.png :width: 300 インストール先のdirectory。 ``Destination Folder`` を確認し :guilabel:`Next` をクリック インストール先のdirectoryは :file:`C:\Users\{アカウント名}\anaconda3` というように 自分のアカウント先が参照されているはずである。インストール先を変えたければここで変える :program:`anaconda` の設定。以下の項目にチェックを入れる。 - ``Create start menu shortcuts(supported packages only).`` - ``Register Anaconda3 as my default Python 3.11`` .. note:: 1番目のチェックを忘れると、インストール完了後スタートメニューにanacondaが表示されない。 .. figure:: No2-26.png :width: 300 項目にチェックを入れ :guilabel:`Install` をクリック インストールが開始される。 ``Completed`` と表示されたら完了。 .. figure:: No2-27.png :width: 300 .. figure:: No2-28.png :width: 300 ``Completed`` と表示されたら→ :guilabel:`Next` をクリック .. figure:: No2-29.png :width: 300 :guilabel:`Next` をクリック .. figure:: No2-30.png :width: 300 :guilabel:`Finish` をクリック Webページが開く。このページは閉じてもかまわない。 .. figure:: No2-31.png :width: 600 Webページを閉じる ホーム画面から、スタート画面を開くとメニューに　:program:`Anaconda3` が表示されインストールされているのがわかる。 .. figure:: No2-32.png :width: 300 :program:`Anaconda3(64-bit)` がインストールされている :program:`conda` の初期化 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :program:`anaconda` がterminalで使用できるように :program:`conda` の初期化を行う。 スタート画面から :menuselection:`Anaconda3 --> Anaconda Prompt` でterminal開く .. figure:: No2-33.png :width: 300 ファイルから :menuselection:`Anaconda Prompt` をクリック ターミナルが開く。 .. code-block:: Powershell conda init を入力して :kbd:`Enter` .. figure:: No2-35.png :width: 600 :program:`conda` の初期化が終了する ``(base)～`` が再び出てきたら、初期化完了。 .. hint:: :program:`Spyder` （python programming 用）の最初の起動 :program:`sphinx` とは関係ないが、python programming開発用のIDE、 :program:`spyder` の使い方を示す。 スタート画面に戻り、 :menuselection:`Anaconda3 --> Spyder` を選択。 .. figure:: No2-36.png :width: 300 :menuselection:`Anaconda3` から **Spyder** をクリック .. figure:: No2-37.png :width: 300 :program:`Spyder` が起動する。 バージョンアップや使い方ツアーを進められるが拒否して :guilabel:`OK` 。 .. figure:: No2-38.png :width: 300 :guilabel:`OK` をクリック .. figure:: No2-39.png :width: 300 :guilabel:`Dismiss` をクリック .. figure:: No2-40.png :width: 600 :program:`Spyder` の初期画面 :program:`Sphinx` のインストール --------------------------------------- :program:`anaconda` 上に :program:`sphinx` をインストールする。 Windowsのスタート画面から **Anaconda Powershell Prompt** を開く。 .. figure:: No4-1.png :width: 300 **Anaconda Powershell Prompt** をクリック :program:`anaconda` 上にプログラムをインストールする際には必ず :program:`anaconda` を最新の状態にしておかなくてはならない。 Powershellで以下のコードを入力する。 .. code-block:: Powershell conda update -n base conda conda update --all 次に、Powershellで .. code-block:: Powershell conda install sphinx を入力して :program:`sphinx` をインストールする。 Windowsのスタート画面のメニューには :program:`sphinx` は表示されない。 :program:`Graphviz` のインストール --------------------------------- :program:`Graphviz` は人や物のネットワーク、フローチャート、系統樹などに適したグラフ描画ツールです。 直接、windows上にインストールすることもできますが、ここでは :program:`anaconda` 上にプログラムをインストールする やり方を紹介します。 インストール ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ スタート画面から :menuselection:`Anaconda3 -->　Anaconda Powershell Prompt` を開く。 .. figure:: No5-1.png :width: 300 :menuselection:`Anaconda Powershell Prompt` を選択 Powershellでインストールのために以下のコードを入力する。 .. code-block:: Powershell conda install python-graphviz .. figure:: No5-2.png :width: 600 ``conda install python-graphviz`` を入力して :kbd:`Enter` ``proceed ([y]/n)?`` ときかれるので、 ``y`` と入力して :kbd:`Enter` .. figure:: No5-3.png :width: 600 .. figure:: No5-4.png :width: 400 この文字が表示されたらインストール完了