site_name: Mathesar Documentation
site_url: https://docs.mathesar.org/
repo_url: https://github.com/mathesar-foundation/mathesar/
repo_name: mathesar-foundation/mathesar
edit_uri: edit/develop/docs/docs/

nav:
  - Introduction: index.md
  - Install Mathesar:
      - Try Mathesar locally: administration/try-mathesar-locally.md
      - Using Docker Compose: administration/install-via-docker-compose.md
      - On Linux · macOS · WSL: administration/install-from-scratch.md
      - DigitalOcean: administration/install-digitalocean.md
      - Railway: administration/install-railway.md
  - Administrator Guide:
      - Configuration:
        - Environment variables: administration/environment-variables.md
        - Single sign-on (SSO): administration/single-sign-on.md
        - File storage backends: administration/file-backend-config.md
        - Form builder configuration: administration/forms-config.md
      - Maintenance:
        - Upgrade Mathesar: administration/upgrade.md
        - Uninstall Mathesar: administration/uninstall.md
        - Postgres & Python versions: administration/version-support.md
      - Debugging Mathesar: administration/debug.md
  - User Guide:
      - Introduction: user-guide/index.md
      - Your data in PostgreSQL:
          - Databases: user-guide/databases.md
          - Schemas: user-guide/schemas.md
          - Tables: user-guide/tables.md
          - Data types: user-guide/data-types.md
          - Relationships: user-guide/relationships.md
      - Access control:
          - Overview: user-guide/access-control.md
          - Mathesar users: user-guide/users.md
          - PostgreSQL roles: user-guide/roles.md
          - Stored roles: user-guide/stored-roles.md
          - Collaborators: user-guide/collaborators.md
      - Features:
          - File data type: user-guide/files.md
          - Form builder: user-guide/forms.md
          - Data Explorer: user-guide/data-explorer.md
          - User data type: user-guide/user-type.md
      - Data management:
          - Importing data: user-guide/importing-data.md
          - Exporting data: user-guide/exporting-data.md
      - Settings:
          - Usage data collection: user-guide/usage-data-collection.md
  - API:
      - Overview: api/index.md
      - Methods: api/methods.md
  - Releases:
      - '0.12.0': releases/0.12.0.md
      - Previous releases:
          - '0.11.0': releases/0.11.0.md
          - '0.10.1': releases/0.10.1.md
          - '0.10.0': releases/0.10.0.md
          - '0.9.0': releases/0.9.0.md
          - '0.8.0': releases/0.8.0.md
          - '0.7.1': releases/0.7.1.md
          - '0.7.0': releases/0.7.0.md
          - '0.6.0': releases/0.6.0.md
          - '0.5.0': releases/0.5.0.md
          - '0.4.0': releases/0.4.0.md
          - '0.3.0': releases/0.3.0.md
          - '0.2.5': releases/0.2.5.md
          - '0.2.4': releases/0.2.4.md
          - '0.2.3': releases/0.2.3.md
          - '0.2.2': releases/0.2.2.md
          - '0.2.1': releases/0.2.1.md
          - '0.2.0': releases/0.2.0.md
          - '0.1.7': releases/0.1.7.md
          - '0.1.6': releases/0.1.6.md
          - '0.1.5': releases/0.1.5.md
          - '0.1.4': releases/0.1.4.md
          - '0.1.3': releases/0.1.3.md
          - '0.1.2': releases/0.1.2.md
          - '0.1.1': releases/0.1.1.md
          - '0.1.0': releases/0.1.0.md

plugins:
  - search:
      lang: en
  - redirects:
      redirect_maps:
        "installation-dc/ansible-setup.md": "administration/install-via-docker-compose.md"
        "product/intro.md": "user-guide/index.md"
        "product/users.md": "user-guide/users.md"
        "install/index.md": "index.md"
        "install/docker-compose/index.md": "administration/install-via-docker-compose.md"
        "install/build-from-source/index.md": "administration/install-from-scratch.md"
        "api/rpc.md": "api/index.md"
        "api/rest.md": "api/index.md"
        "user-guide/glossary.md": "user-guide/index.md"
        "user-guide/permissions.md": "user-guide/access-control.md"
        "configuration/env-variables.md": "administration/environment-variables.md"
        "administration/configuration.md": "administration/environment-variables.md"
        "installation/docker-compose/index.md": "administration/install-via-docker-compose.md"
        "installation/build-from-source/index.md": "administration/install-from-scratch.md"
        "user-guide/stored-role-passwords.md": "user-guide/stored-roles.md"
  - macros
  - placeholder
  - autorefs
  - mkdocstrings:
      handlers:
        python:
          paths: [../mathesar/rpc/]
          options:
            heading_level: 3
            docstring_style: google
            separate_signature: true
            show_root_toc_entry: false
            show_root_members_full_path: true
            show_source: false
            group_by_category: false
  - spellcheck:
      backends:
      - codespell:
          dictionaries: [clear]
      known_words:
      - Mathesar
      ignore_code: yes
      min_length: 2
      max_capital: 1
      allow_unicode: yes
      strict_only: yes

theme:
  name: material
  logo: assets/images/logo.svg
  favicon: assets/images/favicon.ico
  features:
    - content.tabs.link
    - content.code.copy
    - navigation.sections
    - navigation.expand
    - announce.dismiss
  font:
    text: Inter
    code: JetBrains Mono
  icon:
    repo: fontawesome/brands/github
  palette:
    # Palette toggle for light mode
    - scheme: default
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    # Palette toggle for dark mode
    - scheme: slate
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  custom_dir: overrides

extra_css:
  - stylesheets/extra.css

markdown_extensions:
  - admonition
  - attr_list
  - def_list
  - codehilite
  - md_in_html
  - pymdownx.blocks.caption
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.details
  - pymdownx.tabbed:
      alternate_style: true
  - smarty
  - tables
  - toc:
      title: On this page
      permalink: true

extra:
  mathesar_version: 0.12.0
  version:
    provider: mike
    alias: true