[docs] Enable some new features (#2623)

* [docs] Enable a bunch of markdown extensions

* details makes admonitions collapsible and when started with ???
  instead of !!! they'll be collpased by default
* highlights are updated to include linenums by default but with a style
  that doesn't result in the linenums to be copy-pasted when selecting
  and pasting. This makes it possible to directly link to a specific
  line in the documentation instead of just the general page
* caret, mark and tilde make it possible to highlight text and have
  super/subscripts
* keys turns combos like `++ctrl+alt+del++` into HTML key elements
  showing a keyboard combination to press
* tabbed makes it possible to have tabs within a document. Right now we
  have different sections sometimes to show the config for nginx, apache
  and Caddy, which can be turned into tabs instead and which tab is
  picked will get remebered
* smartsymbols turns certain things, like `(c)` in the right symbol ©

* [docs] Upgrade all the python dependencies

* [docs] Explain how to update conda deps

docs/environment.yml

@@ -3,12 +3,12 @@ channels:
   - conda-forge
   - nodefaults
 dependencies:
-  - python=3.11.3=h2755cc3_0_cpython
-  - pip=23.1.2=pyhd8ed1ab_0
-  - mkdocs=1.4.3=pyhd8ed1ab_0
-  - mkdocs-material=9.1.9=pyhd8ed1ab_0
-  - mkdocs-material-extensions=1.1.1=pyhd8ed1ab_0
-  - pillow=9.5.0=py311h573f0d3_0
-  - cairosvg=2.6.0=pyhd8ed1ab_0
+  - cairosvg==2.7.1
+  - mkdocs-material-extensions==1.3.1
+  - mkdocs-material==9.5.8
+  - mkdocs==1.5.3
+  - pillow==10.0.0
+  - pip==23.3.1
+  - python==3.11.3=h2755cc3_0_cpython
   - pip:
-      - mkdocs-swagger-ui-tag==0.6.1
+    - mkdocs-swagger-ui-tag==0.6.8