Update docs

MaddyGuthridge · MaddyGuthridge · commit 6730aa7f9d31 · 2024-09-06T03:10:50.000+10:00
diff --git a/docs/api.md b/docs/api.md
@@ -7,8 +7,8 @@
       members:
         - children
         - attributes
-        - render
         - "_get_tag_name"
         - "_get_default_attributes"
         - "_get_tag_pre_content"
+        - "_render"
         - "_escape_children"
diff --git a/docs/learn/.pages b/docs/learn/.pages
@@ -0,0 +1,4 @@
+nav:
+    - index.md
+    - Cheatsheet: cheatsheet.md
+    - Advanced PyHTML: advanced.md
diff --git a/docs/learn/advanced.md b/docs/learn/advanced.md
@@ -147,30 +147,5 @@ class fancy(p.Tag):
     pass
 ```
 
-### Class properties
-
-If you need to access
-
-* `children`: child elements
-* `attributes`: element attributes
-
-### Rendering control functions
-
-You can also override various functions to control the existing rendering.
-
-* `_get_tag_name`: return the name to use for the tag. For example returning
-  `"foo"` would produce `<foo>`.
-
-* `_get_default_attributes`: return the default values for attributes.
-
-* `_get_tag_pre_content`: return the pre-content for the tag. For example, the
-  `<html>` tag uses this to add the `<!DOCTYPE html>` before the opening tag.
-
-* `_escape_children`: return whether the string child elements should be
-  escaped to prevent HTML injection.
-
-* `_render`: render the element and its children, returning the list of lines
-  to use for the output. Overriding this should be a last resort, as it is easy
-  to subtly break the rendering process if you aren't careful.
-
-Refer to the documentation of the `Tag` class for more information.
+For documentation on the attributes and methods of `Tag`, see the
+[API documentation](../api.md).
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
@@ -1,29 +1,13 @@
 :root>* {
-    /* Fix up the primary colours */
-    --md-primary-fg-color: #ffcd29 !important;
-    --md-accent-fg-color: #ffcd29 !important;
-    --md-primary-fg-color--light: #ffe08a !important;
-    --md-primary-fg-color--dark: #ad7a0b !important;
-    --md-accent-fg-color--light: #ffc38a !important;
-    --md-accent-fg-color--dark: #ad740b !important;
-    --md-typeset-a-color: #ffc853 !important;
+    /* Link hover color */
+    --md-accent-fg-color: #d6a400 !important;
+    /* Title bar color */
+    --md-primary-fg-color: #ffdf77 !important;
 }
 
 .md-header {
     /* Text colour on header */
-    color: #ffffff !important;
-}
-
-/* Search box background */
-@media screen and (min-width: 60em) {
-    .md-search__form {
-        background-color: #ffffff42 !important;
-    }
-}
-
-/* Search icon color */
-.md-search__icon {
-    color: #ececec !important;
+    color: #000000 !important;
 }
 
 div.md-header__topic:first-child {
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -12,13 +12,15 @@ theme:
   palette:
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
-      primary: orange
+      primary: yellow
+      accent: orange
       toggle:
         icon: material/lightbulb-outline
         name: Switch to light mode
     - media: "(prefers-color-scheme: light)"
       scheme: default
-      primary: orange
+      primary: yellow
+      accent: orange
       toggle:
         icon: material/lightbulb
         name: Switch to dark mode
