initial move to mkdocs, lots of broken stuff to fix still

Signed-off-by: Karel van Klink <karel.vanklink@geant.org>

.gitignore

@@ -6,5 +6,6 @@ venv/
 
 # Documentation
 docs/build
-docs/vale/styles/*
-!docs/vale/styles/Vocab/
+vale/styles/*
+!vale/styles/Vocab/
+site/

.gitlab-ci.yml

@@ -6,3 +6,15 @@ stages:
 include:
   # Documentation pipelines, both building and linting
   - local: '/docs/.gitlab-ci.yml'
+
+#image: python:latest
+#pages:
+#  stage: deploy
+#  script:
+#    - pip install mkdocs-material
+#    - mkdocs build --site-dir public
+#  artifacts:
+#    paths:
+#      - public
+#  rules:
+#    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'

docs/Makefile

-# Minimal makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line, and also
-# from the environment for the first two.
-SPHINXOPTS    ?=
-SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = .
-BUILDDIR      = build
-
-# Put it first so that "make" without argument is like "make help".
-help:
-	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-
-.PHONY: help Makefile
-
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/assets/stylesheets/extra.css

+:root {
+  --md-primary-fg-color:        #EE0F0F;
+  --md-primary-fg-color--light: #ECB7B7;
+  --md-primary-fg-color--dark:  #90030C;
+}

docs/static/custom.css

-.wy-menu > p > span {
-    color: rgb(237 21 86);
-}

mkdocs.yml

+# General
+site_name: Geant Automation Platform
+site_url: https://docs.gap.geant.org/
+site_author: GÉANT Orchestration and Automation Team
+site_description: General documentation for the GÉANT Automation Platform
+
+# Repository
+repo_name: goat/gap/geant-automation-platform
+repo_url: https://gitlab.software.geant.org/goat/gap/geant-automation-platform
+
+# Theme
+theme:
+  name: material
+  palette:
+    primary: custom
+extra_css:
+  - static/stylesheets/extra.css
+
+# Page tree
+nav:
+  - Home: index.md
+  - Architecture:
+      - Overview: overview/index.md
+      - Modeling:
+        - modeling/index.md
+        - Ports: modeling/ports.md