myst.yml

version: 1

project:
  plugins:
    - https://github.com/jupyter-book/myst-plugins/releases/download/exercise-and-solution-pdf/exercise-admonition-pdf.mjs
    - https://github.com/jupyter-book/myst-plugins/releases/download/Admonitions/experiment-admonition.mjs
    - https://github.com/jupyter-book/myst-plugins/releases/download/Admonitions/intermezzo-admonition.mjs
    - https://github.com/TUD-JB-Templates/JB2_plugins/releases/download/example/example.mjs
    - https://github.com/jupyter-book/myst-plugins/releases/download/updated-date-frontmatter/update-date-frontmatter.mjs
    # - plugins/aside.mjs
    # - https://github.com/jupyter-book/myst-plugins/releases/download/Admonitions/example-admonition.mjs
    # - https://github.com/jupyter-book/myst-plugins/releases/download/iframe-to-qr-pdf/iframe-to-qr-pdf.mjs
    # - plugins/iframe2.mjs    
    - plugins/typst_eq.mjs              # for unknown symbols in typst
    - https://github.com/jupyter-book/myst-plugins/releases/download/page-last-updated/page-last-updated.mjs
     
  title: Classical Mechanics & Special Relativity for Starters
  authors:
    - name: Robert F. Mudde 
    - name: Bernd Rieger
    - name: C. Freek. J. Pols    
  github: https://github.com/FreekPols/Mechanica
  copyright: Delft University of Technology, CC BY NC 4.0
  date: 2025-09-28 # YYYY/MM/DD
  # abstract:

  numbering:
  description: This book provides an introduction for freshman students into the world of classical mechanics and special relativity theory. Much of physics is build on the basic ideas from classical mechanics. Hence an early introduction to the topic can be beneficial for new students. However, at the start of studying physics, lots of the required math is not available yet. That means that all kind of concepts that are very useful cannot be invoked in the lectures and teaching. That does not have to be a disadvantage. It can also be used to help the students by introducing some math and coupling it directly to the physics, making more clear why mathematics should be studied and what its 'practical use' is. With this book, we aim to introduce new students directly at the start of their studies into the world of physics, more specifically the world of Newton, Galilei and many others who laid the foundation of physics. We aim to help students getting a good understanding of the theory, i.e. the framework of physics. What is 'work' and why do we use it? Why is kinetic energy 1/2mv² and not 1/3mv² or 1/2mv³? Both 3's are fundamentally wrong, but what is behind it?

  exports:
    - format: typst
      template: https://github.com/myst-templates/plain_typst_book.git 
      output: exports/MechaRela.pdf
      id: output-pdf1
      logo: logo_TUD.png
      cover: cover.png


  # downloads:
  # #   # - id: output-typst
  #   - id: output-pdf1


  jupyter:
    binder:
      repo: https://github.com/executablebooks/thebe-binder-base
    

########################################################################  
  toc:
    - file: index.md
    - file: content/Credits.md      
      
    - file: content/classic/Mechanics.md
      children:    
        - file: content/classic/1_Language.md
          children:
            - file: content/classic/1_Language_ex.ipynb        

        - file: content/classic/2_NewtonsLaws.md
          children:
            - file: content/classic/2_NewtonsLaws_ex.ipynb

        - file: content/classic/3_WorkEnergy.md
          children:
            - file: content/classic/3_WorkEnergy_ex.ipynb

        - file: content/classic/4_AngularMomentum.md
          children:
            - file: content/classic/4_AngularMomentum_ex.ipynb

        - file: content/classic/5_ConservationEquations.md
          children:
            - file: content/classic/5_ConservationEquations_ex.ipynb

        - file: content/classic/Ch8_Oscillations.ipynb
          children:
            - file: content/classic/6_Oscillations_ex.ipynb

        - file: content/classic/7_Collisions.md

          children:
            - file: content/classic/7_Collisions_ex.ipynb

        - file: content/classic/8_TwoBody.md
          children:
            - file: content/classic/8_TwoBody_ex.ipynb


#######################################################################
    - file: content/special/SpecialRelativity.md
      children:        
        - file: content/special/ChX2_CracksInMecha.md
          children:
            - file: content/special/ChX2_ex.md

        - file: content/special/ChX3_IntroSpecialRelativity.md
          children:
            - file: content/special/ChX3_ex.md

        - file: content/special/ChX4_VelotransDoppler.md
          children:
            - file: content/special/ChX4_ex.md

        - file: content/special/ChX5_FourVectors.md
          children:
            - file: content/special/ChX5_ex.md

        - file: content/special/ChX6_FourMomentum.md
          children:
            - file: content/special/ChX6_ex.md

        - file: content/special/ChX7_RelDynColl.md
          children:
            - file: content/special/ChX7_ex.md

    # - file: content/appendix/appendix.md
    #   children:
    #     - file: content/appendix/indeces.md

    # - title: Project
    #   children:
    #     - file: content/project/Deeltjes.ipynb

    # - file: content/howto/Fordevelopers.md
    #   children:
    #     - file: content/howto/Howtostart.md
    #     - file: content/howto/Cheatsheet.md
    #     - file: content/howto/test.ipynb
    #     - file: content/howto/test2.md
    #     - file: content/howto/GHGL.md
        
#########################################################################
site:
  options:
    logo: content/images/tudelft.png
    favicon: content/images/favicon.ico
    folders: true
    hide_authors: true
    enable_service_worker: false
    execute_js: true
    style: ./style/custom.css

  actions:
    - title: Feedback
      url: https://github.com/FreekPols/Mechanica/issues
    - title: PDF 
      url: exports/MechaRela.pdf

  template: book-theme