MkDocs静态文档网站


MkDocs静态文档网站

https://www.mkdoc.org/

MkDocs是一个快速、简单的静态网站生成器,专门用于构建项目文档。它可以生成独立站点,或者仅用于生成较大站点的文档部分。MkDocs基于Python编写,所有配置都用一个简单的配置文件管理,配置项的内容也仅有一页文档。它见名知意就是为Markdown而生,根据Markdown格式将内容渲染成美观的文档,并通过目录层级关系对应文档的树状结构,使得所有文档组织分明且层次递进。

图片

一,搜索并拉取镜像文件

大概100多M

docker search mkdocs docker pull squidfunk/mkdocs-material

二,生成项目目录

docker run -it --rm -v /mnt/hgfs/SharedSpaces/mkdocs:/docs squidfunk/mkdocs-material new cc-docs

三,运行测试容器

docker run -it  --name mkdocs --restart=always -v /mnt/hgfs/SharedSpaces/mkdocs:/docs -p 58000:8000  --workdir /docs/cc-docs squidfunk/mkdocs-material serve -a 0.0.0.0:8000

访问地址 :http://虚拟机的ip:58000

四,运行容器

docker run -itd  --name mkdocs --restart=always -v /mnt/hgfs/SharedSpaces/mkdocs:/docs -p 58000:8000  --workdir /docs/cc-docs squidfunk/mkdocs-material serve -a 0.0.0.0:8000

五,删除运行中容器

docker rm -f mkdocs