mkdocs.yml

site_name: UTS Programmers' Society
copyright: Copyright © ProgSoc
repo_url: https://github.com/ProgSoc/Docs
edit_uri: edit/main/docs/
site_url: https://docs.progsoc.org

extra:
  social:
    - icon: fontawesome/brands/discord
      link: https://discord.progsoc.org
    - icon: fontawesome/brands/instagram
      link: https://instagram.com/progsoc_uts
    - icon: fontawesome/brands/github
      link: https://github.com/progsoc
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/company/progsocuts
    - icon: fontawesome/brands/youtube
      link: https://www.youtube.com/@progsoc
    - icon: fontawesome/brands/facebook
      link: https://www.facebook.com/ProgSoc
    # - icon: fontawesome/solid/globe
    #   link: https://progsoc.org


theme:
  name: material
  custom_dir: overrides
  logo: assets/ProgSocWhite.png
  favicon: assets/BackgroundLogo.png
  font:
    code: Fira Code
  features:
    - content.code.copy
    - navigation.instant
    - navigation.tabs
    - content.action.edit
    - navigation.tabs.sticky
    - navigation.indexes
    - toc.follow
    - toc.track
    - navigation.top
    - navigation.tracking
    - navigation.footer
  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

markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - toc:
      permalink: true
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.details
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.magiclink:
      repo_url_shorthand: true
      user: ProgSoc
      repo: Docs
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.snippets:
      url_download: true
  - pymdownx.tilde

plugins:
  - search
  - git-revision-date-localized:
      enabled: !ENV [CI, false]
      enable_creation_date: true
  - tags
  - blog
  - social:
      enabled: !ENV [CI, false]
  - redirects:
      redirect_maps:
        'activate.md': 'https://www.activateuts.com.au/clubs/programmers-society-progsoc/?quickRegistration=true'
        'discord.md': 'https://discord.gg/uSgqcBsrjd'
  - rss:
      match_path: blog/posts/.*
      date_from_meta:
        as_creation: date
      categories:
        - categories
        - tags 
  - git-committers:
      enabled: !ENV [CI, false]
      repository: progsoc/docs
      branch: main

nav:
  - Home: index.md
  - Blog:
    - blog/index.md
  - Projects:
    - projects/index.md
    - ProgBot: projects/progbot.md
    - Voting System: projects/voting-system.md
    - Docs: projects/docs.md
  - Events:
    - events/index.md
    - 2024:
      - React Workshop: events/2024/2024-react-workshop/2024-react-workshop.md
    - 2023:
      - Git Workshop: events/2023/git-workshop.md
      - Full Stack Web Development: events/2023/full-stack-web-development.md
      - UTS Tech Fest Programming Competition: events/2023/programming-competition.md
      - Docker Workshop: events/2023/docker-workshop.md
      - Fuzzing Workshop: events/2023/fuzz.md
      - AGM: events/2023/agm.md
    - 2022:
      - Git Workshop: events/2022/git.md
      - React: events/2022/react.md
      - Rust: events/2022/rust.md
      - AGM: events/2022/agm.md
  - Lore:
     - lore/index.md
     - Brick: lore/brick.md
     - TFM: lore/tfm.md
     - Golden Years: lore/golden-years.md
  - About:
     - What We Do: about/what-we-do.md
     - Execs: about/execs.md
     - Constitution: about/constitution.md
  - Org:
     - org/index.md
     - General Meetings & Standing Orders: org/general-meetings.md
  - Contributing: contributing.md