mkdocs.yml

# project
site_name: 'elapid'
site_description: 'Species distribution modeling tools, including a python implementation of Maxent.'

# documentation build
docs_dir: 'docs'
site_dir: 'build'

# site info
repo_name: 'earth-chris/elapid'
repo_url: 'https://github.com/earth-chris/elapid'
site_url: 'https://earth-chris.github.io/elapid/'

# social
extra:
    social:
      - icon: 'fontawesome/brands/github'
        link: 'https://github.com/earth-chris'
      - icon: 'fontawesome/brands/twitter'
        link: 'https://twitter.com/earth_chris'
      - icon: 'material/earth'
        link: 'https://cbanderson.info/'

# site navigation
nav:
    - Home: 'index.md'
    - Installation guide: 'install.md'
    - Species Distribution Models:
        - Maxent: 'sdm/maxent.md'
        - NicheEnvelope: 'sdm/nicheenvelope.md'
    - Examples:
        - elapid's Geospatial Features: 'examples/WorkingWithGeospatialData.ipynb'
        - A Simple Maxent Model: 'examples/MaxentSimpleModel.ipynb'
    - API Documentation:
        - elapid.features: 'module/features.md'
        - elapid.geo: 'module/geo.md'
        - elapid.models: 'module/models.md'
        - elapid.stats: 'module/stats.md'
        - elapid.train_test_split: 'module/train_test_split.md'
        - elapid.types: 'module/types.md'
        - elapid.utils: 'module/utils.md'
    - Contributing to elapid: 'contributing.md'

# theme
theme:
    logo: 'img/elapid.svg'
    icon:
      repo: 'fontawesome/brands/github'
    name: 'material'
    language: 'en'
    nav_style: dark
    palette:
      - media: "(prefers-color-scheme: light)"
        scheme: 'earthchris-light'
        toggle:
          icon: 'material/weather-night'
          name: 'Go dark'
      - media: "(prefers-color-scheme: dark)"
        scheme: 'slate'
        toggle:
          icon: 'material/weather-sunny'
          name: 'Go light'
    font:
      text: 'Nunito'
      code: 'Source Code Pro'
    favicon: 'img/favicon.png'
    features:
      - navigation.top

# extras
plugins:
    - search
    - mkdocstrings
    - mkdocs-jupyter:
        include_source: True

extra_css:
    - https://earth-chris.github.io/shared/mkdocs.css
    #- css/colors.css

extra_javascript:
  - javascript/mathjax.js
  - https://polyfill.io/v3/polyfill.min.js?features=es6
  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js

# pandoc (https://pandoc.org/MANUAL.html)
markdown_extensions:
    - admonition
    - attr_list
    - codehilite:
        guess_lang: false
    - def_list
    - footnotes
    - pymdownx.arithmatex:
        generic: true
    - pymdownx.betterem
    - pymdownx.caret:
        insert: false
    - pymdownx.details
    - pymdownx.emoji
    - pymdownx.escapeall:
        hardbreak: true
        nbsp: true
    - pymdownx.magiclink:
        hide_protocol: true
        repo_url_shortener: true
    - pymdownx.smartsymbols
    - pymdownx.superfences
    - pymdownx.tasklist:
        custom_checkbox: true
    - pymdownx.tilde
    - toc:
        permalink: true