initial commit

mkdocs.yaml

@@ -0,0 +1,74 @@
+# https://www.mkdocs.org/user-guide/configuration/
+site_name: RSE@PSI
+copyright: © Paul Scherrer Institute (PSI) | Content under CC0 License
+nav:
+  - Home: 'home.md'
+  - About: 'about.md'
+  - FAQ: 'faq.md'
+  - Blog: 'blog/index.md'
+theme: # https://www.mkdocs.org/user-guide/choosing-your-theme/#readthedocs
+  name: material
+  custom_dir: docs/_overrides
+  logo: _static/logos/logo_rse.svg
+  favicon: _static/logos/logo_rse.svg
+  highlightjs: true
+  navigation_depth: 4
+  features:
+    - navigation.instant
+    - navigation.instant.progress
+    - navigation.expand
+    - navigation.path
+    - navigation.indexes
+    - navigation.top
+    - content.footnote.tooltips
+    - announce.dismiss
+  palette: 
+
+    # Palette toggle for light mode
+    - scheme: default
+      toggle:
+        icon: material/brightness-7 
+        name: Switch to dark mode
+
+    # Palette toggle for dark mode
+    - scheme: slate
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+plugins:
+  - search
+  - autorefs
+  - include-markdown
+  - blog
+markdown_extensions:
+  - admonition
+  - pymdownx.superfences
+  - toc:
+      permalink: true
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.snippets
+  - pymdownx.highlight:
+      use_pygments: false
+extra:
+  social:
+    - icon: fontawesome/brands/mastodon 
+      link: https://fosstodon.org/@squidfunk
+
+extra_javascript:
+  - _javascripts/katex.js
+  # https://cdnjs.com/libraries/KaTeX
+  # unpkg is incredibly slow (17s to load the css file)
+  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.js
+  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/contrib/auto-render.min.js
+extra_css:
+  # https://cdnjs.com/libraries/KaTeX
+  # unpkg is incredibly slow (17s to load the css file)
+  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.css
+  - _css/extra.css
+
+watch:
+  - docs
+
+extra:
+  generator: false