mkdocs.yml

site_name: HPC@UCD Documentation
site_url: http://docs.hpc.ucdavis.edu
repo_url: https://github.com/ucdavis/hpccf-docs
copyright: Copyright © 2023-24 The Regents of the University of California, Davis

nav:
  - General:
      - Accessing Clusters: general/access.md
      - Account Requests: general/account-requests.md
      - Data Transfer: data-transfer.md
      - Job Scheduling:
          - About: scheduler/index.md
          - Commands: scheduler/commands.md
          - Job Scripts: scheduler/jobscripts.md
          - Resources: scheduler/resources.md
      - Software:
          - About: software/index.md
          - Conda and Python: software/conda.md
          - Development: software/developing.md
          - Module System: software/modules.md
          - Open OnDemand: software/ondemand.md
          - R and RStudio: software/rlang.md
      - Troubleshooting: general/troubleshooting.md
  - Clusters:
      - Farm:
          - About: farm/index.md
          - Job Scheduling: farm/scheduling.md
          - Resources: farm/resources.md
          - Software:
              - Modules: farm/software/modules.md
          - Storage: farm/storage.md
      - Franklin:
          - About: franklin/index.md
          - Job Scheduling: franklin/scheduling.md
          - Resources: franklin/resources.md
          - Software:
              - alphafold: franklin/software/alphafold.md
              - cryo-EM: franklin/software/cryoem.md
              - Modules: franklin/software/modules.md
          - Storage: franklin/storage.md
      - Hive:
          - Migrating from LSSC0: hive/migration.md

  - Admin:
      - admin/index.md
      - Cobbler: admin/cobbler.md
      - Configuration: admin/configuration.md # puppet, etc
      - DNS: admin/dns.md
      - Monitoring: admin/monitoring.md
      - Netbox: admin/netbox.md
      - Network Architecture: admin/network.md
      - Open OnDemand: admin/ondemand.md
      - Provisioning: admin/provisioning.md
      - PXE boot: admin/PXE.md
      - Software: admin/software.md
      - Virtual Machines: admin/vms.md
#
# Here be dragons! Don't edit these settings unless you Know What You're Doing (tm).
#

markdown_extensions:
  - toc:
      permalink: true
  - def_list
  - attr_list
  - admonition
  - md_in_html
  - footnotes
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true

plugins:
  - search
  - git-revision-date-localized:
      enable_creation_date: true
  - macros:
      module_name: macros

extra:
  spack_modulefiles_path: spack-ucdavis/modulefiles/hpccf/franklin/
  social:
    - icon: material/email-edit
      link: "mailto:hpc-help@ucdavis.edu"
      name: Email HPCCF Support
    - icon: fontawesome/brands/slack
      link: https://ucdavis.slack.com/archives/C053NKA88
      name: "#hpc Channel on ucdavis.slack.com"
extra_css:
  - stylesheets/extra.css
extra_javascript:
  - javascripts/mathjax.js
  - https://cdnjs.cloudflare.com/polyfill/v3/polyfill.min.js?features=es6
  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js

theme:
  name: material
  custom_dir: overrides
  features:
    - content.code.annotate
    #- navigation.tabs
    - navigation.sections
    - navigation.expand
    #- navigation.indexes
    - navigation.instant
    - navigation.top
    #- navigation.footer
    - navigation.tracking
    - search.highlight
    - search.share
    - search.suggest
  logo: assets/HPCCF-logo-dark.png
  favicon: assets/HPCCF-logo.png
  icon:
    repo: fontawesome/brands/github
  palette:
    # Palette toggle for light mode
    - scheme: ucdavis
      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