mkdocs.yml

# Project Information
# =============================================================================

site_name: unit.gl
site_url: https://www.unit.gl/
site_description: Identity Framework
site_author: Scape Agency
lang: en

docs_dir: doc

dev_addr: 127.0.0.1:8888


# Repository
# =============================================================================

repo_name: 'GitHub'
repo_url: https://github.com/stylescape/unit.gl/
edit_uri_template: 'docs/{path}'




# Page tree
# =============================================================================

nav:
  - Introduction: 'index.md'
  - Quick Start: 'quick_start.md'
  - Specifications:
      - 'Overview': 'specifications/index.md'
      - 'Features': 'specifications/features.md'
      - 'Unit System': 'specifications/unit_system.md'
  - Resources:
      - 'Glossary': 'resources/glossary.md'
      - 'Links': 'resources/links.md'
  - About:
      - 'Authors': 'about/authors.md'
  - Legal Information:
      - 'License': 'legal/license.md'
      - 'Privacy Policy': 'legal/privacy_policy.md'
      - 'Disclaimer': 'legal/disclaimer.md'



# Theme Configuration
# =============================================================================

theme:
  name: material
  custom_dir: 'docs/overrides'
  locale: en
  language: en
  palette:
    scheme: stylescape
  # palette:
  #   - scheme: default
  #     primary: indigo
  #     accent: indigo
  #     toggle:
  #       icon: material/brightness-7
  #       name: Switch to dark mode
  #   - scheme: slate
  #     primary: indigo
  #     accent: indigo
  #     toggle:
  #       icon: material/brightness-4
  #       name: Switch to light mode
  # font:
  #   text: 'Manrope'
  #   code: 'Roboto Mono'
  logo: assets/image/stylescape-logo-transparent.png
  favicon: assets/favicon/favicon.ico
  features:
    # - announce.dismiss
    # - content.action.edit
    # - content.action.view
    # - content.code.annotate
    # - content.code.copy
    # - content.tabs.link
    - content.tooltips
    # - header.autohide
    # - navigation.expand
    - navigation.footer
    - navigation.indexes
    # - navigation.instant
    # - navigation.prune
    # - navigation.sections
    # - navigation.tabs
    # - navigation.tabs.sticky
    # - navigation.top
    - navigation.tracking
    - search.highlight
    - search.share
    - search.suggest
    - toc.follow
    # - toc.integrate




# Plugins
# =============================================================================

plugins:
  - search:
      lang: en
      separator: '[\s\-,:!=\[\]()"/]+|(?!\b)(?=[A-Z][a-z])|\.(?!\d)|&[lg]t;'
  - mkdocstrings:
  #   custom_templates: templates
      default_handler: python
      handlers:
        python:
          options:
            # Heading options
            heading_level: 2
            show_root_heading: false
            show_root_toc_entry: false
            show_root_full_path: false
            show_root_members_full_path: false
            show_object_full_path: false
            show_category_heading: false
            # Additional options
            show_bases: true
            show_source: false






# Footer
# =============================================================================

# Copyright
copyright: >
  Copyright &copy; 2024 <a href="https://www.scape.agency">Scape Agency</a>. All Rights Reserved.


# hide:
#   - footer




# Customization
# =============================================================================

extra:
  generator: false
  analytics:
    provider: google
    property: G-9MH8876529
  social:
    - icon: fontawesome/solid/globe
      link: https://www.scape.agency
    - icon: fontawesome/brands/github
      link: https://github.com/stylescape/
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/company/scape-agency/
    - icon: fontawesome/brands/instagram
      link: https://www.instagram.com/scape.agency/
    - icon: fontawesome/brands/facebook
      link: https://www.facebook.com/scape.agency/
  # consent:
  #   title: Cookie consent
  #   description: >-
  #     We use cookies to recognize your repeated visits and preferences, as well
  #     as to measure the effectiveness of our documentation and whether users
  #     find what they're searching for. With your consent, you're helping us to
  #     make our documentation better.
extra_css:
  - assets/style/extra.css
extra_javascript:
  - assets/script/extra.js
# extra_templates:




# Extensions
# =============================================================================

markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - codehilite
  - toc:
      permalink: true
  # - pymdownx.arithmatex:
  #     generic: true
  # - pymdownx.betterem:
  #     smart_enable: all
  # - pymdownx.caret
  # - pymdownx.details
  # - pymdownx.emoji:
  #     emoji_generator: !!python/name:materialx.emoji.to_svg
  #     emoji_index: !!python/name:materialx.emoji.twemoji
  # - pymdownx.highlight:
  #     anchor_linenums: true
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.superfences
  - pymdownx.tabbed
  - pymdownx.details
  - pymdownx.inlinehilite
  - pymdownx.snippets
  # - pymdownx.keys
  - pymdownx.magiclink:
      repo_url_shorthand: true
      user: squidfunk
      repo: mkdocs-material
  # - pymdownx.mark
  # - pymdownx.smartsymbols
  # - pymdownx.superfences:
  #     custom_fences:
  #       - name: mermaid
  #         class: mermaid
  #         format: !!python/name:pymdownx.superfences.fence_code_format
  # - pymdownx.tabbed:
  #     alternate_style: true
  # - pymdownx.tasklist:
  #     custom_checkbox: true
  # - pymdownx.tilde