From 706a15aa88e592bc1e9f619e269ed6aeba9ec877 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 30 Dec 2025 12:03:42 +0100
Subject: [PATCH] =?UTF-8?q?=E2=AC=86=EF=B8=8F=20Migrate=20to=20Zensical?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/contributing.md  | 6 +++---
 mkdocs.yml            | 3 ++-
 requirements-docs.txt | 1 +
 scripts/docs.py       | 6 +++---
 4 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/docs/contributing.md b/docs/contributing.md
index d7b7f53c8c..31a807cedc 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -245,10 +245,10 @@ Go into the docs directory at `docs/`:
 $ cd docs/
 ```
 
-Then run `mkdocs` in that directory:
+Then run `zensical` in that directory:
 
 ```console
-$ mkdocs serve --dev-addr 8008
+$ zensical serve --dev-addr 8008
 ```
 
 ///
@@ -274,7 +274,7 @@ Completion will take effect once you restart the terminal.
 
 ### Docs Structure
 
-The documentation uses <a href="https://www.mkdocs.org/" class="external-link" target="_blank">MkDocs</a>.
+The documentation uses <a href="https://zensical.org" class="external-link" target="_blank">Zensical</a>.
 
 And there are extra tools/scripts in place in `./scripts/docs.py`.
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 744954ce2c..58c31fda5f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -4,6 +4,7 @@ site_description: Typer, build great CLIs. Easy to code. Based on Python type hi
 site_url: https://typer.tiangolo.com/
 
 theme:
+  variant: classic
   name: material
   custom_dir: docs/overrides
   palette:
@@ -71,7 +72,7 @@ plugins:
 nav:
   - Typer: index.md
   - features.md
-  - Tutorial - User Guide:
+  - Learn:
       - tutorial/index.md
       - environment-variables.md
       - virtual-environments.md
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 2c3866ac39..1a5bb17ef7 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -17,3 +17,4 @@ griffe-warnings-deprecated==1.1.0
 # black==24.3.0
 mkdocs-macros-plugin==1.5.0
 markdown-include-variants==0.0.8
+zensical==0.0.15
diff --git a/scripts/docs.py b/scripts/docs.py
index e0b1074e90..c7cefb9b21 100644
--- a/scripts/docs.py
+++ b/scripts/docs.py
@@ -80,7 +80,7 @@ def live(dirty: bool = False) -> None:
     en.
     """
     # Enable line numbers during local development to make it easier to highlight
-    args = ["mkdocs", "serve", "--dev-addr", "127.0.0.1:8008"]
+    args = ["zensical", "serve", "--dev-addr", "127.0.0.1:8008"]
     if dirty:
         args.append("--dirty")
     subprocess.run(args, env={**os.environ, "LINENUMS": "true"}, check=True)
@@ -92,7 +92,7 @@ def build() -> None:
     Build the docs.
     """
     print("Building docs")
-    subprocess.run(["mkdocs", "build"], check=True)
+    subprocess.run(["zensical", "build"], check=True)
     typer.secho("Successfully built docs", color=typer.colors.GREEN)
 
 
@@ -101,7 +101,7 @@ def serve() -> None:
     """
     A quick server to preview a built site.
 
-    For development, prefer the command live (or just mkdocs serve).
+    For development, prefer the command live (or just zensical serve).
 
     This is here only to preview the documentation site.