首页 > TAG信息列表 > MkDocs
（四）MkDocs学习——自定义主题
如果您想对现有主题进行一些调整，则无需从头开始创建自己的主题。对于只需要一些CSS和（或）JavaScript的小调整，您可以使用docs_dir。但是，对于更复杂的自定义（包括覆盖模板），您需要使用主题的custom_dir设置。 使用docs_dir extra_css和extra_javascript配置选项可用于对现有主题进行（五）MkDocs学习——配置文件
简介 始终使用名为mkdocs.yml的位于项目目录中的YAML文件来进行设置。（当然也可以将mkdocs.yml放置其他目录，需要在build时做命令调整，使用-f/--config-file 选项） 此配置文件必须包含site_name与site_url设置。 所有其他设置都是可选项。 项目信息 site_name 这是一个必需的设【Python】mkdocs 生成帮助文档
1. 简介 MkDocs 是一个用于创建项目文档的 快速, 简单 , 完美华丽 的静态站点生成器. 文档源码使用 Markdown 来撰写, 用一个 YAML 文件作为配置文档. 官网文档：https://markdown-docs-zh.readthedocs.io/zh_CN/latest/ 官方网站：https://www.mkdocs.org/ 2. 需求 可以用Ubuntu云服务器配置
建议使用docker安装服务，防止软件安装失败导致系统重新安装。 Ubuntu 云服务器配置 一、安装 Apache 网站服务器 apt 系统安装 1.安装 Apache sudo apt update sudo apt install apache2 2.验证 Apache 是否正在运行 sudo systemctl status apache2 docker 安装 1.查找 Docker HuShowDoc 本地部署
ShowDoc 本地部署 参考：官方文档 基本步骤 1. 自动安装 需要首先安装好Docker wget https://www.showdoc.com.cn/script/showdoc chmod +x showdoc ./showdoc 2. 常用命令 #停止 ./showdoc stop #重启 ./showdoc restart #升级showdoc到最新版 ./showdoc update #卸载shmkdocs 文档系统
mkdocs是一个基于python的静态网页构建框架，非常简单和易于管理，几乎不需要任何python和web开发基础，只需要markdown的编写就可以。 安装 pip install mkdocs 创建第一个项目 # project是你的项目名字 mkdocs new project code project 本地打开serve mkdocs serve 打开localhost