version: 1
project:
  id: modernClassicalMechanics
  title: Modern Classical Mechanics
  short_title: Modern Classical Mechanics
  subtitle: Computational and project-based approaches to classical mechanics
  description: >-
    An open collection of notes, activities, and computational resources for
    learning and teaching classical mechanics.
  authors:
    - name: Martin Veillette
      corresponding: true
      email: martin.veillette@gmail.com
  date: 2026-01-01
  license:
    content: CC-BY-NC-4.0
  open_access: true
  github: QuadriviumPress/modernClassicalMechanics
  keywords:
    - classical mechanics
    - computational physics
    - nonlinear dynamics
    - Lagrangian mechanics
    - open textbook
  settings:
    output_matplotlib_strings: remove
    myst_to_tex:
      code_style: listings
  # These downloads are build artifacts: scripts/build-exports.sh writes them,
  # and CI's Exports workflow runs that before deploy.yml builds the site, so
  # they are on disk by the time MyST looks for them. A fresh clone or `myst
  # start` has not built them yet -- `static: true` turns that from an
  # unsuppressible error into the `static-action-file-copied` warning that
  # error_rules below softens, so local dev stays quiet.
  downloads:
    - file: exports/modernClassicalMechanics.pdf
      title: Download the book (PDF)
      static: true
    - file: exports/modernClassicalMechanics.docx
      title: Download the book (Word)
      static: true
  error_rules:
    - id: static-action-file-copied
      severity: warn
    # Remote hosts often answer 403, 404, or 5xx to the CI checker even when the
    # page is fine in a browser. Internal links and missing files still fail.
    - rule: link-resolves
      severity: ignore
      keys:
        - "{http,https}://**"
    - rule: doi-link-valid
      severity: ignore
  exports:
    - id: book
      format: pdf+tex
      template: ./templates/book
      output: exports/modernClassicalMechanics.pdf
      articles:
        - file: content/index.md
          level: 0
        - title: Course Information
          level: -1
        - file: content/activities.md
          level: 0
        - file: content/resources.md
          level: 0
        - file: content/notebooks/01_start.md
          level: 0
        - file: content/notebooks/01_notes.md
          level: 0
        - file: content/notebooks/02_start.md
          level: 0
        - file: content/notebooks/02_notes.md
          level: 0
        - file: content/notebooks/03_start.md
          level: 0
        - file: content/notebooks/03_notes.md
          level: 0
        - file: content/notebooks/04_start.md
          level: 0
        - file: content/notebooks/04_notes.md
          level: 0
        - file: content/notebooks/05_start.md
          level: 0
        - file: content/notebooks/05_notes.md
          level: 0
        - file: content/notebooks/06_start.md
          level: 0
        - file: content/notebooks/06_notes.md
          level: 0
        - file: content/notebooks/06_momentum_notes.md
          level: 0
        - file: content/notebooks/07_start.md
          level: 0
        - file: content/notebooks/07_notes.md
          level: 0
        - file: content/notebooks/08_start.md
          level: 0
        - file: content/notebooks/08_notes.md
          level: 0
        - file: content/notebooks/09_start.md
          level: 0
        - file: content/notebooks/09_notes.md
          level: 0
        - file: content/notebooks/10_start.md
          level: 0
        - file: content/notebooks/10_notes.md
          level: 0
        - file: content/notebooks/11_start.md
          level: 0
        - file: content/notebooks/11_notes.md
          level: 0
        - file: content/notebooks/12_start.md
          level: 0
        - file: content/notebooks/12_notes.md
          level: 0
        - file: content/notebooks/13_start.md
          level: 0
        - file: content/notebooks/13_notes.md
          level: 0
        - title: Homework
          level: -1
        - file: content/notebooks/hw1.md
          level: 0
        - file: content/notebooks/hw2.md
          level: 0
        - file: content/notebooks/hw3.md
          level: 0
        - file: content/notebooks/hw4.md
          level: 0
        - file: content/notebooks/hw5.md
          level: 0
        - file: content/notebooks/hw6.md
          level: 0
        - file: content/notebooks/hw7.md
          level: 0
        - file: content/notebooks/hw8.md
          level: 0
  toc:
    - file: content/index.md
    - title: Course information
      children:
        - file: content/activities.md
        - file: content/resources.md
    - title: Unit 1 — Introduction
      children:
        - file: content/notebooks/01_start.md
        - file: content/notebooks/01_notes.md
    - title: Unit 2 — Computing and mathematical preliminaries
      children:
        - file: content/notebooks/02_start.md
        - file: content/notebooks/02_notes.md
    - title: Unit 3 — Mathematical modeling
      children:
        - file: content/notebooks/03_start.md
        - file: content/notebooks/03_notes.md
    - title: Unit 4 — Equations of motion
      children:
        - file: content/notebooks/04_start.md
        - file: content/notebooks/04_notes.md
    - title: Unit 5 — Conservation laws
      children:
        - file: content/notebooks/05_start.md
        - file: content/notebooks/05_notes.md
    - title: Unit 6 — Stability, energy, and momentum
      children:
        - file: content/notebooks/06_start.md
        - file: content/notebooks/06_notes.md
        - file: content/notebooks/06_momentum_notes.md
    - title: Unit 7 — Nonlinear dynamics
      children:
        - file: content/notebooks/07_start.md
        - file: content/notebooks/07_notes.md
    - title: Unit 8 — Oscillations
      children:
        - file: content/notebooks/08_start.md
        - file: content/notebooks/08_notes.md
    - title: Unit 9 — Driven oscillations and resonance
      children:
        - file: content/notebooks/09_start.md
        - file: content/notebooks/09_notes.md
    - title: Unit 10 — Chaotic dynamics
      children:
        - file: content/notebooks/10_start.md
        - file: content/notebooks/10_notes.md
    - title: Unit 11 — Calculus of variations
      children:
        - file: content/notebooks/11_start.md
        - file: content/notebooks/11_notes.md
    - title: Unit 12 — The principle of least action
      children:
        - file: content/notebooks/12_start.md
        - file: content/notebooks/12_notes.md
    - title: Unit 13 — Lagrangian mechanics
      children:
        - file: content/notebooks/13_start.md
        - file: content/notebooks/13_notes.md
    - title: Homework
      children:
        - file: content/notebooks/hw1.md
        - file: content/notebooks/hw2.md
        - file: content/notebooks/hw3.md
        - file: content/notebooks/hw4.md
        - file: content/notebooks/hw5.md
        - file: content/notebooks/hw6.md
        - file: content/notebooks/hw7.md
        - file: content/notebooks/hw8.md
site:
  template: book-theme
  title: Modern Classical Mechanics
  actions:
    - title: GitHub
      url: https://github.com/QuadriviumPress/modernClassicalMechanics
  nav:
    - title: Sources & Attribution
      url: https://github.com/QuadriviumPress/modernClassicalMechanics/blob/main/SOURCES.md
  options:
    favicon: images/favicon.svg
    logo: images/logo.svg
    logo_dark: images/logo-dark.svg
    logo_alt: Spinning top with a precession ring
    logo_text: Modern Classical Mechanics
    logo_url: /
    hide_authors: true
