build(docs): use uv for pages deploy (#2266)

Author: jxnl

build_mkdocs.sh

@@ -1,3 +1,9 @@
-pip install -r requirements.txt
-pip install -r requirements-doc.txt
-mkdocs build
+#!/usr/bin/env sh
+set -eu
+
+if ! command -v uv >/dev/null 2>&1; then
+  pipx install uv
+fi
+
+uv sync --python 3.13 --extra docs
+uv run mkdocs build

mkdocs.yml

@@ -415,7 +415,8 @@ plugins:
          'hub/single_classification.md': 'examples/single_classification.md'
          'hub/tables_from_vision.md': 'examples/tables_from_vision.md'
          'hub/youtube_clips.md': 'examples/youtube_clips.md'
-  - social
+  - social:
+      enabled: !ENV [ENABLE_MKDOCS_SOCIAL, false]
   - search:
       separator: '[\s\u200b\-_,:!=\[\]()"`/]+|\.(?!\b)(?=[A-Z][a-z])'
   - minify:

pyproject.toml

@@ -68,6 +68,7 @@ docs = [
     "mkdocs-rss-plugin<2.0.0,>=1.12.0",
     "mkdocs-minify-plugin<1.0.0,>=0.8.0",
     "mkdocs-redirects<2.0.0,>=1.2.1",
+    "mkdocs-llmstxt>=0.5.0,<0.6.0; python_version >= '3.10'",
     "mkdocs-material-extensions>=1.3.1",
     "mkdocs-material>=9.6.14",
 ]

requirements.txt

@@ -71,7 +71,7 @@ pydantic==2.12.5
     # via
     #   instructor (pyproject.toml)
     #   openai
-pydantic-core==2.45.0
+pydantic-core==2.41.5
     # via
     #   instructor (pyproject.toml)
     #   pydantic