mkdocs.yml

site_name: KDP - Keras Data Preprocessor
site_url: https://unicolab.github.io/keras-data-processor
docs_dir: docs
theme:
  name: "material"
  icon:
    logo: material/atom
    admonition:
      note: octicons/tag-16
      abstract: octicons/checklist-16
      info: octicons/info-16
      tip: octicons/squirrel-16
      success: octicons/check-16
      question: octicons/question-16
      warning: octicons/alert-16
      failure: octicons/x-circle-16
      danger: octicons/zap-16
      bug: octicons/bug-16
      example: octicons/beaker-16
      quote: octicons/quote-16
  palette:
    # Light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: black
      accent: black
      toggle:
        icon: material/toggle-switch-off-outline
        name: Switch to dark mode
    # Dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: teal
      accent: teal
      toggle:
        icon: material/toggle-switch
        name: Switch to light mode

nav:
  - 🏠 Home: index.md
  - 🚀 Getting Started:
      - 📦 Installation: getting-started/installation.md
      - 🎯 Quick Start: getting-started/quick-start.md
      - 🌍 Why KDP?: getting-started/motivation.md
      - 🧩 Architecture Overview: getting-started/architecture.md
  - 📚 Feature Types:
      - 🛠️ Features Overview: features/overview.md
      - 🔢 Numerical Features: features/numerical-features.md
      - 🏷️ Categorical Features: features/categorical-features.md
      - 📝 Text Features: features/text-features.md
      - 📅 Date Features: features/date-features.md
      - 📊 Time Series Features: features/time_series_features.md
      - ➕ Cross Features: features/cross-features.md
      - 🔄 Passthrough Features: features/passthrough-features.md
  - 🧠 Advanced Features:
      - 📊 Distribution-Aware Encoding: advanced/distribution-aware-encoding.md
      - 🔢 Advanced Numerical Embeddings: advanced/numerical-embeddings.md
      - 👁️ Tabular Attention: advanced/tabular-attention.md
      - 🤖 Transformer Blocks: advanced/transformer-blocks.md
      - 🧩 Feature-wise Mixture of Experts: advanced/feature-moe.md
      - 🛠️ Custom Preprocessing Pipelines: advanced/custom-preprocessing.md
  - ⚡ Optimization:
      - 🎯 Feature Selection: optimization/feature-selection.md
      - 📈 Tabular Optimization: optimization/tabular-optimization.md
      - ⚙️ Auto-Configuration: optimization/auto-configuration.md
  - 📖 Examples:
      - 🧪 Basic Examples: examples/basic-examples.md
      - 🔥 Complex Examples: examples/complex-examples.md
      - 🧮 Categorical Hashing: examples/categorical-hashing-example.md
  - 🔌 Integration:
      - 🔄 Integration Overview: integrations/overview.md
  - 🤝 Contributing:
      - 🍻 Contributing Guide: contributing/overview.md
      - 📝 Auto-Documentation: contributing/development/auto-documentation.md
      - 🖼️ Images Organization: contributing/development/images-organization.md
  - 📑 API Reference:
      - 🏭 Layers Factory: api/layers-factory.md
      - 📚 API Index: generated/api_index.md

repo_name: Keras Data Preprocessor
repo_url: https://github.com/UnicoLab/keras-data-processor

markdown_extensions:
  - attr_list
  - md_in_html
  - admonition
  - tables
  - pymdownx.details
  - pymdownx.highlight
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tabbed:
      alternate_style: true

plugins:
  - search
  - autorefs:
      link_titles: true
  - mkdocstrings:
      handlers:
        python:
          options:
            show_root_heading: true
            show_source: true
  - mike:
      canonical_version: null
      version_selector: true
      css_dir: css
      javascript_dir: js
  - redirects:
      redirect_maps:
        # Old to new mappings
        'features.md': 'features/overview.md'
        'quick_start.md': 'getting-started/quick-start.md'
        'distribution_aware_encoder.md': 'advanced/distribution-aware-encoding.md'
        'advanced_numerical_embeddings.md': 'advanced/numerical-embeddings.md'
        'tabular_attention.md': 'advanced/tabular-attention.md'
        'feature_selection.md': 'optimization/feature-selection.md'
        'advanced/feature-selection.md': 'optimization/feature-selection.md'
        'auto_configuration.md': 'optimization/auto-configuration.md'
        'complex_examples.md': 'examples/complex-examples.md'
        'integrations.md': 'integrations/overview.md'
        'feature_moe.md': 'advanced/feature-moe.md'
        'transformer_blocks.md': 'advanced/transformer-blocks.md'
        'custom_preprocessing.md': 'advanced/custom-preprocessing.md'
        'contributing.md': 'contributing/overview.md'
        # API reference redirects
        'reference/api-reference.md': 'generated/api_index.md'
        'reference/parameters.md': 'generated/api_index.md'
        'reference/glossary.md': 'generated/api_index.md'
        # Integration specific redirects
        'integrations/tensorflow.md': 'integrations/overview.md'
        'integrations/pytorch.md': 'integrations/overview.md'
        'integrations/scikit-learn.md': 'integrations/overview.md'
        'integrations/production.md': 'integrations/overview.md'
        # Examples redirects
        'examples/classification.md': 'examples/complex-examples.md'
        'examples/regression.md': 'examples/complex-examples.md'
        'examples/recommendation.md': 'examples/complex-examples.md'
        'examples/hashing.md': 'examples/categorical-hashing-example.md'
        'hashing.md': 'examples/categorical-hashing-example.md'
        'categorical-hashing.md': 'examples/categorical-hashing-example.md'
        # Contributing redirects
        'contributing/development.md': 'contributing/development/auto-documentation.md'
        'contributing/testing.md': 'contributing/overview.md'
        'contributing/contributing.md': 'contributing/overview.md'
        # Extra pages that might be referenced
        'memory_optimization.md': 'optimization/tabular-optimization.md'
        'benchmarking.md': 'optimization/tabular-optimization.md'
        'optimization/memory-optimization.md': 'optimization/tabular-optimization.md'

# Disable directory URLs to make relative paths work better
use_directory_urls: false

extra:
  version:
    provider: mike
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/UnicoLab/keras-data-processor
    - icon: fontawesome/brands/python
      link: https://pypi.org/project/keras-data-processor/

extra_javascript:
  - assets/js/fix-image-paths.js