vbezhenar · sio · Sep 12, 2023 · Sep 12, 2023
diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
@@ -0,0 +1,35 @@
+name: pages
+
+on:
+  push:
+    branch: main
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  render:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - uses: actions/cache@v3
+        with:
+          path: |
+            cache/pip
+          key: cache-pip-${{ runner.os }}-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            cache-pip-${{ runner.os }}
+      - run: make build
+        env:
+          PIP_CACHE_DIR: cache/pip
+      - uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: site
+          publish_branch: site
+          commit_message: |-
+            render: ${{ github.event.head_commit.message }}
+
+            Render static website for GitHub pages from
+            commit
diff --git a/.gitignore b/.gitignore
@@ -1,3 +1,8 @@
 *.bin
 *.elf
 *.o
+
+site
+pages/README.md
+Makefile.venv
+.venv
diff --git a/Makefile b/Makefile
@@ -0,0 +1,17 @@
+.PHONY: serve build
+serve build: | venv
+	$(VENV)/mkdocs $@
+
+.INTERMEDIATE: pages/README.md
+serve build: pages/README.md
+pages/README.md: README.md
+	cp $< $@
+
+include Makefile.venv
+Makefile.venv:
+	curl \
+		-o Makefile.fetched \
+		-L "https://github.com/sio/Makefile.venv/raw/v2023.04.17/Makefile.venv"
+	echo "fb48375ed1fd19e41e0cdcf51a4a0c6d1010dfe03b672ffc4c26a91878544f82 *Makefile.fetched" \
+		| sha256sum --check - \
+		&& mv Makefile.fetched Makefile.venv
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -0,0 +1,20 @@
+site_name: Осваиваем STM32 снизу
+repo_name: vbezhenar/stm32-tutorial
+repo_url: https://github.com/vbezhenar/stm32-tutorial
+
+docs_dir: pages
+
+nav:
+  - 1-explore/README.md
+  - 2-loop/README.md
+  - 3-blink/README.md
+  - 4-loopc/README.md
+  - 5-blinkc/README.md
+  - 6-blinkt/README.md
+
+theme:
+  name: material
+  language: ru
+  palette:
+    primary: green
+    accent: green
diff --git a/1-explore/README.md → pages/1-explore/README.md b/1-explore/README.md → pages/1-explore/README.md
diff --git a/2-loop/Makefile → pages/2-loop/Makefile b/2-loop/Makefile → pages/2-loop/Makefile
diff --git a/2-loop/README.md → pages/2-loop/README.md b/2-loop/README.md → pages/2-loop/README.md
diff --git a/2-loop/loop.ld → pages/2-loop/loop.ld b/2-loop/loop.ld → pages/2-loop/loop.ld
diff --git a/2-loop/loop.s → pages/2-loop/loop.s b/2-loop/loop.s → pages/2-loop/loop.s
diff --git a/3-blink/Makefile → pages/3-blink/Makefile b/3-blink/Makefile → pages/3-blink/Makefile
diff --git a/3-blink/README.md → pages/3-blink/README.md b/3-blink/README.md → pages/3-blink/README.md
diff --git a/3-blink/blink.s → pages/3-blink/blink.s b/3-blink/blink.s → pages/3-blink/blink.s
diff --git a/3-blink/linker.ld → pages/3-blink/linker.ld b/3-blink/linker.ld → pages/3-blink/linker.ld
diff --git a/4-loopc/Makefile → pages/4-loopc/Makefile b/4-loopc/Makefile → pages/4-loopc/Makefile
diff --git a/4-loopc/README.md → pages/4-loopc/README.md b/4-loopc/README.md → pages/4-loopc/README.md
diff --git a/4-loopc/linker.ld → pages/4-loopc/linker.ld b/4-loopc/linker.ld → pages/4-loopc/linker.ld
diff --git a/4-loopc/loopc.c → pages/4-loopc/loopc.c b/4-loopc/loopc.c → pages/4-loopc/loopc.c
diff --git a/4-loopc/reset_exception_handler.s → pages/4-loopc/reset_exception_handler.s b/4-loopc/reset_exception_handler.s → pages/4-loopc/reset_exception_handler.s
diff --git a/5-blinkc/Makefile → pages/5-blinkc/Makefile b/5-blinkc/Makefile → pages/5-blinkc/Makefile
diff --git a/5-blinkc/README.md → pages/5-blinkc/README.md b/5-blinkc/README.md → pages/5-blinkc/README.md
diff --git a/5-blinkc/blinkc.c → pages/5-blinkc/blinkc.c b/5-blinkc/blinkc.c → pages/5-blinkc/blinkc.c
diff --git a/5-blinkc/linker.ld → pages/5-blinkc/linker.ld b/5-blinkc/linker.ld → pages/5-blinkc/linker.ld
diff --git a/5-blinkc/reset_exception_handler.s → pages/5-blinkc/reset_exception_handler.s b/5-blinkc/reset_exception_handler.s → pages/5-blinkc/reset_exception_handler.s
diff --git a/6-blinkt/Makefile → pages/6-blinkt/Makefile b/6-blinkt/Makefile → pages/6-blinkt/Makefile
diff --git a/6-blinkt/README.md → pages/6-blinkt/README.md b/6-blinkt/README.md → pages/6-blinkt/README.md
diff --git a/6-blinkt/blinkt.c → pages/6-blinkt/blinkt.c b/6-blinkt/blinkt.c → pages/6-blinkt/blinkt.c
diff --git a/6-blinkt/linker.ld → pages/6-blinkt/linker.ld b/6-blinkt/linker.ld → pages/6-blinkt/linker.ld
diff --git a/6-blinkt/reset_exception_handler.s → pages/6-blinkt/reset_exception_handler.s b/6-blinkt/reset_exception_handler.s → pages/6-blinkt/reset_exception_handler.s
diff --git a/requirements.txt b/requirements.txt
@@ -0,0 +1,35 @@
+# Direct dependencies
+mkdocs==1.5.2
+mkdocs-material==9.2.7
+mkdocs-material-extensions==1.1.1
+
+# Indirect dependencies
+Babel==2.12.1
+certifi==2023.7.22
+charset-normalizer==3.2.0
+click==8.1.7
+colorama==0.4.6
+ghp-import==2.1.0
+idna==3.4
+importlib-metadata==6.7.0
+Jinja2==3.1.2
+Markdown==3.4.4
+MarkupSafe==2.1.3
+mergedeep==1.3.4
+packaging==23.1
+paginate==0.5.6
+pathspec==0.11.2
+platformdirs==3.10.0
+Pygments==2.16.1
+pymdown-extensions==10.2.1
+python-dateutil==2.8.2
+pytz==2023.3.post1
+PyYAML==6.0.1
+pyyaml_env_tag==0.1
+regex==2022.10.31
+requests==2.31.0
+six==1.16.0
+typing_extensions==4.7.1
+urllib3==2.0.4
+watchdog==3.0.0
+zipp==3.15.0