mkdocs-smzhbook-theme 1.1

smallzh's book theme for MkDocs

MkDocs Smzhbook Theme

blog.smallzh.top网站使用的主题，基于MkDocs 构建。

0x00.使用

安装主题

pip install mkdocs-smzhbook-theme

配置 MkDocs

在 mkdocs.yml 中设置主题：

site_name: Your Site Name
theme:
  name: smzhbook

自定义样式和脚本

extra_css:
  - custom.css

extra_javascript:
  - custom.js

本地开发主题

如果需要在本地直接使用主题源码（而非安装的包），可以在 mkdocs.yml 中直接指定主题目录：

theme:
  name: null
  dir: /path/to/mkdocs-smzhbook-theme/smzhbook_theme

0x01.开发

先安装 uv ，再执行以下命令

# 创建虚拟环境
uv venv .venv
# 安装 mkdocs
uv pip install mkdocs
# 启动
uv run mkdocs serve

0xFF.感谢

1. MkDocs ，简单易用的静态站点生成器
2. mkdocs-basic-theme ， mkdocs的基础主题库