docs: Migrate to mdBook and pdoc

Author: yukinarit

.github/workflows/build.yml

@@ -28,6 +28,9 @@ jobs:
        run: |
          pip install poetry
          poetry install
+         curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain stable
+         source $HOME/.cargo/env
+         cargo install mdbook
      - name: Get PR number
        uses: jwalton/gh-find-current-pr@v1
        id: findPr
@@ -50,6 +53,6 @@ jobs:
        with:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          BRANCH: gh-pages
-         FOLDER: docs
+         FOLDER: out
          COMMIT_MESSAGE: ${{ env.COMMIT_MESSAGE }}
          CLEAN: true

.gitignore

@@ -15,3 +15,5 @@ pip-wheel-metadata
 .DS_Store
 venv/
 .idea/
+out/
+docs/CHANGELOG.md

Makefile

@@ -37,12 +37,13 @@ fmt:
 	$(POETRY) run pre-commit run -a
 
 docs:
-	mkdir -p docs
-	$(POETRY) run pdoc serde --html -o html --force --template-dir docs/template
-	cp -f html/serde/* docs/
+	mkdir -p docs out/api out/guide
+	cp -f CHANGELOG.md docs/
+	$(POETRY) run pdoc -e serde=https://github.com/yukinarit/pyserde/tree/master/serde/ serde -o out/api
+	mdbook build -d out/guide
 
 open-docs:
-	$(POETRY) run pdoc serde --html -o html --force --template-dir docs/template --http 127.0.0.1:5001
+	$(POETRY) run pdoc -e serde=https://github.com/yukinarit/pyserde/tree/master/serde serde
 
 bench:
 	pushd bench && $(POETRY) run $(PYTHON) bench.py && popd