Push to dev branch, which will load what your change would look like on https://introml.mit.edu/notes/dev/
If you're happy with the changes, merge dev into main. This will update the live site at https://introml.mit.edu/notes/
We need two things.
-
The engine
quarto. We just need that page's step-oneCLIdownload. It should be a simplecurlorwgetcommand on the terminal. Or on MacOS, just a download and one-click installation. If the installation goes right, the executablequartoshould be callable from the terminal. -
Clone this repo. In the terminal,
cdinto the root of this repo. Runquarto preview. If all goes well, alocalhost:8888link will pop up, and a browser tab will open. That tab will be "live": i.e. it'd be updated as we make local changes.
In terms of content, book chapter source files are those *.qmd files. The qmd syntax is almost identical to markdown (which itself is pretty close to LaTeX). The qmd files are converted to html by quarto and then served on the website.