mkdocs.yml

# https://www.mkdocs.org/user-guide/configuration/

# Project information
site_name: Polars user guide
site_url: https://docs.pola.rs/
repo_url: https://github.com/pola-rs/polars
repo_name: pola-rs/polars

docs_dir: docs/source

# Documentation layout
nav:
  - User guide:
    - index.md
    - user-guide/getting-started.md
    - user-guide/installation.md
    - Concepts:
      - user-guide/concepts/index.md
      - user-guide/concepts/data-types-and-structures.md
      - user-guide/concepts/expressions-and-contexts.md
      - user-guide/concepts/lazy-api.md
    - Expressions:
      - user-guide/expressions/index.md
      - user-guide/expressions/operators.md
      - user-guide/expressions/column-selections.md
      - user-guide/expressions/functions.md
      - user-guide/expressions/casting.md
      - user-guide/expressions/strings.md
      - user-guide/expressions/categorical-data-and-enums.md
      - user-guide/expressions/aggregation.md
      - user-guide/expressions/missing-data.md
      - user-guide/expressions/window.md
      - user-guide/expressions/folds.md
      - user-guide/expressions/lists.md
      - user-guide/expressions/plugins.md
      - user-guide/expressions/user-defined-functions.md
      - user-guide/expressions/structs.md
      - user-guide/expressions/numpy.md
    - Transformations:
      - user-guide/transformations/index.md
      - user-guide/transformations/joins.md
      - user-guide/transformations/concatenation.md
      - user-guide/transformations/pivot.md
      - user-guide/transformations/unpivot.md
      - Time series:
        - user-guide/transformations/time-series/parsing.md
        - user-guide/transformations/time-series/filter.md
        - user-guide/transformations/time-series/rolling.md
        - user-guide/transformations/time-series/resampling.md
        - user-guide/transformations/time-series/timezones.md
    - Lazy API:
      - user-guide/lazy/index.md
      - user-guide/lazy/using.md
      - user-guide/lazy/optimizations.md
      - user-guide/lazy/schemas.md
      - user-guide/lazy/query-plan.md
      - user-guide/lazy/execution.md
      - user-guide/lazy/streaming.md
      - user-guide/lazy/gpu.md
    - IO:
      - user-guide/io/index.md
      - user-guide/io/csv.md
      - user-guide/io/excel.md
      - user-guide/io/parquet.md
      - user-guide/io/json.md
      - user-guide/io/multiple.md
      - user-guide/io/hive.md
      - user-guide/io/database.md
      - user-guide/io/cloud-storage.md
      - user-guide/io/bigquery.md
      - user-guide/io/hugging-face.md
    - SQL:
      - user-guide/sql/intro.md
      - user-guide/sql/show.md
      - user-guide/sql/select.md
      - user-guide/sql/create.md
      - user-guide/sql/cte.md
    - Migrating:
      - user-guide/migration/pandas.md
      - user-guide/migration/spark.md
    - user-guide/ecosystem.md
    - Misc:
      - user-guide/misc/multiprocessing.md
      - user-guide/misc/visualization.md
      - user-guide/misc/styling.md
      - user-guide/misc/comparison.md
      - user-guide/misc/arrow.md
    - user-guide/gpu-support.md

  - API reference: api/index.md

  - Development:
    - Contributing:
      - development/contributing/index.md
      - development/contributing/ide.md
      - development/contributing/test.md
      - development/contributing/ci.md
      - development/contributing/code-style.md
    - development/versioning.md

  - Releases:
    - releases/changelog.md
    - Upgrade guides:
      - releases/upgrade/index.md
      - releases/upgrade/1.md
      - releases/upgrade/0.20.md
      - releases/upgrade/0.19.md

not_in_nav: |
  /_build/
validation:
  links:
    # Allow an absolute link to the features page for our code snippets
    absolute_links: ignore

# Build directories
theme:
  name: material
  locale: en
  custom_dir: docs/source/_build/overrides
  palette:
  # Palette toggle for light mode
  - media: "(prefers-color-scheme: light)"
    scheme: default
    toggle:
      icon: material/brightness-7
      name: Switch to dark mode
  # Palette toggle for dark mode
  - media: "(prefers-color-scheme: dark)"
    scheme: slate
    toggle:
      icon: material/brightness-4
      name: Switch to light mode
  logo: _build/assets/logo.png
  features:
    - navigation.tracking
    - navigation.instant
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.footer
    - navigation.indexes
    - content.tabs.link
    - content.code.copy
  icon:
    repo: fontawesome/brands/github

extra_css:
  - _build/css/extra.css
extra:
  analytics:
    provider: plausible
    domain: guide.pola.rs,combined.pola.rs

# Preview controls
strict: true

# Formatting options
markdown_extensions:
  - admonition
  - pymdownx.details
  - attr_list
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.snippets:
      base_path: ['.','docs/source/src/']
      check_paths: true
      dedent_subsections: true
  - footnotes

hooks:
  - docs/source/_build/scripts/people.py

plugins:
  - search:
      lang: en
  - markdown-exec
  - material-plausible
  - macros:
      module_name: docs/source/_build/scripts/macro
  - redirects:
      redirect_maps:
        'user-guide/index.md': 'index.md'
        'user-guide/basics/index.md': 'user-guide/getting-started.md'
        'user-guide/basics/reading-writing.md': 'user-guide/getting-started.md'
        'user-guide/basics/expressions.md': 'user-guide/getting-started.md'
        'user-guide/basics/joins.md': 'user-guide/getting-started.md'