Make theme match system theme (#107)

Also add icons to index

Author: drhagen

docs/alternative_parsers.md

@@ -1,3 +1,7 @@
+---
+icon: material/directions-fork
+---
+
 # Alternative parsers
 
 ## `parser1 | parser2`: alternative parser

docs/contributing.md

@@ -1,3 +1,7 @@
+---
+icon: material/hand-heart
+---
+
 # Contributing
 
 Parsita is free and open source software developed under an MIT license. Development occurs at the [GitHub project](https://github.com/drhagen/parsita). Contributions, big and small, are welcome.

docs/conversion_parsers.md

@@ -1,3 +1,7 @@
+---
+icon: material/function
+---
+
 # Conversion parsers
 
 ## `parser > function`: conversion parser

docs/getting_started.md

@@ -1,3 +1,7 @@
+---
+icon: material/sign-direction
+---
+
 # Getting started
 
 David Hagen gave an [introductory talk](https://www.youtube.com/watch?v=9JSGGSRgUcw) on Parsita at SciPy 2021. The documentation is more thorough, but the talk is useful for anyone looking for a quick walk-through.
@@ -29,7 +33,7 @@ In version 1 of Parsita, `ParserContext` was split into two context classes, one
 
 ### `Parser.parse`
 
-The only method of note on a `Parser` is the `parse` method. The `parse` method takes a `str` as as argument and returns an instance of the `Result` class, which has two subclasses `Success` and `Failure`. Note that in v2.0, these classes are reexported by Parsita, but are defined by the popular Returns package in [`returns.result`](https://returns.readthedocs.io/en/latest/pages/result.html). By using the `Result` class from Returns, Parsita's error handling can be composed with that of other libraries that use Returns. 
+The only method of note on a `Parser` is the `parse` method. The `parse` method takes a `str` as as argument and returns an instance of the `Result` class, which has two subclasses `Success` and `Failure`. Note that in v2.0, these classes are reexported by Parsita, but are defined by the popular Returns package in [`returns.result`](https://returns.readthedocs.io/en/latest/pages/result.html). By using the `Result` class from Returns, Parsita's error handling can be composed with that of other libraries that use Returns.
 
 Instances of `Result` work especially well with pattern matching in the `match` statement introduced in Python 3.10:
 

docs/index.md

@@ -1,3 +1,7 @@
+---
+icon: material/home
+---
+
 # Parsita
 
 Parsita is a parser combinator library written in Python. Parser combinators provide an easy way to define a grammar using code so that the grammar itself effectively parses the source. They are not the fastest at parsing, but they are the easiest to write.

docs/miscellaneous_parsers.md

@@ -1,3 +1,7 @@
+---
+icon: material/shape-plus
+---
+
 # Miscellaneous parsers
 
 ## `pred(parser, predicate, description)`: predicate parser
@@ -141,6 +145,6 @@ class NumberParsers(ParserContext):
     scientific = reg(r'[-+]?[0-9]+e[-+]?[0-9]+') > float
     number = decimal | scientific | integer
 
-# Assertion is broken and needs debugged 
+# Assertion is broken and needs debugged
 assert isinstance(NumberParsers.number.parse('1e5').unwrap(), float)
 ```

docs/repeated_parsers.md

@@ -1,3 +1,7 @@
+---
+icon: material/repeat-variant
+---
+
 # Repeated parsers
 
 ## `rep(parser, min=0, max=inf)` and `rep1(parser)`: repeated parsers

docs/sequential_parsers.md

@@ -1,3 +1,7 @@
+---
+icon: material/plus
+---
+
 # Sequential parser
 
 ## `parser1 & parser2`: sequential parser

docs/terminal_parsers.md

@@ -1,3 +1,7 @@
+---
+icon: material/text-recognition
+---
+
 # Terminal parsers
 
 Terminal parsers (those created by `lit` and `reg`) are the atoms of a parser, they match and extract the smallest meaningful words of the language.

docs/utility_functions.md

@@ -1,3 +1,7 @@
+---
+icon: material/tools
+---
+
 # Utility functions
 
 There are several utility functions, `constant`, `splat`, and `unsplat`. They are mostly useful when used with the conversion parser (`>`). These utility functions are not exported by `from parsita import *` and must be imported from `parsita.util`.

mkdocs.yml

@@ -18,18 +18,24 @@ theme:
     repo: fontawesome/brands/github
 
   palette:
-    - scheme: default
+    - media: "(prefers-color-scheme)"
+      toggle:
+        icon: material/link
+        name: Switch to light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
       primary: black
       accent: yellow
       toggle:
         icon: material/weather-sunny
         name: Switch to dark mode
-    - scheme: slate
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
       primary: yellow
       accent: deep orange
       toggle:
         icon: material/weather-night
-        name: Switch to light mode
+        name: Switch to system preference
 
 markdown_extensions:
   - pymdownx.highlight