From 707def4339dec1ebe40c015829d4141b50d33ab2 Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Wed, 18 Feb 2026 23:35:59 +0100 Subject: [PATCH 01/23] change theme --- mkdocs.yml | 22 ++++++++-------------- 1 file changed, 8 insertions(+), 14 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index 7aee86c0c0865c..293cb858e9aaee 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -13,21 +13,10 @@ docs_dir: 'docs/design/coreclr/botr' theme: name: material language: en + font: + text: Roboto palette: - - media: '(prefers-color-scheme: light)' - scheme: default - primary: indigo - accent: indigo - toggle: - icon: material/brightness-7 - name: Switch to dark mode - - media: '(prefers-color-scheme: dark)' - scheme: slate - primary: black - accent: indigo - toggle: - icon: material/brightness-4 - name: Switch to light mode + primary: black features: - content.action.view - navigation.footer @@ -49,8 +38,13 @@ extra: link: https://github.com/dotnet/runtime markdown_extensions: +# - meta +# - admonition - pymdownx.highlight - pymdownx.superfences +# - pymdownx.pathconverter +# - pymdownx.tabbed +# - pymdownx.tasklist nav: - Introduction: README.md From c8d11e83f7b964d1f7a6e3ae49bea6d896a12cf6 Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Wed, 18 Feb 2026 23:40:10 +0100 Subject: [PATCH 02/23] dark theme --- mkdocs.yml | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index 293cb858e9aaee..e0aa0fabd79968 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -16,7 +16,18 @@ theme: font: text: Roboto palette: - primary: black + - media: '(prefers-color-scheme: light)' + scheme: default + primary: black + toggle: + icon: material/brightness-7 + name: Switch to dark mode + - media: '(prefers-color-scheme: dark)' + scheme: slate + primary: black + toggle: + icon: material/brightness-4 + name: Switch to light mode features: - content.action.view - navigation.footer From d6df4d4fb147b8b487e8d99744f8755b0541a8fb Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Wed, 18 Feb 2026 23:49:15 +0100 Subject: [PATCH 03/23] update --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index e0aa0fabd79968..14cf02e7eceabc 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -18,7 +18,7 @@ theme: palette: - media: '(prefers-color-scheme: light)' scheme: default - primary: black + primary: white toggle: icon: material/brightness-7 name: Switch to dark mode From 7ea8c631bbdb0d9ff78a45cee4ebb58bc803e2a7 Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Wed, 18 Feb 2026 23:53:11 +0100 Subject: [PATCH 04/23] update readme --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index f4673865a4203f..03ec496621e4cb 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,9 @@ The site provides easy-to-navigate interface with dark and light themes and inte It is available at . +> **Disclaimer:** This is an unofficial documentation site and is not affiliated with Microsoft. +> .NET and Microsoft are trademarks of Microsoft Corporation. + ## Overview This repo has two *main* branches: From b6008b5921aba391984821bd7848966f6689e549 Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Wed, 18 Feb 2026 23:58:18 +0100 Subject: [PATCH 05/23] copyright --- mkdocs.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/mkdocs.yml b/mkdocs.yml index 14cf02e7eceabc..f418b7f0be0f63 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -47,6 +47,9 @@ extra: link: https://github.com/jurakovic/runtime - icon: fontawesome/brands/github link: https://github.com/dotnet/runtime + #generator: false + +copyright: 'Unofficial documentation site. Not affiliated with Microsoft. .NET and Microsoft are trademarks of Microsoft Corporation.' markdown_extensions: # - meta From 6bcdbe7c9fda8d0ff1e027ec9b69c367596c7869 Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Thu, 19 Feb 2026 00:19:04 +0100 Subject: [PATCH 06/23] change font --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index f418b7f0be0f63..47cc6a22df5c85 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -14,7 +14,7 @@ theme: name: material language: en font: - text: Roboto + text: Segoe UI palette: - media: '(prefers-color-scheme: light)' scheme: default From f4d447ae3775f0424ea0a303544d730b6fa11ab5 Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Fri, 20 Feb 2026 22:32:21 +0100 Subject: [PATCH 07/23] custom.css --- build.sh | 1 + custom.css | 12 ++++++++++++ mkdocs.yml | 3 +++ 3 files changed, 16 insertions(+) create mode 100644 custom.css diff --git a/build.sh b/build.sh index 74f48c8030a370..567b8e76da9ff3 100644 --- a/build.sh +++ b/build.sh @@ -10,6 +10,7 @@ rm -rf site # temp config cp ../mkdocs.yml . +cp ../custom.css docs/design/coreclr/botr/custom.css # copy out-of-scope files cp docs/design/coreclr/botr/../jit/ryujit-overview.md docs/design/coreclr/botr/ryujit-overview.md diff --git a/custom.css b/custom.css new file mode 100644 index 00000000000000..bb54259a85f326 --- /dev/null +++ b/custom.css @@ -0,0 +1,12 @@ + +.md-typeset { + font-size: .75rem; +} + +[data-md-color-scheme="slate"] { + --md-default-bg-color: #1F1F1F; +} + +[data-md-color-primary=black] .md-header { + background-color: #1F1F1F; +} diff --git a/mkdocs.yml b/mkdocs.yml index 47cc6a22df5c85..7230e295ad47ca 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -60,6 +60,9 @@ markdown_extensions: # - pymdownx.tabbed # - pymdownx.tasklist +extra_css: + - custom.css + nav: - Introduction: README.md - Book of the Runtime FAQ: botr-faq.md From deff45e408087e0b1a1a97de36d0c5d801e3831d Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Fri, 20 Feb 2026 22:40:06 +0100 Subject: [PATCH 08/23] cr font size --- custom.css | 4 ++++ mkdocs.yml | 8 +------- 2 files changed, 5 insertions(+), 7 deletions(-) diff --git a/custom.css b/custom.css index bb54259a85f326..efd3e4ef686aec 100644 --- a/custom.css +++ b/custom.css @@ -3,6 +3,10 @@ font-size: .75rem; } +.md-copyright__highlight { + font-size: .55rem; +} + [data-md-color-scheme="slate"] { --md-default-bg-color: #1F1F1F; } diff --git a/mkdocs.yml b/mkdocs.yml index 7230e295ad47ca..7db6023580e61e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -47,18 +47,12 @@ extra: link: https://github.com/jurakovic/runtime - icon: fontawesome/brands/github link: https://github.com/dotnet/runtime - #generator: false -copyright: 'Unofficial documentation site. Not affiliated with Microsoft. .NET and Microsoft are trademarks of Microsoft Corporation.' +copyright: 'Unofficial documentation site. Not affiliated with Microsoft. Microsoft and .NET are trademarks of Microsoft Corporation.' markdown_extensions: -# - meta -# - admonition - pymdownx.highlight - pymdownx.superfences -# - pymdownx.pathconverter -# - pymdownx.tabbed -# - pymdownx.tasklist extra_css: - custom.css From 409b1df0fb637137c98cd4c630e5cd5b0a48e03f Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Fri, 20 Feb 2026 22:54:55 +0100 Subject: [PATCH 09/23] update --- README.md | 5 +++-- mkdocs.yml | 4 ++-- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 03ec496621e4cb..8e7c2c5d13e11d 100644 --- a/README.md +++ b/README.md @@ -7,8 +7,9 @@ The site provides easy-to-navigate interface with dark and light themes and inte It is available at . -> **Disclaimer:** This is an unofficial documentation site and is not affiliated with Microsoft. -> .NET and Microsoft are trademarks of Microsoft Corporation. +> **Disclaimer:** +> This is an unofficial documentation site and is not affiliated with Microsoft. +> Microsoft and .NET are trademarks of Microsoft Corporation. ## Overview diff --git a/mkdocs.yml b/mkdocs.yml index 7db6023580e61e..3f98f7489f0990 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -20,13 +20,13 @@ theme: scheme: default primary: white toggle: - icon: material/brightness-7 + icon: material/weather-night name: Switch to dark mode - media: '(prefers-color-scheme: dark)' scheme: slate primary: black toggle: - icon: material/brightness-4 + icon: material/weather-sunny name: Switch to light mode features: - content.action.view From 854187ce23b9eb238a2a75ce879254fd16470814 Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Fri, 20 Feb 2026 23:32:32 +0100 Subject: [PATCH 10/23] override copyright --- build.sh | 11 ++--------- copyright.html | 20 ++++++++++++++++++++ mkdocs.yml | 1 + 3 files changed, 23 insertions(+), 9 deletions(-) create mode 100644 copyright.html diff --git a/build.sh b/build.sh index 567b8e76da9ff3..52355f0921cb7c 100644 --- a/build.sh +++ b/build.sh @@ -11,6 +11,8 @@ rm -rf site # temp config cp ../mkdocs.yml . cp ../custom.css docs/design/coreclr/botr/custom.css +mkdir -p overrides/partials +cp ../copyright.html overrides/partials/copyright.html # copy out-of-scope files cp docs/design/coreclr/botr/../jit/ryujit-overview.md docs/design/coreclr/botr/ryujit-overview.md @@ -61,15 +63,6 @@ sed -i -r 's|(href="https://github\.com/dotnet/runtime/blob/main/docs/design/cor # fix index urls sed -i -r 's|(">All Book of the Runtime \(BOTR\) chapters on GitHub)|" target="_blank\1|' docs/index.html -# add footer url -text='in jurakovic/runtime' -mapfile -t files < <(find docs -type f -iwholename "*.html") -for file in "${files[@]}"; do - total_lines=$(wc -l < "$file") - insert_line=$((total_lines - 48)) - sed -i "${insert_line}i$text" "$file" -done - echo "Removing 'dotnet' worktree" git worktree remove dotnet --force diff --git a/copyright.html b/copyright.html new file mode 100644 index 00000000000000..a9146d6368de5a --- /dev/null +++ b/copyright.html @@ -0,0 +1,20 @@ +{#- + This file was automatically generated - do not edit +-#} + diff --git a/mkdocs.yml b/mkdocs.yml index 3f98f7489f0990..80e7e29130991c 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -12,6 +12,7 @@ docs_dir: 'docs/design/coreclr/botr' theme: name: material + custom_dir: overrides language: en font: text: Segoe UI From 95678318fc40c9c3cb32ce3f0b8dadd9601d5cac Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Fri, 20 Feb 2026 23:34:09 +0100 Subject: [PATCH 11/23] smaller font --- custom.css | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/custom.css b/custom.css index efd3e4ef686aec..80874bcdee9c5f 100644 --- a/custom.css +++ b/custom.css @@ -3,7 +3,7 @@ font-size: .75rem; } -.md-copyright__highlight { +.md-copyright { font-size: .55rem; } From 6c6211be36c1796272302145f6e21d8af28d80cd Mon Sep 17 00:00:00 2001 From: jurakovic <17744091+jurakovic@users.noreply.github.com> Date: Sat, 21 Feb 2026 00:03:30 +0100 Subject: [PATCH 12/23] cleanup --- copyright.html | 3 --- 1 file changed, 3 deletions(-) diff --git a/copyright.html b/copyright.html index a9146d6368de5a..5a109092de695b 100644 --- a/copyright.html +++ b/copyright.html @@ -1,6 +1,3 @@ -{#- - This file was automatically generated - do not edit --#}