This is the website for a new grad course at Cornell on compilers. It uses Zola.
To add a blog post (which you must do for discussion leading and project reports), use a pull request.
You'll want to create a text file in the content/blog/
directory with your new post.
Use a filename like YYYY-MM-DD-title.md
, where the date is the discussion day or the project deadline and the title is up to you.
Include Zola-style "TOML front matter" at the top, which looks like this:
+++
title = "Welcome to CS 6120!"
[extra]
bio = """
Grace Hopper made the first compiler. [Adrian Sampson](https://www.cs.cornell.edu/~asampson/) is an assistant professor of computer science, so that's pretty cool too I guess.
"""
[[extra.authors]]
name = "Adrian Sampson"
link = "https://www.cs.cornell.edu/~asampson/" # Links are optional.
[[extra.authors]]
name = "Grace Hopper"
+++
List all the authors of your post. Include a link to your homepage if you have one, but it's optional. Also write a short bio for yourselves (using Markdown), which will appear at the bottom of the post. Then, the rest of the text file is the Markdown text of your blog post.
If you want to use math in your blog post, put latex = true
in your [extra]
section to enable KaTeX. Then you can use $\pi$
for inline math and \[ e^{i\pi} + 1 = 0 \]
for display math.
To include images or other resources in your post, make your post into a directory.
That is, make a new directory called YYYY-MM-DD-title
inside content/blog/
.
Then, put your text in a file called index.md
inside that.
Put your images in the same directory and refer to them with relative paths.
See the Zola docs on assets for more details.
You can preview your writing with any Markdown renderer.
To see what it will look like when published, install Zola and type zola serve
to preview the entire site.