mkdocs.yaml

site_name: Sugar
site_url: https://osl-incubator.github.io/sugar
repo_url: https://github.com/osl-incubator/sugar
docs_dir: ./docs
site_dir: ./build
# extra_css:
#   - stylesheets/extra.css
# Page tree
nav:
  - index.md
  - Installation: installation.md
  - Changelog: changelog.md
  - Contributing: contributing.md
  # - API: api/references.md
  # - Notebook page: example.ipynb
theme:
  name: material
  features:
    - content.code.annotate
    - content.tabs.link
    - header.autohide
    - navigation.indexes
    - navigation.instant
    - search.highlight
    - search.share
    - search.suggest
  icon:
    repo: fontawesome/brands/github
  logo: images/logo.png
  favicon: images/favicon.ico
  palette:
    scheme: slate
    primary: white
    accent: lime
  # custom_dir: docs/overrides
plugins:
  - search
  - macros
  # - autorefs
  # - exclude:
  #     glob:
  #       - backends/template.md
  - mkdocstrings:
      enable_inventory: true
      handlers:
        python:
          paths: [./src]

          import:
            - https://docs.python.org/3/objects.inv
          options:
            docstring_style: numpy
            filters:
              - "!^Bounds"
              - "!^__class__"
              - "!^_filter_with_like"
              - "!^_find_backends"
              - "!^_key$"
              - "!^_literal_value_hash_key"
              - "!^_log"
              - "!^_nbytes"
              - "!^_safe_name$"
              - "!^_schema_from_csv"
              - "!^_to_geodataframe"
              - "!^_tuplize"
              - "!^ast_schema"
              - "!^backend_table_type"
              - "!^bounds$"
              - "!^column$"
              - "!^compiler$"
              - "!^context_class"
              - "!^database_class"
              - "!^do_connect"
              - "!^fetch_from_cursor"
              - "!^get_schema"
              - "!^largest$"
              - "!^reconnect"
              - "!^select_builder_class"
              - "!^select_class"
              - "!^table_class$"
              - "!^table_expr_class"
              - "!^translator_class"
              - "!^Options$"
          rendering:
            show_category_heading: true
            show_root_full_path: false
            show_root_heading: true
            show_root_toc_entry: true
            show_source: false
            show_modules: true
  - mkdocs-jupyter:
      execute: false
      ignore:
        - "*.py"
      # execute_ignore: "tutorial/*Geospatial*.ipynb"
      include_source: true
      theme: dark
  - literate-nav
markdown_extensions:
  - admonition
  - attr_list
  - codehilite
  - def_list
  - footnotes
  - md_in_html
  - meta
  - pymdownx.emoji:
      emoji_index: !!python/name:materialx.emoji.twemoji
      emoji_generator: !!python/name:materialx.emoji.to_svg
      options:
        custom_icons:
          - docs/static/icons
  - pymdownx.details
  - pymdownx.highlight
  - pymdownx.inlinehilite
  - pymdownx.magiclink:
      provider: github
      repo_url_shortener: true
  - pymdownx.saneheaders
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - tables
  - toc
extra:
  project_name: "Sugar"
  team:
    - name: "Active maintainers"
      members:
        - xmnlab
        - joel5vega
    - name: "Former maintainers"
      members:
        - xmnlab
  social:
    - icon: fontawesome/brands/twitter
      link: https://twitter.com/xmnlab
    - icon: fontawesome/brands/github
      link: https://github.com/osl-incubator/sugar
  support_levels:
    supported:
      icon: :material-check-decagram:{ .verified }
      description: Tested in CI. If this doesn't work for you, please [file an issue](https://github.com/osl-incubator/sugar/issues/new).
    bug:
      icon: :material-bug:{ .bug }
      description: Should work but doesn't because upstream is broken. Supported on a best-effort basis.
    unsupported:
      icon: :material-cancel:{ .cancel }
      description: Unlikely to ever be supported or no upstream support.

copyright: "Copyright © 2023, Sugar Team"