mkdocs_material_theme_project_setup_and_serve.py

1import subprocess
2import os
3
4# 1. Install the material theme package
5subprocess.run(["pip", "install", "mkdocs-material"])
6
7# 2. Create a new project named 'my-project'
8subprocess.run(["mkdocs", "new", "my-project"])
9
10# 3. Change directory to the project folder
11os.chdir("my-project")
12
13# 4. Update mkdocs.yml to use the Material theme
14# This overwrites the default config with the Material configuration
15mkdocs_config = """
16site_name: My Docs
17theme:
18  name: material
19"""
20
21with open("mkdocs.yml", "w") as f:
22    f.write(mkdocs_config.strip())
23
24# 5. Start the local development server
25print("Starting MkDocs server...")
26subprocess.run(["mkdocs", "serve"])