Jupyter Book

背景

case: https://allendowney.github.io/ModSimPy/index.html

source: https://jupyterbook.org/en/stable/intro.html

Pros: jupyter compatible、速度很快、穩定、google-found、全文檢索、左右章節瀏覽、上下翻頁、click to show(這個給學生學習不錯)

Cons: 沒有瀏覽次數、沒有時間標籤、字形及顏色、底色都很平凡、(不知是否支援中文)、似乎適合固定內容的文件(書)

Publish your book online

How do I publish my Jupyter book to GitHub?

Publish your book online with GitHub Pages

1. Install ghp-import. pip install ghp-import.
2. Update the settings for your GitHub pages site: a. …
3. From the main branch of your book’s root directory (which should contain the _build/html folder) call ghp-import and point it to your HTML files, like so:

How to create an on-line Jupyter Book from scratch

Publish your book online - Jupyter Book