Update docs

- Update theme
- Use a more common admonition/details convention
- Update copyright

Author: facelessuser

LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018 - 2025 Isaac Muse <isaacmuse@gmail.com>
+Copyright (c) 2018 - 2026 Isaac Muse <isaacmuse@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

docs/src/markdown/about/changelog.md

@@ -7,7 +7,7 @@ icon: lucide/scroll-text
 
 -   **FIX**: Ensure custom selectors or namespace dictionaries reject non-string keys (@mundanevision20).
 -   **FIX**: Fix handling of `:in-range` and `:out-of-range` with end of year weeks (@mundanevision20).
--   **FIX**: Fix a potential infinite loop in pretty printing of compiled selector objects (@mundanevision20).
+-   **FIX**: Fix a potential infinite loop in pretty printing debug function (@mundanevision20).
 
 ## 2.8.1
 
@@ -120,8 +120,7 @@ icon: lucide/scroll-text
 
 ## 1.9.6
 
-/// note | Last version for Python 2.7
-///
+> [!note] Last version for Python 2.7
 
 -   **FIX**: Prune dead code.
 -   **FIX**: Corner case with splitting namespace and tag name that have an escaped `|`.

docs/src/markdown/about/development.md

@@ -40,8 +40,7 @@ Documents are in Markdown (with some additional syntax provided by extensions) a
 Markdown. If you would like to build and preview the documentation, you must have these packages installed:
 
 -   @Python-Markdown/markdown: the Markdown parser.
--   @mkdocs/mkdocs: the document site generator.
--   @squidfunk/mkdocs-material: a material theme for MkDocs.
+-   @zensical/zensical: the document site generator.
 -   @facelessuser/pymdown-extensions: this Python Markdown extension bundle.
 
 It is advised that you just install document dependencies with the following as the above list may not include all
@@ -56,7 +55,7 @@ able to view the documents at `localhost:8000` in your browser. After that, you
 and have your browser preview update live.
 
 ```
-mkdocs serve
+python3 -m zensical serve -f zensical.yml
 ```
 
 ## Spell Checking Documents
@@ -75,7 +74,7 @@ run the following command from the root of the project.
 You will need to make sure the documents are built first:
 
 ```
-mkdocs build --clean
+python3 -m zensical build --clean -f zensical.yml
 ```
 
 And then run the spell checker.

docs/src/markdown/api.md

