mkdocs.yml

site_name: MSFabricUtils
site_description: A DuckDB connection wrapper for Microsoft Fabric Lakehouses
repo_url: https://github.com/mrjsj/msfabricutils
repo_name: mrjsj/msfabricutils

theme:
  name: material
  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
  navigation_depth: 3
  features:
    - navigation.tracking
    - navigation.instant
    - navigation.expand
    - navigation.tabs
    - navigation.indexes
    - navigation.tabs.sticky
    - navigation.footer
    - content.tabs.link
    - content.code.annotation
    - content.code.copy

plugins:
  - search:
      lang: en
  - include_dir_to_nav
  - gen-files:
      scripts:
        - docs/gen_ref_pages.py
  - mkdocstrings:
      default_handler: python
      handlers:
        python:
          paths: [src]
          options:
            show_root_toc_entry: true
            docstring_style: google
            show_source: false
            show_root_heading: false
            filters: ["!^_", "^__init__$"]
            show_object_full_path: false
            heading_level: 2
            members_order: source
            separate_signature: true
            show_signature_annotations: true
            docstring_section_style: table
            show_if_no_docstring: false

nav:
  - Home:
    - index.md
  - Usage:
    - usage/installation.md
    - usage/cli.md
    - usage/etl.md
    - usage/fabric-api.md
  - API Reference:
    - Core:
      - core/authentication.md
      - Fabric API: core/fabric-api
    - ETL:
      - etl/index.md
      - etl/read.md
      - etl/transform.md
      - etl/load.md
    - Other:
      - other/index.md
      - other/fabric-duckdb-connection.md
      - other/utilities.md

# Formatting options
markdown_extensions:
  - admonition
  - pymdownx.details
  - attr_list
  - pymdownx.superfences
  - tables
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.snippets:
      base_path: ['.','docs/source/src/']
      check_paths: true
      dedent_subsections: true
  - footnotes
  - pymdownx.arithmatex:
      generic: true