mkdocs.yml

# Project Information
site_name: icon.gl
site_url: https://www.icon.gl/
site_description: Identity Framework
site_author: Scape Agency
lang: en

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

dev_addr: 127.0.0.1:8888

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


# hide:
#   - footer

# 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

# Customization
extra:
  generator: false
  analytics:
    provider: google
    property: G-W6XEMQ15PJ
  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
  # - 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.inlinehilite
  # - 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


# Page Tree
# =============================================================================

nav:
  - Introduction: 'index.md'
  - Quick Start: 'quick_start.md'
  - Specifications:
      - 'Overview': 'specifications/index.md'
      - 'Features': 'specifications/features.md'
      - 'Design Principles': 'specifications/design_principles.md'
      - 'Layout Areas': 'specifications/layout_areas.md'
      - 'Grid Layouts': 'specifications/grid_layouts.md'
      - 'Icon Sizes': 'specifications/icon_sizes.md'
      - 'Keyline Shapes': 'specifications/keyline_shapes.md'
      - 'Lines': 'specifications/lines.md'
      - 'Scales': 'specifications/scales.md'
  - Icons:
      - 'Overview': 'icons/index.md'
  - Templates:
      - 'Overview': 'templates/index.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'