ci(docs): update configuration and add template

- Add exclusions and adjust type checking rules in pyrightconfig
- Improve ReadTheDocs build configuration with additional steps
- Add main.html template for better ReadTheDocs integration
- Use frozen dependencies in ReadTheDocs builds for consistency

Author: liblaf

template/.config/linters/pyrightconfig.json

@@ -1,12 +1,15 @@
 {
   "$schema": "https://raw.githubusercontent.com/microsoft/pyright/main/packages/vscode-pyright/schemas/pyrightconfig.schema.json",
 
+  "exclude": ["**/node_modules", "**/__pycache__", "**/.*", "marimo/"],
+
   "enableTypeIgnoreComments": false,
 
   "typeCheckingMode": "standard",
 
   "reportArgumentType": "information",
   "reportAssignmentType": "information",
-  "reportPrivateImportUsage": "none",
-  "reportRedeclaration": "none"
+  "reportRedeclaration": "none",
+  "reportIncompatibleMethodOverride": "warning",
+  "reportIncompatibleVariableOverride": "warning"
 }

template/.readthedocs.yaml.jinja

@@ -2,20 +2,22 @@
 # yaml-language-server: $schema=https://raw.githubusercontent.com/readthedocs/readthedocs.org/master/readthedocs/rtd_tests/fixtures/spec/v2/schema.json
 # This file is @generated by <https://github.com/liblaf/copier-python>.
 # DO NOT EDIT!
+
 # ref: <https://docs.readthedocs.com/platform/stable/config-file/v2.html>
 # ref: <https://docs.readthedocs.com/platform/stable/reference/environment-variables.html>
 
 version: 2
 
-python:
-  install:
-    - requirements: requirements.txt
-
 build:
   os: ubuntu-lts-latest
   tools:
     python: latest
   jobs:
+    post_checkout:
+      # ref: <https://docs.readthedocs.com/platform/stable/build-customization.html#unshallow-git-clone>
+      - git fetch --unshallow || true
+
+    # ref: <https://docs.readthedocs.com/platform/stable/build-customization.html#install-dependencies-with-uv>
     pre_create_environment:
       # {%- if package_manager == "pixi" %}
       - asdf plugin add pixi
@@ -29,14 +31,14 @@ build:
 
     # {%- if package_manager == "uv" %}
     create_environment:
-      - uv venv "$READTHEDOCS_VIRTUALENV_PATH"
+      - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
     # {%- endif %}
 
     install:
       # {%- if package_manager == "pixi" %}
-      - pixi install
+      - pixi install --frozen
       # {%- elif package_manager == "uv" %}
-      - UV_PROJECT_ENVIRONMENT="$READTHEDOCS_VIRTUALENV_PATH" uv sync --all-extras --all-groups --link-mode copy
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --all-extras --all-groups --frozen --link-mode copy
       # {%- endif %}
 
     pre_build:

template/docs/overrides/main.html

@@ -0,0 +1,11 @@
+<!-- This file is @generated by <https://github.com/liblaf/copier-python>. -->
+<!-- DO NOT EDIT! -->
+
+<!-- ref: <https://docs.readthedocs.com/platform/stable/intro/mkdocs.html#integrate-the-read-the-docs-version-menu-into-your-site-navigation> -->
+<!-- prettier-ignore -->
+{% extends "base.html" %}
+
+{% block site_meta %}
+{{ super() }}
+<meta name="readthedocs-addons-api-version" content="1" />
+{% endblock %}