Utilize handler-requested CSS feature

From mkdocstrings/mkdocstrings#218

Author: oprypin

docs/assets/style.css

@@ -9,33 +9,7 @@
 
 /* https://mkdocstrings.github.io/handlers/python/#recommended-style-material */
 
-.doc-contents th, .doc-contents td {
-  padding: 0.5em 0.8em !important;
-}
-
 div.doc-contents:not(.first) {
   padding-left: 15px;
   border-left: 4px solid rgba(230, 230, 230);
 }
-
-h5.doc-heading {
-  text-transform: none !important;
-}
-
-.hidden-toc::before {
-  margin-top: 0 !important;
-  padding-top: 0 !important;
-}
-
-.hidden-toc a.headerlink {
-  display: none;
-}
-
-td code {
-  word-break: normal !important;
-}
-
-td p {
-  margin-top: 0 !important;
-  margin-bottom: 0 !important;
-}

docs/styling.md

@@ -1,8 +1,8 @@
 ## Recommended styles
 
-Adding this styling to your site is **strongly** recommended, otherwise things may not look right. You can, of course, adapt and add more.
+Adding this styling to your site is recommended, otherwise things may not look right. You can, of course, adapt and add more.
 
-!!! example "css/mkdocstrings.css"
+!!! example "docs/css/mkdocstrings.css"
     ```css
     --8<-- "examples/simple/docs/css/mkdocstrings.css"
     ```
@@ -13,6 +13,12 @@ Adding this styling to your site is **strongly** recommended, otherwise things m
       - css/mkdocstrings.css
     ```
 
+This is in addition to the mandatory style that *mkdocstrings-crystal* already inserts (just for reference):
+
+```css
+--8<-- "mkdocstrings/templates/crystal/material/style.css"
+```
+
 ## Custom styles
 
 The doc items have consistently applied CSS classes. As of now, there is no separate documentation of what exactly they are. You are recommended to just *inspect* in the browser whenever you don't like the look of something and see how to reach it in CSS according to the markup.

examples/migrated/docs/css/mkdocstrings.css

@@ -3,18 +3,3 @@ div.doc-contents:not(.first) {
   padding-left: 15px;
   border-left: 4px solid rgba(230, 230, 230);
 }
-
-/* Prevent all-caps names in headings */
-h5.doc-heading {
-  text-transform: none !important;
-}
-
-/* [View source] links don't have brackets by default */
-a.doc-source-link::before {
-  content: "[";
-  color: var(--md-typeset-color);
-}
-a.doc-source-link::after {
-  content: "]";
-  color: var(--md-typeset-color);
-}

examples/simple/docs/css/mkdocstrings.css

@@ -3,18 +3,3 @@ div.doc-contents:not(.first) {
   padding-left: 15px;
   border-left: 4px solid rgba(230, 230, 230);
 }
-
-/* Prevent all-caps names in headings */
-h5.doc-heading {
-  text-transform: none !important;
-}
-
-/* [View source] links don't have brackets by default */
-a.doc-source-link::before {
-  content: "[";
-  color: var(--md-typeset-color);
-}
-a.doc-source-link::after {
-  content: "]";
-  color: var(--md-typeset-color);
-}

mkdocstrings/templates/crystal/material/style.css

@@ -0,0 +1,14 @@
+/* Prevent all-caps names in headings */
+h5.doc-heading {
+  text-transform: none !important;
+}
+
+/* [View source] links don't have brackets by default */
+a.doc-source-link::before {
+  content: "[";
+  color: var(--md-typeset-color);
+}
+a.doc-source-link::after {
+  content: "]";
+  color: var(--md-typeset-color);
+}