diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml index 9a838ee..285c92c 100644 --- a/.github/workflows/deploy-docs.yml +++ b/.github/workflows/deploy-docs.yml @@ -16,6 +16,8 @@ jobs: contents: write steps: - uses: actions/checkout@v4 + with: + fetch-depth: 0 - uses: actions/setup-python@v5 with: diff --git a/docs-requirements.txt b/docs-requirements.txt index 133ec0a..fac328b 100644 --- a/docs-requirements.txt +++ b/docs-requirements.txt @@ -4,3 +4,5 @@ mkdocs-material-extensions>=1.3 pymdown-extensions>=10.0 mkdocstrings>=0.27 mkdocstrings-python>=1.0 +mkdocs-callouts +mkdocs-git-revision-date-localized-plugin diff --git a/docs/assets/cat.png b/docs/assets/cat.png new file mode 100644 index 0000000..696b06d Binary files /dev/null and b/docs/assets/cat.png differ diff --git a/mkdocs.yml b/mkdocs.yml index b17548e..f1ba828 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -9,8 +9,9 @@ copyright: Copyright (c) 2023 Microsoft Corporation theme: name: material - favicon: https://zenodo.org/records/15376499/files/cat.png - logo: https://zenodo.org/records/15376499/files/cat.png + custom_dir: overrides + favicon: assets/cat.png + logo: assets/cat.png icon: menu: material/menu alternate: material/translate @@ -99,6 +100,11 @@ markdown_extensions: pygments_lang_class: true plugins: + - callouts - search - meta - tags + - git-revision-date-localized: + type: date + enable_creation_date: true + fallback_to_build_date: true diff --git a/overrides/main.html b/overrides/main.html new file mode 100644 index 0000000..aafe007 --- /dev/null +++ b/overrides/main.html @@ -0,0 +1,90 @@ +{% extends "base.html" %} + +{# + Theme override for SEO structured data and a clean homepage