项目文档一直找不到合适的工具，今天看到MkDocs能生成静态文件，也能中文搜索，很不错，就决定用它了。

因为 MkDocs 需要用 pip 进行安装，我太懒了，不想装，就直接使用 docker 了

下载镜像

docker pull squidfunk/mkdocs-material

众所周知的原因，如果你不能直接下载镜像，就到 GitHub fork 这个项目，它会告诉你如何下载。

tech-shrimp/docker_image_pusher

创建站点

sudo docker run --rm -it -v /data/mkdocs/docs:/docs squidfunk/mkdocs-material new .

生成站点

sudo docker run --rm -it -v /data/mkdocs/docs:/docs squidfunk/mkdocs-material build --site-dir public 

部署到 Nginx

静态文件都有了，可以自行部署

本文链接：https://letgo.cc/post/mkdocs.html，参与评论 »

--EOF--

发表于 2024-10-22 11:33:00，最后修改于 2024-10-28 11:50:46。

本站使用「署名 4.0 国际」创作共享协议，转载请注明作者及原网址。更多说明 »