mkdocs.yaml

# SPDX-License-Identifier: Apache-2.0
#
# Copyright 2023 The Enola <https://enola.dev> Authors
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# https://squidfunk.github.io/mkdocs-material/creating-your-site/
# https://www.mkdocs.org/user-guide/configuration/

site_name: Enola.dev
site_url: https://www.enola.dev
repo_url: https://github.com/enola-dev/enola
edit_uri: blob/main/docs/
copyright: Copyright &copy; 2023 The Enola <https://enola.dev> Authors

nav:
  - News (Blog): blog/index.md
  - Introduction: index.md
  - Users:
      - Overview: use/index.md
      - Help: use/help/index.md
      - Example Model: use/library/index.md
      - DocGen: use/docgen/index.md
      # - List Entites:
      - Get Entity: use/get/index.md
      - Connectors: use/connector/index.md
      - Server: use/server/index.md
      - Rosetta: use/rosetta/index.md
      - ExecMD: use/execmd/index.md
  - Concepts:
      - Core: concepts/core.md
      - Architecture Diagrams: concepts/core-arch.md
      - Singularity: concepts/singularity.md
  - Developers:
      - Set-Up: dev/setup.md
      - IDE: dev/ide.md
      - Architecture: concepts/implementation.md
      - Code Conventions: dev/style.md
      - Protocol Buffer API: dev/proto/core.md
      - Bazel: dev/bazel.md
      - Dependencies: dev/dependencies.md
      - Contributor Guide: contributing.md
      - Code of Conduct: code-of-conduct.md
  # - Kubernetes:
  #     - Introduction: k8s/index.md
  #     - Demo: k8s/demo.md
  - Appendix:
      # - Playbooks: concepts/playbook.md
      - Comparison: concepts/other.md
      - Security Policy: SECURITY.md

theme:
  logo: images/enola-293_293-transparent.png
  favicon: images/enola-293_293-transparent.png
  name: material
  features:
    - content.action.edit
    - content.code.copy
    - navigation.footer
    - navigation.instant
    - navigation.tracking
    - navigation.expand
    - navigation.path
    - navigation.top
    # - navigation.sections
    # - navigation.tabs
    # - navigation.tabs.sticky
    - search.suggest
    - search.share
  font:
    text: Roboto
    code: Roboto Mono
  palette:
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: green
      accent: lime
      toggle:
        icon: material/brightness-7
        name: Switch to light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: green
      toggle:
        icon: material/brightness-4
        name: Switch to dark mode

markdown_extensions:
  - footnotes
  - tables
  - smarty
  - toc:
      permalink: true
  # https://squidfunk.github.io/mkdocs-material/reference/admonitions/
  - admonition
  - pymdownx.details
  # https://squidfunk.github.io/mkdocs-material/reference/code-blocks/
  - pymdownx.highlight:
      # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown-extensions/#highlight
      #anchor_linenums: true
      #line_spans: __span
      #pygments_lang_class: true
  # https://squidfunk.github.io/mkdocs-material/reference/diagrams/
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format

extra:
  analytics:
    provider: google
    property: G-W0WFEQPB8E
    feedback:
      title: Was this page helpful?
      ratings:
        - icon: material/heart
          name: This page was helpful
          data: 1
          note: >-
            Thanks for your feedback!
        - icon: material/heart-broken
          name: This page could be improved
          data: 0
          note: >-
            Thanks for your feedback! Please <a
            href="https://github.com/enola-dev/enola/issues/new/?title=[Feedback]+{title}&body=On+https://docs.enola.dev{url},+...&labels=documentation"
            target="_blank" rel="noopener">suggest how to improve this page</a>?

plugins:
  - search

  # https://github.com/mondeja/mkdocs-include-markdown-plugin (ASL)
  # Possible alternative: https://github.com/cmacmackin/markdown-include (GPL)
  - include-markdown

  - git-revision-date-localized:
      strict: false
      exclude:
        - dev/proto/*

  # TODO Activate the following plugin once I will pay $15/month for
  # https://squidfunk.github.io/mkdocs-material/insiders/

  # https://squidfunk.github.io/mkdocs-material/setup/adding-a-git-repository/?h=git#document-contributors
  # - git-committers:
  #     repository: enola-dev/enola
  #     branch: main

  # https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/
  # - blog