farshadj101 / emp-125

UIUC CS 199 EMP (paired with CS 125) Slide Website for Spring 2021 and Fall 2020

CS 199 Even More Practice

Slides for CS 199 Even More Practice Using Marp.

The html files are generated from the markdown files, so don't edit the html files but just edit the markdown files and github actions will automatically make the html files.

You can find the homepage here.

Pull Requests welcome.

Powered with fancy automation via Github actions and Netlify.

Contributing

1. git pull - Load up whatever's done so far. Sometimes this will include autogenerated slide files in the dist/ folder.

2. The slides/ folder has the slides in the format sem/YYYY-MM-DD.md, make sure to create/edit the right one. template.md can be a good starting point. sem will be in the format f20, s21 etc.

3. Make sure index.html has a link to /dist/sem/YYYY-MD-DD.html. It's fine if the file doesn't exist yet (it will be autogenerated) just make sure to include it so that viewers can actually see it.

Inspiration

The homepage also lists EMP slides and recordings from previous semesters. The course format doesn't change too drastically so feel free to use those as starting points for inspiration.

Locally Using marp

If you want to do this you can, but the CI will automatically take care of it so you don't have to.

1. Install it (assuming you have npm)

npm install -g @marp-team/marp-cli

2. To convert

marp -I slides/ --output dist/