README.md

使用mkdocs构建项目文档

1. 本地化构建

1.1 环境安装

pip install mkdocs

1.2 初始化项目

# 新建项目
mkdocs new .

# 启动本地服务
mkdocs serve

1.3 配置主题 https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes

例如：material

pip install mkdocs-material

模版参考：

https://github.com/echonoshy/Maozedong-xuanji

2. 远程服务托管

2.1 使用rtd远程托管

https://readthedocs.org/

2.2 项目配置
配置好以后，每当github收到新的提交以后，rtd网站会重新自动构建并部署服务，保证网站是最新的。

• 关联github
• 配置webhook

readthedocs.yaml

# Read the Docs configuration file for MkDocs projects
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

# Required
version: 2

# Set the version of Python and other tools you might need
build:
  os: ubuntu-22.04
  tools:
    python: "3.12"

mkdocs:
  configuration: mkdocs.yml

# Optionally declare the Python requirements required to build your docs
python:
  install:
  - requirements: docs/requirements.txt