@@ -23,13 +23,12 @@ change.
     parser). Some additional configuration is required when using namespaces, see [Namespace](#namespaces) for more
     information.
 
-    /// tip | Getting Proper Namespaces
-    The `html5lib` parser provides proper namespaces for HTML5, but `lxml`'s HTML parser will not. If you need
-    namespace support for HTML5, consider using `html5lib`.
-
-    For XML, the `lxml-xml` parser (`xml` for short) will provide proper namespaces. It is generally suggested that
-    `lxml-xml` is used to parse XHTML documents to take advantage of namespaces.
-    ///
+    > [!tip] Getting Proper Namespaces
+    > The `html5lib` parser provides proper namespaces for HTML5, but `lxml`'s HTML parser will not. If you need
+    > namespace support for HTML5, consider using `html5lib`.
+    > 
+    > For XML, the `lxml-xml` parser (`xml` for short) will provide proper namespaces. It is generally suggested that
+    > `lxml-xml` is used to parse XHTML documents to take advantage of namespaces.
 
 -   While attribute values are generally treated as case sensitive, HTML5 and HTML treat the `type` attribute
     special. The `type` attribute's value is always case insensitive. This is generally how most browsers treat `type`.
@@ -184,9 +183,8 @@ would normally cause an identifier to be invalid.
 '�'
 ```
 
-/// new | New in 1.9.0
-`escape` is a new API function added in 1.9.0.
-///
+> [!new] New in 1.9.0
+> `escape` is a new API function added in 1.9.0.
 
 ## `soupsieve.compile()`
 

docs/src/markdown/faq.md

@@ -17,9 +17,8 @@ feature that Soup Sieve cannot/will not support, see [Beautiful Soup Differences
 
 ## How does `iframe` handling work?
 
-/// note
-Recent versions of Python's `html.parser`, `lxml`, and `html5lib` all seem to escape `iframe` content.
-///
+> [!note]
+> Recent versions of Python's `html.parser`, `lxml`, and `html5lib` all seem to escape `iframe` content.
 
 In web browsers, CSS selectors do not usually select content inside an `iframe` element if the selector is called on an
 element outside of the `iframe`. Each HTML document is usually encapsulated and CSS selector leakage across this

docs/src/markdown/selectors/basic.md

@@ -47,9 +47,8 @@ element
 ```
 ///
 
-/// tip | Additional Reading
-https://developer.mozilla.org/en-US/docs/Web/CSS/Type_selectors
-///
+> [!tip] Additional Reading
+> https://developer.mozilla.org/en-US/docs/Web/CSS/Type_selectors
 
 ## Universal Selectors
 
@@ -90,9 +89,8 @@ The Universal selector (`*`) matches elements of any type.
 ```
 ///
 
-/// tip | Additional Reading
-https://developer.mozilla.org/en-US/docs/Web/CSS/Universal_selectors
-///
+> [!tip] Additional Reading
+> https://developer.mozilla.org/en-US/docs/Web/CSS/Universal_selectors
 
 ## ID Selectors
 
@@ -122,14 +120,12 @@ The ID selector matches an element based on its `id` attribute. The ID must matc
 ```
 ///
 
-/// tip | Additional Reading
-https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors
-///
+> [!tip] Additional Reading
+> https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors
 
-/// note | XML Support
-While the use of the `id` attribute (in the context of CSS) is a very HTML centric idea, it is supported for XML as
-well because Beautiful Soup supported it before Soup Sieve's existence.
-///
+> [!note] XML Support
+> While the use of the `id` attribute (in the context of CSS) is a very HTML centric idea, it is supported for XML as
+> well because Beautiful Soup supported it before Soup Sieve's existence.
 
 ## Class Selectors
 
@@ -160,23 +156,20 @@ treated as a whitespace separated list, where each item is a **class**.
 ```
 ///
 
-/// tip | Additional Reading
-https://developer.mozilla.org/en-US/docs/Web/CSS/Class_selectors
-///
+> [!tip] Additional Reading
+> https://developer.mozilla.org/en-US/docs/Web/CSS/Class_selectors
 
-/// note | XML Support
-While the use of the `class` attribute (in the context of CSS) is a very HTML centric idea, it is supported for XML
-as well because Beautiful Soup supported it before Soup Sieve's existence.
-///
+> [!note] XML Support
+> While the use of the `class` attribute (in the context of CSS) is a very HTML centric idea, it is supported for XML
+> as well because Beautiful Soup supported it before Soup Sieve's existence.
 
 ## Attribute Selectors
 
 The attribute selector matches an element based on its attributes. When specifying a value of an attribute, if it
 contains whitespace or special characters, you should quote them with either single or double quotes.
 
-/// tip | Additional Reading
-https://developer.mozilla.org/en-US/docs/Web/CSS/Attribute_selectors
-///
+> [!tip] Additional Reading
+> https://developer.mozilla.org/en-US/docs/Web/CSS/Attribute_selectors
 
 /// define |
 `[attribute]`

docs/src/markdown/selectors/combinators.md

@@ -60,9 +60,8 @@ parent descendant
 ```
 ///
 
-/// tip | Additional Reading
-https://developer.mozilla.org/en-US/docs/Web/CSS/Descendant_combinator
-///
+> [!tip] Additional Reading
+> https://developer.mozilla.org/en-US/docs/Web/CSS/Descendant_combinator
 
 ## Child combinator
 
@@ -93,9 +92,8 @@ parent > child
 ```
 ///
 
-/// tip | Additional Reading
-https://developer.mozilla.org/en-US/docs/Web/CSS/Child_combinator
-///
+> [!tip] Additional Reading
+> https://developer.mozilla.org/en-US/docs/Web/CSS/Child_combinator
 
 ## General sibling combinator
 
@@ -127,9 +125,8 @@ prevsibling ~ sibling
 ```
 ///
 
-/// tip | Additional Reading
-https://developer.mozilla.org/en-US/docs/Web/CSS/General_sibling_combinator
-///
+> [!tip] Additional Reading
+> https://developer.mozilla.org/en-US/docs/Web/CSS/General_sibling_combinator
 
 ## Adjacent sibling combinator
 
@@ -161,9 +158,8 @@ prevsibling + nextsibling
 ```
 ///
 
-/// tip | Additional Reading
-https://developer.mozilla.org/en-US/docs/Web/CSS/Adjacent_sibling_combinator
-///
+> [!tip] Additional Reading
+> https://developer.mozilla.org/en-US/docs/Web/CSS/Adjacent_sibling_combinator
 
 --8<--
 selector_styles.md

docs/src/markdown/selectors/index.md

@@ -67,23 +67,22 @@ cases, we may adopt them as "custom" selectors.
 </tr>
 </table>
 
-/// tip | Additional Reading
-If usage of a selector is not clear in this documentation, you can find more information by reading these
-specification documents:
-
-[CSS Level 3 Specification](https://www.w3.org/TR/selectors-3/)
-: Contains the latest official document outlying official behaviors of CSS selectors.
-
-[CSS Level 4 Working Draft](https://www.w3.org/TR/selectors-4/)
-: Contains the latest published working draft of the CSS level 4 selectors which outlines the experimental new
-selectors and experimental behavioral changes.
-
-[HTML5](https://www.w3.org/TR/html50/)
-: The HTML 5.0 specification document. Defines the semantics regarding HTML.
-
-[HTML Living Standard](https://html.spec.whatwg.org/)
-: The HTML Living Standard document. Defines semantics regarding HTML.
-///
+> [!tip] Additional Reading
+> If usage of a selector is not clear in this documentation, you can find more information by reading these
+> specification documents:
+>
+> [CSS Level 3 Specification](https://www.w3.org/TR/selectors-3/)
+> : Contains the latest official document outlying official behaviors of CSS selectors.
+>
+> [CSS Level 4 Working Draft](https://www.w3.org/TR/selectors-4/)
+> : Contains the latest published working draft of the CSS level 4 selectors which outlines the experimental new
+> selectors and experimental behavioral changes.
+>
+> [HTML5](https://www.w3.org/TR/html50/)
+> : The HTML 5.0 specification document. Defines the semantics regarding HTML.
+>
+> [HTML Living Standard](https://html.spec.whatwg.org/)
+> : The HTML Living Standard document. Defines semantics regarding HTML.
 
 ## Selector Terminology