theanurin/mkdocs Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

![Docker Image Version]([] ![Docker Image Size]([] ![Docker Pulls]([] ![Docker Stars]([]

MkDocs

MkDocs是一款快速、简单且极其美观的静态站点生成器，专为构建项目文档而设计。文档源文件使用Markdown编写，并通过单一YAML配置文件进行配置。

镜像用途

此镜像嵌入了固定版本的MkDocs，以防止MkDocs及其依赖项发生破坏性变更。我们团队曾多次遇到因MkDocs依赖项出现破坏性变更而导致的问题。

规格说明

环境变量

• PYTHONPATH - 设置额外Python包的路径。默认值为/data/site-packages。（您可以随站点源文件一起开发自己的扩展）

暴露端口

• tcp/8000 - MkDocs开发服务器的监听端点

卷

• /data - 源文件根目录（在此处绑定/挂载您的工作目录）

内部包含

• mkdocs==1.6.1
• mkdocs-material==9.6.19
• mkdocs-markdownextradata-plugin==0.2.6
• mkdocs-pdf-export-plugin==0.5.10
• fontawesome-in-markdown==0.2.1

启动方法

1. 在文档根目录（mkdocs.yml所在目录）启动开发服务器：

   bash
   docker run --interactive --tty --rm --volume ${PWD}:/data --publish 8000:8000 theanurin/mkdocs
   

2. 打开浏览器访问 [***]
3. 编辑内容并在浏览器中查看热重载的更改

支持信息

• 维护者：Max Anurin
• 帮助渠道：***