摘要: 安装python和pip以及mkdocs-material

安装python和pip

安装绿色版python

下载绿色安装包Windows embeddable package (64-bit)

https://www.python.org/ftp/python/3.13.5/python-3.13.5-embed-amd64.zip

解压缩到D:\dev_software\python-3.13.5-embed-amd64

没有git则安装git https://git-scm.com/

添加环境变量

win11->系统->系统信息->高级系统设置->环境变量

系统变量里找到path->编辑->编辑文本

检查末尾是否有;没有则添加

在末尾添加D:\dev_software\python-3.13.5-embed-amd64

检查是否安装成功

需要重新打开git base

在任意目录右键-> open git base here

1

python --version

正确输出版本号则安装成功

安装pip

下载安装脚本https://bootstrap.pypa.io/get-pip.py

复制下载的脚本get-pip.py到D:\dev_software\python-3.13.5-embed-amd64

打开D:\dev_software\python-3.13.5-embed-amd64目录

右键-> open git base here

输入命令

1

python get-pip.py

等待安装成功

之后编辑这个目录下的python313._pth文件

将#import site改为import site (去掉#注释)

添加环境变量

将D:\dev_software\python-3.13.5-embed-amd64\Scripts也添加到环境变量中和上边一样

检查

需要重新打开git base

1

pip --version

输出版本号则安装成功

安装mkdocs

安装mkdocs和插件

1
2

pip install mkdocs
pip install --upgrade setuptools

安装mkdocs-material主题和插件

1
2

pip install mkdocs-material
pip install mkdocs-minify-plugin

创建mkdocs

1
2
3

在任意目录
mkdocs new my-project

更换主题

1
2
3

将以下行添加到 mkdocs.yml
theme:
  name: material

目录

1

docs\blog\posts   博客目录

开发启动

1

mkdocs serve

打开http://127.0.0.1:8000/

部署到cloudflare

根目录添加文件requirements.txt文件内容如下

1
2
3
4
5
6
7
8
9
10
11
12
13

# vercel
setuptools
mkdocs
mkdocs-minify-plugin
cairosvg
mkdocs-blog-plugin
mkdocs-rss-plugin
mkdocs-material
mkdocs-material[imaging]
python-markdown-math
fontawesome_markdown
mdx_unimoji
pymdown-extensions

构建命令和输出目录

1
2

mkdocs build -d public
输出目录public