- 現在の時点(2021/12/02)では、Jupyter Book は Windows 上ではPython 3.8 に対応しておらず、Python 3.7 である必要がある。
- Anaconda promptを起動して、condaが生成したウィンドウの中で以下の作業を行う。
- conda で新しい python 仮想環境を作成する。 ここではpython仮想環境の名前は jb とする。 python 3.7 を使うこと。
(base) C:\Users\nitta> conda create -n jb python=3.7
- 作成した python 仮想環境に切り替える。
(base) C:\Users\nitta> conda activate jb
- pipを使ってJupyter Book をインストールする。
(jb) C:\Users\nitta> pip install -U jupyter-book
- Jupyter Book command-line interface を使う
(jb) C:\Users\nitta> jupyter-book --help
Usage: jupyter-book [OPTIONS] COMMAND [ARGS]...
Build and manage books with Jupyter.
Options:
--version Show the version and exit.
-h, --help Show this message and exit.
Commands:
build Convert your book's or page's content to HTML or a PDF.
clean Empty the _build directory except jupyter_cache.
config Inspect your _config.yml file.
create Create a Jupyter Book template that you can customize.
myst Manipulate MyST markdown files.
toc Command-line for sphinx-external-toc.
- Jupyter Book は、フォルダやファイルを正しく配置することで作成する。
mybookname/
+--- _config.yml configuration file
+--- _toc.yml table of contents
+--- landing-page.md
+--- page1.ipynb