昨日紹介したGitHubにあるオンラインで読める化学や生命科学の学生のための数学の教科書”Applying Maths in the Chemical & Biomolecular Sciences an example-based approach”についての補足です。
https://applying-maths-book.com/intro.html
この本をオンライン(上のリンクからよめます）ではなく、インターネット接続なしで(ローカルで）自分のパソコン上で読めるようにしてみましょう。昨日紹介したGitHubのページにやり方が英語で書いてあるので、そのとおりやってみました(サイトの英語の説明を参考のため記事の末尾にペーストしてありますのでご覧ください）。
私はLinuxのUbuntuが動くパソコンをもっているので、そのPCで著者のgithubの repositoryをクローンして、本をbuildしてhtml版の教科書を時分のPC内に作成することができました。
やり方は以下のとおりです（以下の日本語の説明がわからなかったら、末尾にペーストした著者の説明も参考にしてください。）
１) サイトに指示のあるとおり、著者のrepositoryを自分のPCにクローンします。
Ubuntuのコマンドプロンプト画面で
git clone https://github.com/subblue/applying-maths-book
と入力して実行すると、カレントディレクトリに著者のサイトが丸ごとクローンされます。
２） コマンドプロンプトでcd applying-maths-book/
とうって、applying-maths-bookディレクトリに移動します。
３）そして、pip install -r requirements.txt
というコマンドで、必要なライブラリなどをインストールします。
virtual environmentでやるのがお勧めと書いてありますが、virtual environmentでなくてもよいです。
４）次に、オプションで、本の内容を編集することもできます。applying_maths_book/ のディレクトリにある本のソースファイルを編集するわけです。やらない場合は何もせずに次のステップ ５）にすすみます。
５）コマンドラインで次のコマンドをいれて、既に存在しているビルドを消去します。jupyter-book clean applying_maths_book/
なにも既存のビルドがなければ、何もない旨のメッセージがでます。なにかビルドがあればそれを消去しましたと言うメッセージがでます。
６）次にいよいよ、jupyter-book build applying_maths_book/というコマンドでhtml版の本を作成します。しばらく時間がかかりますが、気長にまっているとhtml版の本ができあがります。
以上の操作で出来上がったhtml版の教科書は、applying-maths-book/applying_maths_book/_buildというディレクトリの中にできています。_buildのディレクトリ内には、3つのフォルダができています。htmlというフォルダ、jupyter_executeというフォルダ、そして、doctreesというフォルダです。htmlというフォルダ内にhtml版の本の中身が集まっています。このフォルダ内にあるindex.htmlというファイル（あるいは、intro.htmlでもOKです）をクリックしてブラウザで開くと、オフラインでこの教科書が読めます。
各章には問題がのっていますが、その答えは各章末に書かれていますので、独習する人に大変親切です。また開いたページの右上にロケットマークがあるページの場合は、ロケットマークのクリックで、そのページにあるpythonプログラムを実行して結果を表示させることができます。htmlのロケットマークをクリックした場合は、クラウドサービスであるBinderまたはGoogle Colabでpytthonプログラムを実行するようになっています。
今日は、Ubuntuで本を作りましたが、WindowsやMac上でUbuntuを動かして、同様にhtml版の本をつくることができると思います。できたフォルダは、コピーして別のパソコンに移動することもできますので、Linuxでつくったhtml版の教科書を、WindowsやMacで読むことももちろん簡単にできます。是非お試しください。
Building the book
If you’d like to develop and/or build the Applying Maths Book book, you should:
- Clone this repository
- Run
pip install -r requirements.txt (it is recommended you do this within a virtual environment)
- (Optional) Edit the books source files located in the
applying_maths_book/ directory
- Run
jupyter-book clean applying_maths_book/ to remove any existing builds
- Run
jupyter-book build applying_maths_book/
A fully-rendered HTML version of the book will be built in applying_maths_book/_build/html/.
