thinkcube/mkdocs

thinkcube/mkdocs镜像说明

镜像概述

本镜像基于CentOS 7环境构建，集成Mkdocs工具，帮助用户快速搭建静态文档站点，无需本地配置依赖，降低文档部署门槛。

核心功能

• 创建新的Mkdocs文档项目
• 提供实时预览服务，查看文档效果
• 支持现有项目的快速部署

使用场景

• 个人/团队技术文档编写与展示
• 开源项目官方文档站点搭建
• 内部知识库共享与管理

配置说明

1. 挂载本地项目目录到容器内/home/user路径
2. 映射主机端口至容器80端口（预览服务端口）
3. 使用user用户权限运行以保证文件读写安全

部署示例

创建新项目

bash
# 进入有权限的目录（如用户主目录）
cd ~
# 生成新Mkdocs项目
docker run -v ~:/home/user -u user docker.xuanyuan.run/thinkcube/mkdocs mkdocs new my_test_project
# 进入项目目录
cd my_test_project
# 启动后台预览服务
docker run -d -v ~/my_test_project:/home/user -p 8092:80 docker.xuanyuan.run/thinkcube/mkdocs
# 访问地址：http://127.0.0.1:8092

部署现有项目

bash
# 启动后台预览服务
docker run -d -v ~/my_existing_project:/home/user -p 8092:80 docker.xuanyuan.run/thinkcube/mkdocs
# 访问地址：[***]