From 82da772c48f1bf7fda080c6edb87d8c2ea9e8886 Mon Sep 17 00:00:00 2001 From: Yudong Jin Date: Tue, 10 Nov 2026 14:41:25 +0800 Subject: [PATCH] Retire the Docker MkDocs preview and dead MkDocs-only config (#2027) * Name the current generator in the hero paint-seam header The workspace generator moved from utils.hero.fit_paint_seams to utils.site.homepage.art.fit_paint_seams; the seam metadata is unchanged. Co-Authored-By: Claude Opus 5.5 * Sync the homepages to the new installer version The workspace homepage installer now imports its roots from utils.core.paths; its own bytes feed the homepage version, so the six homepages point at assets/home/bf55006c61fda74c. Content is unchanged. Co-Authored-By: Claude Opus 5.5 * Retire the Docker MkDocs preview and dead MkDocs-only config The site is built only with Zensical. The root Dockerfile and compose file built a MkDocs Material + glightbox preview that nothing else used, so remove them and the "Docker deployment" section of the contribution guide in all six languages. In mkdocs.yml, drop the keys the Zensical build never reads: glightbox (filtered out by the builder), theme.features, extra_css and extra_javascript (replaced by overrides/zensical/zensical.toml), and docs_dir, site_dir and theme.custom_dir (set by the builder). The effective Zensical config is byte-identical for every language. codes/Dockerfile (the code runtime environment) is unrelated and kept. Co-Authored-By: Claude Opus 5.5 * Remove the unused KaTeX script and the shadowed extra.css overrides/javascripts/katex.js is referenced by no page or config (MathJax renders formulas) and was only published as a dead file. overrides/stylesheets/extra.css is always replaced by overrides/zensical/stylesheets/extra.css during the build. Co-Authored-By: Claude Opus 5.5 --------- Co-authored-by: Claude Opus 5.5 --- Dockerfile | 42 -- docker-compose.yml | 8 - docs/chapter_appendix/contribution.md | 14 - docs/index.html | 142 ++-- en/docs/chapter_appendix/contribution.md | 14 - en/docs/index.html | 138 ++-- en/mkdocs.yml | 49 -- ja/docs/chapter_appendix/contribution.md | 14 - ja/docs/index.html | 138 ++-- ja/mkdocs.yml | 49 -- ko/docs/chapter_appendix/contribution.md | 14 - ko/docs/index.html | 138 ++-- ko/mkdocs.yml | 3 - mkdocs.yml | 49 -- overrides/javascripts/hero-paint-seams.js | 2 +- overrides/javascripts/katex.js | 10 - overrides/stylesheets/extra.css | 689 ------------------ ru/docs/chapter_appendix/contribution.md | 14 - ru/docs/index.html | 146 ++-- ru/mkdocs.yml | 3 - zh-hant/docs/chapter_appendix/contribution.md | 14 - zh-hant/docs/index.html | 150 ++-- zh-hant/mkdocs.yml | 3 - 23 files changed, 427 insertions(+), 1416 deletions(-) delete mode 100644 Dockerfile delete mode 100644 docker-compose.yml delete mode 100644 overrides/javascripts/katex.js delete mode 100644 overrides/stylesheets/extra.css diff --git a/Dockerfile b/Dockerfile deleted file mode 100644 index a0f1bc1a6..000000000 --- a/Dockerfile +++ /dev/null @@ -1,42 +0,0 @@ -FROM python:3.10.0-alpine - -# Official PyPI is preferred when reachable. -ENV PIP_INDEX_URL=https://pypi.org/simple - -# Use the mirror when official PyPI is unreachable. -# ENV PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple - -RUN pip install --upgrade pip -RUN pip install mkdocs-material==9.5.5 mkdocs-glightbox - -WORKDIR /hello-algo - -COPY overrides ./build/overrides - -COPY docs ./build/docs -COPY mkdocs.yml mkdocs.yml -RUN mkdocs build -f mkdocs.yml - -COPY zh-hant/docs ./build/zh-hant/docs -COPY zh-hant/mkdocs.yml ./zh-hant/mkdocs.yml -RUN mkdocs build -f ./zh-hant/mkdocs.yml - -COPY en/docs ./build/en/docs -COPY en/mkdocs.yml ./en/mkdocs.yml -RUN mkdocs build -f ./en/mkdocs.yml - -COPY ja/docs ./build/ja/docs -COPY ja/mkdocs.yml ./ja/mkdocs.yml -RUN mkdocs build -f ./ja/mkdocs.yml - -COPY ru/docs ./build/ru/docs -COPY ru/mkdocs.yml ./ru/mkdocs.yml -RUN mkdocs build -f ./ru/mkdocs.yml - -COPY ko/docs ./build/ko/docs -COPY ko/mkdocs.yml ./ko/mkdocs.yml -RUN mkdocs build -f ./ko/mkdocs.yml - -WORKDIR /hello-algo/site -EXPOSE 8000 -CMD ["python", "-m", "http.server", "8000"] diff --git a/docker-compose.yml b/docker-compose.yml deleted file mode 100644 index d0c43a9f5..000000000 --- a/docker-compose.yml +++ /dev/null @@ -1,8 +0,0 @@ -version: '3' -services: - hello-algo: - build: . - image: hello-algo - container_name: hello-algo - ports: - - "8000:8000" diff --git a/docs/chapter_appendix/contribution.md b/docs/chapter_appendix/contribution.md index ad5a56545..18b0a3411 100644 --- a/docs/chapter_appendix/contribution.md +++ b/docs/chapter_appendix/contribution.md @@ -31,17 +31,3 @@ 3. 在本地进行内容创作,并进行完整测试,验证代码的正确性。 4. 将本地所做更改 Commit ,然后 Push 至远程仓库。 5. 刷新仓库网页,点击“Create pull request”按钮即可发起拉取请求。 - -### Docker 部署 - -在 `hello-algo` 根目录下,执行以下 Docker 脚本,即可在 `http://localhost:8000` 访问本项目: - -```shell -docker-compose up -d -``` - -使用以下命令即可删除部署: - -```shell -docker-compose down -``` diff --git a/docs/index.html b/docs/index.html index 7028510fa..268fe6314 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,5 +1,5 @@ - +