Pelican is a static site generator that uses python.
We can write content into markdown files and then run "pelican [content_dir]", plugging in the name of the directory in which we write our markdown files
Pelican generally treats content files as "posts", like for a blog. Information about the posts can be passed to Pelican using lines at the top of the markdown files. (title, date, summary) It seems to be important that there are NO EMPTY LINES between these metadata lines, and they must be at the very top. Posts seem to require titles and dates, the "compiler" will choke if they are missing.
Categories
we can assign up to one category to each post. this can be useful if we want to create a view with a list of all posts with a certain category.
how to assign Categories
a "category: the_category" line at the top of the file can be used to explicitly assign a category
if there are subdirectories within the "content_dir" folder, the name of the containing