Code examples for the Fall 2023 term of the University of Michigan's AEROSP 523 CFD course
Find the rendered site here
All packages required to build and run the website pages are listed in requirements.txt
.
It's probably a good idea to create a new python environment for working on the site.
Once you've created and activated your environment, run:
pip install -r requirements.txt
First create either a markdown file or jupyter notebook in whichever directory feels most appropriate (Examples, Content, some new directory etc).
If the page is part of a new chapter, also create a markdown file for the chapter in the same directory, e.g in NewChapter.md
# Chapter Title
```{tableofcontents}
```
Add the new page to the table of contents file, _toc.yml
, for example, to add the new chapter and new file within the chapter, you can add:
chapters:
.
.
.
- file: Path/To/NewChapter
sections:
- file: Path/To/NewPage.ipynb
To build the site locally, run:
make
Which should rebuild only the new content you added. To rebuild the whole site from scratch, run:
make clean&&make
To check the built website, open up _build/html/index.html
in your web browser.
This project is created using the excellent open source Jupyter Book project and the executablebooks/cookiecutter-jupyter-book template.