From d20eb3c1f9110bd09fb248c579dafe33295093f7 Mon Sep 17 00:00:00 2001 From: Wesley B <62723358+wesleyboar@users.noreply.github.com> Date: Mon, 5 Oct 2026 15:20:27 -0500 Subject: [PATCH 1/5] fix(theme): swap admonition caution and warning styling Match Core-Styles severity mapping in pymdownx icons and layer overrides until CDN bump. Co-authored-by: Cursor --- .../css/tacc-theme/core-styles.docs.css | 12 ++++++++++++ .../tacc_readthedocs/css/tacc-theme/pymdownx.css | 6 +++--- 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/core-styles.docs.css b/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/core-styles.docs.css index 5bf1598..c175fda 100644 --- a/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/core-styles.docs.css +++ b/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/core-styles.docs.css @@ -44,3 +44,15 @@ margin: 0; /* overwrites core-styles, bootstrap, ReadTheDocs */ } } + +/* Admonition: swap caution vs warning (overrides CDN until @tacc/core-styles bump) */ +.admonition:is(.warning, .important) { + --icon-color: var(--global-color-warning--dark); + background-color: var(--global-color-warning--x-light); + border-color: var(--global-color-warning--dark); +} +.admonition:is(.caution, .error, .danger) { + --icon-color: var(--global-color-danger--dark); + background-color: var(--global-color-danger--x-light); + border-color: var(--global-color-danger--dark); +} diff --git a/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/pymdownx.css b/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/pymdownx.css index 8473bf6..99b2d74 100644 --- a/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/pymdownx.css +++ b/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/pymdownx.css @@ -26,14 +26,14 @@ text-rendering: auto; -webkit-font-smoothing: antialiased; } -.admonition:is(.caution)::before { content: "\f071"; } +.admonition:is(.warning)::before { content: "\f071"; } .admonition:is(.important, .attention)::before { content: "\f12a"; } -.admonition:is(.warning)::before { content: "\f00d"; } +.admonition:is(.caution)::before { content: "\f00d"; } .admonition:is(.tip)::before { content: "\f0eb"; } .admonition:is(.note)::before { content: "\f040"; } .admonition:is(.hint)::before { content: "\f00c"; } .admonition:is(.error, .danger)::before { content: "\f00d"; } -.admonition:is(.warning)::before { +.admonition:is(.caution)::before { color: transparent; -webkit-text-stroke: var(--global-color-primary--xx-light) 2px; } From ee832bd03b568cbf8f5ed591d976eed553ac2d6e Mon Sep 17 00:00:00 2001 From: Wesley B <62723358+wesleyboar@users.noreply.github.com> Date: Wed, 7 Oct 2026 14:08:11 -0500 Subject: [PATCH 2/5] chore(deps): pin CDN to core-styles 2.59.0 and release 1.0.5 Bump theme CDN after Core-Styles minor release; drop redundant admonition overrides. Co-authored-by: Cursor --- mkdocs_tacc/tacc_readthedocs/css/tacc-theme.css | 4 ++-- .../css/tacc-theme/core-styles.docs.css | 12 ------------ pyproject.toml | 2 +- 3 files changed, 3 insertions(+), 15 deletions(-) diff --git a/mkdocs_tacc/tacc_readthedocs/css/tacc-theme.css b/mkdocs_tacc/tacc_readthedocs/css/tacc-theme.css index 6b4093c..8c6c066 100644 --- a/mkdocs_tacc/tacc_readthedocs/css/tacc-theme.css +++ b/mkdocs_tacc/tacc_readthedocs/css/tacc-theme.css @@ -9,9 +9,9 @@ @import url('./tacc-theme/bootstrap.css') layer(foundation.tacc); /* TACC's Core-Styles & tweaks to it */ -@import url('https://cdn.jsdelivr.net/npm/@tacc/core-styles@2.37.4/dist/core-styles.base.css') layer(base); +@import url('https://cdn.jsdelivr.net/npm/@tacc/core-styles@2.59.0/dist/core-styles.base.css') layer(base); @import url('./tacc-theme/core-styles.base.css') layer(base); -@import url('https://cdn.jsdelivr.net/npm/@tacc/core-styles@2.37.4/dist/core-styles.docs.css') layer(project); +@import url('https://cdn.jsdelivr.net/npm/@tacc/core-styles@2.59.0/dist/core-styles.docs.css') layer(project); @import url('./tacc-theme/core-styles.docs.css') layer(project); /* TACC's skin for basic documentation */ diff --git a/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/core-styles.docs.css b/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/core-styles.docs.css index c175fda..5bf1598 100644 --- a/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/core-styles.docs.css +++ b/mkdocs_tacc/tacc_readthedocs/css/tacc-theme/core-styles.docs.css @@ -44,15 +44,3 @@ margin: 0; /* overwrites core-styles, bootstrap, ReadTheDocs */ } } - -/* Admonition: swap caution vs warning (overrides CDN until @tacc/core-styles bump) */ -.admonition:is(.warning, .important) { - --icon-color: var(--global-color-warning--dark); - background-color: var(--global-color-warning--x-light); - border-color: var(--global-color-warning--dark); -} -.admonition:is(.caution, .error, .danger) { - --icon-color: var(--global-color-danger--dark); - background-color: var(--global-color-danger--x-light); - border-color: var(--global-color-danger--dark); -} diff --git a/pyproject.toml b/pyproject.toml index 72855b7..d43e903 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -17,7 +17,7 @@ classifiers = [ [project] name = "mkdocs-tacc" -version = "1.0.4" +version = "1.0.5" description = "TACC-specific MkDocs theme" authors = [ { name = "TACC COA CMD", email = "coa-cmd@tacc.utexas.edu" } From b68cba0d40d541dd2722db48f87620c50ad62b33 Mon Sep 17 00:00:00 2001 From: Wesley B <62723358+wesleyboar@users.noreply.github.com> Date: Wed, 7 Oct 2026 14:08:52 -0500 Subject: [PATCH 3/5] chore: gitignore venv Co-authored-by: Cursor --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 2869cb2..282ea81 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,5 @@ # Python +venv/ __pycache__/ *.py[cod] *.egg-info/ From a6a49b5119c461a7d3d6e1e1decb61b3d384e413 Mon Sep 17 00:00:00 2001 From: Wesley B <62723358+wesleyboar@users.noreply.github.com> Date: Wed, 7 Oct 2026 15:00:18 -0500 Subject: [PATCH 4/5] docs(extensions): swap caution and warning admonition usage Co-authored-by: Cursor --- docs/extensions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/extensions.md b/docs/extensions.md index 11e95d9..bae3e28 100644 --- a/docs/extensions.md +++ b/docs/extensions.md @@ -265,7 +265,7 @@ I am in a `
` with markdown enabled. !!! note "Custom Title" This is a note with a custom title. -!!! warning +!!! caution You can include blocks in admonitions, e.g. ```shell @@ -279,7 +279,7 @@ I am in a `
` with markdown enabled. !!! note "Custom Title" This is a note with a custom title. -!!! tip +!!! caution You can include blocks in admonitions, e.g. ```shell @@ -460,7 +460,7 @@ Content for second tab #### Tabbed { #pymdownx-tabbed } -/// caution | Deprecated +/// warning | Deprecated attrs: { id: pymdownx-tabbed-warning } This extension is deprecated. Try the [`blocks.tab`](#pymdownx-tab) extension instead. /// From ae9f69d6af083cea5417573fab5811f166f0b80b Mon Sep 17 00:00:00 2001 From: Wesley B <62723358+wesleyboar@users.noreply.github.com> Date: Wed, 7 Oct 2026 15:04:53 -0500 Subject: [PATCH 5/5] =?UTF-8?q?fix(docs):=20revert=20tip=E2=86=92caution?= =?UTF-8?q?=20in=20admonition=20result;=20drop=20venv=20gitignore?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- .gitignore | 1 - docs/extensions.md | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/.gitignore b/.gitignore index 282ea81..2869cb2 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,4 @@ # Python -venv/ __pycache__/ *.py[cod] *.egg-info/ diff --git a/docs/extensions.md b/docs/extensions.md index bae3e28..250bd8a 100644 --- a/docs/extensions.md +++ b/docs/extensions.md @@ -279,7 +279,7 @@ I am in a `
` with markdown enabled. !!! note "Custom Title" This is a note with a custom title. -!!! caution +!!! tip You can include blocks in admonitions, e.g. ```shell