vehicle-physics-docs
Sources for the documentation at Vehicle Physics Pro. This repository contains the sources for the documentation site only.
Follow @VehiclePhysics for latest news and updates on the project.
Contributing
Feedback, improvements and corrections to the docs are welcome, specially typo and grammar fixes. Feel free to submit your contributions via comments and/or pull requests.
Documents are plain markdown files. You don't need any special procedure for editing, just a text editor. Previewing the HTML result requires building the docs.
Building & previewing the docs
This is optional. Documentation sources are plain text files using the Markdown format.
The HTML documentation is built out of the md files using MkDocs:
- Ensure Python and pip are installed
- Install MkDocs:
pip install mkdocs
- Install the Bootswatch themes:
pip install mkdocs-bootswatch
- Install the Markdown extensions markdown-icons and mathjax.
- Clone the repository from GitHub
- Open a console at the repository folder, they type
mkdocs serve
- Navigate to
http://127.0.0.1:8000
in your browser
Now you should see the documentation in your browser.