diff --git a/.gitignore b/.gitignore index b7a3b99..52e2f3b 100644 --- a/.gitignore +++ b/.gitignore @@ -18,4 +18,5 @@ Cargo.lock /target # Documentation +/.cache/ /site/ diff --git a/hatch.toml b/hatch.toml index 7382c9d..a6e2fed 100644 --- a/hatch.toml +++ b/hatch.toml @@ -1,22 +1,25 @@ [envs.docs] detached = true dependencies = [ - "mkdocs~=1.4.0", - "mkdocs-material~=9.1.16", + "mkdocs~=1.5.3", + "mkdocs-material~=9.5.1", # Plugins - "mkdocs-minify-plugin~=0.6.4", - "mkdocs-git-revision-date-localized-plugin~=1.2.0", - "mkdocs-glightbox~=0.3.4", - # https://github.com/jimporter/mike/issues/82#issuecomment-1172913929 - "mike @ https://github.com/jimporter/mike/archive/392d57b8bb9d14bcedf2451a0dc302709f8055eb.zip", + "mkdocs-minify-plugin~=0.7.1", + "mkdocs-git-revision-date-localized-plugin~=1.2.1", + "mkdocs-glightbox~=0.3.5", + "mike~=2.0.0", # Extensions - "pymdown-extensions~=10.0.1", + "pymdown-extensions~=10.5.0", # Necessary for syntax highlighting in code blocks - "pygments~=2.15.1", + "pygments~=2.17.2", # Validation # https://github.com/linkchecker/linkchecker/pull/669#issuecomment-1267236287 "linkchecker @ git+https://github.com/linkchecker/linkchecker.git@d9265bb71c2054bf57b8c5734a4825d62505c779", ] +[envs.docs.overrides] +env.GITHUB_ACTIONS.env-vars = [ + { key = "MKDOCS_IMAGE_PROCESSING", value = "true", if = ["true"] }, +] [envs.docs.env-vars] SOURCE_DATE_EPOCH = "1580601600" PYTHONUNBUFFERED = "1" diff --git a/mkdocs.yml b/mkdocs.yml index 60b4b5f..04ca32f 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -36,6 +36,8 @@ theme: features: - content.action.edit - content.code.copy + - content.tabs.link + - content.tooltips - navigation.expand - navigation.footer - navigation.instant @@ -61,6 +63,8 @@ plugins: git-revision-date-localized: strict: false type: date + # social: + # enabled: !ENV [MKDOCS_IMAGE_PROCESSING, false] markdown_extensions: # Built-in @@ -68,6 +72,7 @@ markdown_extensions: - markdown.extensions.admonition: - markdown.extensions.attr_list: - markdown.extensions.footnotes: + - markdown.extensions.md_in_html: - markdown.extensions.meta: - markdown.extensions.tables: - markdown.extensions.toc: @@ -82,8 +87,8 @@ markdown_extensions: - pymdownx.emoji: # https://github.com/twitter/twemoji # https://raw.githubusercontent.com/facelessuser/pymdown-extensions/master/pymdownx/twemoji_db.py - emoji_index: !!python/name:materialx.emoji.twemoji - emoji_generator: !!python/name:materialx.emoji.to_svg + emoji_index: !!python/name:material.extensions.emoji.twemoji + emoji_generator: !!python/name:material.extensions.emoji.to_svg - pymdownx.highlight: guess_lang: false linenums_style: pymdownx-inline @@ -117,6 +122,9 @@ markdown_extensions: format: !!python/name:pymdownx.superfences.fence_code_format - pymdownx.tabbed: alternate_style: true + slugify: !!python/object/apply:pymdownx.slugs.slugify + kwds: + case: lower - pymdownx.tasklist: custom_checkbox: true - pymdownx.tilde: