feat: Release visually-lighter admonitions for source code blocks

Author: pawamoy

docs/insiders/changelog.md

@@ -2,7 +2,11 @@
 
 ## mkdocstrings-python Insiders
 
-### 1.12.0 <small>March 22, 2025</small> { id="1.12.0" }
+### 1.12.1 <small>May 24, 2025</small> { id="1.12.1" }
+
+- Visually-lighter admonitions for source code blocks
+
+### 1.12.0 <small>March 24, 2025</small> { id="1.12.0" }
 
 - [Ordering method: `__all__`][option-members_order]
 
@@ -14,6 +18,11 @@
 
 - [Backlinks][backlinks]
 
+### 1.9.1 <small>December 26, 2024</small> { id="1.9.1" }
+
+- Re-add class template for RTD theme
+- Make inheritance diagrams rendering more robust
+
 ### 1.9.0 <small>September 03, 2024</small> { id="1.9.0" }
 
 - [Relative cross-references][relative_crossrefs]

docs/insiders/goals.yml

@@ -50,4 +50,6 @@ goals:
       since: 2025/03/20
     - name: "Ordering method: `__all__`"
       ref: /usage/configuration/members/#option-members_order
-      since: 2025/03/22
+      since: 2025/03/24
+    - name: "Visually-lighter source code blocks"
+      since: 2025/05/24

src/mkdocstrings_handlers/python/templates/material/_base/class.html.jinja

@@ -252,7 +252,7 @@ Context:
             {% if config.merge_init_into_class %}
               {% if "__init__" in all_members and all_members["__init__"].source %}
                 {% with init = all_members["__init__"] %}
-                  <details class="quote">
+                  <details class="mkdocstrings-source">
                     <summary>Source code in <code>
                       {%- if init.relative_filepath.is_absolute() -%}
                         {{ init.relative_package_filepath }}
@@ -265,7 +265,7 @@ Context:
                 {% endwith %}
               {% endif %}
             {% elif class.source %}
-              <details class="quote">
+              <details class="mkdocstrings-source">
                 <summary>Source code in <code>
                   {%- if class.relative_filepath.is_absolute() -%}
                     {{ class.relative_package_filepath }}

src/mkdocstrings_handlers/python/templates/material/_base/function.html.jinja

@@ -149,7 +149,7 @@ Context:
           This block renders the source code for the function.
           -#}
           {% if config.show_source and function.source %}
-            <details class="quote">
+            <details class="mkdocstrings-source">
               <summary>{{ lang.t("Source code in") }} <code>
                 {%- if function.relative_filepath.is_absolute() -%}
                   {{ function.relative_package_filepath }}

src/mkdocstrings_handlers/python/templates/material/style.css

@@ -210,3 +210,27 @@ code.doc-symbol-module::after {
   color: inherit;
   border-bottom: 1px dotted currentcolor;
 }
+
+/* Source code blocks (admonitions). */
+:root {
+  --md-admonition-icon--mkdocstrings-source: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.22 4.97a.75.75 0 0 1 1.06 0l6.5 6.5a.75.75 0 0 1 0 1.06l-6.5 6.5a.749.749 0 0 1-1.275-.326.75.75 0 0 1 .215-.734L21.19 12l-5.97-5.97a.75.75 0 0 1 0-1.06m-6.44 0a.75.75 0 0 1 0 1.06L2.81 12l5.97 5.97a.749.749 0 0 1-.326 1.275.75.75 0 0 1-.734-.215l-6.5-6.5a.75.75 0 0 1 0-1.06l6.5-6.5a.75.75 0 0 1 1.06 0"/></svg>')
+}
+.md-typeset .admonition.mkdocstrings-source,
+.md-typeset details.mkdocstrings-source {
+  border: none;
+  padding: 0;
+}
+.md-typeset .admonition.mkdocstrings-source:focus-within,
+.md-typeset details.mkdocstrings-source:focus-within {
+  box-shadow: none;
+}
+.md-typeset .mkdocstrings-source > .admonition-title,
+.md-typeset .mkdocstrings-source > summary {
+  background-color: inherit;
+}
+.md-typeset .mkdocstrings-source > .admonition-title::before,
+.md-typeset .mkdocstrings-source > summary::before {
+  background-color: var(--md-default-fg-color);
+  -webkit-mask-image: var(--md-admonition-icon--mkdocstrings-source);
+          mask-image: var(--md-admonition-icon--mkdocstrings-source);
+}