add named colors and themes (#206)

Update the docs to include discussion of named colors and
the available themes.

Author: brharrington

docs/api/graph/color-palettes.md

@@ -53,11 +53,11 @@ for the dark theme. Overall there are 24 distinct colors with this palette.
 [Polychrome light palette]: https://rdrr.io/rforge/Polychrome/man/palettes.html
 
 @@@ atlas-uri { hilite=palette%3Dlight24 }
-/api/v1/graph?e=2012-01-01T09:00&no_legend=1&palette=light24&stack=1&tz=UTC&q=1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
+/api/v1/graph?e=2012-01-01T09:00&no_legend=1&palette=light24&theme=dark&stack=1&tz=UTC&q=1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
 @@@
 
 @@@ atlas-graph { show-expr=false }
-/api/v1/graph?e=2012-01-01T09:00&no_legend=1&palette=light24&stack=1&tz=UTC&q=1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
+/api/v1/graph?e=2012-01-01T09:00&no_legend=1&palette=light24&theme=dark&stack=1&tz=UTC&q=1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
 @@@
 
 ## Epic

docs/api/graph/theme.md

@@ -0,0 +1,21 @@
+Two themes are supported: `light` and `dark`. The default is the `light` theme.
+
+## Light
+
+@@@ atlas-uri { hilite=theme%3Dlight }
+/api/v1/graph?e=2012-01-01T09:00&no_legend=1&theme=light&stack=1&tz=UTC&q=1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
+@@@
+
+@@@ atlas-graph { show-expr=false }
+/api/v1/graph?e=2012-01-01T09:00&no_legend=1&theme=light&stack=1&tz=UTC&q=1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
+@@@
+
+## Dark
+
+@@@ atlas-uri { hilite=theme%3Ddark }
+/api/v1/graph?e=2012-01-01T09:00&no_legend=1&theme=dark&stack=1&tz=UTC&q=1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
+@@@
+
+@@@ atlas-graph { show-expr=false }
+/api/v1/graph?e=2012-01-01T09:00&no_legend=1&theme=dark&stack=1&tz=UTC&q=1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
+@@@

docs/asl/ref/color.md

@@ -12,6 +12,15 @@ Set the color for the line. The value should be one of:
 * 6 digit hex RBG, e.g. ff0000 is red.
 * 8 digit hex ARGB, e.g. ffff0000 is red. The first byte is the [alpha](alpha.md)
   setting to use with the color.
+* Named colors. These are useful when working with [themes](../../api/graph/theme.md), they provide
+  a few shades for some common colors. The specific colors will vary based on the theme to ensure
+  they have good contrast with the background color. Available options:
+    * `blue1`, `blue2`, `blue3`
+    * `gray1`, `gray2`, `gray3`
+    * `green1`, `green2`, `green3`
+    * `orange1`, `orange2`, `orange3`
+    * `purple1`, `purple2`, `purple3`
+    * `red1`, `red2`, `red3`
 
 For queries with multiple time series, color palettes are available to automatically assign
 different colors to the various series. See [Color Palettes](../../api/graph/color-palettes.md).

mkdocs.yml

@@ -31,6 +31,7 @@ nav:
     - Line Styles: api/graph/line-styles.md
     - Multi Y Axis: api/graph/multi-y.md
     - Output Formats: api/graph/outputs.md
+    - Themes: api/graph/theme.md
     - Tick Labels: api/graph/tick.md
     - Time Shift: api/graph/time-shift.md
     - Time Zones: api/graph/time-zone.md