config.toml

languageCode = 'en-us'
title = 'Mach: zig game engine & graphics toolkit'
description = "The Zig game engine & graphics toolkit for building high-performance, native, truly-cross-platform games, visualizations & desktop/mobile apps."
theme = "minimal"
canonifyURLs = true # Required for Hugo to rewrite Markdown links with baseURL in support of our site versioning

# Important: This should be configured according to the branch.
baseURL = 'https://machengine.org/'
[params]
  branch = 'main'

  # Other branch-agnostic site params below
  #alert = '**Mach v0.3 has been released!** For all the details check out [the announcement](https://devlog.hexops.com/2024/mach-v0.3-released/)'
  #alert = '**Mach now _nominates Zig versions for use!_** For details check out [the docs](/docs/nominated-zig)'
  debug_opengraph_images = false

[markup.goldmark.renderer]
unsafe = true

[menu]
[[menu.docs]]
  identifier = 'docs'
  name = 'Overview'
  url = '/docs'
  weight = 10000
[[menu.docs]]
  identifier = 'docs-getting-started'
  name = 'Getting started'
  url = '/docs/getting-started'
  weight = 10001

[[menu.docs]]
  identifier = 'docs-object'
  name = 'Object system'
  weight = 15000
[[menu.docs]]
  parent = 'docs-object'
  identifier = 'docs-object-overview'
  name = 'Overview'
  url = '/docs/object'
  weight = 15001
[[menu.docs]]
  parent = 'docs-object'
  identifier = 'docs-object-modules'
  name = 'Modules'
  url = '/docs/object/modules'
  weight = 15002
[[menu.docs]]
  parent = 'docs-object'
  identifier = 'docs-object-systems'
  name = 'Systems'
  url = '/docs/object/systems'
  weight = 15003
[[menu.docs]]
  parent = 'docs-object'
  identifier = 'docs-object-objects'
  name = 'Objects'
  url = '/docs/object/objects'
  weight = 15004
[[menu.docs]]
  parent = 'docs-object'
  identifier = 'docs-object-relations'
  name = 'Relations'
  url = '/docs/object/relations'
  weight = 15005


[[menu.docs]]
  identifier = 'docs-math'
  name = 'Math'
  weight = 20000
[[menu.docs]]
  parent = 'docs-math'
  identifier = 'docs-math-Overview'
  name = 'Overview'
  url = '/docs/math'
  weight = 20001
[[menu.docs]]
  parent = 'docs-math'
  identifier = 'docs-math-coordinate-system'
  name = 'Coordinate system'
  url = '/docs/math/coordinate-system'
  weight = 20002
[[menu.docs]]
  parent = 'docs-math'
  identifier = 'docs-math-traversing-coordinate-systems'
  name = 'Traversing coordinate systems'
  url = '/docs/math/traversing-coordinate-systems'
  weight = 20003
[[menu.docs]]
  parent = 'docs-math'
  identifier = 'docs-math-matrix-storage'
  name = 'Matrix storage'
  url = '/docs/math/matrix-storage'
  weight = 20004

[[menu.docs]]
  identifier = 'docs-gpu'
  name = 'GPU'
  weight = 30000
[[menu.docs]]
  parent = 'docs-gpu'
  identifier = 'docs-gpu-overview'
  name = 'Overview'
  url = '/docs/gpu'
  weight = 30001
[[menu.docs]]
  parent = 'docs-gpu'
  identifier = 'docs-gpu-memory'
  name = 'Memory management'
  url = '/docs/gpu/memory'
  weight = 30002
[[menu.docs]]
  parent = 'docs-gpu'
  identifier = 'docs-gpu-errors'
  name = 'Error handling'
  url = '/docs/gpu/errors'
  weight = 30003

[[menu.docs]]
  identifier = 'docs-general'
  name = 'General'
  weight = 40000
[[menu.docs]]
  parent = 'docs-general'
  identifier = 'docs-general-roadmap'
  name = 'Roadmap'
  url = '/docs/roadmap'
  weight = 40001
[[menu.docs]]
  parent = 'docs-general'
  identifier = 'docs-general-modularity'
  name = 'Modularity'
  url = '/docs/modularity'
  weight = 40002
[[menu.docs]]
  parent = 'docs-general'
  identifier = 'docs-general-stdlib'
  name = 'Standard library'
  url = '/docs/stdlib'
  weight = 40003
[[menu.docs]]
  parent = 'docs-general'
  identifier = 'docs-general-zig-version'
  name = 'Zig version'
  url = '/docs/zig-version'
  weight = 40004
[[menu.docs]]
  identifier = 'docs-dev-nominated-zig'
  parent = 'docs-general'
  name = 'Nominated Zig'
  url = '/docs/nominated-zig'
  weight = 40005


[[menu.about]]
  identifier = 'about'
  name = 'About the project'
  url = '/about'
  weight = 100
[[menu.about]]
  identifier = 'about-goals'
  name = 'Project goals'
  url = '/about/goals'
  weight = 200
[[menu.about]]
  identifier = 'about-platforms'
  name = 'Platform support'
  url = '/about/platforms'
  weight = 300
[[menu.about]]
  identifier = 'about-faq'
  name = 'FAQ'
  url = '/about/faq'
  weight = 800

[[menu.about]]
  identifier = 'about-dev'
  name = 'Development'
  weight = 10000
[[menu.about]]
  identifier = 'about-dev-style'
  parent = 'about-dev'
  name = 'Style guide'
  url = '/about/style'
  weight = 10100