#1 Initial commit

.gitattributes

+*.gif filter=lfs diff=lfs merge=lfs -text
+*.ico filter=lfs diff=lfs merge=lfs -text
+*.jpeg filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.mp4 filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.xlsx filter=lfs diff=lfs merge=lfs -text
+*.tar.gz filter=lfs diff=lfs merge=lfs -text
+*.webp filter=lfs diff=lfs merge=lfs -text

.gitignore

+/.cache/
+/site/
+/.ahoy.l3d
+/.env
+/docs/diagrams/uml/out/
+/docs/__pycache__/

.gitlab-ci.yml

+stages:
+  - build
+  - deploy
+
+Build:
+  stage: build
+  tags:
+    - default
+  script:
+    - export WORKDIR=$(php /usr/local/bin/volume.php | cut -d":" -f 1)/apbs/documentation
+    - echo "WorkDir is ${WORKDIR}"
+    - docker-compose up -d
+    - sleep 20
+    - docker-compose exec -T --workdir=/mkdocs mkdocs mkdocs build
+    - docker-compose down
+  artifacts:
+    name: build
+    when: always
+    paths:
+      - site/
+  only:
+    - main
+
+Deploy:
+  stage: deploy
+  tags:
+    - ansible
+  variables:
+    GIT_STRATEGY: none
+  script:
+    - a -m synchronize -a "src=${PWD}/site/ dest=/var/www/docs/apbs delete=yes" --limit=bsdevop1
+  cache: {}
+  only:
+    - main

ahoy.mkdocs.yml

+ahoyapi: v2
+commands:
+  up:
+    cmd: |
+      docker-compose up -d
+      echo "Open site in browser: http://127.0.0.1:8999"
+      echo "It may take a few seconds before the server is up and running."
+    usage: Start MkDocs server.
+  down:
+    cmd: docker-compose down
+    usage: Stop MkDocs server and remove container.
+  stop:
+    cmd: docker-compose stop
+    usage: Stop MkDocs server.
+  restart:
+    cmd: docker-compose restart
+    usage: Restart MkDocs server.
+  logs:
+    cmd: docker-compose logs -f
+    usage: Show logs from MkDocs server.
+  build:
+    cmd: docker-compose exec --workdir=/mkdocs mkdocs mkdocs build
+    usage: Builds the documentation in site directory.

docker-compose.yml

+services:
+  mkdocs:
+    container_name: mkdocs
+    image: registry.lakedrops.com/docker/mkdocs:1.6.0.3
+    restart: unless-stopped
+    ports:
+      - 8999:8000
+    environment:
+      LIVE_RELOAD_SUPPORT: 'true'
+      FAST_MODE: 'true'
+      DOCS_DIRECTORY: /mkdocs
+    volumes:
+      - ${WORKDIR}:/mkdocs

docs/stylesheets/extra.css

+/* Repository Sidebar Link */
+.md-sidebar__inner .md-header-nav__source {
+  margin-left: 0;
+  margin-bottom: 0.8rem;
+}

mkdocs.yml

+site_name: APBS - Tierpension Verwaltung
+site_url: https://apbs.docs.lakedrops.com
+site_description: Dokumentation zum Verwaltungs-System APBS für Tierpensionen
+dev_addr: 127.0.0.1:8000
+theme:
+  name: material
+  custom_dir: overrides
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      toggle:
+          icon: material/toggle-switch-off-outline
+          name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: indigo
+      accent: yellow
+      toggle:
+          icon: material/toggle-switch
+          name: Switch to light mode
+  font: false
+  logo: images/logo.png
+  favicon: images/favicon.ico
+  icon:
+    repo: fontawesome/brands/gitlab
+  features:
+    - navigation.instant
+    - navigation.indexes
+    - navigation.sections
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.tracking
+    - navigation.top
+    - search.highlight
+    - search.share
+    - search.suggest
+    - toc.follow
+repo_name: APBS Dokumentation
+repo_url: https://gitlab.lakedrops.com/apbs/documentation
+validation:
+  nav:
+    absolute_links: info
+    not_found: warn
+    omitted_files: info
+  links:
+    absolute_links: relative_to_docs
+    anchors: warn
+    not_found: warn
+    unrecognized_links: info
+extra:
+  social:
+    - icon: fontawesome/brands/gitlab
+      link: https://gitlab.lakedrops.com/apbs/documentation
+extra_css:
+  - stylesheets/extra.css
+markdown_extensions:
+  - admonition
+  - attr_list
+  - def_list
+  - markdown_include.include
+  - pymdownx.details
+  - pymdownx.highlight:
+      linenums: True
+  - pymdownx.inlinehilite
+  - pymdownx.superfences
+  - toc:
+      permalink: True
+plugins:
+  - build_plantuml:
+      render: "server"
+      server: "http://www.plantuml.com/plantuml"
+      output_format: "svg"
+      diagram_root: "docs/diagrams/uml"
+      output_folder: "out"
+      input_folder: "src"
+      input_extensions: ""
+  - git-authors
+  - git-revision-date-localized:
+      type: datetime
+  - mkdocs-backlinks:
+      ignored_pages: [ 'Tags', 'Home' ]
+  - mkdocs-simple-hooks:
+      hooks:
+        on_config: "docs.hooks:append_nav"
+  - mkdocs-video
+  - search:
+      lang: en
+  - social:
+      cards_layout_options:
+        background_color: '#CC0000'
+  - tags:
+      tags_file: tags.md
+nav:
+  - APBS:
+      - index.md
+  - Konfiguration:
+      - index.md